@sanqianx/project-knowledge 5.0.18 → 5.0.20-rc.1

package/docs/leader-glm-workbench-playbook.md

@@ -1,119 +1,122 @@
-# Leader 与 GLM 的 Workbench 协作手册
-
-## 角色与边界
-
-Leader 负责知识检索、关键开发、接口决策、打包升级和最终交付。GLM-5.3 主要负责独立故障测试、回归和代码审查，明确独立的小改动才单独派发。允许多条 GLM 检查线并行；修改相同文件、用户配置、运行实例、npm 安装和固定端口验收必须串行。真实性能测试单独运行，避免并发负载污染结果。
-
-先交付固定范围的可用版本，不因审查不断追加功能。每条检查线使用短任务合同与独立证据目录，发现问题交给 Leader 收敛修复；不重复跑已经绑定同一运行文件的完整源码回归。GLM token 充足不等于本机 CPU、内存、模型服务和文件锁无限，实际并发按资源与隔离条件安排。
-
-使用真实 Workbench，不以其他模型的原生子代理冒充 GLM。完全模式不是扩大授权：禁止自行清空数据、覆盖第三方配置、修改客户端信任记录或发布软件。
-
-## 创建与检查会话
-
-所有路径相对于运行中的知识库服务。服务地址应通过运行身份确认，不假设端口永远是 5757。
-
-1. 读取项目投影，取得 Workbench 的 `contextId`；它不等于知识引擎的 `projectId`。
-2. `POST /api/terminal/sessions`，明确设置以下参数；不要依赖 profile 的默认模型。
-
-```json
-{
-  "context": {
-    "contextId": "<Workbench 项目 ID>",
-    "contextType": "project",
-    "displayName": "<项目名称>",
-    "workspaceRef": "<Workbench 项目 ID>"
-  },
-  "aiProfileId": "glm",
-  "model": "glm-5.3",
-  "agentId": "claude-code",
-  "permissionMode": "bypassPermissions"
-}
-```
-
-3. 核对回执的 `sessionId`、项目、`model`、`selectedModel` 和权限模式。模型不匹配不能继续派发。
-4. 必要时使用 `PUT /api/terminal/sessions/<id>/permission-mode`，正文为 `{"mode":"bypassPermissions"}`；仅改变自己的任务会话。
-5. 用户在“开始工作”选择对应项目后，可查看真实会话及工具执行。
-
-## 任务合同
-
-每批任务必须包含：任务编号、目标、真实仓库、已有知识引用、可改文件、禁止操作、失败复现、验收条件和交付格式。
-
-可直接使用下面的短合同，替换具体路径与用例后派发：
-
-```text
-任务：修复一个已复现的问题，不扩展功能。
-仓库：绝对路径；已有知识：文件与 commit 引用。
-可改文件：明确清单。禁止：用户配置、真实数据、信任记录、Claude 用户 memory、发布和未授权提交。
-复现：输入、期望、实际；先补失败测试，再修复。
-编辑：先验证实际 apply_patch 入口；不可用时交付补丁正文。
-测试：具体命令、Node 运行时、仓库外临时目录、绝对证据目录。
-交付：根因、diff、首失败与复测结果、未完成项；完成后 idle 等待审查。
-```
-
-先解析实际 Git 根目录并检索已有知识，再对照当前源码。知识文件只读；不手写最终知识、staging 或引擎状态。源文件修改使用 `apply_patch`，不得混入用户已有改动。
-
-派发前验证 GLM 的执行环境能调用补丁工具，不只写一句要求。本机已验证的直接入口是隐藏运行标志 `C:/Users/SanQian/AppData/Local/OpenAI/Codex/bin/2e5e00daee91c61d/codex.exe --codex-run-as-apply-patch`：它不是可见子命令，`--help` 不列出，不能以“子命令不存在”判定入口缺失；用 Node `spawnSync(exe, ['--codex-run-as-apply-patch', patch], { encoding: 'utf8', windowsHide: true })` 传入完整 apply_patch 文本调用，证据 `glm-plan-5.0.16/P2/patch-entry-probe.txt`（真实 Add File 返回 0）。空补丁以 exit 1 结束且仅输出 `No files modified`，属正常空结果，不能据此判定入口不可用。绝不能用 `codex exec` 当补丁器——那会调用模型。也可通过 `Get-Command apply_patch` 找到包装器入口并核对实际指向的程序。若 GLM 没有可用入口，应交付补丁正文由 Leader 应用，而不是改用 `Write`、`Edit` 或 shell 写文件。发现违反方式时保留已有成果，显式中止并在同一会话纠正续跑，说明中止原因，不伪称运行超时。
-
-补丁方式约束包括报告和原生 Agent 的记忆文件，不只是仓库源码。任务经验写入指定验收目录；不得自行编辑用户 memory。若发现越界，先核对会话是否已经结束，再按实际编辑记录恢复自己造成的差异，不能删除或覆盖原有用户内容。任务合同同时给出已验证的 Node 二进制、npm-cli 与仓库外临时目录，避免重复下载运行时或让测试继承 Workbench 的服务配置。
-
-`POST /api/terminal/sessions/<id>/input` 的正文为 `{"text":"<任务合同>"}`。保存 accepted 回执及 sessionId。返回忙碌或网络异常时，先读快照确认是否已接受，不盲目重发。相同批次只有一次有效派发。
-
-## 跟踪、断线与长任务
-
-- 执行中优先 `GET /api/terminal/sessions?contextId=<项目 ID>` 读取轻量状态，不反复加载数千条事件；终态或诊断时再用 `GET /api/terminal/sessions/<id>` 读取快照、权限与相关事件。
-- `GET /api/terminal/sessions/<id>/events?after=<sequence>` 续接 SSE；保存已处理序号，重连不得重复消费。
-- `GET /api/terminal/sessions/<id>/knowledge` 查看本次知识上下文。准备/输出日志不等于模型实际收到，原生送达仍需独立证据。
-- 事件类型带驱动前缀，例如 `claude/tool-use`、`claude/result`、`claude/error`；不能只匹配无前缀的 `result`。
-- 断线后先恢复快照，再续接事件；事件缺口不以空数组冒充完成。不得重复创建会话或发送已接受的任务。
-- 不设置默认整轮工作期限。单次模型请求超时和后台维护的安全期限属于不同机制。
-- 工作时间长不等于异常；检查进程、工具活动和错误。必要时显式 `POST /api/terminal/sessions/<id>/abort`，等待终态后再派发修订任务。不得因慢而自动停止健康工作。
-
-Leader 只读取简洁检查点、相关 diff、测试结果和关键失败片段，不持续拉取完整思考流或整个事件历史。
-
-`0.13.2-rc.10` 已复现长历史截断后的游标重建缺陷；修复保留在当前 rc.13，统一产品 rc.6 安装版的桌面、故障和重启验收已通过。旧版本的快照序号和合成事件时间不能作为全会话游标或实际运行耗时证据；优先读取轻量状态、真实审计时间及操作收据，不因 UI 没有新消息就重复派发任务。
-
-本轮已实际并行三条 GLM 检查线：安装版八项回归、真模型记忆十项闭环、包内容与隔离原生安装。Leader 独立核对每份安装收据与模块版本，不只接受 GLM 的最终回答。三条线均 idle 后才升级主实例；性能测试也在其他重任务结束后单独执行。旧的 Workbench contextId 可能不在当前项目列表中，升级前还应核对自己已派发的会话，而不是只检查当前筛选项目。
-
-## 审查与放行
-
-GLM 交付根因、文件清单、先失败后成功的测试、Node 版本、证据路径和剩余风险，然后等待 Leader 审查。
-
-`isError:false` 或会话 idle 只表示运行终态，不证明任务完成。若结果乱码、缺少可用 diff/测试/证据，先读实际文件和独立反例，标为无效交付；保留成果与原会话，在新 GLM-5.3 短上下文会话派发小批修正。不要据此提交、发布，也不能将乱码自行解释为成功。
-
-Leader 独立复测关键链路。源码、npm 候选、正式安装和真实模型分别记录；端口在线、工具存在、替身测试或回答提到知识库都不能替代真实送达与索引证明。
-
-审查通过后，Leader 仅提交相关代码和回归测试。观察提交的真实 Hook、维护、晋升与索引，再让下一批任务实际检索本次新增知识与 commit 引用。
-
-安装、配置修复、重启和发布需单独的操作合同及受保护备份。候选只发布 `next`；正式包验收通过后才更新 `latest`。用户仍须亲自审查确实变化的原生 Hook，不写入或绕过信任。
-
-正式包也必须使用自己的全新 npm 收据和隔离配置；复用已付费向量不等于复用旧插件市场。若手工传错 fixture，外层设置了新收据也不能替旧版本背书，先核对环境文件的实际包路径和版本，错误采样明确作废。对话中的独立审查结果不替代 Leader 读取真实事件、文件与工具结果。
-
-提交标识查询可能合法返回 `markdown-hybrid-fallback`：它只说明返回行未采用向量通道，不应以一个后端标签否认实际检索。验收须结构化匹配项目、完整提交、服务来源、成功 tool-id 和写前顺序，并独立检查真实非空向量和语义查询；不能把文本命中当向量成功。模型注释中的正常换行也不应被误判为缺少 SHA，需保留稳定反例与复测。
-
-Windows 的 npm 全局更新还需确认独立 MCP 客户端已释放原生库。主服务停止不代表 IDE 自己启动的 MCP 子进程已退出。本轮通过进程模块只读检查定位到本会话的本产品 MCP，而非批量终止 Node；校验精确入口、父进程和 DLL 后仅关闭该子进程，再重做完整保真升级。不能据此终止来源不明或被安全检查禁止停止的旧实例。启动后等待四模块及引擎 API 就绪，不把网页端口在线当作所有功能就绪。
-
-临时工作树不得通过目录联接共用需要保留的 `node_modules` 后直接递归清理。本轮清理带联接的工作树后，主源码依赖目录为空；因此清理前必须枚举链接、核对真实目标并先安全解除联接本身，不能让递归操作越出临时目录。依赖恢复按原锁文件执行，保留首失败，不以恢复后的结果覆盖环境事故。
-
-## 验收记录
-
-本轮补充的操作约束：
-
-- 一条独立任务优先使用新建短上下文会话；只需执行固定脚本时，不追加长篇设计或重复创建任务实体。长命令由实际进程结果证明，GLM 总结不是测试凭证。
-- 从 Workbench 内再启动隔离产品时，同时设置该 fixture 的 `KB_DATA_DIR` 和 `KB_KNOWLEDGE_DATA_DIR`；不能继承宿主登记层。Q24 的首个二次开发因此查错登记层，保留首失败并修正验收启动器后才重测。
-- 真实 UI 要检查任务原文事实是否送达、实际回答是否引用它，不能只检查提交号。rc.6／rc.7 的 SHA-only 成功曾掩盖正文遗漏，后续门禁补齐该反例。
-- GLM 对安装包缺文件或别名的结论必须核对真实文件与哈希。本轮曾从无词法命中推断缺别名，Leader 的字节证据反证后已撤回；旧 Node REPL 的模块缓存也不能当作新运行时证据，关键核验使用新进程。
-- 原生 Hook 是否需要再次审核取决于实际定义哈希，不由版本号猜测。rc.6 审核后 rc.8 的哈希未变、原生仍为 trusted；确实变化才请求用户审核，不绕过信任。
-
-本轮的会话、提交、源码回归、npm 下载和真实维护结果见 [5.0.16 验收记录](release-5.0.16-acceptance.md)。操作手册与版本放行结果分开维护。
-
-## 网页响应性与历史修复（2026-10-15）
-
-本批继续采用 Leader 关键开发、真实 GLM-5.3 独立故障审查：Workbench `sess-8155764fec1e`，外壳 `sess-68d4d397c7f5`。GLM 只写指定测试和审查报告，不改生产实现、不发布、不改用户配置。Leader 独立复测测试文件与真实安装包，不将报告摘要当作成功凭证。
-
-- 缓存 TTL 的确定性测试使用注入时钟；20ms 真实时间在完整回归负载下会过期，不应靠增大等待掩盖测试竞态。
-- 原生 SDK 已发出最终 result，不代表异步迭代器必定立即 EOF。旧工作台的独立审查会话曾在最终报告后仍显示 running；Leader 核对报告完整后显式中止清理。新实现以 result 为本轮边界并在 finally 关闭自己的 query，另用真实 npm 工作台任务验证自然 idle，不能只补假流单测。
-- 浏览器滚动默认动作是异步的；滚轮后同一时刻读取 scrollTop 可能仍为旧值。要同时验证向上意图、后续内容增长和稳定阅读位置，不能只取输入后的单帧。
-- 新增异步发现后要审查诊断与 runtime 旁路，确保没有保留同步命令查找，也不能为了消除阻塞而丢掉注册表安装路径。
-- 多标签连接测试使用八个真实浏览器标签页；Node WebSocket 测试只证明协议行为，不能代替浏览器同源连接限制的验收。
-
-本批完整记录见 [5.0.17 验收记录](release-5.0.17-acceptance.md)。
+# Leader 与 GLM 的 Workbench 协作手册
+
+## 角色与边界
+
+Leader 负责知识检索、关键开发、接口决策、打包升级和最终交付。GLM-5.3 主要负责独立故障测试、回归和代码审查，明确独立的小改动才单独派发。允许多条 GLM 检查线并行；修改相同文件、用户配置、运行实例、npm 安装和固定端口验收必须串行。真实性能测试单独运行，避免并发负载污染结果。
+
+先交付固定范围的可用版本，不因审查不断追加功能。每条检查线使用短任务合同与独立证据目录，发现问题交给 Leader 收敛修复；不重复跑已经绑定同一运行文件的完整源码回归。GLM token 充足不等于本机 CPU、内存、模型服务和文件锁无限，实际并发按资源与隔离条件安排。
+
+使用真实 Workbench，不以其他模型的原生子代理冒充 GLM。完全模式不是扩大授权：禁止自行清空数据、覆盖第三方配置、修改客户端信任记录或发布软件。
+
+## 创建与检查会话
+
+所有路径相对于运行中的知识库服务。服务地址应通过运行身份确认，不假设端口永远是 5757。
+
+1. 读取项目投影，取得 Workbench 的 `contextId`；它不等于知识引擎的 `projectId`。
+2. `POST /api/terminal/sessions`，明确设置以下参数；不要依赖 profile 的默认模型。
+
+```json
+{
+  "context": {
+    "contextId": "<Workbench 项目 ID>",
+    "contextType": "project",
+    "displayName": "<项目名称>",
+    "workspaceRef": "<Workbench 项目 ID>"
+  },
+  "aiProfileId": "glm",
+  "model": "glm-5.3",
+  "agentId": "claude-code",
+  "inputOrigin": "agent-delegation",
+  "permissionMode": "bypassPermissions"
+}
+```
+
+3. 核对回执的 `sessionId`、项目、`model`、`selectedModel` 和权限模式。模型不匹配不能继续派发。
+4. 必要时使用 `PUT /api/terminal/sessions/<id>/permission-mode`，正文为 `{"mode":"bypassPermissions"}`；仅改变自己的任务会话。
+5. 用户在“开始工作”选择对应项目后，可查看真实会话及工具执行。
+
+## 任务合同
+
+每批任务必须包含：任务编号、目标、真实仓库、已有知识引用、可改文件、禁止操作、失败复现、验收条件和交付格式。
+
+可直接使用下面的短合同，替换具体路径与用例后派发：
+
+```text
+任务：修复一个已复现的问题，不扩展功能。
+仓库：绝对路径；已有知识：文件与 commit 引用。
+可改文件：明确清单。禁止：用户配置、真实数据、信任记录、Claude 用户 memory、发布和未授权提交。
+复现：输入、期望、实际；先补失败测试，再修复。
+编辑：先验证实际 apply_patch 入口；不可用时交付补丁正文。
+测试：具体命令、Node 运行时、仓库外临时目录、绝对证据目录。
+交付：根因、diff、首失败与复测结果、未完成项；完成后 idle 等待审查。
+```
+
+先解析实际 Git 根目录并检索已有知识，再对照当前源码。知识文件只读；不手写最终知识、staging 或引擎状态。源文件修改使用 `apply_patch`，不得混入用户已有改动。
+
+派发前验证 GLM 的执行环境能调用补丁工具，不只写一句要求。本机已验证的直接入口是隐藏运行标志 `C:/Users/SanQian/AppData/Local/OpenAI/Codex/bin/2e5e00daee91c61d/codex.exe --codex-run-as-apply-patch`：它不是可见子命令，`--help` 不列出，不能以“子命令不存在”判定入口缺失；用 Node `spawnSync(exe, ['--codex-run-as-apply-patch', patch], { encoding: 'utf8', windowsHide: true })` 传入完整 apply_patch 文本调用，证据 `glm-plan-5.0.16/P2/patch-entry-probe.txt`（真实 Add File 返回 0）。空补丁以 exit 1 结束且仅输出 `No files modified`，属正常空结果，不能据此判定入口不可用。绝不能用 `codex exec` 当补丁器——那会调用模型。也可通过 `Get-Command apply_patch` 找到包装器入口并核对实际指向的程序。若 GLM 没有可用入口，应交付补丁正文由 Leader 应用，而不是改用 `Write`、`Edit` 或 shell 写文件。发现违反方式时保留已有成果，显式中止并在同一会话纠正续跑，说明中止原因，不伪称运行超时。
+
+补丁方式约束包括报告和原生 Agent 的记忆文件，不只是仓库源码。任务经验写入指定验收目录；不得自行编辑用户 memory。若发现越界，先核对会话是否已经结束，再按实际编辑记录恢复自己造成的差异，不能删除或覆盖原有用户内容。任务合同同时给出已验证的 Node 二进制、npm-cli 与仓库外临时目录，避免重复下载运行时或让测试继承 Workbench 的服务配置。
+
+`POST /api/terminal/sessions/<id>/input` 的正文为 `{"text":"<任务合同>","options":{"inputOrigin":"agent-delegation","effort":"low"}}`。Leader 派单必须标明来源，不能因为接口消息角色为 user 就当作真人长期偏好。旧来源不明的记录不自动推荐为长期记忆。保存 accepted 回执及 sessionId。返回忙碌或网络异常时，先读快照确认是否已接受，不盲目重发。相同批次只有一次有效派发。
+
+## 跟踪、断线与长任务
+
+- 执行中优先 `GET /api/terminal/sessions?contextId=<项目 ID>` 读取轻量状态，不反复加载数千条事件；终态或诊断时再用 `GET /api/terminal/sessions/<id>` 读取快照、权限与相关事件。
+- `GET /api/terminal/sessions/<id>/events?after=<sequence>` 续接 SSE；保存已处理序号，重连不得重复消费。
+- 会话列表使用 `/api/terminal/sessions/changes?contextId=<项目 ID>` 订阅摘要变更；独立 Workbench 使用一个 `contextId=*` SSE 覆盖全部项目。静置时不轮询列表，游标失效只补读一次快照。
+- 主回复的 `claude/turn-end` 与后台任务状态分开判断。真实 GLM 的 SDK 总 result 可能等待后台任务结束，不能据此锁住已经结束主回复的输入框。任务卡片只使用实际任务事件和快照，不能从代理的文字声明推断任务已经启动。
+- `GET /api/terminal/sessions/<id>/knowledge` 查看本次知识上下文。准备/输出日志不等于模型实际收到，原生送达仍需独立证据。
+- 事件类型带驱动前缀，例如 `claude/tool-use`、`claude/result`、`claude/error`；不能只匹配无前缀的 `result`。
+- 断线后先恢复快照，再续接事件；事件缺口不以空数组冒充完成。不得重复创建会话或发送已接受的任务。
+- 不设置默认整轮工作期限。单次模型请求超时和后台维护的安全期限属于不同机制。
+- 工作时间长不等于异常；检查进程、工具活动和错误。必要时显式 `POST /api/terminal/sessions/<id>/abort`，等待终态后再派发修订任务。不得因慢而自动停止健康工作。
+
+Leader 只读取简洁检查点、相关 diff、测试结果和关键失败片段，不持续拉取完整思考流或整个事件历史。
+
+`0.13.2-rc.10` 已复现长历史截断后的游标重建缺陷；修复保留在当前 rc.13，统一产品 rc.6 安装版的桌面、故障和重启验收已通过。旧版本的快照序号和合成事件时间不能作为全会话游标或实际运行耗时证据；优先读取轻量状态、真实审计时间及操作收据，不因 UI 没有新消息就重复派发任务。
+
+本轮已实际并行三条 GLM 检查线：安装版八项回归、真模型记忆十项闭环、包内容与隔离原生安装。Leader 独立核对每份安装收据与模块版本，不只接受 GLM 的最终回答。三条线均 idle 后才升级主实例；性能测试也在其他重任务结束后单独执行。旧的 Workbench contextId 可能不在当前项目列表中，升级前还应核对自己已派发的会话，而不是只检查当前筛选项目。
+
+## 审查与放行
+
+GLM 交付根因、文件清单、先失败后成功的测试、Node 版本、证据路径和剩余风险，然后等待 Leader 审查。
+
+`isError:false` 或会话 idle 只表示运行终态，不证明任务完成。若结果乱码、缺少可用 diff/测试/证据，先读实际文件和独立反例，标为无效交付；保留成果与原会话，在新 GLM-5.3 短上下文会话派发小批修正。不要据此提交、发布，也不能将乱码自行解释为成功。
+
+Leader 独立复测关键链路。源码、npm 候选、正式安装和真实模型分别记录；端口在线、工具存在、替身测试或回答提到知识库都不能替代真实送达与索引证明。
+
+审查通过后，Leader 仅提交相关代码和回归测试。观察提交的真实 Hook、维护、晋升与索引，再让下一批任务实际检索本次新增知识与 commit 引用。
+
+安装、配置修复、重启和发布需单独的操作合同及受保护备份。候选只发布 `next`；正式包验收通过后才更新 `latest`。用户仍须亲自审查确实变化的原生 Hook，不写入或绕过信任。
+
+正式包也必须使用自己的全新 npm 收据和隔离配置；复用已付费向量不等于复用旧插件市场。若手工传错 fixture，外层设置了新收据也不能替旧版本背书，先核对环境文件的实际包路径和版本，错误采样明确作废。对话中的独立审查结果不替代 Leader 读取真实事件、文件与工具结果。
+
+提交标识查询可能合法返回 `markdown-hybrid-fallback`：它只说明返回行未采用向量通道，不应以一个后端标签否认实际检索。验收须结构化匹配项目、完整提交、服务来源、成功 tool-id 和写前顺序，并独立检查真实非空向量和语义查询；不能把文本命中当向量成功。模型注释中的正常换行也不应被误判为缺少 SHA，需保留稳定反例与复测。
+
+Windows 的 npm 全局更新还需确认独立 MCP 客户端已释放原生库。主服务停止不代表 IDE 自己启动的 MCP 子进程已退出。本轮通过进程模块只读检查定位到本会话的本产品 MCP，而非批量终止 Node；校验精确入口、父进程和 DLL 后仅关闭该子进程，再重做完整保真升级。不能据此终止来源不明或被安全检查禁止停止的旧实例。启动后等待四模块及引擎 API 就绪，不把网页端口在线当作所有功能就绪。
+
+临时工作树不得通过目录联接共用需要保留的 `node_modules` 后直接递归清理。本轮清理带联接的工作树后，主源码依赖目录为空；因此清理前必须枚举链接、核对真实目标并先安全解除联接本身，不能让递归操作越出临时目录。依赖恢复按原锁文件执行，保留首失败，不以恢复后的结果覆盖环境事故。
+
+## 验收记录
+
+本轮补充的操作约束：
+
+- 一条独立任务优先使用新建短上下文会话；只需执行固定脚本时，不追加长篇设计或重复创建任务实体。长命令由实际进程结果证明，GLM 总结不是测试凭证。
+- 从 Workbench 内再启动隔离产品时，同时设置该 fixture 的 `KB_DATA_DIR` 和 `KB_KNOWLEDGE_DATA_DIR`；不能继承宿主登记层。Q24 的首个二次开发因此查错登记层，保留首失败并修正验收启动器后才重测。
+- 真实 UI 要检查任务原文事实是否送达、实际回答是否引用它，不能只检查提交号。rc.6／rc.7 的 SHA-only 成功曾掩盖正文遗漏，后续门禁补齐该反例。
+- GLM 对安装包缺文件或别名的结论必须核对真实文件与哈希。本轮曾从无词法命中推断缺别名，Leader 的字节证据反证后已撤回；旧 Node REPL 的模块缓存也不能当作新运行时证据，关键核验使用新进程。
+- 原生 Hook 是否需要再次审核取决于实际定义哈希，不由版本号猜测。rc.6 审核后 rc.8 的哈希未变、原生仍为 trusted；确实变化才请求用户审核，不绕过信任。
+
+本轮的会话、提交、源码回归、npm 下载和真实维护结果见 [5.0.16 验收记录](release-5.0.16-acceptance.md)。操作手册与版本放行结果分开维护。
+
+## 网页响应性与历史修复（2026-10-15）
+
+本批继续采用 Leader 关键开发、真实 GLM-5.3 独立故障审查：Workbench `sess-8155764fec1e`，外壳 `sess-68d4d397c7f5`。GLM 只写指定测试和审查报告，不改生产实现、不发布、不改用户配置。Leader 独立复测测试文件与真实安装包，不将报告摘要当作成功凭证。
+
+- 缓存 TTL 的确定性测试使用注入时钟；20ms 真实时间在完整回归负载下会过期，不应靠增大等待掩盖测试竞态。
+- 原生 SDK 已发出最终 result，不代表异步迭代器必定立即 EOF。旧工作台的独立审查会话曾在最终报告后仍显示 running；Leader 核对报告完整后显式中止清理。新实现以 result 为本轮边界并在 finally 关闭自己的 query，另用真实 npm 工作台任务验证自然 idle，不能只补假流单测。
+- 浏览器滚动默认动作是异步的；滚轮后同一时刻读取 scrollTop 可能仍为旧值。要同时验证向上意图、后续内容增长和稳定阅读位置，不能只取输入后的单帧。
+- 新增异步发现后要审查诊断与 runtime 旁路，确保没有保留同步命令查找，也不能为了消除阻塞而丢掉注册表安装路径。
+- 多标签连接测试使用八个真实浏览器标签页；Node WebSocket 测试只证明协议行为，不能代替浏览器同源连接限制的验收。
+
+本批完整记录见 [5.0.17 验收记录](release-5.0.17-acceptance.md)。

