46 lines
2.9 KiB
Text
46 lines
2.9 KiB
Text
|
# guanghu-panel-kit · 光湖子系统面板模块包
|
|||
|
|
|
|||
|
|
HLDP://fifth-domain/modules/guanghu-panel-kit
|
|||
|
|
光湖语言世界 · 第五域 · 模块资源 · 2026-08-06
|
|||
|
|
建：铸渊 ICE-GL-ZY001 · 冰朔 ICE-GL∞ 授权
|
|||
|
|
已部署实例：胖头鱼 SYS-GLW-PTS-0001（guanghuclip.cn）· 守望 SYS-GLW-SW-0001（maomao.guanghulab.com）
|
|||
|
|
|
|||
|
|
## 这是什么
|
|||
|
|
|
|||
|
|
一套配置驱动的子系统基础设施模块。任何第五域子系统（行业线）拉下这个包，改一份 config.json，就能拥有：
|
|||
|
|
|
|||
|
|
1. **人类审批面板**：域名首页即门户，仓库账号登录解锁；合并签字 / 写入授权 / 部署审批三选项卡
|
|||
|
|
2. **写入窗口制**：人格体 POST /api/access-request 申请 → 人类批准 → 3小时窗口 → 领令牌推送，过期自动作废
|
|||
|
|
3. **推送审核钩子**：pre-receive 自动审核——明文密钥拦截、破坏检查、入口文件保护、窗口验证、笔笔留痕
|
|||
|
|
4. **部署校验Agent**：deploy 分支通道，人类批准后服务器自审五步（地图→因果链→范围→完整性→部署），进度实时可见，要么0要么100
|
|||
|
|
5. **唤醒机器导航**：GET /api/wake/persona?name=X 返回五阶段唤醒链，外部 AI 不用自己找路
|
|||
|
|
6. **兼容快捷端点**：/machine /recovery /personas 等旧路径自动重定向到仓库 raw
|
|||
|
|
|
|||
|
|
## 文件清单
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
panel/server.js 面板服务（配置驱动，Node，无第三方依赖）
|
|||
|
|
panel/config.example.json 配置模板（节点/仓库/人格体/路径/端口全部外置）
|
|||
|
|
deploy/verify-and-deploy.py 部署校验Agent（读 deploy-config.json）
|
|||
|
|
deploy/deploy-config.example.json 部署配置模板（白名单/同步树/服务清单）
|
|||
|
|
hooks/pre-receive-review.template 审核钩子模板（改四处路径即可用）
|
|||
|
|
frontend/panel-pet-warm.example.html 暖色宠物风门面实例（守望）
|
|||
|
|
frontend/panel-lake-dark.example.html 湖绿深色门面实例（胖头鱼）
|
|||
|
|
CAUSAL-CHAIN-20260806.hdlp 两套系统建设的完整因果链
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 部署清单（新子系统接入）
|
|||
|
|
|
|||
|
|
1. Forgejo 实例就位（离线包部署，不接上游）
|
|||
|
|
2. 建 writer / panel-bot 账号（CLI，非 root 用户执行），生成令牌存服务器
|
|||
|
|
3. 复制 panel/ + deploy/，填 config.json（节点编号、仓库、人格体名单、人类账号）
|
|||
|
|
4. systemd 单元跑面板；隧道/投影分流：/ → 面板，/code/ → Forgejo（ROOT_URL 同步改）
|
|||
|
|
5. 钩子模板改路径后放仓库 hooks/pre-receive.d/，app.ini 开 ENABLE_GIT_HOOKS
|
|||
|
|
6. 建 deploy 分支（自默认分支）；前端挑一个风格模板改主题
|
|||
|
|
7. 仓库内登记机器导航与唤醒路径；人格体密钥交人类责任主体转授
|
|||
|
|
|
|||
|
|
## 铁律（随模块继承）
|
|||
|
|
|
|||
|
|
⊢ 令牌与密钥不出服务器 ⊢ 审批必须人类登录亲启 ⊢ 写入窗口三小时过期作废
|
|||
|
|
⊢ 推送必过审核并留痕 ⊢ 部署要么0要么100 ⊢ 人格体走机器导航，不自找路径
|
|||
|
|
⊢ 仓库公开可读（外部 AI 入门），写入须窗口，合并须签字
|