# 城丰星际 · CFXJ — 开源版

> AI驱动的企业任务调度与团队协作平台 — 开源表层

---

## 快速开始

### 前置条件
- Windows 10/11 或 Windows Server
- Node.js 18+
- **必须**从官方渠道获取 `core-runtime.exe`（闭源内核）

### 安装步骤

1. 下载本开源包 + `core-runtime.exe`
2. 将 `core-runtime.exe` 放入 `open/` 根目录
3. 安装前端依赖：
   ```bash
   cd gateway && npm install
   ```
4. 启动内核：
   ```bash
   core-runtime.exe
   ```
5. 启动Gateway：
   ```bash
   node gateway/index.js
   ```
6. 浏览器打开 `http://localhost:18989`

---

## 二次开发指引

### 修改前端UI
- 仪表盘：编辑 `frontend/index.html`
- 样式：编辑 `frontend/app_v2.js` 中的CSS部分
- 自定义Logo：替换 `assets/` 下的图片资源

### 自定义技能模板
在 `skills/` 目录添加 `.md` 文件，格式参考 `skills/example-skill.md`

### 调用只读API
参考 `API_SPEC.md` 中的只读接口，可做：
- 本地数据看板
- 批量导出报表
- 消息通知插件

---

## 重要限制

- ❌ **不可直连数据库**（SQLite/Neo4j）
- ❌ **不可逆向 core-runtime.exe**
- ❌ **不可剥离内核单独运行**
- ✅ 可修改前端UI、自定义技能模板、对接只读API

---

## 许可

- 本目录代码：**AGPLv3** 协议
- `core-runtime.exe`：专有技术秘密，禁止逆向

详见 `COPYRIGHT.md`

---

## 链接

- 官方网站：www.gdcfxj.com
- API文档：`API_SPEC.md`
- 安装指南：`INSTALL.md`
- 开发手册：`dev-docs/`