# 城丰星际 · CFXJ — 开源层安装手册

> 本手册仅指导**开源表层（前端+Gateway）**的部署  
> 不包含 core-runtime.exe 编译/构建/加密流程

---

## 系统要求

| 项 | 最低配置 |
|----|---------|
| 操作系统 | Windows 10/11 或 Windows Server 2019+ |
| Node.js | 18.x 或更高 |
| 内存 | 2GB（仅前端） |
| 端口 | 18989（Gateway） |

> 如需完整业务调度能力，还需 core-runtime.exe（约10MB，官方分发）

---

## 安装步骤

### 1. 获取文件

- 开源层：从 GitHub 下载或 `git clone`
- 内核：从 www.gdcfxj.com 下载 `core-runtime.exe`

### 2. 安装 Node.js 依赖

```bash
cd open/gateway
npm install
```

### 3. 启动

```bash
# 先启动内核（在 open/ 目录下）
core-runtime.exe

# 另开终端，启动Gateway
cd open/gateway
node index.js
```

### 4. 验证

浏览器访问 `http://localhost:18989`，看到仪表盘即部署成功。

---

## 常见问题

### 页面加载失败/空白
- 检查 core-runtime.exe 是否已启动
- 检查端口18989是否被占用：`netstat -ano | findstr 18989`

### API跨域错误
- 确保Gateway和core-runtime在同一台机器
- 检查 `gateway/config.js` 中的API地址配置

### 静态资源缺失
- 确保 `frontend/` 目录完整（index.html + app_v2.js + app.js）
- 清除浏览器缓存后重试

### 内核启动失败排查
- 确认 `core-runtime.exe` 在 `open/` 目录下
- 检查 18991 端口是否被占用：`netstat -ano | findstr 18991`
- 启动后应有日志输出 `task-server: 18991`，无输出则检查杀毒软件是否拦截
- 内核启动后访问 `http://localhost:18991/api/health` 验证

### 安装脚本仅部署UI
- 本脚本不包含内核编译、构建、加密
- 无 `core-runtime.exe` 无法执行业务调度
- 内核二进制必须从官方渠道获取