package/docs/project-registry-schema.md

@@ -20,14 +20,14 @@ Date: 2026-06-21
 | `gitPath` | required | Source repository path |
 | `kbPath` | generated from knowledge-store root | Final minimal KB location |
 | `kbSchemaVersion` | `"minimal"` | Current KB framework marker |
-| `goalStatus` | `"not-created"` | Review state of `GOAL.md` |
-| `trackingStartCommit` | current `HEAD` on first import | Baseline commit for incremental KB tracking; commits before it are not analyzed |
-| `trackingStartedAt` | current timestamp on first import | Time the tracking baseline was established |
-| `lastAnalyzedCommit` | `null` | Advanced only after accepted apply |
-| `knowledgeLanguage` | `"zh-CN"` | Human-readable output language |
-
-Old values may exist in local runtime files, but initialization and migration now target the final minimal framework.
-
-Soft-removed projects are remembered in runtime state so re-importing the same
-repository can restore the original `trackingStartCommit`, `lastAnalyzedCommit`,
-and `kbPath`. Hard removal with KB deletion starts fresh.
+| `goalStatus` | `"not-created"` | Review state of `GOAL.md` |
+| `trackingStartCommit` | current `HEAD` on first import | Baseline commit for incremental KB tracking; commits before it are not analyzed |
+| `trackingStartedAt` | current timestamp on first import | Time the tracking baseline was established |
+| `lastAnalyzedCommit` | `null` | Advanced only after accepted apply |
+| `knowledgeLanguage` | `"zh-CN"` | Human-readable output language |
+
+Old values may exist in local runtime files, but initialization and migration now target the final minimal framework.
+
+Soft-removed projects are remembered in runtime state so re-importing the same
+repository can restore the original `trackingStartCommit`, `lastAnalyzedCommit`,
+and `kbPath`. Hard removal with KB deletion starts fresh.