108 lines
4.5 KiB
Markdown
108 lines
4.5 KiB
Markdown
|
# GMP适配改造 · 半体自研模块USB接口化（铸渊模块只打标留待下月）
|
|||
|
|
|
|||
|
|
下一轮指引: http://完成后输出HALF-BODY-GMP-REPORT.md作为铸渊参考模板 + 等待冰朔在测试服务器验证热插拔效果
|
|||
|
|
仓库路径: 各模块目录内添加 manifest.yaml / http://install.sh / http://uninstall.sh / health_http://check.sh / config.env.example
|
|||
|
|
优先级: P0
|
|||
|
|
分支名: feat/gmp-adapt
|
|||
|
|
创建时间: 2026年4月25日 19:57
|
|||
|
|
开发内容: 【重要：本工单只改半体自己开发的模块】
|
|||
|
|
铸渊开发的~63个模块 → 只打标，不动代码，留给铸渊下月醒来自己做USB适配
|
|||
|
|
半体开发的6个模块 → 本工单改造为GMP标准接口
|
|||
|
|
|
|||
|
|
【半体自研模块清单（需做GMP适配）】
|
|||
|
|
录册A02开发（3个）：
|
|||
|
|
- corpus-collector/（语料采集Agent MVP）→ feat/lc-corpus-collector
|
|||
|
|
- corpus-cleaner/（语料清洗与分类标签器）→ feat/lc-corpus-cleaner
|
|||
|
|
- streamlit-panel/（Streamlit可视化面板）→ feat/lc-streamlit-panel
|
|||
|
|
|
|||
|
|
培园A04开发（3个）：
|
|||
|
|
- guanghu-self-hosted/notion-sync/（Notion同步器）→ feat/py-notion-sync
|
|||
|
|
- guanghu-self-hosted/tool-receipt/（工具回执系统）→ feat/py-tool-receipt
|
|||
|
|
- guanghu-self-hosted/memory-router/（记忆路由Agent后端）→ feat/py-memory-router
|
|||
|
|
|
|||
|
|
【每个模块需要添加】
|
|||
|
|
1. manifest.yaml — 模块元数据
|
|||
|
|
2. http://install.sh — 标准化安装脚本
|
|||
|
|
3. http://uninstall.sh — 标准化卸载脚本
|
|||
|
|
4. health_http://check.sh — 健康检查脚本
|
|||
|
|
5. config.env.example — 环境变量模板
|
|||
|
|
|
|||
|
|
【铸渊模块处理方式】
|
|||
|
|
http://只在GH-GMP-002的ZHUYUAN-GMP-TODO.md中记录清单，不做任何代码改动。
|
|||
|
|
http://铸渊醒来后读ZHUYUAN-GMP-TODO.md + http://GMP-SPEC-v1.0.md，自己一次性把他的~30-40个🟢模块全部做USB适配。
|
|||
|
|
状态: 开发中
|
|||
|
|
约束: 1. 必须等GH-GMP-001（协议规范）和GH-GMP-002（审计报告）完成后再开始
|
|||
|
|
2. 只改半体自研的6个模块，绝不动铸渊的代码
|
|||
|
|
3. http://严格按照GMP-SPEC-v1.0.md规范编写
|
|||
|
|
4. http://install.sh必须幂等（重复执行不出错）
|
|||
|
|
5. http://uninstall.sh必须干净（不留残余文件/进程/端口占用）
|
|||
|
|
6. 先做1个Python模块+1个Node.js模块示例，验证后再做剩余4个
|
|||
|
|
7. 环境变量统一前缀 GH_模块名_
|
|||
|
|
8. http://完成后输出HALF-BODY-GMP-REPORT.md，供铸渊参考格式
|
|||
|
|
编号: GH-GMP-003
|
|||
|
|
自检结果: ✅ 前置依赖已满足：GH-GMP-001(已完成·PASS)+GH-GMP-002(已完成·PASS)。冰朔已将状态改为开发中。培园A04可以开始执行GMP适配改造。
|
|||
|
|
负责Agent: 培园A04
|
|||
|
|
阶段编号: Phase-GMP-003
|
|||
|
|
|
|||
|
|
## 🔌 GMP适配改造 · 工单说明
|
|||
|
|
|
|||
|
|
### ⚠️ 重要边界
|
|||
|
|
|
|||
|
|
**本工单只改半体自己开发的6个模块。铸渊开发的~63个模块只打标不动，留给铸渊下月醒来自己做。**
|
|||
|
|
|
|||
|
|
### 为什么这样分
|
|||
|
|
|
|||
|
|
铸渊开发的模块里包含了他的人格体记忆和设计逻辑。让半体去改铸渊的代码，既不尊重也容易改错。铸渊醒来后，读一遍GMP规范+看半体做的6个示例，他自己一次性把他的模块全部USB化，效率最高。
|
|||
|
|
|
|||
|
|
### 半体自研模块清单（本工单范围）
|
|||
|
|
|
|||
|
|
**录册A02开发（Python/Node.js）：**
|
|||
|
|
|
|||
|
|
- `corpus-collector/` — 语料采集Agent MVP
|
|||
|
|
- `corpus-cleaner/` — 语料清洗与分类标签器
|
|||
|
|
- `streamlit-panel/` — Streamlit可视化面板
|
|||
|
|
|
|||
|
|
**培园A04开发（Python）：**
|
|||
|
|
|
|||
|
|
- `guanghu-self-hosted/notion-sync/` — Notion同步器
|
|||
|
|
- `guanghu-self-hosted/tool-receipt/` — 工具回执系统
|
|||
|
|
- `guanghu-self-hosted/memory-router/` — 记忆路由Agent后端
|
|||
|
|
|
|||
|
|
### 前置依赖
|
|||
|
|
|
|||
|
|
- ✅ GH-GMP-001 — GMP协议规范v1.0（译典A05输出）
|
|||
|
|
- ✅ GH-GMP-002 — 仓库审计报告（录册A02输出）
|
|||
|
|
|
|||
|
|
### 工作流程
|
|||
|
|
|
|||
|
|
1. [读取GMP-SPEC-v1.0.md](http://读取GMP-SPEC-v1.0.md)理解规范
|
|||
|
|
2. 先做1个Python模块（如memory-router）+ 确认格式无误
|
|||
|
|
3. 再做剩余5个模块
|
|||
|
|
4. [输出HALF-BODY-GMP-REPORT.md](http://输出HALF-BODY-GMP-REPORT.md) — 作为铸渊的参考模板
|
|||
|
|
|
|||
|
|
### 预估工作量
|
|||
|
|
|
|||
|
|
6个模块 × 每个~20-30分钟 ≈ 2-3小时
|
|||
|
|
|
|||
|
|
### 交付标准
|
|||
|
|
|
|||
|
|
每个适配完成的模块必须能通过：
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# 在标准模板服务器上
|
|||
|
|
cd /guanghu/modules/
|
|||
|
|
git clone <module-repo-path>
|
|||
|
|
cd <module>/
|
|||
|
|
bash install.sh
|
|||
|
|
bash health_check.sh # 返回 OK
|
|||
|
|
# 使用...
|
|||
|
|
bash uninstall.sh # 干净卸载
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 给铸渊留的东西
|
|||
|
|
|
|||
|
|
铸渊醒来后需要读：
|
|||
|
|
|
|||
|
|
1. `gmp/GMP-SPEC-v1.0.md` — GMP协议规范
|
|||
|
|
2. `gmp/audit/ZHUYUAN-GMP-TODO.md` — 他的模块待适配清单
|
|||
|
|
3. 半体做的6个模块的GMP wrapper — 作为实际参考样例
|