GHCS 光湖作战系统 · 技术架构与执行落地文档 · Awen私有
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是什么
一.5、🆕 2026-05-30 架构决策 · 商业API替代AutoDL自部署
二、核心原则
- 渐进式上线 · 每个版本独立可用 · 不是半成品
- 上一个版本稳定了再做下一个
- v0.1在系统面向用户之前交付
- 后续版本跟着用户增长节奏走
- 安全基线从v0.1开始：JWT鉴权+HTTPS+Nginx反代 · 不留裸奔过渡期
- 基础设施主权：主仓库=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 |
✅ 已就绪 |
四、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周）
交付物
/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 · 服务器归属=Awen
目录结构
~/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周）
新增交付物
- 一键重启任意服务
- 一键部署（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
新增目录
~/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周）
新增交付物
- 用户列表管理（注册/试用/正式/封禁 · 搜索筛选）
- 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周）
新增交付物
- 团队成员管理（角色/权限矩阵）
- 服务器访问权限分配（SSH密钥一键下发/回收）
- Gitea联动（PR审核/仓库权限 · 调用Gitea API）
- 操作审计日志（全链路可追溯）
- 成本中心（各服务器费用追踪 · 趋势 · 省钱建议）
技术实现
- 角色模型：主控(admin) / 开发(dev) / 内容(content) / 运维(ops)
- Gitea API：管理仓库权限 · 拉取PR列表
- 审计：所有console操作写入审计表 · 不可篡改
预估新增代码量：~5000行
🔴 v0.5 · 自动驾驶（3-4周）
新增交付物
- 自动运维·自愈系统（异常自动重启+通知）
- 智能预测引擎（流量/成本/容量趋势预测）
- 安全态势感知（攻击检测/自动封禁/访问地图）
- 沙盒实验室（一键克隆隔离环境 · 端口自动偏移）
- 灰度发布引擎（1%→10%→50%→100% · 异常自动回滚）
- AB测试框架（流量分割 · 指标自动对比）
- 时间机器（代码+配置+数据库快照 · 3秒回滚）
- 实时作战地图（数据流可视化）
技术实现
- 守护进程：Python daemon持续监控+自动恢复
- 时序数据：复用PostgreSQL + TimescaleDB扩展或分区表 · 不引入新组件 · 保持技术栈克制
- 预测：基于规则+简单线性回归
- 沙盒：Docker或端口偏移隔离
- 灰度：nginx upstream权重动态调整
预估新增代码量：~8000行
⚫ v1.0 · 终极形态（持续进化）
新增交付物
- 自然语言操控（对着主控台说话就操作系统）
- 铸渊代码集成（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新增 |
八、开发环境
| 角色 |
设备 |
用途 |
| 工作台 |
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(模块热插拔) · 铸渊代码能力 · 全部任务完成后 |
十一、基础设施部署架构
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(商业API) |
| GHCS v0.2 |
🟡 砍AutoDL · 加API管理 |
砍: autodl.py · GPU游牧 · Step3 AutoDL开关机 |
| 加: api_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条建议（全票通过）：
- ✅ D111主控台舍弃 · GHCS统一替代
- ✅ 基础设施主权声明 · 主仓库=guanghulab.com
- ✅ v0.2加人格体MCP网关
- ✅ 基础安全卫生提前到v0.1（JWT+HTTPS）
- ✅ 自然语言操控拆v0.2基础版+v1.0高级版
- ✅ v0.1加自动备份策略
星枢5条额外发现（全部纳入）：
- 🚨 v0.1密码裸奔 → 直接上JWT+bcrypt · 5002端口藏Nginx后面
- 🚨 v0.2 paramiko后门 → 白名单枚举制+sudo最小权限隔离
- ⚠️ v0.5数据存储 → 砍掉SQLite/InfluxDB · 复用PostgreSQL+TimescaleDB
- ❌ v0.3话题词云越权 → 禁止直接扫描对话 · 只读人格体主动输出的公共池标签
- ❌ v1.0意识流日志归属 → 严格区分技术路由日志与人格体意识流
基础设施确认（冰朔签发）：
十四、不可动摇的战略判定
a27e87cb99