v0.4.37

中文

新增

• 捕获详情页显示每条请求实际转发的上游地址（issue 260913_捕获详情显示实际转发上游）。请求侧元信息卡（model / stream 同排）新增 upstream chip：裸 host 自解释，悬停见完整 URL，空值不渲染。数据层 rec.upstream 与后端聚合早已在用，本次只是把它呈现给人——OAuth 会话被 BASE_URL patch 劫到第三方上游时，「401 是谁拒的」此前在界面上无从回答（260913 排障即由此而来）。零新增 i18n 键，与 stop_reason 等协议字段的裸展示风格一致。

变更

• 实时分析页空态说明改为先讲用户处境，再讲机制（issue 260908-260912_实时分析页面与动作账本）。ob.empty.body 是这一页唯一的自我介绍位，原文案通篇讲机制（外环是另开的一个 AI、CCWA 只给事实存结论），第一次打开的人知道「谁在干活」，不知道「我为什么需要它」。改成三段式：vibe coding 多轮之后记不清跟 AI 说过什么、更难判断它把话理解成了什么（尤其它自创项目黑话）→ 这一页让外部 Agent 读录制、梳理整体目标，看清做过什么、在做哪一件、它怎么理解 → 原有机制交代与上手句。四处同步（行内兜底 + 中/英/日词典），ob.empty.title 不改（空态标题说状态，用途归正文）。

修复

• tools/build/manual/build_product.py 在 Python 3.11 下编译不过（issue 260713-260912_发版链路与产物一致性）。第 34 行 f-string 的替换字段里用了与外层同类型的单引号（f'… {gap['id']}'），这是 PEP 701（3.12）才合法的写法，3.10/3.11 直接报 SyntaxError。在 3.11 下逐文件扫描 src/、tests/、tools/ 共 54 个 .py，失败只有这一处。CI 没拦住是因为 verify job 跑 3.12、CONTRIBUTING 也写明「本地说明书生成使用 Python 3.12+」，只有第八节清单的 compileall 条目覆盖 tools/build 却没带这个前提，在 3.11 本机按清单跑就会撞上。外层引号改成双引号后 3.10+ 均可编译，语义不变。

文档

• CHANGELOG 的写作要求移入 CLAUDE.md，并改成「条目求短」（issue 260714-260912_CHANGELOG写法的反复）。要求此前分散在两处：CHANGELOG.md 开头的导语（分类与「说明问题、改动与必要影响」）和 CLAUDE.md 迭代纪律（「不设字数上限」）——写在被写文件自己开头的那半份在干活时读不到规则的身份，另一半还直接授权了长条目，于是条目越写越长（用户 260912 第二次点出）。现在导语只留导航并指向 CLAUDE.md，写作要求全部归「迭代纪律」，并把字数条款改成一条三到五句、细节留 issue 与 commit。存量条目不回改，新条目按新规则写。
• 第八节自测清单补回 node tests/observe_guide_selftest.js（issue 260809-260912_文档体检与闸门机械化）。与 release.yml verify 的 Self-tests 步（17 条 Python + 2 条 Node）逐条对账，CI 有而清单没有的只有这一条；它断言界面「复制接入说明」三语×已建/未建观测的文案，少登则它只在 CI 上跑，CI 红在它上面时本地复现不出来。核对中发现此前对 compileall 的理解有误：清单那条与 CI 的 Syntax 步只是路径写法不同，compileall 递归子目录，两者覆盖完全相同，并非「清单多覆盖」；上一条 bug 没被 CI 拦住的原因是 CI 跑 3.12，与路径无关。「改 CI 时顺手对一遍清单」260825 就写了，这次是发版逐条跑时才对出来的——「顺手」没有触发点。
• 架构总览 §3.1 端点分组表补齐整组缺失，并给 doc_audit 加分组覆盖软检查（issue 260809-260912_文档体检与闸门机械化）。问题：该表只列了约 20 条路由骨架，快照、就地更新、外环观测、来源、上游配置历史、实例、存储占用、失败趋势等整组缺席（合计 40+ 端点、外加页面路由），而 doc_audit 的端点对账只认 API契约.md，契约侧全绿，导航层没有任何机器在看——「架构总览」是新人和 agent 的第一张地图。改动：①表按方案 B 重写成通配分组（组名 / 通配端点 / 受众 / 契约章节指路，行序跟契约章节走），受众列逐组对照契约原文、前端 fetch 调用面与 CLI 子命令重新核对（/api/actions 契约明写「外环观测者用」、界面只读显示清单；trends / uncompact 无界面入口走 CLI 或 API；ai-guide / unknowns 前端零调用，维持仅 AI）；补页面路由行（/、/view、/favicon.ico）与 catch-all 并列。②doc_audit 新增第 10 条检查 _overview_group_gaps：每个 /api/* 路由的组前缀（第一段）须在 §3.1 出现，只查组不查端点，与通配写法天然兼容；归软差异不挡发版（导航层漏一行不该卡发版，契约那条硬门已保证事实源不缺）；自测补五条用例（缺口能检出 / 通配覆盖同组 / §3.1 锚点解析到正文 / 真实表全覆盖 / 软分类不挡）。③开发约定第十一节文档维护表新增「端点分组导航」行：新增端点不必回改表，新增组必须登记。实施中踩到一次自误报：示例写法 `/api/<组>` 被幽灵端点正则当成引用提取，改成散文写法后干净——闸门对自己人也生效。验证：doc_audit.py 对账干净（通配写法未触发 ghost 误报）、--self-test 全过、check_refs.py 未解析 0，issue 的缺失清单逐组人工对拍全部覆盖。