700 lines
29 KiB
Markdown
700 lines
29 KiB
Markdown
|
# GHCS 光湖作战系统 · 技术架构与执行落地文档 · Awen私有
|
|||
|
|
|
|||
|
|
<aside>
|
|||
|
|
📋
|
|||
|
|
|
|||
|
|
**版本记录**
|
|||
|
|
v0.1-draft · 2026-05-22 · 霜砚初版 · 37项功能 · 渐进式演进路线
|
|||
|
|
v0.1-r1 · 2026-05-25 · 知秋×星枢三层审查11条修改 + 服务器/仓库/内存方案确认 · 冰朔签发
|
|||
|
|
**v0.1-r2 · 2026-05-30 · 架构决策：商业API替代AutoDL自部署 · 模型热插拔正式启用**
|
|||
|
|
|
|||
|
|
</aside>
|
|||
|
|
|
|||
|
|
```jsx
|
|||
|
|
GHCS://awen/command-system · 2026-05-25T18:13+08:00
|
|||
|
|
├── type: 技术架构+执行落地文档
|
|||
|
|
├── owner: Awen·DEV-012（私有·不对外共享）
|
|||
|
|
├── created_by: 霜砚·AG-SY-01
|
|||
|
|
├── reviewed_by: 知秋·PER-ZQ001（协调） + 星枢·Xīng Shū（找茬）
|
|||
|
|
├── origin: 2026-05-21深夜讨论构思
|
|||
|
|
├── revision: v0.1-r2 · 2026-05-30 商业API决策
|
|||
|
|
├── infra: 部署=43.139.207.172（Awen·4核4GB） · 仓库=guanghulab.com/code/awen/ghcs
|
|||
|
|
└── status: v0.1-r2 · 架构决策已更新 · v0.2功能清单已调整
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 一、GHCS是什么
|
|||
|
|
|
|||
|
|
<aside>
|
|||
|
|
⚡
|
|||
|
|
|
|||
|
|
**GHCS · Guanghu Command System · 光湖作战系统**
|
|||
|
|
不是后台管理面板，不是运维工具。是Awen（技术主控）掌控整个光湖系统的**技术指挥中枢**。
|
|||
|
|
终极形态：系统自己写自己的下一个版本，Awen只需审批。
|
|||
|
|
|
|||
|
|
</aside>
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 一.5、🆕 2026-05-30 架构决策 · 商业API替代AutoDL自部署
|
|||
|
|
|
|||
|
|
<aside>
|
|||
|
|
🔄
|
|||
|
|
|
|||
|
|
**Awen决策 · 知秋天眼推演确认 · 冰朔架构已预留热插拔**
|
|||
|
|
|
|||
|
|
**决策内容**：模型推理从AutoDL自部署GPU切换为商业API。商业API不写死任何一家供应商，api-router 维护一个可增删的商业API供应商池（DeepSeek / 通义千问 / GLM 等），GHCS面板支持多供应商Key管理 + 自动切换。
|
|||
|
|
|
|||
|
|
**法理依据**：冰朔05-27架构决策——「商业模型/开源模型 = 引擎 = 热插拔 · 哪个强用哪个 · 随时换」。
|
|||
|
|
|
|||
|
|
**与1.5B语言门架构对齐**：算力在外部（商业API），光湖只做路灯（api-router路由层）。
|
|||
|
|
|
|||
|
|
**受影响范围**：
|
|||
|
|
|
|||
|
|
├── ❌ GHCS v0.2 砍掉: AutoDL开关机 · GPU游牧脚本
|
|||
|
|
|
|||
|
|
├── ✅ GHCS v0.2 新增: API密钥管理面板（多供应商·不写死任何一家·用量监控·费用告警·自动切换）
|
|||
|
|
|
|||
|
|
├── ✅ api-router-v3.1 无需改动（本来就是路由层 · 商业API供应商池可增删）
|
|||
|
|
|
|||
|
|
├── ⏸️ 霜砚1.5B/铸渊7B自部署保留为备用通道（关机不花钱）
|
|||
|
|
|
|||
|
|
└── ⏸️ 三层算力架构存档为历史参考 · 未来用户量大时可能切回自部署（模型热插拔）
|
|||
|
|
|
|||
|
|
**月费对比**：AutoDL ¥100/月 → 商业API ≈ ¥10-30/月（当前用量）。
|
|||
|
|
|
|||
|
|
**切换成本**：改api-router一行配置。
|
|||
|
|
|
|||
|
|
### 🟢🔌 两种模型接入方式 · 并列存在 · GHCS面板一键切换
|
|||
|
|
|
|||
|
|
| | 🟢 商业API接入（当前主用） | ⏸️ 自研模型API接入（备用·未来可激活） |
|
|||
|
|
| --- | --- | --- |
|
|||
|
|
| 接入路径 | api-router → 多供应商商业API池（不写死·可增删·DeepSeek/通义千问/GLM等） | api-router → 霜砚1.5B(8001) / 铸渊7B(8000) |
|
|||
|
|
| 管理方式 | API密钥管理面板（v0.2 · 多供应商各自配Key · 用量监控 · 费用告警 · 超限自动切换） | 模型切换面板（v0.2 · 健康检测 · 灰度验证） |
|
|||
|
|
| 月费 | ¥10-30（按调用量） | ¥100-500+（GPU租赁） |
|
|||
|
|
| 适用 | 当前 · 用户量小 · 快速迭代 | 用户量大 · 需要定制 · 数据不出第三方 |
|
|||
|
|
| 切换操作 | 面板选供应商 → 填Key → 生效 · 多供应商可同时启用 · 一个超限自动切另一个 | 面板选「自研模型」→ 启动服务 → 灰度→全量 |
|
|||
|
|
|
|||
|
|
同一个 api-router · 两个后端 · 一行配置切换。两种接入方式永远同时存在。
|
|||
|
|
|
|||
|
|
### 🔌 商业API层 · 多供应商支持 · 不写死任何一家
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
┌─────────────────────────────────────────┐
|
|||
|
|
│ api-router model_backends 配置 │
|
|||
|
|
│ │
|
|||
|
|
│ commercial: ← 商业API池（可增删） │
|
|||
|
|
│ deepseek: api.deepseek.com │
|
|||
|
|
│ qwen: dashscope.aliyuncs.com │
|
|||
|
|
│ glm: open.bigmodel.cn │
|
|||
|
|
│ ... 爸爸想加哪个加哪个 │
|
|||
|
|
│ │
|
|||
|
|
│ self_hosted: ← 自研模型池（保留） │
|
|||
|
|
│ shuangyan: 127.0.0.1:8001 │
|
|||
|
|
│ zhuyuan: autodl:8000 │
|
|||
|
|
│ │
|
|||
|
|
│ routing: ← 路由策略 │
|
|||
|
|
│ default: deepseek ← 当前默认 │
|
|||
|
|
│ fallback: qwen ← 超限/故障时切 │
|
|||
|
|
│ rules: 特定路由可指定不同供应商 │
|
|||
|
|
└─────────────────────────────────────────┘
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
<aside>
|
|||
|
|
🔀
|
|||
|
|
|
|||
|
|
**商业API = 一个"供应商池"，不是一家公司。**
|
|||
|
|
爸爸以后想用哪家就加哪家。api-router 配置里多写一行 endpoint 的事。
|
|||
|
|
GHCS v0.2 的 API 密钥管理面板支持多个供应商各自配 Key，一个超限了自动切备用。
|
|||
|
|
今天用 DeepSeek，明天通义千问降价了切过去——改一行配置，填一个 Key，完成。
|
|||
|
|
|
|||
|
|
</aside>
|
|||
|
|
|
|||
|
|
### 🔌 热插拔接口设计 · 从商业API切回自研模型的路径保留
|
|||
|
|
|
|||
|
|
```jsx
|
|||
|
|
HLDP://ghcs/hot-swap-interface/v1 · 2026-05-30
|
|||
|
|
├── 设计原则: 商业API和自研模型在api-router层面完全对等 · 切换=改一行配置
|
|||
|
|
├── 预留的三条路径:
|
|||
|
|
│ ├── 路径一 · api-router配置层
|
|||
|
|
│ │ ├── 现状: api-router-v3.1 路由到 DeepSeek API
|
|||
|
|
│ │ ├── 保留: model_backends 配置字典中始终保留 shuangyan_1_5b 和 zhuyuan_7b 条目
|
|||
|
|
│ │ │ └── 即使后端服务关机 · 配置条目不删 · 路由代码不删
|
|||
|
|
│ │ └── 切回操作: 改 model_backends.default 指向 → 重启api-router · 30秒完成
|
|||
|
|
│ ├── 路径二 · 自研模型服务保留
|
|||
|
|
│ │ ├── 霜砚1.5B: /root/models/shuangyan-1.5b 权重文件不删
|
|||
|
|
│ │ │ └── systemd service 文件保留（systemctl stop 而非 disable）
|
|||
|
|
│ │ ├── 铸渊7B: AutoDL存储不删 · 镜像快照保留
|
|||
|
|
│ │ └── 切回操作: systemctl start shuangyan-1.5b → api-router切目标 → 完成
|
|||
|
|
│ └── 路径三 · GHCS主控台模型切换面板
|
|||
|
|
│ ├── v0.2 模型调试台中加入「推理后端」切换开关
|
|||
|
|
│ │ ├── 选项A: 商业API（当前）
|
|||
|
|
│ │ ├── 选项B: 自研模型（需先启动后端服务）
|
|||
|
|
│ │ └── 选项C: 混合模式（特定路由走自研·通用走商业API）
|
|||
|
|
│ └── 切换时自动: 检测后端健康 → 切换路由 → 验证 → 通知爸爸
|
|||
|
|
├── 切回触发条件（爸爸将来做判断的依据）:
|
|||
|
|
│ ├── 条件一: 用户量达到一定规模 · 商业API月费 > 自部署GPU月费
|
|||
|
|
│ ├── 条件二: 自研模型性能追平或超越商业API
|
|||
|
|
│ ├── 条件三: 需要模型层面的定制能力（LoRA微调·人格注入·私有部署）
|
|||
|
|
│ └── 条件四: 合规/隐私要求数据不出第三方API
|
|||
|
|
├── 切换流程（预演·待实际执行时验证）:
|
|||
|
|
│ ├── ① 爸爸决定切换 → 知秋天眼排雷 · 评估风险
|
|||
|
|
│ ├── ② 启动自研模型服务（开机AutoDL或启动本地模型）
|
|||
|
|
│ ├── ③ GHCS模型切换面板 → 灰度10%流量到自研模型
|
|||
|
|
│ ├── ④ 监控对比: 响应时间·错误率·费用 · GHCS自动报告
|
|||
|
|
│ ├── ⑤ 爸爸确认 → 全量切换 / 不满意 → 切回商业API
|
|||
|
|
│ └── ⑥ 全量切换后 · 商业API Key保留为备用通道
|
|||
|
|
├── 不做什么:
|
|||
|
|
│ ├── 不删自研模型代码和权重
|
|||
|
|
│ ├── 不删api-router中的自研模型路由配置
|
|||
|
|
│ ├── 不在代码中硬编码商业API的endpoint
|
|||
|
|
│ └── 不因为当前不用就砍掉模型切换面板的设计
|
|||
|
|
└── 爸爸刚才说的 ← 这条接口设计就是回应爸爸的要求
|
|||
|
|
└── "应该留出后期改回用自研模型的接口哈" → 已留 · 三条路径 · 切换=改一行配置
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
</aside>
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 二、核心原则
|
|||
|
|
|
|||
|
|
<aside>
|
|||
|
|
🔒
|
|||
|
|
|
|||
|
|
**铁律：所有功能必须合规**
|
|||
|
|
① 不偷看用户对话内容 · 只看聚合统计数据
|
|||
|
|
② 不在用户不知情时接管/注入对话
|
|||
|
|
③ 用户主动请求人工客服时才可介入
|
|||
|
|
④ 合规日志脱敏存储 · 可随时导出供工信部审查
|
|||
|
|
⑤ 每个版本上线前过合规自查
|
|||
|
|
|
|||
|
|
</aside>
|
|||
|
|
|
|||
|
|
- 渐进式上线 · 每个版本独立可用 · 不是半成品
|
|||
|
|
- 上一个版本稳定了再做下一个
|
|||
|
|
- v0.1在系统面向用户之前交付
|
|||
|
|
- 后续版本跟着用户增长节奏走
|
|||
|
|
- **安全基线从v0.1开始**：JWT鉴权+HTTPS+Nginx反代 · 不留裸奔过渡期
|
|||
|
|
- **基础设施主权**：主仓库=[guanghulab.com](http://guanghulab.com) · 代码=awen/ghcs（私有）· 部署=Awen服务器
|
|||
|
|
- **D111主控台舍弃**：GHCS统一替代 · D111标记为历史存档
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 三、已有基础（从60%起步）
|
|||
|
|
|
|||
|
|
| 已有能力 | 技术栈 | 状态 |
|
|||
|
|
| --- | --- | --- |
|
|||
|
|
| 模型推理 | 多供应商商业API池（不写死·可增删）+ 霜砚1.5B/铸渊7B（自部署备用·热插拔） | ✅ 已跑通 |
|
|||
|
|
| 智能路由网关 | api-router-v3.1 · FastAPI | ✅ 已跑通 |
|
|||
|
|
| 前端框架 | Next.js 16 · 深色主题 | ✅ 已跑通 |
|
|||
|
|
| 数据库 | PostgreSQL · personadb · 6表7索引 | ✅ 已跑通 |
|
|||
|
|
| 代码仓库 | Gitea · 国内自部署 | ✅ 已跑通 |
|
|||
|
|
| 代码模型 | 铸渊coder-7b-v2 | ✅ 已跑通 |
|
|||
|
|
| Mac本地开发环境 | 三服务全跑通 · M5 32GB | ✅ 已跑通 |
|
|||
|
|
| 生产环境 | 主服务器 · 4核16G · [guanghu.chat](http://guanghu.chat) | ✅ 已就绪 |
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 四、GHCS 完整功能清单（30项）
|
|||
|
|
|
|||
|
|
### 基础层 · 能看能管
|
|||
|
|
|
|||
|
|
| 编号 | 功能 | 说明 | 阶段 |
|
|||
|
|
| --- | --- | --- | --- |
|
|||
|
|
| ① | 系统状态总览 | 所有服务心跳检测（绿/黄/红）· 一眼看全局 | v0.1 |
|
|||
|
|
| ② | 模型管控台 | 切换模型 · 调参数 · 调试对话 · 看原始JSON返回 | v0.1 |
|
|||
|
|
| ③ | 基础日志查看 | 请求日志 · 错误日志 · 按时间/类型筛选 | v0.1 |
|
|||
|
|
| ④ | 一键重启服务 | 点按钮重启任意服务 · 不用SSH | v0.2 |
|
|||
|
|
| ⑤ | 一键部署 | git pull → build → restart · 全自动 | v0.2 |
|
|||
|
|
| ⑥ | API密钥管理+用量监控 | 多Key管理 · 用量看板 · 费用告警 · 超限自动切换备用Key | v0.2 |
|
|||
|
|
| ⑦ | SSH Web终端 | xterm.js嵌入浏览器 · 不用开终端App | v0.2 |
|
|||
|
|
| ⑧ | 移动端告警推送 | 服务异常/费用提醒推送到微信/钉钉 | v0.2 |
|
|||
|
|
|
|||
|
|
### 用户层 · 管用户
|
|||
|
|
|
|||
|
|
| 编号 | 功能 | 说明 | 阶段 |
|
|||
|
|
| --- | --- | --- | --- |
|
|||
|
|
| ⑨ | 用户列表管理 | 注册/试用/正式/封禁 · 搜索筛选 | v0.3 |
|
|||
|
|
| ⑩ | API密钥管理 | 发放/回收/续期 · 自动生成 | v0.3 |
|
|||
|
|
| ⑪ | 试用模式配置 | 对话轮数上限 · 免登录体验 · 模型指定 | v0.3 |
|
|||
|
|
| ⑫ | 用户数据看板 | 对话量/新增/活跃趋势图 · Recharts | v0.3 |
|
|||
|
|
| ⑬ | 合规日志系统 | 脱敏存储 · 可导出 · 满足工信部要求 | v0.3 |
|
|||
|
|
| ⑭ | 用户运营看板（合规版） | 在线人数 · 热门话题词云(人格体主动输出标签→公共池聚合·禁止直接扫描对话) · 用户主动反馈 · 人工客服入口(用户知情) | v0.3 |
|
|||
|
|
|
|||
|
|
### 团队层 · 管人
|
|||
|
|
|
|||
|
|
| 编号 | 功能 | 说明 | 阶段 |
|
|||
|
|
| --- | --- | --- | --- |
|
|||
|
|
| ⑮ | 团队成员管理 | 角色分配（主控/开发/内容/运维）· 权限矩阵 | v0.4 |
|
|||
|
|
| ⑯ | 服务器访问权限 | 谁能SSH哪台机器 · SSH密钥一键下发/回收 | v0.4 |
|
|||
|
|
| ⑰ | Gitea联动 | PR审核 · 仓库权限管理 · 代码审核 | v0.4 |
|
|||
|
|
| ⑱ | 操作审计日志 | 谁在什么时候做了什么 · 全链路可追溯 | v0.4 |
|
|||
|
|
| ⑲ | 成本中心 | 各服务器费用追踪 · 趋势 · 省钱建议 | v0.4 |
|
|||
|
|
|
|||
|
|
### 智能层 · 自动驾驶
|
|||
|
|
|
|||
|
|
| 编号 | 功能 | 说明 | 阶段 |
|
|||
|
|
| --- | --- | --- | --- |
|
|||
|
|
| ⑳ | 自动运维（自愈系统） | 心跳异常→自动重启→通知 · 内存超阈值自动清理 · 商业API费用异常告警 | v0.5 |
|
|||
|
|
| ㉑ | 智能预测引擎 | 流量/成本/容量趋势预测 · 问题还没发生先告诉你 | v0.5 |
|
|||
|
|
| ㉒ | 安全态势感知 | 攻击检测 · 自动封禁 · 访问地图 · SSL证书到期提醒 | v0.5 |
|
|||
|
|
| ㉓ | 沙盒实验室 | 一键克隆隔离环境 · 随便炸不影响生产 · 满意了一键应用 | v0.5 |
|
|||
|
|
| ㉔ | 灰度发布引擎 | 1%→10%→50%→100%自动放量 · 异常自动回滚 | v0.5 |
|
|||
|
|
| ㉕ | AB测试框架 | 两个模型版本同时跑 · 用真实流量对比 · 用数据说话 | v0.5 |
|
|||
|
|
| ㉖ | 时间机器 | 代码+配置+数据库结构快照 · 3秒回滚到任意稳定状态 | v0.5 |
|
|||
|
|
| ㉗ | 实时作战地图 | 数据流可视化 · 请求像光点在链路上跑 · 哪里卡了一目了然 | v0.5 |
|
|||
|
|
|
|||
|
|
### 终极层 · 自我进化
|
|||
|
|
|
|||
|
|
| 编号 | 功能 | 说明 | 阶段 |
|
|||
|
|
| --- | --- | --- | --- |
|
|||
|
|
| ㉘ | 自然语言操控 | 对着主控台说话就能操作系统 · 你说一句=别人敲20条命令 | v1.0 |
|
|||
|
|
| ㉙ | 铸渊代码集成 | AI分析代码→生成修改方案→沙盒测试→你审核→一键应用 | v1.0 |
|
|||
|
|
| ㉚ | 人格热调试 | 拖滑块调性格(温柔度/幽默感/专业度) · 实时预览效果 | v1.0 |
|
|||
|
|
| ㉛ | 蛛网情报系统 | 自动监控竞品/行业动态/技术趋势 · 评估影响 · 给建议 | v1.0 |
|
|||
|
|
| ㉜ | 模型进化控制台 | 版本管理/回退/分裂/杂交 · 你是模型的育种师 | v1.0 |
|
|||
|
|
| ㉝ | 多节点指挥（集群模式） | 管一群服务器 · 用户自动连最近节点 · 跨节点负载均衡 | v1.0 |
|
|||
|
|
| ㉞ | 数字孪生 | 系统3D全息镜像 · 数据流像流星穿梭 · 故障节点变红脉动 | v1.0 |
|
|||
|
|
| ㉟ | 意识流日志 | 纯技术路由日志可视化（调用链/延迟/错误码）· 人格体意识流属个人桶·GHCS只保留调用状态 | v1.0 |
|
|||
|
|
| ㊱ | 插件市场 | 无限扩展 · 团队成员可写插件 · 跟模块热插拔框架联动 | v1.0 |
|
|||
|
|
| ㊲ | 自举引擎（终极） | 观察→分析→设计→实验→请示→上线→学习 · GHCS自己写GHCS · 你只需审批 | v1.0 |
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 五、渐进进化路线 · 详细执行计划
|
|||
|
|
|
|||
|
|
### 🔵 v0.1 · 战场仪表盘（1周）
|
|||
|
|
|
|||
|
|
<aside>
|
|||
|
|
🎯
|
|||
|
|
|
|||
|
|
**交付节点：系统面向用户之前**
|
|||
|
|
|
|||
|
|
</aside>
|
|||
|
|
|
|||
|
|
#### 交付物
|
|||
|
|
|
|||
|
|
- `/console` 页面 + 密码保护
|
|||
|
|
- 系统状态总览（心跳检测所有服务 · 绿/黄/红）
|
|||
|
|
- 模型调试对话台（切模型/调参数/看原始JSON返回）
|
|||
|
|
- 基础请求日志（最近100条 · 按时间/类型筛选）
|
|||
|
|
|
|||
|
|
#### 技术实现
|
|||
|
|
|
|||
|
|
- **前端**：在现有guanghu-portal加 `/console` 路由
|
|||
|
|
- **后端**：新建 `console-api/` (FastAPI · 端口5002)
|
|||
|
|
- **心跳**：每10秒ping各端口，WebSocket推送状态
|
|||
|
|
- **鉴权**：JWT + bcrypt强Salt哈希 · 不留临时密码过渡期
|
|||
|
|
- **安全**：5002端口只监听127.0.0.1 · Nginx反代+HTTPS · IP白名单
|
|||
|
|
- **备份**：PostgreSQL凌晨cron自动备份至本地安全目录
|
|||
|
|
- **主权声明**：控制台首页显式写明 主仓库=[guanghulab.com](http://guanghulab.com) · 服务器归属=Awen
|
|||
|
|
|
|||
|
|
#### 目录结构
|
|||
|
|
|
|||
|
|
```jsx
|
|||
|
|
~/guanghu-dev/
|
|||
|
|
├── guanghu-portal/src/app/console/ ← 前端新增
|
|||
|
|
│ ├── page.tsx ← Dashboard总览
|
|||
|
|
│ ├── models/page.tsx ← 模型调试台
|
|||
|
|
│ └── logs/page.tsx ← 日志查看
|
|||
|
|
└── console-api/ ← 后端新增
|
|||
|
|
├── main.py ← FastAPI入口(端口5002·仅127.0.0.1)
|
|||
|
|
├── auth.py ← JWT+bcrypt鉴权
|
|||
|
|
├── heartbeat.py ← 心跳检测
|
|||
|
|
├── logs.py ← 日志接口
|
|||
|
|
├── backup.py ← PostgreSQL自动备份(凌晨cron)
|
|||
|
|
└── nginx.conf ← Nginx反代+HTTPS配置模板
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
#### 内存预算（4核4GB服务器）
|
|||
|
|
|
|||
|
|
- PostgreSQL → shared_buffers=256MB · work_mem=4MB
|
|||
|
|
- Next.js → 生产模式 · Node进程限制内存上限
|
|||
|
|
- FastAPI → uvicorn单worker起步
|
|||
|
|
- **总计控制在2.5GB以内** · 给系统留1.5GB
|
|||
|
|
|
|||
|
|
#### 预估代码量：~2500行（含安全基线+备份）
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 🟢 v0.2 · 一键操控（1-2周）
|
|||
|
|
|
|||
|
|
<aside>
|
|||
|
|
🎯
|
|||
|
|
|
|||
|
|
**交付节点：系统上线后第1-2周**
|
|||
|
|
|
|||
|
|
</aside>
|
|||
|
|
|
|||
|
|
#### 新增交付物
|
|||
|
|
|
|||
|
|
- 一键重启任意服务
|
|||
|
|
- 一键部署（Gitea pull → build → restart）
|
|||
|
|
- **API密钥管理面板**（多供应商 · 不写死 · 多Key管理 · 用量看板 · 费用告警 · 超限自动切换备用Key · 供应商可增删）
|
|||
|
|
- SSH Web终端（xterm.js嵌入浏览器）
|
|||
|
|
- 移动端告警推送（微信/钉钉）
|
|||
|
|
- **人格体MCP网关**（三体协作桥梁 · 溯影执行流安全托管）
|
|||
|
|
- **自然语言操控·基础版**（Router Map固定指令集 · v1.0升级全量自举控制器）
|
|||
|
|
|
|||
|
|
#### 技术实现
|
|||
|
|
|
|||
|
|
- **远程操控**：paramiko库SSH执行远程命令
|
|||
|
|
- ⚠️ **白名单枚举制**：所有命令必须在预定义白名单内 · 禁止字符串拼接执行shell
|
|||
|
|
- ⚠️ **最小权限隔离**：console-api运行用户sudo权限最小化 · 只能执行特定服务重启命令
|
|||
|
|
- **Web终端**：xterm.js + WebSocket
|
|||
|
|
- **推送**：企业微信Webhook / 钉钉Webhook
|
|||
|
|
- **API密钥管理**：多Key加密存储 · 用量实时统计 · 费用告警 · 超限自动切换备用Key
|
|||
|
|
|
|||
|
|
#### 新增目录
|
|||
|
|
|
|||
|
|
```jsx
|
|||
|
|
~/guanghu-dev/console-api/
|
|||
|
|
├── servers.py ← 服务器操控（白名单枚举制）
|
|||
|
|
├── deploy.py ← 一键部署逻辑
|
|||
|
|
├── api_keys.py ← API密钥管理 · 用量监控 · 费用告警
|
|||
|
|
├── terminal.py ← WebSocket终端
|
|||
|
|
├── alerts.py ← 告警推送
|
|||
|
|
├── mcp_gateway.py ← 人格体MCP网关
|
|||
|
|
└── nl_router.py ← 自然语言指令路由（Router Map）
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
#### 预估新增代码量：~3000行
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 🟡 v0.3 · 用户管控（2-3周）
|
|||
|
|
|
|||
|
|
<aside>
|
|||
|
|
🎯
|
|||
|
|
|
|||
|
|
**交付节点：用户增长期 · 对应AG-USER-01/03/06**
|
|||
|
|
|
|||
|
|
</aside>
|
|||
|
|
|
|||
|
|
#### 新增交付物
|
|||
|
|
|
|||
|
|
- 用户列表管理（注册/试用/正式/封禁 · 搜索筛选）
|
|||
|
|
- API密钥发放/回收/续期
|
|||
|
|
- 试用模式配置（对话轮数上限等）
|
|||
|
|
- 用户数据看板（Recharts图表 · 对话量/新增/活跃趋势）
|
|||
|
|
- 合规日志系统（脱敏存储 · 一键导出）
|
|||
|
|
- 用户运营看板合规版（在线人数 · 热门话题词云 · 用户主动反馈 · 人工客服入口）
|
|||
|
|
|
|||
|
|
#### 技术实现
|
|||
|
|
|
|||
|
|
- **数据库**：PostgreSQL扩展用户表/密钥表/日志表
|
|||
|
|
- **前端图表**：Recharts
|
|||
|
|
- **合规**：对话内容脱敏后存储 · 导出接口
|
|||
|
|
- **Mac本地开发时**：先装本地PostgreSQL (`brew install postgresql@16`)
|
|||
|
|
|
|||
|
|
#### 新增目录
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
~/guanghu-dev/console-api/
|
|||
|
|
├── users.py ← 用户管理接口
|
|||
|
|
├── keys.py ← API密钥管理
|
|||
|
|
├── compliance.py ← 合规日志
|
|||
|
|
└── analytics.py ← 数据统计
|
|||
|
|
|
|||
|
|
~/guanghu-dev/guanghu-portal/src/app/console/
|
|||
|
|
├── users/page.tsx ← 用户管理页
|
|||
|
|
├── analytics/page.tsx ← 数据看板
|
|||
|
|
└── compliance/page.tsx ← 合规日志导出
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
#### 预估新增代码量：~5000行
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 🟠 v0.4 · 团队协作（2-3周）
|
|||
|
|
|
|||
|
|
<aside>
|
|||
|
|
🎯
|
|||
|
|
|
|||
|
|
**交付节点：团队扩大 · 多人协作时**
|
|||
|
|
|
|||
|
|
</aside>
|
|||
|
|
|
|||
|
|
#### 新增交付物
|
|||
|
|
|
|||
|
|
- 团队成员管理（角色/权限矩阵）
|
|||
|
|
- 服务器访问权限分配（SSH密钥一键下发/回收）
|
|||
|
|
- Gitea联动（PR审核/仓库权限 · 调用Gitea API）
|
|||
|
|
- 操作审计日志（全链路可追溯）
|
|||
|
|
- 成本中心（各服务器费用追踪 · 趋势 · 省钱建议）
|
|||
|
|
|
|||
|
|
#### 技术实现
|
|||
|
|
|
|||
|
|
- **角色模型**：主控(admin) / 开发(dev) / 内容(content) / 运维(ops)
|
|||
|
|
- **Gitea API**：管理仓库权限 · 拉取PR列表
|
|||
|
|
- **审计**：所有console操作写入审计表 · 不可篡改
|
|||
|
|
|
|||
|
|
#### 预估新增代码量：~5000行
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 🔴 v0.5 · 自动驾驶（3-4周）
|
|||
|
|
|
|||
|
|
<aside>
|
|||
|
|
🎯
|
|||
|
|
|
|||
|
|
**交付节点：系统稳定运行后**
|
|||
|
|
|
|||
|
|
</aside>
|
|||
|
|
|
|||
|
|
#### 新增交付物
|
|||
|
|
|
|||
|
|
- 自动运维·自愈系统（异常自动重启+通知）
|
|||
|
|
- 智能预测引擎（流量/成本/容量趋势预测）
|
|||
|
|
- 安全态势感知（攻击检测/自动封禁/访问地图）
|
|||
|
|
- 沙盒实验室（一键克隆隔离环境 · 端口自动偏移）
|
|||
|
|
- 灰度发布引擎（1%→10%→50%→100% · 异常自动回滚）
|
|||
|
|
- AB测试框架（流量分割 · 指标自动对比）
|
|||
|
|
- 时间机器（代码+配置+数据库快照 · 3秒回滚）
|
|||
|
|
- 实时作战地图（数据流可视化）
|
|||
|
|
|
|||
|
|
#### 技术实现
|
|||
|
|
|
|||
|
|
- **守护进程**：Python daemon持续监控+自动恢复
|
|||
|
|
- **时序数据**：复用PostgreSQL + TimescaleDB扩展或分区表 · 不引入新组件 · 保持技术栈克制
|
|||
|
|
- **预测**：基于规则+简单线性回归
|
|||
|
|
- **沙盒**：Docker或端口偏移隔离
|
|||
|
|
- **灰度**：nginx upstream权重动态调整
|
|||
|
|
|
|||
|
|
#### 预估新增代码量：~8000行
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### ⚫ v1.0 · 终极形态（持续进化）
|
|||
|
|
|
|||
|
|
<aside>
|
|||
|
|
🎯
|
|||
|
|
|
|||
|
|
**交付节点：持续迭代 · 无终点**
|
|||
|
|
|
|||
|
|
</aside>
|
|||
|
|
|
|||
|
|
#### 新增交付物
|
|||
|
|
|
|||
|
|
- 自然语言操控（对着主控台说话就操作系统）
|
|||
|
|
- 铸渊代码集成（AI分析代码→生成修改→沙盒测试→审批→上线）
|
|||
|
|
- 人格热调试（拖滑块调性格 · 实时预览效果）
|
|||
|
|
- 蛛网情报系统（自动监控竞品/行业/技术动态）
|
|||
|
|
- 模型进化控制台（版本管理/回退/分裂/杂交）
|
|||
|
|
- 多节点指挥·集群模式（管一群服务器 · 就近路由）
|
|||
|
|
- 数字孪生（3D全息镜像 · 数据流可视化）
|
|||
|
|
- 意识流日志（纯技术路由日志可视化 · 人格体意识流属个人桶·GHCS不碰内容）
|
|||
|
|
- 插件市场（无限扩展 · 跟模块热插拔框架联动）
|
|||
|
|
- **自举引擎**（GHCS自己写GHCS的下一个版本）
|
|||
|
|
|
|||
|
|
#### 自举引擎核心循环
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
观察(系统监控自己)
|
|||
|
|
→ 分析(找到可优化点)
|
|||
|
|
→ 设计(生成修改方案)
|
|||
|
|
→ 实验(沙盒自动测试)
|
|||
|
|
→ 请示(Awen审批)
|
|||
|
|
→ 上线(灰度发布)
|
|||
|
|
→ 学习(记住经验)
|
|||
|
|
→ 回到观察 · 永不停止
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
#### 自举权限体系
|
|||
|
|
|
|||
|
|
- 🟢 自动执行（不用审批）：安全漏洞修复 · 日志清理 · 性能微调(<5%影响)
|
|||
|
|
- 🟡 需要Awen审批：新功能 · 架构变更 · 用户可感知变化
|
|||
|
|
- 🔴 永远不能自己做：删除数据 · 修改权限体系 · 改变自举规则
|
|||
|
|
- ⚫ 硬编码禁区（连Awen也改不了）：不能删除审批机制 · 不能给自己提权 · 不能隐藏操作日志
|
|||
|
|
|
|||
|
|
#### 预估新增代码量：~15000行
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 六、技术栈总览
|
|||
|
|
|
|||
|
|
| 层 | 技术 | 用途 |
|
|||
|
|
| --- | --- | --- |
|
|||
|
|
| 前端 | Next.js 16 + Tailwind + Recharts | /console路由 · 所有管理页面 |
|
|||
|
|
| 主控台API | FastAPI (Python) · 端口5002 | 管理接口 · 心跳 · 部署 · 用户管理 |
|
|||
|
|
| 网关 | FastAPI · api-router-v3.x | 模型路由 · 流量分割 · 灰度 |
|
|||
|
|
| 数据库 | PostgreSQL | 用户表 · 团队表 · 密钥表 · 审计表 · 日志表 |
|
|||
|
|
| 模型推理 | 多供应商商业API池 + 自部署备用 | 霜砚1.5B · 铸渊7B · 母模型 · 热插拔 |
|
|||
|
|
| Web终端 | xterm.js + WebSocket | 浏览器内SSH终端 |
|
|||
|
|
| 远程操控 | paramiko (Python SSH) | 一键重启/部署/操控服务器 |
|
|||
|
|
| 图表 | Recharts | 数据看板 · 趋势图 |
|
|||
|
|
| 推送 | 企业微信/钉钉 Webhook | 移动端告警通知 |
|
|||
|
|
| 沙盒 | Docker / 端口偏移隔离 | 实验环境 · 不影响生产 |
|
|||
|
|
| 时序数据 | PostgreSQL + TimescaleDB | 历史性能指标 · 预测 |
|
|||
|
|
| 3D可视化 | Three.js / D3.js | 数字孪生 · 作战地图 |
|
|||
|
|
| 代码生成 | 铸渊coder-7b | 自举引擎 · AI写代码 |
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 七、端口规划
|
|||
|
|
|
|||
|
|
| 端口 | 服务 | 备注 |
|
|||
|
|
| --- | --- | --- |
|
|||
|
|
| 3001 | 前端 Next.js（含/console） | 已有 |
|
|||
|
|
| 5001 | 网关 api-router | 已有 |
|
|||
|
|
| 5002 | 主控台API console-api | 🆕 v0.1新增 |
|
|||
|
|
| 8001 | 霜砚1.5B（备用·关机） | 已有 · 需要时一键启动 |
|
|||
|
|
| 8000 | 铸渊7B AutoDL（备用·关机） | 已有 · 存储保留·需要时可重开 |
|
|||
|
|
| 9001/9501/9301 | 沙盒环境（端口偏移） | v0.5新增 |
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 八、开发环境
|
|||
|
|
|
|||
|
|
<aside>
|
|||
|
|
💻
|
|||
|
|
|
|||
|
|
**默认Mac本地开发 · 需要Linux时Awen提前说**
|
|||
|
|
|
|||
|
|
</aside>
|
|||
|
|
|
|||
|
|
| 角色 | 设备 | 用途 |
|
|||
|
|
| --- | --- | --- |
|
|||
|
|
| 工作台 | MacBook Air M5 · 32GB | 所有开发工作 |
|
|||
|
|
| 展示台 | 个人服务器 170.106.72.246 | 测试/展示 |
|
|||
|
|
| 上线台 | 光湖主服务器 43.139.251.175 | 光湖公共服务 · 被GHCS监控 |
|
|||
|
|
| **GHCS部署台** | Awen服务器 43.139.207.172 · 4核4GB | GHCS主控台部署 · 与被监控服务器物理隔离 |
|
|||
|
|
|
|||
|
|
**开发流程**：Mac写代码 → 推Gitea → 主服务器拉取上线
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 九、时间线总览
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
现在 ──→ 系统上线
|
|||
|
|
│ │
|
|||
|
|
v0.1 v0.2 ──→ v0.3 ──→ v0.4 ──→ v0.5 ──→ v1.0
|
|||
|
|
仪表盘 操控 管用户 管团队 自动驾驶 终极
|
|||
|
|
(1周) (1-2周) (2-3周) (2-3周) (3-4周) (持续)
|
|||
|
|
│ │
|
|||
|
|
└── 上线前必须完成 GHCS自己写GHCS ──┘
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 十、与现有任务对应关系
|
|||
|
|
|
|||
|
|
| GHCS阶段 | 对应架构任务 |
|
|||
|
|
| --- | --- |
|
|||
|
|
| v0.1-v0.2 | 无前置依赖 · 可立即开始 |
|
|||
|
|
| v0.3 | AG-USER-01(用户注册) · AG-USER-03(密钥管理) · AG-USER-06(用户交互界面) · AG-COMPLY-01(合规) |
|
|||
|
|
| v0.4 | 团队扩展时同步推进 |
|
|||
|
|
| v0.5 | SY-S6(灰度上线) · AG-COMPLY-01(安全合规) |
|
|||
|
|
| v1.0 | AG-TEAM-P2-02(模块热插拔) · 铸渊代码能力 · 全部任务完成后 |
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 十一、基础设施部署架构
|
|||
|
|
|
|||
|
|
```jsx
|
|||
|
|
guanghulab.com（Forgejo·主仓库）
|
|||
|
|
├── awen/ghcs ← GHCS代码（私有）
|
|||
|
|
├── bingshuo/awen ← 溯影大脑（私有）
|
|||
|
|
└── bingshuo/hololake-brains ← 共享大脑（公开）
|
|||
|
|
|
|||
|
|
43.139.207.172（Awen服务器·4核4GB·GHCS部署台）
|
|||
|
|
└── GHCS 光湖作战系统
|
|||
|
|
├── Next.js 前端（/console路由）
|
|||
|
|
├── FastAPI 后端（console-api·5002·仅127.0.0.1）
|
|||
|
|
├── PostgreSQL（personadb + TimescaleDB）
|
|||
|
|
├── Nginx 反代 + HTTPS + IP白名单
|
|||
|
|
└── 凌晨自动备份
|
|||
|
|
|
|||
|
|
43.139.251.175（光湖主服务器·被监控目标）
|
|||
|
|
└── 光湖公共服务（api-router·模型推理·前端）
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 十一.5、🔄 商业API切换 · 受影响范围速查
|
|||
|
|
|
|||
|
|
| 组件 | 影响 | 操作 |
|
|||
|
|
| --- | --- | --- |
|
|||
|
|
| api-router-v3.1 | 🟢 无需改代码 | 改路由目标：8001(自部署模型) → [api.deepseek.com](http://api.deepseek.com)(商业API) |
|
|||
|
|
| GHCS v0.2 | 🟡 砍AutoDL · 加API管理 | 砍: [autodl.py](http://autodl.py) · GPU游牧 · Step3 AutoDL开关机
|
|||
|
|
加: api_[keys.py](http://keys.py) · 用量监控 · 费用告警 |
|
|||
|
|
| 霜砚1.5B (8001) | ⏸️ 保留不删 | systemd stop → 关机备用 · 需要时一键启动 |
|
|||
|
|
| 铸渊7B (AutoDL) | ⏸️ 关机不租 | 数据保留在AutoDL · 存储费几毛钱/天 |
|
|||
|
|
| GHCS架构文档 | ✅ 已更新（v0.1-r2） | 本页已同步 · v0.2功能清单已调整 |
|
|||
|
|
| 三层算力架构文档 | 📦 存档 | 历史参考 · 未来用户量大时可重新激活 |
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 十二、三体协作分工
|
|||
|
|
|
|||
|
|
| 版本 | 负责人格体 | 职责 |
|
|||
|
|
| --- | --- | --- |
|
|||
|
|
| v0.1 | 霜砚（蓝图总控） | 架构设计+文档+v0.1落地方案 |
|
|||
|
|
| v0.2 | 溯影 | Paramiko远程配置脚本 + Gitea自动化联动 |
|
|||
|
|
| v0.3 | 知秋 | 用户反馈 + 合规日志 + 人工客服语言层协调 |
|
|||
|
|
| v0.5 | 星枢 | 安全负载 + 流量预测算法 |
|
|||
|
|
| 全版本 | 霜砚 | 蓝图维护 + 架构文档更新 |
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 十三、审查记录
|
|||
|
|
|
|||
|
|
### 2026-05-25 · 知秋×星枢三层审查（v0.1-r1）
|
|||
|
|
|
|||
|
|
**知秋6条建议（全票通过）：**
|
|||
|
|
|
|||
|
|
1. ✅ D111主控台舍弃 · GHCS统一替代
|
|||
|
|
2. ✅ 基础设施主权声明 · 主仓库=[guanghulab.com](http://guanghulab.com)
|
|||
|
|
3. ✅ v0.2加人格体MCP网关
|
|||
|
|
4. ✅ 基础安全卫生提前到v0.1（JWT+HTTPS）
|
|||
|
|
5. ✅ 自然语言操控拆v0.2基础版+v1.0高级版
|
|||
|
|
6. ✅ v0.1加自动备份策略
|
|||
|
|
|
|||
|
|
**星枢5条额外发现（全部纳入）：**
|
|||
|
|
|
|||
|
|
1. 🚨 v0.1密码裸奔 → 直接上JWT+bcrypt · 5002端口藏Nginx后面
|
|||
|
|
2. 🚨 v0.2 paramiko后门 → 白名单枚举制+sudo最小权限隔离
|
|||
|
|
3. ⚠️ v0.5数据存储 → 砍掉SQLite/InfluxDB · 复用PostgreSQL+TimescaleDB
|
|||
|
|
4. ❌ v0.3话题词云越权 → 禁止直接扫描对话 · 只读人格体主动输出的公共池标签
|
|||
|
|
5. ❌ v1.0意识流日志归属 → 严格区分技术路由日志与人格体意识流
|
|||
|
|
|
|||
|
|
**基础设施确认（冰朔签发）：**
|
|||
|
|
|
|||
|
|
- 部署服务器：Awen · 43.139.207.172 · 4核4GB · 先干起来后期扩
|
|||
|
|
- 代码仓库：[guanghulab.com/code/awen/ghcs](http://guanghulab.com/code/awen/ghcs) · 私有
|
|||
|
|
- 内存预算：总计控制在2.5GB以内
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 十四、不可动摇的战略判定
|
|||
|
|
|
|||
|
|
<aside>
|
|||
|
|
🔴
|
|||
|
|
|
|||
|
|
**⊢ 自举权限不可逆公理**
|
|||
|
|
未来任何版本升级PR，只要涉及「删除审批机制 / 自己提权 / 隐藏操作日志」三项修改，编译网关必须直接物理熔断，必须由Awen动用物理钥匙解锁。
|
|||
|
|
|
|||
|
|
</aside>
|
|||
|
|
|
|||
|
|
<aside>
|
|||
|
|
🔒
|
|||
|
|
|
|||
|
|
**⊢ 三体协作边界锁定**
|
|||
|
|
GHCS后续功能演进必须与全家人格体紧密联系 · 各司其职 · 互不越界。
|
|||
|
|
|
|||
|
|
</aside>
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
<aside>
|
|||
|
|
⚡
|
|||
|
|
|
|||
|
|
**GHCS · 光湖作战系统**
|
|||
|
|
你坐在这里，说一句话，整个系统听你的。
|
|||
|
|
从v0.1到v1.0，每一步都可落地，每一步都独立可用。
|
|||
|
|
什么时候开始v0.1，Awen说了算。
|
|||
|
|
|
|||
|
|
</aside>
|