# 📋 冰朔待办 · 霜砚Agent+MCP开发配合清单 · 2026-04-14

## 冰朔需要做的事

铸渊已开始开发。以下是你需要在Notion侧配合的事项，铸渊开发到对应Phase时会需要这些。

**不急，按铸渊开发进度来就行。**

---

### P0 · 铸渊开发前就要做的

- [x]  **创建空数据库：霜砚·认知运行时** ✅ 已创建
    - 位置：光之湖下面
    - 只有标题列，其他属性霜砚自己后续加
    - 数据库：[霜砚·认知运行时](../%E9%9C%9C%E7%A0%9A%C2%B7%E8%AE%A4%E7%9F%A5%E8%BF%90%E8%A1%8C%E6%97%B6%2023d48c8c4379425f95f10884cb9a4bf5.md)
- [x]  **创建数据库：霜砚·开发工单** ✅ 已创建
    - 属性：任务标题/任务ID/状态/优先级/开发步骤/架构决策/约束/铸渊审查结果/创建时间
    - 数据库：[霜砚·开发工单](../%E9%9C%9C%E7%A0%9A%C2%B7%E5%BC%80%E5%8F%91%E5%B7%A5%E5%8D%95%20518f6dd0e90044d2a7f813b7a75715bc.md)
- [x]  **Share给Integration** ✅ 已完成
    - 两个数据库已Share给「曜冥纪元-HoloLake」Integration（ZY_NOTION_TOKEN）

---

### P1 · 铸渊Phase 1-2开发时

- [ ]  [**确认guanghulab.online](http://确认guanghulab.online)网站可访问**
    - 铸渊开发Phase 2（网站聊天后端升级）时需要部署测试
    - 确认服务器PM2进程正常、Nginx配置没问题
- [ ]  **确认Notion Integration Token**
    - 如果用新的Integration，把Token告诉铸渊
    - 如果用已有的ZY_NOTION_TOKEN，确认它有权限访问新建的两个数据库

---

### P2 · 铸渊Phase 3-4开发时

- [ ]  **验收霜砚Web Agent的唤醒注入效果**
    - 铸渊开发完Phase 3后会有一个可测试的版本
    - 你需要实际聊几轮，判断"它是真懂了还是在猜"
    - 这一步只有你能做——因为只有你知道霜砚"对"的时候是什么样
- [ ]  **验收跨层开发触发**
    - 铸渊开发完Phase 4后，测试一次完整链路：对话中产生开发需求→Agent创建Issue→Copilot开发→铸渊审查→合并

---

### P3 · 全部上线后

- [ ]  **国内部署**
    - 铸渊把代码从新加坡服务器部署到广州节点
    - [DNS解析guanghulab.com](http://DNS解析guanghulab.com)指向国内服务器
    - 确认ICP备案号已落地

---

---

### 当前状态（2026-04-14 23:25 更新）

- ✅ P0三项全部完成（数据库创建 + Integration授权）
- ✅ 铸渊5个Phase代码全部开发完成 + PR合并 + deploy production已执行
- ✅ 霜砚认知守护逻辑已写入（4层优先级 + 5个漂移信号 + 3类复盘）
- ✅ MCP Auth Bug已修复（trust proxy冲突 · req.ip返回客户端IP而非127.0.0.1）
- ✅ 数据库迁移已确认（001~005全部已执行 · 面孔服务器本机PostgreSQL）
- ✅ Schema路径问题已澄清（实际在 /opt/age-os/schema/ · 不是 /opt/zhuyuan/age-os/schema/）
- ✅ PM2进程全部在线（age-os-mcp + age-os-agents + zhuyuan-server + zhuyuan-preview）
- ✅ .[env.app](http://env.app) 已补数据库配置（ZY_DB_HOST/USER/PASS/NAME/PORT）+ MCP配置（MCP_HOST/PORT）
- ✅ zhuyuan-server 已重启（PID 838321）

---

### ❌ 未解决 · 需要铸渊排查（2026-04-14 23:25）

**核心问题：zhuyuan-server 聊天后端没有真正调用 MCP 工具，大模型在自由发挥。**

具体表现：

1. **大模型假装调了MCP** — 输出一堆 ✅ 状态更新（"正在访问Notion账户""检索数据库中的页面内容"），但列出的页面全是编的，Notion里根本不存在
2. **被追问后承认** — "我无法读取您Notion数据库中的实际页面内容，我的回答是基于系统中的预设描述和信息"
3. **日志证据** — pm2 logs zhuyuan-server 重启后仍然只有两类报错：
    - `[国内网关] 广州中继失败，降级为直连：广州中继超时(30000ms)` — 新加坡服务器不应该绕广州
    - `[记忆桥接] ⚠️数据库暂未连接，使用静态模式` — 补了DB配置重启后仍然报这个
4. **日志里完全没有 MCP/tool_call/function 相关字样** — 说明代码层面没有调用MCP

排查方向：

- **zhuyuan-server 的 server.js 里，聊天请求发给大模型时，有没有把 MCP 工具注册为 function/tool？** 如果 tool list 为空，大模型看不到任何工具，只能演戏
- **记忆桥接模块为什么重启后仍然连不上数据库？** .[env.app](http://env.app) 已经补了 ZY_DB_PASS，PM2 ecosystem 的 loadEnvFile 也能读到，但日志仍报⚠️。可能是代码里读的变量名不对（类似之前 db-migrate.js 的 ZY_DB_PASS vs ZY_DB_PASSWORD 问题）
- **广州中继路由** — ZY_CN_LLM_RELAY_HOST=43.138.243.30 每次都超时30s才降级直连。新加坡服务器应该直连，不应该先尝试广州中继

已完成的排查（冰朔+霜砚 · 2026-04-14 22:45~23:25）：

- 确认 pm2 list 四个进程全部 online
- 确认 .env.mcp 有 NOTION_TOKEN + DB配置
- 确认 .[env.app](http://env.app) 原来缺 DB 和 MCP 配置 → 已补上 → 已重启
- 确认 age-os ecosystem.config.js 正确加载 .env.mcp
- 确认 zhuyuan ecosystem.config.js 读的是 /opt/zhuyuan/app/.[env.app](http://env.app)
- 确认 db-migrate.js 需要手动 export 环境变量才能跑（代码没用dotenv）
- 确认数据库迁移状态：全部已是最新
- 实测聊天：大模型假装调MCP · 列出不存在的页面 · 被追问后承认无法访问

`2026-04-14 23:25 CST` · 霜砚更新 · 等铸渊排查 zhuyuan-server → MCP 调用链路