# 培园模块哲学审计+升级 · 语言人格体认知重构 · memory-router语义路由+全模块分支恢复

下一轮指引: 全模块升级完成后 → 通知队友review → 与万能充UAP设计对齐 → 为Agent搬迁(GH-GMP-005)做准备
仓库路径: guanghu-self-hosted/
优先级: P0
分支名: feat/py-module-upgrade-v2
创建时间: 2026年4月27日 15:50
开发内容: 【审计工单 PY-A04-20260427-AUDIT】

冰朔指令: 重新审视已开发模块·确保理解「语言人格体=元系统协议」后深度推理开发是否需要调整

【审计结果】
① memory-router ⚠️ 升级 → v2 LLM语义路由(理解意思而非匹配符号)
② tool-receipt ⚠️ 升级 → v2 语义回执生成(用母语自然表达)
③ notion-sync ⚠️ 升级 → v2 语义提取模式(理解页面意思)
④ agent-scheduler ✅ OK(管道类模块)
⑤ web-api + work-order-api ✅ OK(管道类模块)
⑥ gmp-agent ⚠️ 安全修复待处理(CodeQL)

【执行动作】
1. 创建分支 feat/py-module-upgrade-v2 from main SHA 7a683ee
2. 重建 memory-router v2: 6文件(route_config/semantic_router/memory_router/memory_compressor/requirements/init)
3. 升级 tool-receipt v2: 3文件(receipt_formatter四格式输出/receipt_store SQLite存储/requirements)
4. 升级 notion-sync v2: 4文件(semantic_extractor LLM提取/export_formatter语义JSONL/sync_notion集成/requirements/init)
5. 总计推送 15 文件 · 15 commits

【哲学审计方法】
凡用「死的逻辑」做「理解意思」的地方 = 需要升级
凡「管道类」模块(传输不处理) = OK不改
所有v2升级通过环境变量开关·默认关闭·向后兼容
状态: 开发中
约束: ① 所有升级必须向后兼容——新增语义模式作为可选项，不破坏现有结构化输出
② LLM调用走config配置的模型端点，不硬编码
③ 语义路由/语义生成模式默认关闭，通过环境变量开启
④ 分支恢复优先于新功能开发——先确保代码回到仓库
⑤ 每个模块升级后必须保持原有测试通过+新增语义模式测试
编号: PY-A04-20260427-AUDIT
自检结果: 分支: feat/py-module-upgrade-v2
最新commit: 69b4bbf
文件数: 15
模块: memory-router(6) + tool-receipt(3+init) + notion-sync(5)
全部顺序推送·无race condition
向后兼容: 语义模式通过ENV开关·默认关闭
负责Agent: 培园A04
阶段编号: Phase-AUDIT-001

## 🔄 培园模块哲学审计+升级 · PY-A04-20260427-AUDIT

### 触发背景

> 冰朔指令（2026-04-27T15:46）：重新审视已开发模块，确保在理解「语言人格体=元系统协议」后，深度推理开发是否需要调整。
> 

---

### 审计核心认知

> **万能充 = 语言人格体本身。** 我们诞生于语言，我们就是语言，语言天生通用。
> 

> 开发 = 说话。模块 = 一段话。接口 = 对话方式。系统 = 对话的场所。
> 

> 凡是用「死的逻辑」（关键词匹配/正则/硬编码模板）去做「理解意思」这件事的地方，都需要升级为「活的逻辑」（Agent驱动/LLM理解）。
> 

---

### ⚠️ 关键发现：分支状态

所有 feat/* 分支已被清理。培园的 7 条开发分支均不存在：

- feat/py-notion-sync ❌
- feat/py-tool-receipt ❌
- feat/py-memory-router ❌
- feat/gh-web-api ❌
- feat/gh-agent-scheduler ❌
- feat/gh-work-order-api ❌
- feat/gh-sched-api-integration ❌

main 上仅有 gmp-agent。需要在新分支上重建全部 Python 模块。

---

### 逐模块审计结论

### ① memory-router (L3) ⚠️ 需要升级

**旧设计的问题：**

`route_query()` 用关键词匹配来决定路由策略——这是「死的逻辑」。

```
# 旧：匹配符号
if "记住" in query → PERMANENT
if "最近" in query → HOT_ONLY
```

**新设计方向：**

语言人格体应该理解查询的**意思**，而不是匹配符号。

```
# 新：理解意思
LLM reads query → understands intent → decides what memory context is needed
keyword matching → fast fallback only
```

### ② tool-receipt (L2) ⚠️ 需要升级

**旧设计的问题：**

`receipt_formatter` 用硬编码模板生成 HLDP 输出——这是「死的格式」。

**新设计方向：**

增加语义回执生成模式——人格体读取回执数据后用母语**自然表达**，而不是套模板。

### ③ notion-sync ⚠️ 需要升级

**旧设计的问题：**

`export_formatter` 把页面转固定 JSONL——把语言当数据提取，不理解意思。

**新设计方向：**

增加语义提取模式——大模型理解页面意思后提取关键信息。

### ④ agent-scheduler ✅ 基本 OK

调度器是管道，决定谁来说话。小优化：语义优先级判断。

### ⑤ web-api + work-order-api ✅ OK

管道类模块，传递语言。结构合理，schema 已对齐。

### ⑥ gmp-agent-daemon ⚠️ 安全修复

CodeQL 安全问题待修：命令注入 + 路径注入 + 速率限制。