feat(ai): switch page ai to hermes panel

2026-05-14 15:10:33 +08:00
parent e9188716e6
commit 9816035491
48 changed files with 6353 additions and 412 deletions
@@ -0,0 +1,36 @@
+# 7-1 [done] 页面 AI provider=hermes 仍命中旧 run route 导致 502
+
+## 现象
+
+- 当前 Rust 3000 页面壳里，页面 AI 默认 provider 是 `hermes`。
+- 发送消息时仍请求旧 `/api/ai-agent/run`。
+- Rust compat route 对显式 `provider=hermes` 返回 `ai_provider_bridge_unavailable`，HTTP 状态为 502。
+
+## 复现证据
+
+- 页面壳默认 provider：`rust/crates/mnote-web/src/ssr/pages/layout.rs`
+- 页面 AI 发送旧 route：`fetch('/api/ai-agent/run')`
+- 旧 route 注册：`rust/crates/mnote-web/src/routes/mod.rs`
+- 502 来源：`rust/crates/mnote-web/src/routes/compat.rs`
+- 可复跑 smoke：`scripts/task-hermes-page-ai-baseline-smoke.js`
+
+## 归类
+
+- owner：`07-ai`
+- 根因：页面 AI UI 仍走旧 mnote-cli / compat 主链，而默认 provider 已切到 Hermes。
+- 修复方向：页面 AI 主链改为同源 `/api/hermes/client/*`，旧 `/api/ai-agent/run` 只保留 legacy guard。
+
+## 验收
+
+- [x] 页面 AI 打开后创建或恢复 Hermes session。
+- [x] 发送消息不再请求 `/api/ai-agent/run`。
+- [x] 未配置 Hermes upstream 时返回稳定 `hermes_client_unconfigured`，不再出现旧 502。
+- [x] 配置 Hermes upstream 后 run/event stream 由 Hermes 返回。
+
+## 完成证据
+
+- 代码主链：`rust/crates/mnote-web/src/ssr/pages/layout.rs` 已改为 `/api/hermes/client/sessions`、`/api/hermes/client/runs`、`/api/hermes/client/events/{run_id}`。
+- 合同与路由：`rust/crates/mnote-web/src/routes/hermes_client.rs` 提供同源 Hermes client proxy。
+- 测试：`cd /mnt/Data1T/mnote/rust && cargo test -p mnote-web hermes_ -- --nocapture`，14 passed。
+- smoke：`MNOTE_UI_BASE_URL=http://127.0.0.1:3000 node scripts/task-hermes-page-ai-smoke.js` 通过，并拦截旧 `/api/ai-agent/run` 证明新页面 AI 主链未调用旧 route。
+- 说明：2026-05-14 已在正式 `3000` 入口复跑 Hermes 页面 AI smoke 矩阵，旧 `/api/ai-agent/run` 只保留 410 retirement guard。