# 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 — 作为实际参考样例