docs(blueprint/agent): 完成访问可靠性正式版验收
All checks were successful
Push & PR Check / check (push) Successful in 1m1s

Rules-Applied: R03,R08,R13
This commit is contained in:
lanrtop 2026-09-23 09:45:39 +09:00
parent 43a4e4382a
commit 7fc3011411
3 changed files with 8 additions and 7 deletions

View File

@ -483,10 +483,10 @@ modules:
- id: agent-access-reliability - id: agent-access-reliability
name: Agent 访问可靠性 name: Agent 访问可靠性
area: infra area: infra
status: in_progress status: done
progress: 98 progress: 100
updated: 2026-09-23 updated: 2026-09-23
note: "A1-A9 的 Agent 路径与设置页视觉均已闭环:关闭开发态窗口后托盘 MCP 仍可用,炼境与 Enterprise 新 Codex 任务均原生发现 scoped 工具;设置页能诚实呈现运行、reload_required 与 debug 自启动禁用状态。仅余正式安装版 autostart human_verify。" note: "A1-A9 已完成:双项目原生 scoped MCP、开发态托盘常驻、设置页真实 readiness 与正式安装版 0.1.19 自启动启停均已验收;最终自启动关闭。Windows 注销后的自动拉起尚未实测。"
position: [2750, 950] position: [2750, 950]
edges: edges:

View File

@ -1,8 +1,8 @@
--- ---
id: agent-access-reliability id: agent-access-reliability
name: Agent 访问可靠性 name: Agent 访问可靠性
status: in_progress status: done
progress: 98 progress: 100
--- ---
## 设计决策:Agent Access Reliability v1 ## 设计决策:Agent Access Reliability v1
@ -127,7 +127,7 @@ Codex / Claude 项目
- files: src-tauri/Cargo.toml, src-tauri/Cargo.lock, src-tauri/src/lib.rs, src-tauri/src/commands/settings.rs - files: src-tauri/Cargo.toml, src-tauri/Cargo.lock, src-tauri/src/lib.rs, src-tauri/src/commands/settings.rs
- acceptance: "[Tauri command] set_agent_autostart(enabled) → 默认 false,可启用、查询并撤销;重复调用幂等;不启动第二个炼境实例,不修改项目文件或 pnpm-lock.yaml。" - acceptance: "[Tauri command] set_agent_autostart(enabled) → 默认 false,可启用、查询并撤销;重复调用幂等;不启动第二个炼境实例,不修改项目文件或 pnpm-lock.yaml。"
- decision_note: "用户于 2026-09-23 明确恢复 A6,但限定正式安装版:默认关闭,debug/target 构建拒绝启用,查询/启停幂等,复用 single-instance;开发前先退出正式版,不并行运行两个实例;updater 单独建设。" - decision_note: "用户于 2026-09-23 明确恢复 A6,但限定正式安装版:默认关闭,debug/target 构建拒绝启用,查询/启停幂等,复用 single-instance;开发前先退出正式版,不并行运行两个实例;updater 单独建设。"
- done_note: "接入官方 tauri-plugin-autostart,保留既有 single-instance;query/set command 通过纯状态机 fixture 证明重复调用幂等,debug 与 target/release 路径拒绝启用,未改 pnpm-lock。路径 fixture、cargo test --lib 179/179 与 cargo check --release 通过;`mise exec -- pnpm build:local` 已生成 NSIS/MSI,NSIS SHA-256=82F05ECB0A68E5B87FCD5D50906A64A4CD07B6E9169A07CB2F20D6130FE36C12。正式安装后的注册表效果留待安装包 human_verify。" - done_note: "接入官方 tauri-plugin-autostart,保留既有 single-instance;query/set command 通过纯状态机 fixture 证明重复调用幂等,debug 与 target/release 路径拒绝启用,未改 pnpm-lock。路径 fixture、cargo test --lib 179/179 与 cargo check --release 通过;`mise exec -- pnpm build:local` 已生成 NSIS/MSI,NSIS SHA-256=82F05ECB0A68E5B87FCD5D50906A64A4CD07B6E9169A07CB2F20D6130FE36C12。2026-09-23 正式版 0.1.19 安装后默认无 HKCU Run 项,用户在正式版 UI 完成开启与关闭并分别看到成功提示;终态开关为 off、HKCU Run 无炼境项,进程仍为正式安装路径的单一实例。开启瞬间的注册表读数未捕获,Windows 注销后的自动拉起未实测。"
### ✅ A7. Agent 连接状态与自启动 UI 投影 ### ✅ A7. Agent 连接状态与自启动 UI 投影
- status: done - status: done
@ -135,7 +135,7 @@ Codex / Claude 项目
- depends: A2. 分层 Agent runtime readiness 本体, A6. Windows 登录自启动后端能力 - depends: A2. 分层 Agent runtime readiness 本体, A6. Windows 登录自启动后端能力
- files: src/lib/commands.ts, src/components/settings/SettingsPage.tsx, src/components/settings/SettingsPage.test.ts - files: src/lib/commands.ts, src/components/settings/SettingsPage.tsx, src/components/settings/SettingsPage.test.ts
- acceptance: "agent_verify: [pnpm typecheck] Agent runtime/autostart 类型与调用无错误;[Tauri command fixture] unavailable、reload_required、ready 分别渲染准确状态和唯一建议动作。human_verify: 设置页能区分未配置、炼境未运行、需重启 Codex、已就绪,并仅在正式安装版允许启停登录自启动。" - acceptance: "agent_verify: [pnpm typecheck] Agent runtime/autostart 类型与调用无错误;[Tauri command fixture] unavailable、reload_required、ready 分别渲染准确状态和唯一建议动作。human_verify: 设置页能区分未配置、炼境未运行、需重启 Codex、已就绪,并仅在正式安装版允许启停登录自启动。"
- done_note: "设置页新增项目级 Agent readiness 与正式版自启动投影;五类状态映射各自产生唯一行动。Vitest 5/5、mise pnpm typecheck 与 production frontend build 通过。2026-09-23 用户在开发态设置页完成视觉终验:MCP 真实显示运行中与延迟、地址为 127.0.0.1 scoped URL、debug 自启动开关禁用且说明准确、当前任务未加载 MCP 时诚实显示 reload_required。仅正式安装版开关与注册表效果留待 human_verify。" - done_note: "设置页新增项目级 Agent readiness 与正式版自启动投影;五类状态映射各自产生唯一行动。Vitest 5/5、mise pnpm typecheck 与 production frontend build 通过。2026-09-23 用户在开发态设置页完成视觉终验:MCP 真实显示运行中与延迟、地址为 127.0.0.1 scoped URL、debug 自启动开关禁用且说明准确、当前任务未加载 MCP 时诚实显示 reload_required;正式版 0.1.19 开关可操作,启停成功提示与最终关闭状态均经截图确认。"
### ✅ A8. 项目作用域配置迁移与 Skill 降级指引 ### ✅ A8. 项目作用域配置迁移与 Skill 降级指引
- status: done - status: done

View File

@ -22,3 +22,4 @@
{"content":"【复盘】P3-S1 炼境自身 Codex 接入闭环\n任务类型: MCP工具\n复杂度: M\n实际轮数: 2轮(预估2轮)\n是否返工: 否\n有效策略: 先由 inject_mcp 建立工具无关 canonical context,再由 apply_onboarding_pack 分发版本化能力包;最终通过 verify_onboarding 11/11 与 get_delivery_status 实机调用验证,未读取或复制 Gitea token。\n遗留风险: 当前 Codex 任务不能热加载新 MCP 配置,需在新任务验证原生工具发现;个人 marketplace 指向的 lian-jing-codex 源目录缺失,仓库插件源码已更新但本机插件缓存尚未刷新。\nauto_applied_rules: R10,R13\nrule_effectiveness: R10=有效,R13=有效","created_at":"2026-09-22 21:08:45","id":175,"project_id":"dev-manager-tauri","source":"mcp"} {"content":"【复盘】P3-S1 炼境自身 Codex 接入闭环\n任务类型: MCP工具\n复杂度: M\n实际轮数: 2轮(预估2轮)\n是否返工: 否\n有效策略: 先由 inject_mcp 建立工具无关 canonical context,再由 apply_onboarding_pack 分发版本化能力包;最终通过 verify_onboarding 11/11 与 get_delivery_status 实机调用验证,未读取或复制 Gitea token。\n遗留风险: 当前 Codex 任务不能热加载新 MCP 配置,需在新任务验证原生工具发现;个人 marketplace 指向的 lian-jing-codex 源目录缺失,仓库插件源码已更新但本机插件缓存尚未刷新。\nauto_applied_rules: R10,R13\nrule_effectiveness: R10=有效,R13=有效","created_at":"2026-09-22 21:08:45","id":175,"project_id":"dev-manager-tauri","source":"mcp"}
{"content":"【复盘】P3-S2 Agent PR 合并安全门禁\n任务类型: MCP工具\n复杂度: M\n实际轮数: 2轮(预估2轮)\n是否返工: 是\n返工原因: 初版只在发起 merge 前读取并比较 head SHA,代码审查发现检查与执行之间仍有 TOCTOU 窗口;补充 Gitea head_commit_id 由服务端在合并时再次绑定确认 SHA。\n有效策略: 将 confirmed、完整 expected_head_sha、PR open/mergeable、CI、review 全部收敛在 Rust 能力本体;MCP 仅传参。先用错误 SHA 验证拒绝,再在用户确认 PR #14 与 b6d749025458928b86ab607a5a7f31479f8db85f 后真实合并并回读状态。\n遗留风险: review=pending 在当前轻量治理策略中允许合并;若未来需要强制审批,应新增项目级 required-review policy,不应在客户端复制判断。\nauto_applied_rules: R06,R07,R10,R12,R13\nrule_effectiveness: R06=有效,R07=有效,R10=有效,R12=有效,R13=有效","created_at":"2026-09-22 21:20:28","id":176,"project_id":"dev-manager-tauri","source":"mcp"} {"content":"【复盘】P3-S2 Agent PR 合并安全门禁\n任务类型: MCP工具\n复杂度: M\n实际轮数: 2轮(预估2轮)\n是否返工: 是\n返工原因: 初版只在发起 merge 前读取并比较 head SHA,代码审查发现检查与执行之间仍有 TOCTOU 窗口;补充 Gitea head_commit_id 由服务端在合并时再次绑定确认 SHA。\n有效策略: 将 confirmed、完整 expected_head_sha、PR open/mergeable、CI、review 全部收敛在 Rust 能力本体;MCP 仅传参。先用错误 SHA 验证拒绝,再在用户确认 PR #14 与 b6d749025458928b86ab607a5a7f31479f8db85f 后真实合并并回读状态。\n遗留风险: review=pending 在当前轻量治理策略中允许合并;若未来需要强制审批,应新增项目级 required-review policy,不应在客户端复制判断。\nauto_applied_rules: R06,R07,R10,R12,R13\nrule_effectiveness: R06=有效,R07=有效,R10=有效,R12=有效,R13=有效","created_at":"2026-09-22 21:20:28","id":176,"project_id":"dev-manager-tauri","source":"mcp"}
{"content":"【复盘】A9 炼境与 Enterprise 消费者端到端验收\n任务类型: MCP工具\n复杂度: M\n实际轮数: 3轮(预估2轮)\n是否返工: 是\n返工原因: 初次只验证 scoped HTTP,尚不能证明 Codex 新任务已原生加载工具;随后增加新任务 tool marker 与托盘关闭后存活证据。\n有效策略: 以 127.0.0.1 scoped endpoint 先验证作用域、跨项目拒绝与 unavailable 边界,再用两个全新 Codex 任务禁止 shell/HTTP/file fallback,确认 lian-jing/get_delivery_status 原生 tool marker;关闭窗口后继续验证进程、health、26 个工具与交付状态。\n遗留风险: Settings 页视觉 human_verify 与正式安装版 autostart human_verify 尚未完成;开发态继续优先 pnpm tauri dev,正式包仅在安装/自启动/升级/发布里程碑验收。","created_at":"2026-09-23 04:20:52","id":177,"project_id":"dev-manager-tauri","source":"mcp"} {"content":"【复盘】A9 炼境与 Enterprise 消费者端到端验收\n任务类型: MCP工具\n复杂度: M\n实际轮数: 3轮(预估2轮)\n是否返工: 是\n返工原因: 初次只验证 scoped HTTP,尚不能证明 Codex 新任务已原生加载工具;随后增加新任务 tool marker 与托盘关闭后存活证据。\n有效策略: 以 127.0.0.1 scoped endpoint 先验证作用域、跨项目拒绝与 unavailable 边界,再用两个全新 Codex 任务禁止 shell/HTTP/file fallback,确认 lian-jing/get_delivery_status 原生 tool marker;关闭窗口后继续验证进程、health、26 个工具与交付状态。\n遗留风险: Settings 页视觉 human_verify 与正式安装版 autostart human_verify 尚未完成;开发态继续优先 pnpm tauri dev,正式包仅在安装/自启动/升级/发布里程碑验收。","created_at":"2026-09-23 04:20:52","id":177,"project_id":"dev-manager-tauri","source":"mcp"}
{"content":"【复盘】Agent 访问可靠性 A1-A9 收官\n任务类型: 架构调整\n复杂度: L\n实际轮数: 分阶段完成(预估分阶段)\n是否返工: 是\n返工原因: 初期静态配置被误当作 Agent 当前可用,之后补齐 listener、握手、核心工具、客户端重载的分层证据;原生客户端验收和正式安装版自启动另行补测。\n有效策略: 单一 loopback MCP 加项目作用域;以两个新 Codex 任务的原生工具调用验证消费端;开发态用 pnpm tauri dev 快速验证,正式安装包只在自启动里程碑验收。0.1.19 正式版默认无自启动项,用户通过 UI 完成启停,终态为关闭,get_diagnostics 五层就绪。\n遗留风险: 开启瞬间 HKCU Run 读数未捕获,Windows 注销后的自动拉起未实测;若后续需要证明登录触发效果,再做一次计划内登录验证。P3-E 与 usage.json 并行改动不属于本模块。","created_at":"2026-09-23 09:45:16","id":178,"project_id":"dev-manager-tauri","source":"mcp"}