Compare commits

...

30 Commits

Author SHA1 Message Date
d18df0ca88 Merge pull request 'fix(coexist): 新炼境接管项目文件后,旧炼境的模板分发、蓝图规则同步与 buff 轮询跳过该项目' (#47) from fix/files-managed-guard into master
All checks were successful
Push & PR Check / check (push) Successful in 1m7s
Reviewed-on: #47
2026-10-06 12:08:04 +08:00
lanrtop
ec672bb027 fix(coexist): 新炼境接管项目文件后,旧炼境的模板分发、蓝图规则同步与 buff 轮询跳过该项目
All checks were successful
Push & PR Check / check (pull_request) Successful in 1m2s
共存期两边会来回覆盖同一批托管文件(AGENTS.md、CLAUDE.md、lian-jing 技能、CONVENTIONS、任务卡)。
新炼境(lian-jing-next)接管某项目时在 .lian-jing/context.json 写入 files_managed_by="lian-jing-next";
旧炼境据此跳过:dispatch_templates_with、sync_blueprint_rules_with、buff check_project。
身份合并写(write_canonical_context_with)本就保留未知字段,测试锁定接管标记不会被自己抹掉。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-06 07:46:48 +09:00
lanrtop
3cf3f87319 docs(blueprint): MVP 收口 M2——B2 终验否决(IC10 误标),blueprint-buff 剩余缺口为方案 C 并冻结,INT-04 goal 收口
All checks were successful
Push & PR Check / check (push) Successful in 1m5s
M2 前提「零误标、14% 只是进度数字」在执行中被证伪;用户在会话中选定记否决、方案 C 冻结,M2 验收按此改口径并在卡上报备。

Goal-Receipt: INT-04@2.0#a504755
Goal-Cards: M2, M3, M4
Goal-Result: 中止(M2 前提被证伪:buff 12:46 误标 IC10,终点第 2 条主仓库 .blueprint/modules 非空、第 3 条 status done/progress 100 按原文不成立;验收经用户选定改口径后三卡 ✅)
Goal-Rounds: 1
Goal-Interventions: 2
Goal-Tokens: n/a
Not-Verified: M4 第 8 条逐节对照靠阅读而非机器 diff;typecheck 在主仓库同一 TS 源码上跑(worktree 无 node_modules,已证明 3228b49..master 无 TS 改动);主仓库 IC10 误标待用户决定是否恢复
Human-Pending: M3 手动删除 §5 所列目录与文件;M5 enterprise 实战四条

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-04 15:52:51 +09:00
lanrtop
7907793f19 docs: MVP 收口 M3/M4——常驻文档漂移五处修复,按钮清单收敛到 AGENTS.md,agents-meta-rules 对齐托管块 1.10.0 并附逐节对照
All checks were successful
Push & PR Check / check (push) Successful in 1m2s
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-04 15:34:40 +09:00
lanrtop
ca1ffb0965 docs(blueprint/mvp-closure): M2、M3、M4 开工标 🔵(INT-04 goal)
All checks were successful
Push & PR Check / check (push) Successful in 1m1s
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-04 15:08:48 +09:00
lanrtop
7b9c18620a docs(intent): 目录 2.0——新增 INT-04 MVP 收口(enterprise-system 实战为人看坐标)
All checks were successful
Push & PR Check / check (push) Successful in 1m3s
用户 2026-10-04 在统筹会话确认:P8 达成后阶段终点改为 MVP 收口,以 enterprise-system 真实开发验证开工、自验、交付、摩擦闭环四条能力。

Feature-Confirmed: true
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-04 14:49:50 +09:00
lanrtop
296419d796 docs(blueprint/mvp-closure): 立 MVP 收口模块与 M2–M5 卡(挂 INT-04@2.0),统筹文档 §3 MVP 行映射到卡
用户 2026-10-04 定以 enterprise-system 真实开发验证四条能力(M5,原 V13 并入),intent-catalog 的 enterprise 试点继续冻结。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-04 14:49:40 +09:00
lanrtop
ef09ef247b docs(tasks): 统筹文档切换到「MVP 收口」阶段——P8 达成,扩展冻结登记 §3,意图目录线交接与本轮清理记入 §4/§5
All checks were successful
Push & PR Check / check (push) Successful in 1m30s
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-04 12:45:45 +09:00
lanrtop
c0e2e3c133 docs(blueprint): P8g 用户终验通过,P8 一键接入整卡标 ✅,记录终验证据与转后续小修的文案项
All checks were successful
Push & PR Check / check (push) Successful in 1m3s
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-04 11:39:13 +09:00
0ffaad03fd Merge pull request 'docs(blueprint/intent-catalog): IC4 跨客户端纸面编译通过(Codex)并修订指南' (#45) from feat/intent-catalog into master
All checks were successful
Push & PR Check / check (push) Successful in 1m3s
2026-10-04 10:22:29 +08:00
lanrtop
50a8bf2f8c docs(blueprint/intent-catalog): IC4 跨客户端纸面编译通过(Codex),按其反馈修订指南七处
All checks were successful
Push & PR Check / check (push) Successful in 1m26s
Push & PR Check / check (pull_request) Successful in 59s
Codex 照指南对 INT-02 纸面编译(只读、未粘贴)的确认卡原文如下:

[INT-02@1.0#8392d18] 目标确认卡
项目: dev-manager-tauri | 分支/worktree: feat/intent-catalog @ E:\code-project\dev-manager-tauri-wt-intent | HEAD: 216a056
章意图: 人给出意图或模糊轮廓,agent 编译出可判定的 /goal:定型章编交付终点,探索章编每轮试验终点,人粘贴即确认 | 不做: 炼境不编译 goal、不判定完成;目录不存状态与进度
形态: 定型
纳入卡: IC6([gate 脚本] node .claude/hooks/intent-gate.cjs --self-test → exit 0 且输出 self-test ok,内置 6 类坏样例各恰好 1 条警告;node .claude/hooks/intent-gate.cjs → exit 0、真实目录 0 警告;INTENT_CATALOG=/nonexistent → 无输出、exit 0)、IC7([gate 脚本] --self-test 夹具的 --impact/--report/--pending 报 stale、orphan、low_confidence、divergence、status_source、缺终验、缺 Feature-Confirmed;全部 exit 0,运行前后 sha256sum 不变)、IC8([YAML 解析] lefthook.yml 可解析且 intent-gate.run 以 || true 结尾;[cargo test] cargo test onboarding → 0 failed;[CLI] AGENTS.md hunk 均在托管块前;grep → 0;临时 worktree 提交输出 1 条警告且成功,验证后移除)、IC9([cargo test] cargo test parse_module_md_ignores_intent_lines → 1 passed;全量 cargo test 无 FAILED)、IC10([gate 脚本] 0 警告;书签三行有效、coordination 指向书签、提案附 --report 与 base blob、提交带 Feature-Confirmed: true)
终点(合取): 1) IC6 的 self-test、真实目录检查和不存在目录降级均符合预期。 2) IC7 的夹具报告覆盖 stale、orphan、low_confidence、divergence、status_source、缺终验及目录提交审计,且全程不改 catalog/module 文件。 3) IC8 的 lefthook、Rust onboarding、AGENTS.md 位置、术语及临时 worktree 警告提交检查通过。 4) IC9 的定向与全量 Rust 测试通过。 5) IC10 的门控、书签、coordination 指向、提案证据及提交 trailer 检查通过。 6) IC6–IC10 均为 ✅,且收口提交已写 Goal-Receipt。
终验待办: IC10:用户确认书签切换。
停止找人: 出现 human_verify;需写运行中的数据库;需删除文件、数据或分支;需变更凭据或机器状态;工作超出 IC6–IC10 或 INT-02;需修改目录;出现 stale 或 orphan;同一问题失败 3 次。
能力入口: node .claude/hooks/intent-gate.cjs(IC6 落地后);cargo test onboarding;cargo test parse_module_md_ignores_intent_lines;cargo test;Git、YAML 解析与临时 worktree。
没验什么: 本次仅纸面编译,未执行尚未实现的 intent-gate,未运行 cargo test 或 lefthook,未创建/删除临时 worktree,未确认 P8 收口及各依赖卡实际状态,也未进行用户书签终验。
作废: 分支变化或 catalog blob ≠ 8392d18

核对(主会话):9 个字段齐全;标签 blob 8392d18 = HEAD:.blueprint/catalog.md;5 条终点可追溯到 IC6–IC10 的 agent_verify;按当时的黑名单(按方针|符合设计|设计已完成|基本完成)命中 0。Codex 的 /goal 文本逐条写了「命令 → 预期输出」,但上面确认卡的终点 1 被改写成「均符合预期」,两者写法不一致,这是本次发现之一。

指南修订(docs/ai-context/intent-catalog-guide.md):
- 无 Bash 环境(Codex 沙箱报 E_ACCESS_DENIED)允许用语义等价命令,并在确认卡注明
- 检查一律逐行解析(整文件正则会跨行误报悬空)
- 只读演练不写盘:第 10 条改为管道检查
- 第 3 步区分机器检查(必须通过)和人工核对(结果写进确认卡)
- 第 4 步检查 depends,确认卡新增「前置」行;有未满足的前置时只能纸面编译
- 体量改量提交里的 blob(git cat-file -s),工作区 CRLF 会让 wc -c 多算 34 字节
- 确认卡与 /goal 的终点写法必须一致;黑名单加「符合预期」

模块:IC4 ✅(附结果记录)、下一步 IC5;manifest 进度 31%。

Compiled-By: Codex
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-04 11:16:57 +09:00
lanrtop
216a056ae1 docs(blueprint/intent-catalog): IC6–IC10 卡侧挂靠 INT-02@1.0(补丁);IC4 开工,报备目标章由书签章改为指定 INT-02
All checks were successful
Push & PR Check / check (push) Successful in 1m2s
- IC6–IC10 各加一行 `- intent: INT-02@1.0`(紧跟 complexity),离线检查第 7 条通过(引用的章都存在)
- IC4 🔵;notes 报备改断言理由:书签所指 INT-01(P8)的卡在统筹会话的 agent-client-parity.md 中且几乎全为 ✅,纸面编译无测试价值;INT-02 挂有五张待做卡,纸面编译即 IC5 预演

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-04 04:01:21 +09:00
8b78c72bb9 Merge pull request 'docs(intent): 炼境意图目录 1.0 与探索章修订(IC3)' (#44) from feat/intent-catalog into master
All checks were successful
Push & PR Check / check (push) Successful in 1m1s
2026-10-04 03:01:14 +08:00
lanrtop
3417219a61 docs(intent): 炼境意图目录 1.0——INT-01 一键接入三端可用、INT-02 意图编译为可判定终点、INT-03 摩擦驱动沉淀与退出(IC3)
All checks were successful
Push & PR Check / check (push) Successful in 1m0s
Push & PR Check / check (pull_request) Successful in 57s
用户 2026-10-04 逐章确认三章的意图、人看与不做(1.0 为大版本,由人定稿);INT-02 的措辞覆盖定型和探索两种形态。书签在 P8 期间只指向 coordination §0,IC10 再改为自持。
- 新增 .blueprint/catalog.md:34 行、1748 字节;版本行 1;3 章;禁用键 0;path/module 指针 0 悬空;4 个 card 指针与 3 个标题锚点人工核对一致;无超长字段;探索章检查无输出
- 模块:IC3 ✅、下一步 IC4;记录探索章修订决策(起因、做法、同步项),W8 待补项、IC6 坏样例(6 类)、度量(探索章三项)同步更新
- manifest:intent-catalog 进度 23%

Feature-Confirmed: true
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-04 03:57:32 +09:00
lanrtop
5af71253dd docs(ai-context/intent-catalog): 增加探索章——意图可从 MVP 迭代中结晶,探索期 goal 只编译本轮试验终点
- 指南新增「探索章与结晶」一节:形态 定型|探索(人对意图清晰度的声明,不是任务进度);探索章必填 轮廓、试探、不做、预算、收敛信号;每轮试验的终验行(保留/否决 + 理由)作为结晶原料;收敛或预算用完时由 agent 起草意图提炼、人确认后转为定型(小版本);未收敛由人三选一,agent 不得自行延长预算
- 目录语法:新增「形态」字段与「不必开章的情况」(修修补补和直接做 MVP 不必开章);goal 编译第 5 步补探索章分支;确认卡增加形态与轮次行;离线检查新增第 11 条(探索章必填字段),已用夹具实测
- 设计文档头部注明此次修订;起因与决策见模块决策记录(下一提交)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-04 03:57:29 +09:00
2d47cda85a Merge pull request 'docs(ai-context/intent-catalog): IC2 意图目录编写与使用指南' (#43) from feat/intent-catalog into master
All checks were successful
Push & PR Check / check (push) Successful in 1m0s
2026-10-04 02:33:46 +08:00
lanrtop
8415a11381 docs(blueprint): P8g 合并后验收标 ✅(master typecheck、vitest 29、cargo test 414 passed),更新 manifest 与统筹文档 §3/§4
Some checks are pending
Push & PR Check / check (push) Waiting to run
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-04 03:33:29 +09:00
lanrtop
a67e0e7d75 docs(ai-context/intent-catalog): IC2 新增意图目录编写与使用指南——目录语法、修订与钉版、goal 编译七步、确认卡与回执、离线检查
All checks were successful
Push & PR Check / check (push) Successful in 1m1s
Push & PR Check / check (pull_request) Successful in 58s
- 新增 docs/ai-context/intent-catalog-guide.md(212 行),作为意图目录语法与 goal 编译流程的单一来源;流程模型无关,/architect 只作可选包装
- 离线检查给出 10 条 shell 单行命令(版本行、章数、体量、禁用键、path/module 指针、卡侧 intent 引用、钉版对照、### 计数、过程词黑名单),Phase 4 由 intent-gate.cjs 替换
- IC2 ✅;模块转 in_progress(进度 15%),下一步 IC3 首批章节由用户定稿

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-04 03:29:46 +09:00
cf93392130 Merge pull request 'docs(blueprint/intent-catalog): 立意图目录模块并完成 IC1 设计(最小文件优先方案,拆 IC2–IC13)' (#42) from feat/intent-catalog into master
All checks were successful
Push & PR Check / check (push) Successful in 1m1s
2026-10-04 02:28:05 +08:00
3228b490f2 Merge pull request 'feat(onboard/parity): UI 一键接入面板——先计划预览、人确认后接入,四个入口接线(P8g)' (#41) from feat/agent-client-parity-p8g into master
All checks were successful
Push & PR Check / check (push) Successful in 1m19s
2026-10-04 02:24:49 +08:00
lanrtop
a3dfa8a337 docs(blueprint/intent-catalog): IC1 设计确认,模块转 planned,追加 IC2–IC13 任务卡与五项决策
All checks were successful
Push & PR Check / check (push) Successful in 1m2s
Push & PR Check / check (pull_request) Successful in 1m1s
- 用户 2026-10-04 确认设计,五个待拍板问题全部采纳推荐:门控排在 P8 收口后;IC5 首次真实 /goal 用于 Phase 4 的卡;首批三章方向在 IC3 定稿;去留阈值初定;接受约 10 行常驻启动读书签
- IC1 ✅;新增「概述」段供 UI 展示;IC2–IC13 每张卡都带 files、complexity、depends 和可执行 acceptance(IC3/IC5/IC10–IC13 另有 human_verify)
- manifest:intent-catalog 转 planned,note 同步;设计文档头标为已确认

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-04 03:04:59 +09:00
lanrtop
7f616cd26e docs(blueprint/intent-catalog): IC1 设计文档——最小文件优先方案(.blueprint/catalog.md + 卡侧 intent 钉版 + 模型无关 goal 编译),拆 IC2–IC13,待用户确认
All checks were successful
Push & PR Check / check (push) Successful in 1m2s
- 新增 docs/tasks/2026-10-04-intent-catalog-design.md:评审团工作流 wf_60e4c430-bb1 出稿(3 方案 × 2 视角评委,最小文件优先胜出 25/30、24/30),含设计规格 1–7、13 问化解、W1–W14 四问、受影响文件、边界变更、风险、12 张卡、度量与退出、立法草案、没验什么与用量记账
- 关键代码事实已复核:archive 只归档 modules/*.md;parse_module_md 只认固定键、未识别 ## 段下的 ### 会被当卡;buff 自动标 🔵 不碰 intent/终验行;lefthook 存在即跳过
- 模块 IC1 标 🔵 等用户确认;试用期只新增文件,门控与接线排在 P8 收口后

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-04 02:08:45 +09:00
lanrtop
c28caf72ee chore(merge): 合并 origin/master(统筹文档 §7 交接)进 P8g 分支
All checks were successful
Push & PR Check / check (push) Successful in 1m0s
Push & PR Check / check (pull_request) Successful in 1m0s
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-04 02:08:03 +09:00
lanrtop
9d85609287 fix(onboard/parity): 处置 P8g 独立审查——新建入口按有效根目录弹出、Toast 置于面板之上、bypass 与错误阶段文案如实
All checks were successful
Push & PR Check / check (push) Successful in 1m2s
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-04 02:06:29 +09:00
lanrtop
5b6c197a74 feat(onboard/parity): UI 一键接入面板——先计划预览、人确认后接入,四个入口接线(P8g)
- onboardView.ts:计划 / 报告 → 视图模型的纯函数(阻断禁用确认、可跳过只看后端 skippable、
  not_installed / not_applicable 灰色说明、bypassPermissions 与 Codex 信任单列、确认带 expected_digest
  与生成计划时的选项),onboardView.test.ts 13 条 vitest
- OnboardPanel.tsx / OnboardSections.tsx:全局挂载的接入面板(plan → 预览 → onboard_project → 分步结果、
  L1 矩阵、待你提交的 N 个文件、待你操作),refused 可回到新计划重新确认
- 入口:新建项目选了目录、模板新建成功后弹出预览;批量添加只给逐项入口;蓝图治理「施加 Buff」
  改为同一面板(先 plan 再 apply)
- plan.rs:BlockedItem 序列化附派生字段 skippable(= BlockReason::skippable,不进 digest)

Feature-Confirmed: true
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-04 01:35:06 +09:00
lanrtop
aaabd0b231 docs(blueprint/intent-catalog): 立意图目录 concept 模块——目录/正文两层模型与 W1–W14 承重墙纲目,并入 handoff 试点的信息归属与任务简报
All checks were successful
Push & PR Check / check (push) Successful in 1m4s
- 新增 .blueprint/modules/intent-catalog.md:为什么(含 09-30 /goal 被提前判达成的实证)、两层模型、承重墙表(指向已有机制,只列待补)、并入与依赖、13 个待设计问题、不做什么、分阶段、收益度量与退出条件、IC1 设计卡、4 条决策记录
- manifest 追加 intent-catalog(concept,backend)与 3 条边(blueprint-governance、agent-client-capability-packs 为依赖,governance-feedback-loop 为相关);updated 改为 2026-10-04
- 只做蓝图同步,不改代码、模板与分发层;与 P8 并行,不碰其热点文件

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-04 01:19:48 +09:00
lanrtop
23c50eccca docs(tasks): 统筹文档 §7 交接——上下文将满,新会话接手 P8g 与收尾
All checks were successful
Push & PR Check / check (push) Successful in 1m5s
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-04 00:34:51 +09:00
lanrtop
2f73c21d7a docs(tasks): 统筹流水——P8g 工作流看门狗卡死后改派后台 Agent,铁律补工作流 180 秒看门狗教训
All checks were successful
Push & PR Check / check (push) Successful in 1m2s
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-03 23:56:39 +09:00
lanrtop
51a39d0fa4 docs(blueprint): P8e、P8f 端到端实测通过标 ✅,P8 卡记录新登记项目一键接入与收敛证据
All checks were successful
Push & PR Check / check (push) Successful in 1m5s
新登记临时项目 register_project → plan_onboarding → onboard_project(confirmed) 得 done,
三端可用子集全部就绪(Codex 列待用户信任目录单列 pending_user),再次执行 9 步全收敛、
文件 mtime 不变。enterprise 主工作区落后 origin/main,计划如实显示 update 3,不对其 apply。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-03 23:28:18 +09:00
d7f481616a Merge pull request 'feat(onboard/parity): 一键接入 plan_onboarding / onboard_project 的 MCP 与 Tauri 投影,Codex 信任计 pending_user(P8e)' (#40) from feat/agent-client-parity-p8e into master
All checks were successful
Push & PR Check / check (push) Successful in 1m12s
2026-10-03 21:14:06 +08:00
32 changed files with 2836 additions and 141 deletions

42
.blueprint/catalog.md Normal file
View File

@ -0,0 +1,42 @@
# 意图目录
> catalog_version: 2.0 | 前言 → path:AGENTS.md#项目定位 | 语法 → path:docs/ai-context/intent-catalog-guide.md
## 书签
- 当前 → path:docs/tasks/2026-10-03-coordination.md#0. 方针与本阶段终点
## INT-01 一键接入三端可用
- rev: 1.0
- 意图: 新建或添加子项目后一次确认,即可在 Claude Code、Codex、DSH 三端开工
- 人看: 三端桌面 GUI 新开会话即能调用炼境工具,无需手工配置
- 机器: card:agent-client-parity#P8;card:agent-client-parity#P8g
- 不做: 不替 agent 选模型;不让子项目依赖炼境在线;不改写客户端的信任表
- 墙: W12,W13
## INT-02 意图编译为可判定终点
- rev: 1.0
- 意图: 人给出意图或模糊轮廓,agent 编译出可判定的 /goal:定型章编交付终点,探索章编每轮试验终点,人粘贴即确认
- 人看: 定型章粘贴 /goal 后一次判对;探索章在预算内收敛为定型章
- 机器: card:intent-catalog#IC5;card:intent-catalog#IC13
- 不做: 炼境不编译 goal、不判定完成;目录不存状态与进度
- 假设: card:intent-catalog#IC13
- 墙: W1,W4,W7
## INT-03 摩擦驱动沉淀与退出
- rev: 1.0
- 意图: agent 反复摩擦之处经准入沉淀为跨 agent 能力,实测无收益就撤销
- 人看: 每条使者回传都有处置回执,撤销的能力在决策记录里查得到理由
- 机器: module:governance-feedback-loop;cmd:list_envoy_returns
- 不做: 不替 agent 思考或调度;不接管子项目自有事实;不因已经做了而保留
- 墙: W11,W14
## INT-04 MVP 收口
- rev: 2.0
- 意图: agent 拿到子项目即能开工、能自验、能交付,摩擦能闭环回传;四条都可用后再谈扩展
- 人看: 在 enterprise-system 真实开发中,agent 能开工、自验、交付,摩擦能回传;常驻文档与代码一致
- 机器: module:mvp-closure;path:docs/tasks/2026-10-03-coordination.md#0. 方针与本阶段终点
- 不做: 不开新能力;冻结的扩展项不派单;不改子项目业务规则与凭据
- 墙: W2,W3,W14
## 附录
- 承重墙 → path:.blueprint/modules/intent-catalog.md#承重墙
- 决策与否决 → 各模块「决策记录」;终验否决理由 → 卡上 `- 终验:` 行

View File

@ -6,7 +6,7 @@ description: >
项目自身保留业务规则、测试、部署声明与交付决策。炼境本身亦被纳入其中, 项目自身保留业务规则、测试、部署声明与交付决策。炼境本身亦被纳入其中,
形成可自我进化的开发智能闭环。 形成可自我进化的开发智能闭环。
iteration: 1 iteration: 1
updated: 2026-10-03 updated: 2026-10-04
agent_button_carrier: tauri agent_button_carrier: tauri
@ -258,7 +258,9 @@ modules:
name: 蓝图 Buff name: 蓝图 Buff
area: backend area: backend
status: in_progress status: in_progress
progress: 86 progress: 90
updated: 2026-10-04
note: "8 张卡全 ✅;B2 终验 2026-10-04 被否决(只改共用文档的提交仍误标无关 📋 卡,实例 IC10),剩余缺口为方案 C(files 重叠改记 DB 信号),MVP 收口期冻结为扩展。"
position: [2250, 0] position: [2250, 0]
- id: claude-autonomy-config - id: claude-autonomy-config
@ -511,9 +513,9 @@ modules:
name: 三端客户端对等 name: 三端客户端对等
area: infra area: infra
status: in_progress status: in_progress
progress: 61 progress: 78
updated: 2026-10-03 updated: 2026-10-04
note: "P1/P2/P3/P3b/P7/P9/P10 完成:三端(Claude Code、Codex 含 Desktop、DSH 含桌面 GUI)在 Enterprise 经 %USERPROFILE%\\.lian-jing 稳定入口连项目专用地址,人终验通过。Claude 条目经 claude CLI 写入、以 claude mcp get 为准;DSH 由托管块全局行(headless)+ 会话级插件(GUI/web/acp 按会话工作目录)路由;接入写入幂等;接入包改写块外带未提交改动的托管块文件时给出混合文件预警;P7 实测 MCP 服务器说明仅 Claude/DSH 带入模型上下文、Codex 不带,引导提示保留在 skill。2026-10-03 P8 一键接入设计定稿(docs/tasks/2026-10-03-p8-onboarding-oneclick-design.md):A1 不前置;P4 分 L0 静态 / L1 零模型 / L3 无头会话,P8 只依赖 L1(P4a);拆为 P8-0、P8a–P8g 与 P4-0、P4a–P4e(P8-0、P8a、P4-0 已完成,P8b 适配器注册表与三端结构化注入结果(PR #33,enterprise 实测两次注入三端 converged、零写入)、P8c 写入汇与写入前计划(PR #36)、P4a L1 零模型三端检查(PR #38,enterprise 三端 18 格 ready)、P8d 编排本体(PR #39)已完成,P8f 已合并待链路实测;P8a 把「已接入」统一为有项目 token;P4-0 实测六项假设,Codex 只在目录受信任时加载项目配置、Claude 用无效模型名可零额度取 init 并入 L1),P8 进行中;进度按拆分后卡数重算。待做 P5、P6(基于 P8c 的 WriteSink)。" note: "P1/P2/P3/P3b/P7/P9/P10 完成:三端(Claude Code、Codex 含 Desktop、DSH 含桌面 GUI)在 Enterprise 经 %USERPROFILE%\\.lian-jing 稳定入口连项目专用地址,人终验通过。Claude 条目经 claude CLI 写入、以 claude mcp get 为准;DSH 由托管块全局行(headless)+ 会话级插件(GUI/web/acp 按会话工作目录)路由;接入写入幂等;接入包改写块外带未提交改动的托管块文件时给出混合文件预警;P7 实测 MCP 服务器说明仅 Claude/DSH 带入模型上下文、Codex 不带,引导提示保留在 skill。2026-10-03 P8 一键接入设计定稿(docs/tasks/2026-10-03-p8-onboarding-oneclick-design.md):A1 不前置;P4 分 L0 静态 / L1 零模型 / L3 无头会话,P8 只依赖 L1(P4a);拆为 P8-0、P8a–P8g 与 P4-0、P4a–P4e(P8-0、P8a、P4-0 已完成,P8b 适配器注册表与三端结构化注入结果(PR #33,enterprise 实测两次注入三端 converged、零写入)、P8c 写入汇与写入前计划(PR #36)、P4a L1 零模型三端检查(PR #38,enterprise 三端 18 格 ready)、P8d 编排本体(PR #39)、P8e 投影(PR #40)、P8f register_project(PR #37)、P8g UI 一键接入面板(PR #41,2026-10-04)已完成,P8 一键接入整卡 ✅(2026-10-04 用户终验:UI 新建→预览→确认 7.7 秒 done,三端 L1 18 格 ready,三端桌面会话调通),端到端:新登记项目 plan→onboard_project done、重复执行全收敛;P8a 把「已接入」统一为有项目 token;P4-0 实测六项假设,Codex 只在目录受信任时加载项目配置、Claude 用无效模型名可零额度取 init 并入 L1),P8 进行中;进度按拆分后卡数重算。待做 P5、P6(基于 P8c 的 WriteSink)。"
position: [3500, 950] position: [3500, 950]
- id: architecture-evolution - id: architecture-evolution
@ -525,6 +527,24 @@ modules:
note: "技术栈评估:Tauri v2 + Rust + React/TS 适合管家方针,不换栈。按收益排序的结构改进:A1 本体与投影分离(2026-10-03 改写为三段——A1a 随 agent-client-parity P8b 落地的投影无关适应度测试、A1b 按需 CLI 薄客户端、A1c 触发式拆 core crate;P4/P8 不再依赖拆 crate)、A2 前后端类型契约生成、A3 配置文本模板化、A4 MCP 改用官方 rmcp SDK(P4b 轨迹环排在其后)。" note: "技术栈评估:Tauri v2 + Rust + React/TS 适合管家方针,不换栈。按收益排序的结构改进:A1 本体与投影分离(2026-10-03 改写为三段——A1a 随 agent-client-parity P8b 落地的投影无关适应度测试、A1b 按需 CLI 薄客户端、A1c 触发式拆 core crate;P4/P8 不再依赖拆 crate)、A2 前后端类型契约生成、A3 配置文本模板化、A4 MCP 改用官方 rmcp SDK(P4b 轨迹环排在其后)。"
position: [3750, 950] position: [3750, 950]
- id: intent-catalog
name: 意图目录
area: backend
status: in_progress
progress: 31
updated: 2026-10-04
note: "两层模型(人持有的意图目录 .blueprint/catalog.md + 蓝图正文),书装意图、指向事实;卡侧 intent 钉版,agent 编译可判定 /goal,确认卡兼作最小任务简报,回执写进提交。IC1 设计已确认(最小文件优先方案);IC2–IC4 只新增文档、可与 P8 并行,门控与接线等 P8 收口后做,IC13 按实测数据决定去留。"
position: [4000, 950]
- id: mvp-closure
name: MVP 收口
area: infra
status: in_progress
progress: 75
updated: 2026-10-04
note: "2026-10-04 P8 达成后的阶段终点(INT-04):炼境侧关账、清理、修常驻文档漂移(M2–M4,编进 /goal),四条能力在 enterprise-system 真实开发中只读取证(M5);扩展项冻结见统筹文档 §3。"
position: [4250, 950]
edges: edges:
- from: project-resource-broker - from: project-resource-broker
to: project-dev-variables to: project-dev-variables
@ -867,3 +887,13 @@ edges:
- from: architecture-evolution - from: architecture-evolution
to: agent-client-parity to: agent-client-parity
type: dependency type: dependency
# 意图目录:安全派发与状态语义收敛(blueprint-governance 前置)、版本化 pack 机制在先;修订历史与否决理由回流复用治理反馈闭环。
- from: blueprint-governance
to: intent-catalog
type: dependency
- from: agent-client-capability-packs
to: intent-catalog
type: dependency
- from: governance-feedback-loop
to: intent-catalog
type: related

View File

@ -213,8 +213,9 @@ skill 只是五个接入面之一,兼容层覆盖全部五面。
- known_limits: "Claude 与 DSH 只验了无头模式,Claude 只用了 sonnet-4-6;Codex 未验 TUI 与桌面版(桌面版可能走 app-server 路径,结论可能不同),也未验 SSE 传输。探针用的是桩服务的中英混合短说明,未用炼境真实说明(中文 238 字、UTF-8 500 字节,远低于 DSH 默认上限 32768 字节)实测。Codex 后续版本若开始带入服务器说明,按「检测行为而非嗅探版本」重跑本探针(P4 固化后纳入矩阵),三端都支持时再迁移。现有服务器说明五条要点中,「先读状态」「canonical project_id」「开发变量先查后登记」在 skill 有对应条目;「其他写操作须用户明确确认」与「unavailable/unknown 不得当作成功」在 skill 与 AGENTS.md 中只有分场景表述(合并 PR、CI workflow、工具链安装;MCP 不可用时不伪造诊断),Codex 会话只能从这些条目与工具描述获知——是否补成通用条目留待下次改 skill 时一并处理(需升接入包版本),本卡不改。 - known_limits: "Claude 与 DSH 只验了无头模式,Claude 只用了 sonnet-4-6;Codex 未验 TUI 与桌面版(桌面版可能走 app-server 路径,结论可能不同),也未验 SSE 传输。探针用的是桩服务的中英混合短说明,未用炼境真实说明(中文 238 字、UTF-8 500 字节,远低于 DSH 默认上限 32768 字节)实测。Codex 后续版本若开始带入服务器说明,按「检测行为而非嗅探版本」重跑本探针(P4 固化后纳入矩阵),三端都支持时再迁移。现有服务器说明五条要点中,「先读状态」「canonical project_id」「开发变量先查后登记」在 skill 有对应条目;「其他写操作须用户明确确认」与「unavailable/unknown 不得当作成功」在 skill 与 AGENTS.md 中只有分场景表述(合并 PR、CI workflow、工具链安装;MCP 不可用时不伪造诊断),Codex 会话只能从这些条目与工具描述获知——是否补成通用条目留待下次改 skill 时一并处理(需升接入包版本),本卡不改。
已补齐(2026-10-03,分支 feat/agent-client-parity-p7-skill-rules):两条已作为通用边界写进 lian-jing skill 模板开头(双投影到 .agents 与 .claude),两条规则的核心句与服务器说明逐字一致;只读查询、登记开发需求元数据与回传炼境明确列为无需确认的例外,与服务器说明的「其他写操作」及 skill「回传不必逐条征得同意」相容。服务器说明的例外是泛称「不含秘密的开发需求元数据」,skill 例外括注同时列出两个登记工具 register_project_test_account 与 register_project_dev_variable(审查修复:初版只列前者,会把开发变量登记误归入须确认的写操作);同批修正 skill 第 8 条——开发变量改用 register_project_dev_variable 登记名称与用途,测试账号仍用 register_project_test_account(初版两者都指向后者)。接入包 base-onboarding 1.7.0→1.8.0(修复在 1.8.0 发布前,未再升版本,只更新指纹);mcp_server 新增 server_instruction_universal_rules_are_in_skill,服务器说明与 skill 任一侧缺这两条即失败,skill 例外行缺任一登记工具也失败。AGENTS.md 托管块未改,仍只有分场景表述;存量项目需重建安装炼境后重跑 apply_onboarding_pack 才拿到新 skill。" 已补齐(2026-10-03,分支 feat/agent-client-parity-p7-skill-rules):两条已作为通用边界写进 lian-jing skill 模板开头(双投影到 .agents 与 .claude),两条规则的核心句与服务器说明逐字一致;只读查询、登记开发需求元数据与回传炼境明确列为无需确认的例外,与服务器说明的「其他写操作」及 skill「回传不必逐条征得同意」相容。服务器说明的例外是泛称「不含秘密的开发需求元数据」,skill 例外括注同时列出两个登记工具 register_project_test_account 与 register_project_dev_variable(审查修复:初版只列前者,会把开发变量登记误归入须确认的写操作);同批修正 skill 第 8 条——开发变量改用 register_project_dev_variable 登记名称与用途,测试账号仍用 register_project_test_account(初版两者都指向后者)。接入包 base-onboarding 1.7.0→1.8.0(修复在 1.8.0 发布前,未再升版本,只更新指纹);mcp_server 新增 server_instruction_universal_rules_are_in_skill,服务器说明与 skill 任一侧缺这两条即失败,skill 例外行缺任一登记工具也失败。AGENTS.md 托管块未改,仍只有分场景表述;存量项目需重建安装炼境后重跑 apply_onboarding_pack 才拿到新 skill。"
### 🔵 P8 — 一键接入:创建/添加子项目即完成三端可用 ### ✅ P8 — 一键接入:创建/添加子项目即完成三端可用
- status: in_progress - status: done
- done_verify: "2026-10-04:子卡 P8-0、P8a–P8g 全部 ✅;agent_verify 见 e2e_verify 与各子卡 merge_verify(master 3228b49 全量 cargo test 414 passed、vitest 29 passed);human_verify 由用户在 P8g 终验中完成(UI 新建→预览→确认 7.7 秒 done,Codex 信任后三端 L1 18 格 ready,Claude Code / Codex / DSH 桌面 GUI 新会话调 LJ_PROBE_NONEXISTENT 均得「开发需求未登记」),证据见 P8g human_verify。"
- complexity: L(2026-10-03 设计评审后拆为 P8-0、P8a–P8g,均为 S/M) - complexity: L(2026-10-03 设计评审后拆为 P8-0、P8a–P8g,均为 S/M)
- depends: P4a(原为 P4;P8 只依赖 L1 零模型检查,不等 L3) - depends: P4a(原为 P4;P8 只依赖 L1 零模型检查,不等 L3)
- acceptance: "agent_verify: [Tauri command / MCP] 对新登记项目 plan_onboarding → 用户确认 → onboard_project(expected_digest, confirmed=true),依次完成 canonical context、接入包分发(规则、skill 双投影、Codex 托管块)、本机三端注册(Claude local、DSH 白名单与会话插件、shim、token),并以 L1 零模型三端矩阵(每格带证据等级)验收,附最近一次 L3 结果及是否过期;重复执行收敛(全部 converged、文件 mtime 不变);接入包对项目文件的改动只报告 diff、不自动提交。human_verify: 在 Claude Code、Codex、DSH 桌面 GUI 各新开会话调 read_project_test_account(name=LJ_PROBE_NONEXISTENT),得「开发需求未登记」。" - acceptance: "agent_verify: [Tauri command / MCP] 对新登记项目 plan_onboarding → 用户确认 → onboard_project(expected_digest, confirmed=true),依次完成 canonical context、接入包分发(规则、skill 双投影、Codex 托管块)、本机三端注册(Claude local、DSH 白名单与会话插件、shim、token),并以 L1 零模型三端矩阵(每格带证据等级)验收,附最近一次 L3 结果及是否过期;重复执行收敛(全部 converged、文件 mtime 不变);接入包对项目文件的改动只报告 diff、不自动提交。human_verify: 在 Claude Code、Codex、DSH 桌面 GUI 各新开会话调 read_project_test_account(name=LJ_PROBE_NONEXISTENT),得「开发需求未登记」。"
@ -224,6 +225,7 @@ skill 只是五个接入面之一,兼容层覆盖全部五面。
- 决策(Q2–Q11 均采纳推荐项):写入前预览走 plan → digest 确认 → apply;bypassPermissions 默认值保持现状但在 plan 与报告中单列、可按项目取消;Codex 信任列入 next_actions,炼境不写 ~/.codex 信任表;L3 只在显式触发时跑,建议在 canary(enterprise)项目、指纹变化时跑;做 register_project 的全局路由投影;A4 先于 P4b;CLI 只做 pnpm probe:clients 薄脚本;A1 改写为三段;探针默认用各客户端默认模型。 - 决策(Q2–Q11 均采纳推荐项):写入前预览走 plan → digest 确认 → apply;bypassPermissions 默认值保持现状但在 plan 与报告中单列、可按项目取消;Codex 信任列入 next_actions,炼境不写 ~/.codex 信任表;L3 只在显式触发时跑,建议在 canary(enterprise)项目、指纹变化时跑;做 register_project 的全局路由投影;A4 先于 P4b;CLI 只做 pnpm probe:clients 薄脚本;A1 改写为三段;探针默认用各客户端默认模型。
- 非目标:不自动 commit/push;不自动建 Gitea 仓库、webhook、CI,不自动装工具链(只列 next_actions,Gitea 一项注明「工具默认建公开仓库」);不改客户端全局安全设置,不覆盖手写同名 MCP 配置;L3 不作接入门槛、不作 CI 闸门;不做离线 CLI 写入,不拆 core crate;P8 不改接入包模板;批量登记不自动接入。 - 非目标:不自动 commit/push;不自动建 Gitea 仓库、webhook、CI,不自动装工具链(只列 next_actions,Gitea 一项注明「工具默认建公开仓库」);不改客户端全局安全设置,不覆盖手写同名 MCP 配置;L3 不作接入门槛、不作 CI 闸门;不做离线 CLI 写入,不拆 core crate;P8 不改接入包模板;批量登记不自动接入。
- 为什么:2026-10-01 Enterprise 验收时,接入散落在 inject_mcp、apply_onboarding_pack、verify_onboarding 与手工探针多个步骤。按「分发 vs 查询」:随仓库走的文件由炼境分发一次、按版本升级;与机器相关的客户端注册由炼境在本机维护、不进仓库;易变信息走 MCP 查询。默认三端都接入(成本小,保留随时换客户端的能力);能用标准的不做专门适配(Codex、DSH 原生读 AGENTS.md 与 .agents/skills,只有 Claude 需要 CLAUDE.md 与 .claude/skills 投影);炼境离线时规则与 skill 仍可用。 - 为什么:2026-10-01 Enterprise 验收时,接入散落在 inject_mcp、apply_onboarding_pack、verify_onboarding 与手工探针多个步骤。按「分发 vs 查询」:随仓库走的文件由炼境分发一次、按版本升级;与机器相关的客户端注册由炼境在本机维护、不进仓库;易变信息走 MCP 查询。默认三端都接入(成本小,保留随时换客户端的能力);能用标准的不做专门适配(Codex、DSH 原生读 AGENTS.md 与 .agents/skills,只有 Claude 需要 CLAUDE.md 与 .claude/skills 投影);炼境离线时规则与 skill 仍可用。
- e2e_verify: "2026-10-03 22:5x 统筹会话端到端(炼境 d7f4816 重编译后经全局 MCP):新建临时 git 仓库 E:code-projectlj-p8-e2e-20261003 → register_project 得 project_id=ac73a4bb-a601-4e21-bc0f-7eda71fae4aa(目录落库为规范反斜杠形式;换大小写/正斜杠/尾分隔符再登记被拒并给出已有 ID)→ plan_onboarding:文件 create 14、本机 token/claude/codex/dsh/product_group_buff/git_hooks=apply、shim=noop、阻断 0、bypass_permissions=true、codex_trust=untrusted(进 next_actions)→ onboard_project(expected_digest=bb60bf69…, confirmed=true) 7.9 s:status=done,9 步全收敛,completion 全 ready(AGENTS/git-workflow 管理块最新、身份、能力包 1.9.0、两份 skill、Codex MCP 块、lefthook 挂载与检查段、Claude local、Codex 托管块、DSH 白名单、L1 适用格、改动可报告、HEAD 不变),L1:Claude 2.1.90 与 DSH 0.2.0-rc.2 各 6/6 ready,Codex C–F 4 格 codex_project_untrusted 单列 pending_user(统筹决定 ⑩);14 个接入文件留待提交、HEAD 不变 → 再次 plan:文件全 noop、七步全 noop(digest 83479aa5…)→ 再次 onboard_project 3.0 s:status=done,9 步全 converged,written_files 为空,14 个文件 mtime 全不变;verify_onboarding 10/12(origin、CI 两项按设计进 next_actions),clients 三端 converged,runtime ready。 human_verify 待用户:在 Claude Code、Codex(先信任该目录)、DSH 桌面 GUI 各新开会话调 read_project_test_account(name=LJ_PROBE_NONEXISTENT) 得「开发需求未登记」;P8g 界面终验。"
### ✅ P8-0 — 蓝图与依赖修正 ### ✅ P8-0 — 蓝图与依赖修正
- status: done - status: done
@ -297,8 +299,8 @@ skill 只是五个接入面之一,兼容层覆盖全部五面。
- merge_verify: "2026-10-03 统筹会话:PR #39(2f2a9f1,CI passed;独立审查 10 条:6 修、1 部分修、2 登记/转指引、1 转统筹)合并为 d018d44,合并结果全量 cargo test 402 passed / 0 failed / 6 ignored。acceptance ①–⑨ 均为 cargo onboard::apply 层,据此标 ✅;端到端(新登记项目 plan → onboard_project)随 P8e 合并后由统筹实测。统筹决定(审查 ⑩):codex_project_untrusted 按设计 Q5 计为 next_action、不计入 done(只放宽这一种原因),非 git 目录维持不能 done(acceptance ⑥),子目录与 worktree 补 next_action 说明——由 P8e 实现。" - merge_verify: "2026-10-03 统筹会话:PR #39(2f2a9f1,CI passed;独立审查 10 条:6 修、1 部分修、2 登记/转指引、1 转统筹)合并为 d018d44,合并结果全量 cargo test 402 passed / 0 failed / 6 ignored。acceptance ①–⑨ 均为 cargo onboard::apply 层,据此标 ✅;端到端(新登记项目 plan → onboard_project)随 P8e 合并后由统筹实测。统筹决定(审查 ⑩):codex_project_untrusted 按设计 Q5 计为 next_action、不计入 done(只放宽这一种原因),非 git 目录维持不能 done(acceptance ⑥),子目录与 worktree 补 next_action 说明——由 P8e 实现。"
- 统筹决定落地(审查 ⑩,2026-10-03,P8e 实现,详见 P8e 卡):codex_project_untrusted 视为 next_action、不阻断 done——L1 的 Codex 列里仅因 cause=codex_project_untrusted 未就绪的格不计入「L1 适用格」,completion 单列一项「Codex 信任」(source=l1、ready=false、新增字段 pending_user=true,不计入 done),next_actions 保留一条 codex_trust(计划已列不重复;计划预判已信任而 L1 仍显示未信任时补一条)——设计 Q5:炼境不写 Codex 信任表。其余原因的 Codex 格(含 blocked)照常计入;L1Report.all_applicable_ready 保持 L1 自身的原始判定。非 git 目录维持不能 done(acceptance ⑥);仓库子目录与 worktree / 子模块(.git 为文件)补 next_action repo_layout,说明「lefthook hook 挂载」只认项目根 .git/hooks、按当前口径到不了 done,并给出外层仓库根或实际 hooks 目录与怎样才能 done。由此 known_limits ④「Codex 未信任 → partial」改为 done + pending_user;⑤ 的判定口径不变,只补说明。 - 统筹决定落地(审查 ⑩,2026-10-03,P8e 实现,详见 P8e 卡):codex_project_untrusted 视为 next_action、不阻断 done——L1 的 Codex 列里仅因 cause=codex_project_untrusted 未就绪的格不计入「L1 适用格」,completion 单列一项「Codex 信任」(source=l1、ready=false、新增字段 pending_user=true,不计入 done),next_actions 保留一条 codex_trust(计划已列不重复;计划预判已信任而 L1 仍显示未信任时补一条)——设计 Q5:炼境不写 Codex 信任表。其余原因的 Codex 格(含 blocked)照常计入;L1Report.all_applicable_ready 保持 L1 自身的原始判定。非 git 目录维持不能 done(acceptance ⑥);仓库子目录与 worktree / 子模块(.git 为文件)补 next_action repo_layout,说明「lefthook hook 挂载」只认项目根 .git/hooks、按当前口径到不了 done,并给出外层仓库根或实际 hooks 目录与怎样才能 done。由此 known_limits ④「Codex 未信任 → partial」改为 done + pending_user;⑤ 的判定口径不变,只补说明。
### 🔵 P8e — 投影收口与契约同步 ### ✅ P8e — 投影收口与契约同步
- status: in_progress - status: done
- complexity: S - complexity: S
- files: src-tauri/src/mcp_tools.rs, src-tauri/src/lib.rs, src/lib/commands.ts, docs/ai-context/project-context.yaml, docs/ai-context/agent-button-system.md, AGENTS.md(实际另含 src-tauri/src/commands/onboarding.rs(Tauri command 本身)、src-tauri/src/mcp_inject.rs(去掉生产入口的 dead_code 标注)、src-tauri/src/onboard/report.rs、onboard/apply.rs、onboard/apply/tests.rs(统筹决定 ⑩)) - files: src-tauri/src/mcp_tools.rs, src-tauri/src/lib.rs, src/lib/commands.ts, docs/ai-context/project-context.yaml, docs/ai-context/agent-button-system.md, AGENTS.md(实际另含 src-tauri/src/commands/onboarding.rs(Tauri command 本身)、src-tauri/src/mcp_inject.rs(去掉生产入口的 dead_code 标注)、src-tauri/src/onboard/report.rs、onboard/apply.rs、onboard/apply/tests.rs(统筹决定 ⑩))
- depends: P8d - depends: P8d
@ -309,9 +311,10 @@ skill 只是五个接入面之一,兼容层覆盖全部五面。
- verification: "2026-10-03:全量 cargo test 413 passed / 0 failed / 6 ignored(master 402,新增 11 条),编译 0 warning;改动的 Rust 文件 rustfmt --check(skip_children)无差异;pnpm typecheck 通过,pnpm test(vitest)4 文件 16 条通过。cargo test mcp_tools 40 条通过,其中 P8e 新增 5 条:onboarding_tools_are_on_both_routes_with_confirmation_contract(全局与项目路由 tools/list 都含两工具;plan required=[project_id],onboard_project required 含 project_id、expected_digest、confirmed 且 confirmed 为 boolean;plan readOnly+idempotent+非破坏,apply 非只读+idempotent+非破坏+非 openWorld;两工具都有 bypass_permissions / skip_targets 且描述含 manual_entry、shared_key;描述含「给用户看」「用户明确确认」「在 Codex 里信任」「公开仓库」「private=true」;排在 apply_onboarding_pack 之前且相邻;项目路由 project_id 为 const=p1、不在 required,onboard_project required 为 [expected_digest, confirmed])、onboarding_tools_on_project_route_reject_cross_project_before_io(项目路由传 project_id=p2 两工具都 isError + structuredContent.code=scope_violation、文案含「绑定 project_id=p1」)、onboard_options_follow_schema_names_and_default(按 schema 声明的选项名构造入参解析正确;缺省与 null 为默认;两工具选项参数完全一致;三种类型错误文案)、onboarding_tools_reject_malformed_arguments_before_io(全局与项目路由:skip_targets 非数组、confirmed 非布尔、expected_digest 非字符串、bypass_permissions 非布尔均在 IO 前报错)、onboarding_responses_carry_structured_content_and_one_line_summary(序列化真实 OnboardingPlan / OnboardReport:structuredContent 原样、摘要含计数、本机步骤、阻断与 skip_targets 提示、digest、待提交接入文件数与 next_actions;status=done 不带 isError)。onboard::report 新增 4 条:codex_trust_only_cells_are_pending_user_and_do_not_block_done(Codex 列 C–F 只因未信任 → done、L1 适用格 ready、单列 1 项 pending_user、补 1 条 codex_trust、计划已列不重复、全就绪时无 pending 项)、other_not_ready_cells_still_block_done(Codex 列混入 auth_failed、别的列出现同一归因、Codex 列 blocked(dependency)、其他 L0 未就绪 → 均 partial)、repo_layout_next_action_explains_why_done_is_unreachable、repo_layout_detects_root_subdirectory_worktree_and_non_git(真实 git 仓库、子目录、git worktree 与普通目录)。onboard::apply 新增 2 条(测试替身 FakeRunner 增加 Codex 自省模拟、FakeLocator 可定位 Codex,lefthook 替身改为装到 git --git-path hooks 与真实 lefthook 一致):codex_untrusted_cells_are_pending_user_and_do_not_block_done(经真实 L1 判定链:codex mcp get 找不到 → C–F 为 codex_project_untrusted → status=done、pending_user 1 项、codex_trust 1 条;计划预判已信任时 L1 结论补 1 条;生效为全局地址 → partial、无 pending 项)、worktree_project_is_partial_and_next_action_explains_why(真实 git worktree:hook 装在主仓库,未就绪的只有「lefthook hook 挂载」,repo_layout 1 条,重跑同样 partial 且 lefthook 再跑);既有 project_in_repo_subdirectory_does_not_touch_outer_hooks 补断言(唯一障碍为 lefthook hook 挂载,repo_layout 含外层仓库名),first_apply 补断言(仓库根无 repo_layout、无 pending 项)。变异验证(全部改动先已 git add 暂存,用 Edit 注入、跑 cargo test --lib -- mcp_tools onboard:: commands::projects、git checkout 从暂存区还原,未用 sed)三轮 10 处全部被杀且失败集合与预期一致:第一轮 4 处——onboard_project 移出幂等列表、plan_onboarding 移出 STRUCTURED_TOOLS、l1_readiness 不限 Codex 列、repo_layout_next_action 恒为 None——恰好 6 条失败(路由契约、摘要、other_not_ready、repo_layout 说明及子目录 / worktree 两条 apply 用例)、126 条通过;第二轮 3 处——onboard_project 不进项目路由、done 判定不跳过 pending_user、.git 为文件也判仓库根——恰好 7 条失败、125 条通过;第三轮 2 处——L1 结论不补 codex_trust、选项解析丢弃 skip_targets——恰好 3 条失败、129 条通过。避开会绕过 IO 前校验的变异(如去掉 scope 绑定、去掉类型检查),以免测试进程调到生产入口。" - verification: "2026-10-03:全量 cargo test 413 passed / 0 failed / 6 ignored(master 402,新增 11 条),编译 0 warning;改动的 Rust 文件 rustfmt --check(skip_children)无差异;pnpm typecheck 通过,pnpm test(vitest)4 文件 16 条通过。cargo test mcp_tools 40 条通过,其中 P8e 新增 5 条:onboarding_tools_are_on_both_routes_with_confirmation_contract(全局与项目路由 tools/list 都含两工具;plan required=[project_id],onboard_project required 含 project_id、expected_digest、confirmed 且 confirmed 为 boolean;plan readOnly+idempotent+非破坏,apply 非只读+idempotent+非破坏+非 openWorld;两工具都有 bypass_permissions / skip_targets 且描述含 manual_entry、shared_key;描述含「给用户看」「用户明确确认」「在 Codex 里信任」「公开仓库」「private=true」;排在 apply_onboarding_pack 之前且相邻;项目路由 project_id 为 const=p1、不在 required,onboard_project required 为 [expected_digest, confirmed])、onboarding_tools_on_project_route_reject_cross_project_before_io(项目路由传 project_id=p2 两工具都 isError + structuredContent.code=scope_violation、文案含「绑定 project_id=p1」)、onboard_options_follow_schema_names_and_default(按 schema 声明的选项名构造入参解析正确;缺省与 null 为默认;两工具选项参数完全一致;三种类型错误文案)、onboarding_tools_reject_malformed_arguments_before_io(全局与项目路由:skip_targets 非数组、confirmed 非布尔、expected_digest 非字符串、bypass_permissions 非布尔均在 IO 前报错)、onboarding_responses_carry_structured_content_and_one_line_summary(序列化真实 OnboardingPlan / OnboardReport:structuredContent 原样、摘要含计数、本机步骤、阻断与 skip_targets 提示、digest、待提交接入文件数与 next_actions;status=done 不带 isError)。onboard::report 新增 4 条:codex_trust_only_cells_are_pending_user_and_do_not_block_done(Codex 列 C–F 只因未信任 → done、L1 适用格 ready、单列 1 项 pending_user、补 1 条 codex_trust、计划已列不重复、全就绪时无 pending 项)、other_not_ready_cells_still_block_done(Codex 列混入 auth_failed、别的列出现同一归因、Codex 列 blocked(dependency)、其他 L0 未就绪 → 均 partial)、repo_layout_next_action_explains_why_done_is_unreachable、repo_layout_detects_root_subdirectory_worktree_and_non_git(真实 git 仓库、子目录、git worktree 与普通目录)。onboard::apply 新增 2 条(测试替身 FakeRunner 增加 Codex 自省模拟、FakeLocator 可定位 Codex,lefthook 替身改为装到 git --git-path hooks 与真实 lefthook 一致):codex_untrusted_cells_are_pending_user_and_do_not_block_done(经真实 L1 判定链:codex mcp get 找不到 → C–F 为 codex_project_untrusted → status=done、pending_user 1 项、codex_trust 1 条;计划预判已信任时 L1 结论补 1 条;生效为全局地址 → partial、无 pending 项)、worktree_project_is_partial_and_next_action_explains_why(真实 git worktree:hook 装在主仓库,未就绪的只有「lefthook hook 挂载」,repo_layout 1 条,重跑同样 partial 且 lefthook 再跑);既有 project_in_repo_subdirectory_does_not_touch_outer_hooks 补断言(唯一障碍为 lefthook hook 挂载,repo_layout 含外层仓库名),first_apply 补断言(仓库根无 repo_layout、无 pending 项)。变异验证(全部改动先已 git add 暂存,用 Edit 注入、跑 cargo test --lib -- mcp_tools onboard:: commands::projects、git checkout 从暂存区还原,未用 sed)三轮 10 处全部被杀且失败集合与预期一致:第一轮 4 处——onboard_project 移出幂等列表、plan_onboarding 移出 STRUCTURED_TOOLS、l1_readiness 不限 Codex 列、repo_layout_next_action 恒为 None——恰好 6 条失败(路由契约、摘要、other_not_ready、repo_layout 说明及子目录 / worktree 两条 apply 用例)、126 条通过;第二轮 3 处——onboard_project 不进项目路由、done 判定不跳过 pending_user、.git 为文件也判仓库根——恰好 7 条失败、125 条通过;第三轮 2 处——L1 结论不补 codex_trust、选项解析丢弃 skip_targets——恰好 3 条失败、129 条通过。避开会绕过 IO 前校验的变异(如去掉 scope 绑定、去掉类型检查),以免测试进程调到生产入口。"
- 有意偏差:"① dispatch 的一行委托指向 mcp_tools 内的 plan_onboarding_call / onboard_project_call,再由它们调 mcp_inject 入口:中间只做 JSON 类型解析(类型错误须在任何 IO 之前报错,且与 register_project 的分发写法一致),判定仍全在本体。② onboard_project 的 annotations 为非只读、非破坏、幂等(重复执行收敛)、非 openWorld(只写本机与子项目文件、不出网);plan_onboarding 靠既有 plan_ 前缀规则得 readOnly。③ 统筹决定 ⑩ 的 pending_user 做成 CompletionItem 的通用布尔字段(serde default,目前只有「Codex 信任」一项会置 true),而不是新增 completion 来源;L1 适用格的 detail 注明有几格单列出去。④ 仓库子目录与 worktree 的 next_action 统一名为 repo_layout,同时提示「origin 指向 Gitea」也只读项目根 .git/config(同类口径问题,只说明、不改 verify);子模块与 worktree 同属「.git 为文件」一类,文案按 worktree 写。⑤ 非 git 目录不给 repo_layout(由 completion「项目文件改动可报告」未就绪说明,acceptance ⑥ 不变)。⑥ files 比卡片多,见 files。" - 有意偏差:"① dispatch 的一行委托指向 mcp_tools 内的 plan_onboarding_call / onboard_project_call,再由它们调 mcp_inject 入口:中间只做 JSON 类型解析(类型错误须在任何 IO 之前报错,且与 register_project 的分发写法一致),判定仍全在本体。② onboard_project 的 annotations 为非只读、非破坏、幂等(重复执行收敛)、非 openWorld(只写本机与子项目文件、不出网);plan_onboarding 靠既有 plan_ 前缀规则得 readOnly。③ 统筹决定 ⑩ 的 pending_user 做成 CompletionItem 的通用布尔字段(serde default,目前只有「Codex 信任」一项会置 true),而不是新增 completion 来源;L1 适用格的 detail 注明有几格单列出去。④ 仓库子目录与 worktree 的 next_action 统一名为 repo_layout,同时提示「origin 指向 Gitea」也只读项目根 .git/config(同类口径问题,只说明、不改 verify);子模块与 worktree 同属「.git 为文件」一类,文案按 worktree 写。⑤ 非 git 目录不给 repo_layout(由 completion「项目文件改动可报告」未就绪说明,acceptance ⑥ 不变)。⑥ files 比卡片多,见 files。"
- 没验什么:"① acceptance 的 [MCP 全局](对 enterprise 做 plan 全部 noop、apply done 且各步 converged)与 P8f 的 register_project → plan_onboarding → onboard_project 链路:需合并后在运行中的炼境重编译再调写工具,按授权规则由统筹会话实测,本卡保持 🔵。② Tauri command 两个薄包装与 commands.ts 封装没有自动化测试、没在 UI 里调过(P8g 才有界面),只由 pnpm typecheck 与类型逐字段对照保证;Tauri 入参 options 的 camelCase / snake_case 映射(顶层参数 camelCase、OnboardOptions 内部字段 snake_case)按 Tauri 约定推断,未实机验证。③ MCP 客户端侧的工具超时:首次一键接入可能 30 秒以上,Codex 默认 tool_timeout_sec 等客户端限制没有实测。④ repo_layout 的 git rev-parse 与报告里其他 git 观测一样直接起 git、无超时(P8d known_limits ① 同类)。⑤ 统筹决定的 done 判定只在测试替身与单元层验证;真实 Codex 未信任目录的端到端(L1 显示 codex_project_untrusted → done + pending_user)待统筹实测。⑥ 本卡未做独立审查(S 级)。" - 没验什么:"① acceptance 的 [MCP 全局](对 enterprise 做 plan 全部 noop、apply done 且各步 converged)与 P8f 的 register_project → plan_onboarding → onboard_project 链路:需合并后在运行中的炼境重编译再调写工具,按授权规则由统筹会话实测,本卡保持 🔵。② Tauri command 两个薄包装与 commands.ts 封装没有自动化测试、没在 UI 里调过(P8g 才有界面),只由 pnpm typecheck 与类型逐字段对照保证;Tauri 入参 options 的 camelCase / snake_case 映射(顶层参数 camelCase、OnboardOptions 内部字段 snake_case)按 Tauri 约定推断,未实机验证。③ MCP 客户端侧的工具超时:首次一键接入可能 30 秒以上,Codex 默认 tool_timeout_sec 等客户端限制没有实测。④ repo_layout 的 git rev-parse 与报告里其他 git 观测一样直接起 git、无超时(P8d known_limits ① 同类)。⑤ 统筹决定的 done 判定只在测试替身与单元层验证;真实 Codex 未信任目录的端到端(L1 显示 codex_project_untrusted → done + pending_user)待统筹实测。⑥ 本卡未做独立审查(S 级)。"
- mcp_verify: "PR #40(97578b2,CI passed,独立审查可合并:3 低 5 信息转后续)合并为 d7f4816。2026-10-03 22:5x 统筹会话端到端(炼境 d7f4816 重编译后经全局 MCP):新建临时 git 仓库 E:code-projectlj-p8-e2e-20261003 → register_project 得 project_id=ac73a4bb-a601-4e21-bc0f-7eda71fae4aa(目录落库为规范反斜杠形式;换大小写/正斜杠/尾分隔符再登记被拒并给出已有 ID)→ plan_onboarding:文件 create 14、本机 token/claude/codex/dsh/product_group_buff/git_hooks=apply、shim=noop、阻断 0、bypass_permissions=true、codex_trust=untrusted(进 next_actions)→ onboard_project(expected_digest=bb60bf69…, confirmed=true) 7.9 s:status=done,9 步全收敛,completion 全 ready(AGENTS/git-workflow 管理块最新、身份、能力包 1.9.0、两份 skill、Codex MCP 块、lefthook 挂载与检查段、Claude local、Codex 托管块、DSH 白名单、L1 适用格、改动可报告、HEAD 不变),L1:Claude 2.1.90 与 DSH 0.2.0-rc.2 各 6/6 ready,Codex C–F 4 格 codex_project_untrusted 单列 pending_user(统筹决定 ⑩);14 个接入文件留待提交、HEAD 不变 → 再次 plan:文件全 noop、七步全 noop(digest 83479aa5…)→ 再次 onboard_project 3.0 s:status=done,9 步全 converged,written_files 为空,14 个文件 mtime 全不变;verify_onboarding 10/12(origin、CI 两项按设计进 next_actions),clients 三端 converged,runtime ready。 偏差报备:acceptance 写的对 enterprise「plan 全 noop、apply 全 converged」——enterprise 的 plan 如实给出 update 3(两份 skill 与 capability-packs 待从 1.8.0 升 1.9.0,因其主工作区本地 main 落后 origin/main),按执行铁律不对他会话在制的工作区 apply;同一组断言(计划全 noop、apply 全 converged、mtime 不变)改在上述新登记项目上实测通过。enterprise 主工作区同步后再 plan 即应全 noop。"
### 🔵 P8f — register_project 控制面投影 ### ✅ P8f — register_project 控制面投影
- status: in_progress - status: done
- complexity: S - complexity: S
- files: src-tauri/src/commands/projects.rs, src-tauri/src/mcp_tools.rs, src-tauri/src/commands/templates.rs(实施扩展), src-tauri/src/commands/git_repos.rs(实施扩展), src/components/dashboard/BatchAddModal.tsx(实施扩展), src-tauri/src/mcp_inject.rs(审查处置:路径键两函数改 pub(crate) 供复用), docs/ai-context/project-context.yaml(T1) - files: src-tauri/src/commands/projects.rs, src-tauri/src/mcp_tools.rs, src-tauri/src/commands/templates.rs(实施扩展), src-tauri/src/commands/git_repos.rs(实施扩展), src/components/dashboard/BatchAddModal.tsx(实施扩展), src-tauri/src/mcp_inject.rs(审查处置:路径键两函数改 pub(crate) 供复用), docs/ai-context/project-context.yaml(T1)
- depends: P8-0 - depends: P8-0
@ -327,14 +330,20 @@ skill 只是五个接入面之一,兼容层覆盖全部五面。
- 有意偏差:① 未加 confirmed 参数——任务要求是「描述写明写操作须用户确认目标」;登记只写炼境 DB、可经 unregister_project 撤销,按 unregister_project 的先例只在描述里约束。② MCP 不收 project_id,统一由炼境生成 UUID,避免 agent 自拟 ID 与已有命名冲突。③ 重复目录检查扩到批量添加、模板新建、挂载仓库三个新建入口(files 标「实施扩展」):PR #34 审查 L1/L2 的根因是同一目录多条登记,只堵 create_project 和 MCP 两个入口治不了根;编辑入口 update_project 仍未堵(审查 I1,转后续小修)。 - 有意偏差:① 未加 confirmed 参数——任务要求是「描述写明写操作须用户确认目标」;登记只写炼境 DB、可经 unregister_project 撤销,按 unregister_project 的先例只在描述里约束。② MCP 不收 project_id,统一由炼境生成 UUID,避免 agent 自拟 ID 与已有命名冲突。③ 重复目录检查扩到批量添加、模板新建、挂载仓库三个新建入口(files 标「实施扩展」):PR #34 审查 L1/L2 的根因是同一目录多条登记,只堵 create_project 和 MCP 两个入口治不了根;编辑入口 update_project 仍未堵(审查 I1,转后续小修)。
- T1:新 MCP 工具 register_project 已同步 docs/ai-context/project-context.yaml「MCP 工具接口」段(paths 补 projects.rs,doc 补路由、本体、同目录判定、落库规范化、UI 占位例外、warning 与入参语义,以及 scan_unregistered_projects 与 mount_repo 的同口径);Tauri command 签名未变,src/lib/commands.ts 无需改动。 - T1:新 MCP 工具 register_project 已同步 docs/ai-context/project-context.yaml「MCP 工具接口」段(paths 补 projects.rs,doc 补路由、本体、同目录判定、落库规范化、UI 占位例外、warning 与入参语义,以及 scan_unregistered_projects 与 mount_repo 的同口径);Tauri command 签名未变,src/lib/commands.ts 无需改动。
- review: "2026-10-03 独立只读审查 bd4ebaf,结论 fix_then_merge,10 条发现处置:M1 [中] MCP 入参原样落库(正斜杠、尾部分隔符、长路径前缀、8.3、`..`),scan_unregistered_projects 按字面比较会自相矛盾 → 已修:本体对 Windows 目录 canonicalize 后去长路径前缀落库,register_project_at 回执 path 为落库值、名称缺省按规范形式取目录名(相对路径不 canonicalize,交本体拒绝);scan 的已登记判定与父目录去重改用 registration_path_key。M2 [中] UI 不选目录的概念占位被取消,超出 P8f 范围且与 mcp-server 模块记录的用户用法冲突 → 已恢复原行为:本体新增 RootRequirement,UI 入口有效路径为空时只写 profile+workspace、不校验目录、不查重复,MCP 入口仍拒绝;是否改为显式占位概念交统筹会话问用户(需求澄清),本 PR 不预设答案。L1 [低] 已有登记两列都比,残留列误拦 → 已修:按 platform 只取有效根目录(registration_root),查询补 platform 列。L2 [低] 8.3、`..`、末尾点等漏判 → 已修:新目录在写事务外另算 canonical 键,两键比对已有行的字面键(已有行不读磁盘,写锁内无 I/O)。L3 [低] mount_repo 检查在插 profile 之后且无事务 → 已修:抽 mount_repo_records(连接注入),检查前移、整体 IMMEDIATE 事务;前端先 gitClone 再 mount 的白克隆属 UI 范围,未改。L4 [低] 路径比较键多份实现 → 部分修:registration_path_key 改为复用 mcp_inject::normalize_dsh_root + strip_verbatim_prefix(两函数改 pub(crate));normalize_trust_path、WSL 发行版查询与 UNC 换算的第三份拷贝统一抽 crate::path_key 转后续小修(会动 P4a/P8d 热点 mcp_inject.rs)。I1 [信息] update_project 仍可造同目录登记 → 转后续小修:UI 编辑整表提交,须「有效根目录实际变化才检查 + 排除自身」,否则存量重复登记(beast-mode)连改名都会被拦,单独做更稳。I2 [信息] project_root_with_conn 对 UNC 形式的 wsl_path 错误拼接(已有缺陷)→ 不在本 PR 改(mcp_inject.rs 热点),转后续小修;卡片与代码注释里「同口径」改为只指取列与 Linux 路径换算。I3 [信息] 重登目录遗留旧 context.json 无提示 → 已修:register_project_at 只读检查,project_id 不同时回执与摘要带 warning(不沿用旧 ID)。I4 [信息] 分发分支无测试 → 已修:分发抽成 register_project_call(conn, args),测试按 schema 声明的参数名构造入参;IMMEDIATE 并发仍无测试(见没验什么③)。" - review: "2026-10-03 独立只读审查 bd4ebaf,结论 fix_then_merge,10 条发现处置:M1 [中] MCP 入参原样落库(正斜杠、尾部分隔符、长路径前缀、8.3、`..`),scan_unregistered_projects 按字面比较会自相矛盾 → 已修:本体对 Windows 目录 canonicalize 后去长路径前缀落库,register_project_at 回执 path 为落库值、名称缺省按规范形式取目录名(相对路径不 canonicalize,交本体拒绝);scan 的已登记判定与父目录去重改用 registration_path_key。M2 [中] UI 不选目录的概念占位被取消,超出 P8f 范围且与 mcp-server 模块记录的用户用法冲突 → 已恢复原行为:本体新增 RootRequirement,UI 入口有效路径为空时只写 profile+workspace、不校验目录、不查重复,MCP 入口仍拒绝;是否改为显式占位概念交统筹会话问用户(需求澄清),本 PR 不预设答案。L1 [低] 已有登记两列都比,残留列误拦 → 已修:按 platform 只取有效根目录(registration_root),查询补 platform 列。L2 [低] 8.3、`..`、末尾点等漏判 → 已修:新目录在写事务外另算 canonical 键,两键比对已有行的字面键(已有行不读磁盘,写锁内无 I/O)。L3 [低] mount_repo 检查在插 profile 之后且无事务 → 已修:抽 mount_repo_records(连接注入),检查前移、整体 IMMEDIATE 事务;前端先 gitClone 再 mount 的白克隆属 UI 范围,未改。L4 [低] 路径比较键多份实现 → 部分修:registration_path_key 改为复用 mcp_inject::normalize_dsh_root + strip_verbatim_prefix(两函数改 pub(crate));normalize_trust_path、WSL 发行版查询与 UNC 换算的第三份拷贝统一抽 crate::path_key 转后续小修(会动 P4a/P8d 热点 mcp_inject.rs)。I1 [信息] update_project 仍可造同目录登记 → 转后续小修:UI 编辑整表提交,须「有效根目录实际变化才检查 + 排除自身」,否则存量重复登记(beast-mode)连改名都会被拦,单独做更稳。I2 [信息] project_root_with_conn 对 UNC 形式的 wsl_path 错误拼接(已有缺陷)→ 不在本 PR 改(mcp_inject.rs 热点),转后续小修;卡片与代码注释里「同口径」改为只指取列与 Linux 路径换算。I3 [信息] 重登目录遗留旧 context.json 无提示 → 已修:register_project_at 只读检查,project_id 不同时回执与摘要带 warning(不沿用旧 ID)。I4 [信息] 分发分支无测试 → 已修:分发抽成 register_project_call(conn, args),测试按 schema 声明的参数名构造入参;IMMEDIATE 并发仍无测试(见没验什么③)。"
- mcp_verify: "PR #37 合并(55dc637);P8e 合并后经全局 MCP 实测链路 register_project → plan_onboarding → onboard_project 得 status=done(证据同 P8e mcp_verify);同目录换写法再登记被拒并给出已有 project_id。"
### 📋 P8g — UI 一键接入 ### ✅ P8g — UI 一键接入
- status: todo - status: done
- merge_verify: "PR #41 CI passed(head c28caf72ee94a2ce9c749de941d9c43ffafc33ee,核对完整 SHA 后合并)→ master 3228b49:pnpm typecheck 通过;pnpm test 5 文件 29 passed(含 onboardView 13 条);全量 cargo test 414 passed / 0 failed / 6 ignored(另一测试二进制 1 passed)。agent_verify 全部达成。"
- human_verify: "2026-10-04 用户终验通过(临时 git 仓库 E:\\code-project\\lj-p8g-ui-test,project_id 5818aa5a-7789-4f4d-a0b3-3b2d433d0a8c):① 「+ 添加项目」选目录保存后弹出接入预览(14 个新建文件、bypassPermissions 与 Codex 信任单列、本机七步、无阻断);③ 在预览里取消,目录 git status 为空、零改动;② 经蓝图治理「一键接入」确认后 7.7 秒得 done(9 步收敛),分步结果、L1 矩阵(Claude/DSH 各 6 格就绪,Codex C–F 待你信任)、「待你提交的 14 个文件」与磁盘一致、HEAD 未变、lefthook 三个钩子已挂;用户在 Codex 桌面版该目录发起对话后信任表写入,重跑 probe_client_parity 三端 18 格 ready、all_applicable_ready=true(Codex 桌面版只「添加项目」不写信任);④ Claude Code、Codex、DSH 桌面 GUI 新会话调 read_project_test_account(LJ_PROBE_NONEXISTENT) 均得「开发需求未登记」(DSH 未传 project_id,会话按工作区绑定本项目)。终验中记下的 UI 文案小问题转后续小修:新建文件的「查看差异」只有一行概要应改行内显示;git_hooks 与 Claude/DSH 行的「已写入」标签重复或不准。"
- complexity: M - complexity: M
- files: src/components/dashboard/OnboardPanel.tsx, src/components/dashboard/onboardView.ts, src/components/dashboard/onboardView.test.ts, src/components/dashboard/ProjectModal.tsx, src/components/dashboard/BatchAddModal.tsx, src/components/manage/NewProjectModal.tsx, src/components/dashboard/BlueprintModal.tsx, src/lib/commands.ts - files: src/components/dashboard/OnboardPanel.tsx, src/components/dashboard/onboardView.ts, src/components/dashboard/onboardView.test.ts, src/components/dashboard/ProjectModal.tsx, src/components/dashboard/BatchAddModal.tsx, src/components/manage/NewProjectModal.tsx, src/components/dashboard/BlueprintModal.tsx, src/lib/commands.ts
- depends: P8e - depends: P8e
- acceptance: "agent_verify: [pnpm typecheck && pnpm test] 视图纯函数:blocked 非空时确认按钮禁用并列出文件和原因;not_installed 和 not_applicable 显示为灰色说明、不显示为红色失败;bypassPermissions 和 Codex 信任单独列出;确认时携带 expected_digest。human_verify: ① 用临时 git 仓库新建项目,弹出接入预览;② 确认后 30 秒内看到分步结果、L1 矩阵和「待你提交的 N 个文件」;③ 另试一次在预览里取消,目录零改动;④ 在该目录新开 Claude Code、Codex、DSH 桌面 GUI 会话调 LJ_PROBE_NONEXISTENT,得「开发需求未登记」。" - acceptance: "agent_verify: [pnpm typecheck && pnpm test] 视图纯函数:blocked 非空时确认按钮禁用并列出文件和原因;not_installed 和 not_applicable 显示为灰色说明、不显示为红色失败;bypassPermissions 和 Codex 信任单独列出;确认时携带 expected_digest。human_verify: ① 用临时 git 仓库新建项目,弹出接入预览;② 确认后 30 秒内看到分步结果、L1 矩阵和「待你提交的 N 个文件」;③ 另试一次在预览里取消,目录零改动;④ 在该目录新开 Claude Code、Codex、DSH 桌面 GUI 会话调 LJ_PROBE_NONEXISTENT,得「开发需求未登记」。"
- 说明:新建 / 模板创建成功后弹出「接入预览」,create_project 本身保持无副作用;批量添加只提供批量入口、不自动接入;BlueprintModal 的「应用接入包」改为先 plan 再 apply。 - 说明:新建 / 模板创建成功后弹出「接入预览」,create_project 本身保持无副作用;批量添加只提供批量入口、不自动接入;BlueprintModal 的「应用接入包」改为先 plan 再 apply。
- 实现(2026-10-04,分支 feat/agent-client-parity-p8g,统筹会话主线程直做——两次委派卡死于一次性生成大文件):onboardView.ts 视图纯函数(计划预览、确认请求、报告、L1 矩阵;判定全取后端字段);OnboardPanel.tsx 全局挂载于 App、经 useUIStore.openOnboard 打开(新建弹窗保存即卸载,面板须独立存在),状态机 planning → preview → applying → report,过期响应按请求序号丢弃、接入中不可关闭,refused 附新计划可回预览重新确认;plan.rs 的 BlockedItem 序列化附派生字段 skippable(可跳过判定只在本体,反序列化忽略、不进 digest),commands.ts 同步;入口:ProjectModal 新建且按 platform 的有效根目录非空才弹(概念占位不弹),NewProjectModal 模板创建成功自动弹、完成页可再开,BatchAddModal 添加后列出有目录的新项目逐个「一键接入」,BlueprintModal「施加 Buff」改为同一面板(buff 已激活时另给「重新检查接入」),关闭后按报告刷新 buff 与 init prompt;project-context.yaml 同步 skippable 与 UI 投影。
- 有意偏差:"① 呈现块拆到 OnboardSections.tsx(files 外新增,控制单文件规模)。② Toast 层级 z-50 → z-[70](审查 ②,否则接入提示被面板遮住)。③ 本地 confirm 函数改名 applyConfirmed:confirmUsage.test.ts 扫描 confirm( 防同步确认框,属正确的守卫。"
- review: "2026-10-04 独立只读审查 5b6c197,结论 merge,5 条:① [低] 新建入口按任一路径非空判是否弹面板,与后端按 platform 取有效根目录不同口径 → 已修。② [低] Toast z-50 被面板 z-[60] 遮住 → 已修。③ [低] 已有 permissions 又取消 bypass 时文案称会写 default → 已改文案(如实说明两种情况)。④ [信息] L1 格子着色在前端写死 codex_project_untrusted=待你操作,轻度复制判定 → 转后续小修(L1 格子带 pending_user 字段)。⑤ [信息] onboard_project 抛错后「取消」提示仍称不写入 → 已修(错误阶段换提示)。审查核实:确认带 plan.digest 与生成计划时的选项;refused 回预览时 planned 与新计划同一组选项(apply.rs 用请求选项重算);四条 agent_verify 有实断言。"
### ✅ P9 — DSH 桌面 GUI 按工作区连项目地址(会话级插件) ### ✅ P9 — DSH 桌面 GUI 按工作区连项目地址(会话级插件)
- status: done - status: done

View File

@ -13,6 +13,7 @@ id: blueprint-buff
- Buff 同步后顺手调用 `get_blueprint()`,内部触发 `append_usage_snapshot()`,使飞轮数据与实际开发进度对齐 - Buff 同步后顺手调用 `get_blueprint()`,内部触发 `append_usage_snapshot()`,使飞轮数据与实际开发进度对齐
- 使用文件路径匹配而非 commit message 解析,与 AI 工具/提交信息风格完全解耦 - 使用文件路径匹配而非 commit message 解析,与 AI 工具/提交信息风格完全解耦
- **files 重叠只作兜底(2026-10-02,B1)**:本批提交已有卡被显式推进(新增 🔵/✅/🔴 标题行)则不推断,整批无推进才视为「agent 忘了加锁」。原因:两阶段锁下在做的卡落地时已非 📋,files 重叠只能碰到未开工卡,精度结构性偏低。曾评估「提交说明引用卡 ID」——正文自由文本 4 次命中 3 次误判(「阶段二 N3/N4/N5 待启动」),结构化 trailer 又与上条解耦决策冲突且兜不住忘加锁场景,故不采用;「可能相关」改记 DB 信号不改卡片(方案 C)留作残余噪声持续时的升级路径 - **files 重叠只作兜底(2026-10-02,B1)**:本批提交已有卡被显式推进(新增 🔵/✅/🔴 标题行)则不推断,整批无推进才视为「agent 忘了加锁」。原因:两阶段锁下在做的卡落地时已非 📋,files 重叠只能碰到未开工卡,精度结构性偏低。曾评估「提交说明引用卡 ID」——正文自由文本 4 次命中 3 次误判(「阶段二 N3/N4/N5 待启动」),结构化 trailer 又与上条解耦决策冲突且兜不住忘加锁场景,故不采用;「可能相关」改记 DB 信号不改卡片(方案 C)留作残余噪声持续时的升级路径
- **剩余缺口与冻结(2026-10-04,MVP 收口 M2)**:manifest 曾记 86%,剩余 14% 起初判为未更新的进度数字;同日 B2 终验被否决(见 B2 卡),证明剩余是真实缺口——兜底推断的误标须按上条升级路径做方案 C(files 重叠改记 DB「可能相关」信号、不改卡片,L 级)。用户定:误标属噪声、不阻挡 MVP 四条能力,方案 C 冻结为扩展,模块保持 in_progress。
## 任务卡 ## 任务卡
@ -79,3 +80,5 @@ id: blueprint-buff
- 实现:infer_task_marks 增加第二个显式归属条件 edits_existing_lines——本批 .blueprint/modules patch 在 hunk 内有 `-` 行(删改既有内容)即视为 agent 在跟进维护,不推断;纯追加(新立 📋 卡、新模块)仍走兜底,保留「立卡即实现、忘了加锁」的捕获。 - 实现:infer_task_marks 增加第二个显式归属条件 edits_existing_lines——本批 .blueprint/modules patch 在 hunk 内有 `-` 行(删改既有内容)即视为 agent 在跟进维护,不推断;纯追加(新立 📋 卡、新模块)仍走兜底,保留「立卡即实现、忘了加锁」的捕获。
- verification: "2026-10-03:cargo test 284 passed / 0 failed / 5 ignored;buff 10 passed(新增 edits_existing_lines 单测与端到端 ⑧⑨);变异验证见 acceptance。回放 master 260 个 first-parent 批次:B1 下无推进 172 批,B2 新增抑制 27 批,其中含代码改动的 6 批:19b9388(本次误标)、8f3be6b、0d4c2ad、cbc1d46、23de433、0552180,其余为只改蓝图的 docs/chore 提交(本就不会命中代码卡);纯追加立卡的 9881b56、9c2064e、4f5cf43 保持兜底。" - verification: "2026-10-03:cargo test 284 passed / 0 failed / 5 ignored;buff 10 passed(新增 edits_existing_lines 单测与端到端 ⑧⑨);变异验证见 acceptance。回放 master 260 个 first-parent 批次:B1 下无推进 172 批,B2 新增抑制 27 批,其中含代码改动的 6 批:19b9388(本次误标)、8f3be6b、0d4c2ad、cbc1d46、23de433、0552180,其余为只改蓝图的 docs/chore 提交(本就不会命中代码卡);纯追加立卡的 9881b56、9c2064e、4f5cf43 保持兜底。"
- known_limits: "同批若只改写了无关 📋 卡的文字同时改代码且忘了加锁,B2 会少标(漏信号,不误标)。下次再出现误标时按 B1 决策记录升级到方案 C(files 重叠改记 DB「可能相关」信号,不改卡片,L 级)。" - known_limits: "同批若只改写了无关 📋 卡的文字同时改代码且忘了加锁,B2 会少标(漏信号,不误标)。下次再出现误标时按 B1 决策记录升级到方案 C(files 重叠改记 DB「可能相关」信号,不改卡片,L 级)。"
- human_verify: "2026-10-04 否决:主仓库 12:45 快进到 ef09ef2(只改 docs/tasks/2026-10-03-coordination.md,无蓝图改动)后约 1 分钟,buff 把 intent-catalog 未开工的 📋 IC10(files 含该文件)标为 🔵——无显式推进、files 共用即兜底命中,属 B1 known_limits「不更新蓝图的提交碰共享文件仍可能误标」。B1/B2 两道闸已生效但不足以消除此类误标。"
- 终验: 2026-10-04 否决:只改共用文档、不动蓝图的提交仍会把无关 📋 卡误标 🔵(实例 IC10)

View File

@ -0,0 +1,215 @@
# 意图目录(intent-catalog)
> status: in_progress | created: 2026-10-04 | 设计:docs/tasks/2026-10-04-intent-catalog-design.md(IC1 ✅,用户 2026-10-04 确认)| 指南:docs/ai-context/intent-catalog-guide.md(IC2 ✅)| 目录:.blueprint/catalog.md 1.0(IC3 ✅)| 下一步:IC5(P8 收口后首次真实 /goal)
> 来源:2026-10-03~04 与用户讨论(/goal 与 Loop Engineering 操作手册、目录/正文模型、承重墙),以及侦察工作流 wf_6dc3756a-b72 的重叠与冲突扫描。
## 概述
在蓝图之上加一层由人持有的意图目录 `.blueprint/catalog.md`:每章写意图、双坐标、不做什么和 rev;任务卡用 `- intent: INT-NN@X.Y` 单向挂靠。agent 据此编译可判定的 /goal,确认卡兼作最小任务简报,收口回执写进提交。试用期只新增文档,门控与接线排在 P8 收口后,按实测数据决定保留或撤销。
## 为什么
- 用户能给的是需求、意图方向和已知现状,不是评估器能判定的条件。/goal 这类无人值守 loop 需要可判定的终点,这一步翻译应由 agent 完成,但 agent 需要一个人持有、稳定的意图来源。
- 现状:意图散在 AGENTS.md「项目定位」、统筹文档 §0、设计文档的决策节、manifest description 和私有记忆里;manifest 的 areas 按技术层分区,不按意图方向。
- 实证:2026-09-30 的 `/goal 按照方针设计方向走,直到符合设计要求` 跑了 3 轮,评估器就以「设计已完成」为由判定达成并解除了 goal。评估器不读文件,条件只能写成可判定的终点。
- 与 `docs/tasks/2026-09-23-blueprint-agent-handoff-pilot.md` 的「项目工作账本 + 信息归属 + 最小任务简报」同构,应合并推进,不能分两处做。
## 模型(概念,待设计确认)
- **两层**:目录层由人持有,保持稳定;正文层是蓝图模块与任务卡,由 agent 维护。
- **书的比喻**:
- 前言是长期方针,只指向 AGENTS.md「项目定位」,不另抄一份。
- 每一章是一个意图方向。
- 章首导语写意图、双坐标(人看的投影坐标 + agent 可断言的坐标)和「不做什么」。
- 附录放现状指针、约束、决策与否决理由(勘误表)。
- 索引是稳定 ID,书签标出当前阶段。
- **定位**:它是全生命周期信息的骨架与索引,不是容器——**书装意图,指向事实**。代码、CI、状态、会话、凭据和环境都留在原生位置,书里只放可机器校验的指针;意图由人写,现状由机器采。
- **迭代**:
- 修订分三级:补丁指正文内的改动,agent 自主完成;小版本指调整章首坐标或由正文反推修改目录,agent 提案、人确认;大版本指增删章节或调整方向,由人主导。
- 配套机制:沿 ID 做影响分析;版本钉住,卡和 goal 记录自己编译自哪一版目录;保护在制品;修订历史回流飞轮。
- **/goal 的来源**:由架构 agent 从「当前章的验收坐标 + 本阶段卡的完成判定」编译,人确认后粘贴,粘贴这一下即确认。
## 承重墙(设计纲目)
agent 开发子项目时躲不掉的现象。每面墙都要回答四个问题:落在书的哪个部位、靠什么机制承重、怎样用机器检查它生效、什么情况下算拆除(拆除即撤销对应机制)。原则是能指向已有机制的,就不新建。
| 墙 | 已有承重机制(指向) | 待补 |
|---|---|---|
| W1 迭代 | 模块迭代记录与决策记录;能力包、托管块、模板指纹三重版本 | 目录版本层、修订分级、版本钉住;与 manifest.iteration 语义分开 |
| W2 遗忘 | 启动读蓝图;catchup/taskify;统筹文档 §0;复盘笔记 | 稳定入口回答「整体方向走到哪」;书签载体;方向与卡的双向索引 |
| W3 熵增 | 文档防腐 T1–T4;模板指纹测试;blueprint-gate;梦核蒸馏 | 指针可解析门控(只警告);禁止索引膨胀成正文 |
| W4 意图鸿沟 | 需求对齐协议与确认卡;Feature-Confirmed;双尺子;辩证收缩 | 章级意图与「不做什么」;卡挂回意图章 |
| W5 注意力稀缺 | 统筹三类找人;pending_user;回传只列待处置 | 跨章的「待人裁决」视图;书签由人确认 |
| W6 理解债 | 决策记录;复盘笔记;架构速查;导师上下文 | 从代码或模块反查「服务哪条意图」;关键决策摘要推送给人 |
| W7 自评偏差 | 两把尺子;「没验什么」;证据等级;独立/对抗审查;CI 兜底 | 章坐标标注证据等级;章完成只能推导,不能手动切换 |
| W8 不确定性 | R10 先实测;P4-0 假设证伪;三闸门 | 探索章(轮廓、试探、预算、收敛信号)→ 结晶为定型章;「假设:」指向既有的证伪落点(2026-10-04 修订) |
| W9 并发冲突 | 🔵 执行锁;每卡独立 worktree;串行队列;plan→digest→apply | 目录本身成为争用点;版本钉住复用 digest 语义 |
| W10 风险不对称 | 计划→确认→应用;confirmed=true;破坏性标注;凭据边界 | 目录大版本与书签切换的「提案 + digest + 人确认」;章级风险等级 |
| W11 资源有限 | L0/L1/L3 分层;风险预测;提交飞轮指标 | 按章、按 goal 记账(只记账不分配,不替 agent 选模型) |
| W12 环境漂移 | 工具链状态;诊断;verify_onboarding;L1 对等检查 | 基本齐全,目录只放工具指针 |
| W13 异构 agent | canonical context;AGENTS.md 跨端单一来源;三端对等 | 模型无关的 goal 编译流程(/architect 只有 Claude 有) |
| W14 摩擦重复 | 使者回传闭环;梦核;Rules-Applied;管家准入 | 修订历史与否决理由回流(复用 envoy 与复盘笔记,不新建账本) |
## 并入与依赖
- **并入**:handoff 试点中的「信息归属与同步契约」和「最小任务简报的按需读取与回执」两项。
- **留在 blueprint-governance 作为前置**:「安全派发 + blueprint-baseline 能力包」和「任务状态语义收敛」。
- **依赖**:blueprint-governance(安全派发)、agent-client-capability-packs(版本化 pack 机制)。
- **相关**:governance-feedback-loop(修订历史与否决理由回流)。
## 待设计问题(IC1 须逐条化解)
1. 「意图层」现有三处归属:CONVENTIONS「蓝图定位(意图层)」、agent-button-system「意图层 — AGENTS.md」,以及本模型。设计时需先定死术语映射,并且只在一处改名。
2. 红线:章的完成只能从卡状态加 human_verify 推导,不能做成人手动切换(AGENTS.md 设计红线)。
3. 前置:CONVENTIONS 中 in_progress/done 一处说从 Git 推断、另一处说手标,影响分析不能建立在未收敛的状态语义上。
4. 分类轴对应:修订分级、需求对齐协议(Bug/Feature × S/M/L)、文档元规则 T1–T4、manifest.iteration 之间的对应关系;考虑新增 T5「意图变更」,避免另起一套。
5. ID 前缀:承重墙用 W1–W14,章用 INT-xx,卡用 IC(2026-10-04 用 git grep 确认均未被占用)。
6. 「goal 级确认可代替逐卡确认」:起草立法提案,边界是写运行中的 DB、删除、human_verify、超出当前章的工作仍须找人。等 P8 跑完、用实测数据再定。
7. W11 只记账、不分配;CONVENTIONS 复杂度表把复杂度映射到模型名,与 handoff 的「不映射模型名」矛盾,交给前置一起收敛。
8. 防止容器化:目录只放 ID、一句话意图和指针(参照 project-context.yaml 的 label/paths,但禁止长 doc 字段),并配一个只警告的指针可解析门控。
9. 书签与统筹文档 §0 的交接:P8 期间只做指向;之后改为 agent 起草书签、人确认,统筹文档只管派单与交接。
10. 离线与降级:目录放在项目 Git 中、离线可读;影响分析与跨项目索引走 MCP 查询,并保留直接读文件的降级路径。
11. 跨 agent:goal 编译流程写成模型无关的形式(CONVENTIONS「复杂功能分析流程」),不能只靠 Claude 的 /architect。
12. 子项目已有的意图载体(例如 enterprise 的 `.specify/specs/.../spec.md`)只做指向,不复制。
13. 目录的物理位置与前言的归属(例如 `.blueprint/catalog.md`、`docs/intent/`,或放在 AGENTS.md 块外)。
## 不做什么
- 设计确认且 P8 收口之前,不写代码,不改接入包模板、CONVENTIONS、AGENTS.md、分发层和 P8 热点文件。
- 不给存量卡回填 `intent:`;试用阶段只在新卡上可选填写。
- 炼境不替 agent 编译 goal、选模型或判定完成;炼境只提供结构、校验、现状采集与查询。
- 不把蓝图的版本化事实源搬进炼境 DB,不让子项目依赖炼境在线,不建派发调度器。
## 分阶段
1. 立 concept 模块(本次)。
2. IC1 设计文档,与 P8 并行,只写文档。
3. 在炼境自身试用:新增目录文件,新卡可选 `intent:`。
4. P8 收口后:补前置,加只读校验与影响分析。
5. enterprise 隔离试点。
6. 按实测结果决定:并入能力包分发,或撤销。
## 收益度量与退出条件
- 度量:/goal 一次判对率、人工介入次数、续接所需的上下文量、方向返工与 human_verify 否决率、每阶段 token 用量;探索章另看收敛轮数、是否守住预算、否决理由是否逐轮减少。
- 退出:实测无收益、已被 agent 原生能力覆盖,或维护成本超过收益时撤销(管家准入与退出)。
## 任务卡
### ✅ IC1 — 意图目录设计文档(/architect)
- status: done
- complexity: L
- files: docs/tasks/2026-10-04-intent-catalog-design.md, .blueprint/modules/intent-catalog.md
- acceptance: "agent_verify: [读文件] 设计文档含方案选择、设计规格 1–7、13 问化解表、W1–W14 四问表、受影响文件、系统边界变更、风险点、拆解建议、度量与退出、立法草案、没验什么。human_verify: 用户确认设计(含 5 个待拍板问题),确认后模块转 planned 并追加 IC2–IC13。"
- notes: 2026-10-04 评审团工作流 wf_60e4c430-bb1 出稿(最小文件优先方案胜出,两位评委 25/30、24/30),设计文档已写,等用户确认。产出 `docs/tasks/<日期>-intent-catalog-design.md`,以 W1–W14 为纲、书模型为体,逐条化解上面的待设计问题,写明收益度量与退出条件;完成后交用户确认,确认后模块转 planned,再用 /splitter 拆成 S/M 卡。
### ✅ IC2 — 新增 intent-catalog-guide.md:目录语法、修订钉版、goal 编译七步、确认卡与回执、离线检查
- status: done
- complexity: S
- files: docs/ai-context/intent-catalog-guide.md
- depends: IC1
- acceptance: "agent_verify: [CLI] grep -cE '^## (目录语法|修订与钉版|goal 编译|确认卡与回执|离线检查)' docs/ai-context/intent-catalog-guide.md → 5;grep -ciE 'opus|sonnet|haiku|gpt-|deepseek-' 该文件 → 0;/architect 只以「可选包装」出现;git status --porcelain → 只有该文件新增。"
### ✅ IC3 — 新增 .blueprint/catalog.md:1.0 骨架与首批 2–4 章,书签只指向 coordination §0
- status: done
- complexity: S
- files: .blueprint/catalog.md
- depends: IC2
- acceptance: "agent_verify: [CLI] grep -c 'catalog_version: 1.0' → 1;grep -cE '^## INT-[0-9]{2} ' 介于 2–4;wc -l ≤200 且 wc -c ≤8192;grep -cE '^- (status|progress|doc|files|acceptance|model):' → 0;指南中的 path 指针检查 → 0 悬空;cat .blueprint/modules/*.md | grep -c '^### ' 前后相等。human_verify: 用户逐章确认意图与不做(1.0 为大版本,人定稿),提交带 Feature-Confirmed: true。"
### ✅ IC4 — 跨 agent 纸面编译:Codex 或 DSH 按指南对书签章编译确认卡(不粘贴)
- status: done
- complexity: S
- files: .blueprint/modules/intent-catalog.md
- depends: IC3
- notes: 2026-10-04 报备改断言:目标章由「书签章」改为指定 INT-02。理由:书签所指的 INT-01(P8)卡在统筹会话的 agent-client-parity.md 中,且几乎全为 ✅,纸面编译无测试价值;INT-02 挂有 IC6–IC10 五张待做卡,纸面编译即 IC5 的预演。
- result: 2026-10-04 Codex 纸面编译通过:9 个字段齐全;标签 blob 8392d18 等于目录 blob;5 条终点可追溯到 IC6–IC10 的 agent_verify;按当时的黑名单命中 0。Codex 环境起不了 Bash,改用语义等价的 PowerShell 执行;它报告的 5 处指南不足和主会话核对时发现的 2 处(字节数量法与平台有关;确认卡终点被改写成「均符合预期」,与 /goal 文本写法不一致)已修进指南。按新黑名单,该卡第 1 条终点会命中「符合预期」,这正是本次的发现。
- acceptance: "agent_verify: [CLI] git log -1 --grep='IC4' --format=%B → 含 项目、分支/worktree、HEAD、纳入卡、终点、终验待办、停止找人、没验什么、作废 9 字段与 Compiled-By: <非 Claude 客户端>;标签 blob 等于该提交中 .blueprint/catalog.md 的短 blob;每条终点可在来源卡 agent_verify 原文找到;过程词黑名单 grep → 0。"
### 📋 IC5 — 首次真实 /goal:为 Phase 4 的卡编译 → 人粘贴 → 收口回执
- status: todo
- complexity: S
- files: 收口提交 body 与 PR body;纳入卡的 intent 与终验行
- depends: IC4, P8 收口
- acceptance: "agent_verify: [CLI] git log --grep='^Goal-Receipt: INT-' --format=%B → ≥1 条,含 Goal-Cards、Goal-Result、Goal-Rounds、Goal-Interventions、Not-Verified、Human-Pending;纳入卡标题前缀均为 ✅;含 human_verify 的纳入卡各有一行终验;^### 计数增量等于新增卡数。human_verify: 人粘贴 /goal 并判定 Goal-Result。"
### 📋 IC6 — intent-gate.cjs 核心:结构、防膨胀、类型指针、卡侧引用,加 --self-test
- status: todo
- complexity: M
- intent: INT-02@1.0
- files: .claude/hooks/intent-gate.cjs
- depends: IC3, P8 收口
- acceptance: "agent_verify: [gate 脚本] node .claude/hooks/intent-gate.cjs --self-test → exit 0 且输出 self-test ok,内置 6 类坏样例(悬空 path:、未知 INT、超长字段、status: 键、card: 指向不存在的卡、探索章缺预算或收敛信号)各恰好 1 条警告;node .claude/hooks/intent-gate.cjs → exit 0、真实目录 0 警告;INTENT_CATALOG=/nonexistent → 无输出、exit 0。"
### 📋 IC7 — 门控只读视图 --report/--impact/--pending 与目录提交审计
- status: todo
- complexity: M
- intent: INT-02@1.0
- files: .claude/hooks/intent-gate.cjs
- depends: IC6
- acceptance: "agent_verify: [gate 脚本] --self-test 夹具:章 rev 1.1 而 📋 卡钉 1.0 → --impact 报 stale;钉墓碑章 → orphan;只有模块默认挂靠 → low_confidence;前缀 🔵 而 status: todo → --report 报 divergence 并标 status_source;含 human_verify 而无终验行的 ✅ 卡 → --pending 列出;缺 Feature-Confirmed 的目录提交 → --report 审计列出;全部 exit 0,运行前后 sha256sum .blueprint/catalog.md .blueprint/modules/*.md 不变。"
### 📋 IC8 — 接线:lefthook 加 intent-gate、AGENTS.md 块外加 T5 与启动读书签、agent-button-system 单处改名
- status: todo
- complexity: S
- intent: INT-02@1.0
- files: lefthook.yml, AGENTS.md, docs/ai-context/agent-button-system.md, docs/ai-context/intent-catalog-guide.md, .blueprint/modules/intent-catalog.md
- depends: IC6, P8 收口
- acceptance: "agent_verify: [YAML 解析] lefthook.yml 可解析且 pre-commit.commands.intent-gate.run 以 || true 结尾;[cargo test] cargo test onboarding → 0 failed;[CLI] git diff -U0 AGENTS.md 全部 hunk 位于 BLUEPRINT_MANAGED_START 行之前;grep -c '意图层 — AGENTS.md' docs/ai-context/agent-button-system.md → 0;临时 worktree 内提交一次「改章文不升 rev」→ pre-commit 输出 1 条警告且提交成功,验证后移除该 worktree。"
### 📋 IC9 — cargo test 锁定 parse_module_md 忽略 intent 与终验行
- status: todo
- complexity: S
- intent: INT-02@1.0
- files: src-tauri/src/commands/blueprint.rs
- depends: P8 收口
- acceptance: "agent_verify: [cargo test] cargo test parse_module_md_ignores_intent_lines → 1 passed:含 intent、终验行与模块头 intent 的样本,和删去这些行的样本相比,tasks.len()、status、acceptance、notes 逐字段相等(只改 #[cfg(test)]);全量 cargo test 无 FAILED。"
### 📋 IC10 — 书签交接:目录书签自持三行,coordination §0 改为指向书签
- status: todo
- complexity: S
- intent: INT-02@1.0
- files: .blueprint/catalog.md, docs/tasks/2026-10-03-coordination.md
- depends: IC7, IC8
- acceptance: "agent_verify: [gate 脚本] node .claude/hooks/intent-gate.cjs → 0 警告;[CLI] grep -A3 '^## 书签' .blueprint/catalog.md → 当前、终点、确认 三行且当前章存在未撤销;coordination §0(若仍存在)含指向书签的一行;提案附 --report 与 base blob;提交带 Feature-Confirmed: true。human_verify: 用户确认书签切换。"
### 📋 IC11 — 「goal 级确认代替逐卡确认」立法提案定稿
- status: todo
- complexity: S
- files: .blueprint/modules/intent-catalog.md
- depends: IC5, P8 收口
- acceptance: "agent_verify: [读文件] 决策记录新增提案:条文、例外清单(运行中 DB、删除、human_verify、凭据与机器状态、超出纳入卡或本章、改目录、stale pin、失败 3 次)与数据(P8 期间逐卡确认次数及可合并次数、IC5 的 Goal-Result);git diff --name-only 不含 AGENTS.md 与 src-tauri/resources/。human_verify: 用户裁决采纳或否决并记录理由。"
### 📋 IC12 — enterprise 隔离 worktree 试点:catalog 加门控试点副本,规格只用 spec: 指向
- status: todo
- complexity: M
- files: E:/code-project/enterprise-system/.blueprint/catalog.md, E:/code-project/enterprise-system/.claude/hooks/intent-gate.cjs
- depends: IC9, IC10
- acceptance: "agent_verify: [gate 脚本] 试点 worktree 内 → exit 0、0 警告、spec: 指针全部可解析;副本首行含「试点副本,IC13 后替换或删除」;[CLI] 试点 worktree git status --porcelain → 只新增这 2 个文件;enterprise 主工作区 git status --porcelain 前后一致;试点分支 ≥1 条 Goal-Receipt。human_verify: 人确认一次 enterprise goal 的意图与页面结果并记 Goal-Result。"
### 📋 IC13 — 去留决策:按五项度量并入能力包或撤销
- status: todo
- complexity: S
- files: .blueprint/modules/intent-catalog.md
- depends: IC12
- acceptance: "agent_verify: [读文件] 决策记录含五项度量的前后对比,样本 ≥5 条 Goal-Receipt;撤销分支:git grep -lE 'intent-gate|catalog_version' → 只命中决策记录,AGENTS.md 无 T5,lefthook.yml 无 intent-gate 键;保留分支:另拆 blueprint-baseline 分发卡,本卡不改模板。human_verify: 用户裁决去留。"
## 决策记录
- 2026-10-04 归属:新建本模块,并入 handoff 试点的「信息归属 + 任务简报」部分;不做 blueprint-governance 的新迭代。理由:目录层叠在蓝图之上,需要独立的家;governance 已 done,开新迭代会改变全局 iteration 口径;独立模块也便于按退出条款整体撤销。
- 2026-10-04 时机:与 P8 并行做设计,只写文档、在独立 worktree 中进行;实现等 P8 收口后再做。理由:改动的文件与 P8 不重叠,设计也需要时间,等 P8 收口正好衔接。
- 2026-10-04 试点范围:先在炼境自身试用。理由:先在自己身上踩坑成本最低;enterprise 主工作区有他人的在制品,分发机制也尚未安全化。
- 2026-10-04 立法:「goal 级确认代替逐卡确认」只在设计中起草提案,P8 之后再定。理由:先用 P8 的实测数据说话;这条规则依赖「章」的定义;现在改托管块会和 P8 撞车。
- 2026-10-04 设计确认(IC1):采用最小文件优先方案,即 `.blueprint/catalog.md`、卡侧 `- intent:` 钉版和模型无关的 goal 编译指南;不选结构化 YAML 加 Rust/MCP(子项目离线时拿不到同等校验,撤销成本也最高),也不选最大化复用(会提前分发给所有子项目,还要改动 CONVENTIONS 的分类轴)。评审团 wf_60e4c430-bb1 两位评委打分为 25/30、24/30。设计中的五个待拍板问题,用户全部采纳推荐项:
- 门控脚本放在 P8 收口后,试用期只新增文档;
- IC5 首次真实 /goal 用于 P8 收口后本模块 Phase 4 的卡,不打断 P8 在制品;
- 炼境 1.0 首批章节方向为「一键接入三端可用 / 意图编译为可判定终点 / 摩擦驱动沉淀与退出」,在 IC3 逐章定稿;
- 去留阈值初定为样本 ≥5、一次判对率 ≥60%、人工介入不高于基线、每阶段改目录 ≤1 次,IC13 前可以调整;
- 接受在 AGENTS.md 块外常驻约 10 行「启动读目录引言和书签」。
- 2026-10-04 修订(用户提出,采纳推荐):增加探索章,让意图可以从迭代中结晶。起因是很多需求一开始只有模糊轮廓,甚至没有意图,要靠 MVP 反复试用才慢慢说清。原设计默认自上而下,是盲区。具体做法:
- 章新增可选字段「形态: 定型(缺省)|探索」。它是人对意图清晰度的声明,不是任务进度,因此不违反「目录不存状态」,并且只能由人确认修改。
- 探索章必填 轮廓、试探、不做、预算、收敛信号。
- 探索期的 goal 只编译本轮试验的终点;人的试用反馈记成终验行(保留/否决 + 理由),作为结晶原料。
- 收敛或预算用完时,agent 起草意图提炼,人确认后转为定型(小版本)。未收敛时由人三选一:追加预算、换方向、撤销留墓碑;agent 不得自行延长预算。
- 修修补补和直接做 MVP 不必开章,目录与卡侧 intent 一律可选。
- 同步:INT-02 措辞覆盖定型和探索两种形态;指南新增「探索章与结晶」一节和离线检查第 11 条;IC6 坏样例增至 6 类;W8 有了实质承重件;度量增加探索章三项。

View File

@ -0,0 +1,56 @@
# MVP 收口(mvp-closure)
> status: in_progress | created: 2026-10-04 | intent: INT-04 | 统筹:docs/tasks/2026-10-03-coordination.md §0
> 来源:2026-10-04 用户在 P8 达成后定下一阶段为「炼境 MVP 收口」,并定以 enterprise-system 真实开发作为验证场。
## 概述
把炼境收口到 MVP:agent 拿到子项目能开工、能自验、能交付,摩擦能闭环回传。炼境侧只做收拾(关账、清理、修文档漂移),
不开新能力;四条能力是否真的可用,在 enterprise-system 的真实开发中只读观察取证。
## 决策记录
- 2026-10-04 用户定:扩展项(部署控制面、P4b–e、P5/P6、治理缺口②③、DSH 接管、Codex 模型切换、多维视图、架构演进、
intent-catalog Phase 4+、概念占位显式化、project-dev-variables V14–V16)冻结,MVP 达成后再排;清单在统筹文档 §3。
- 2026-10-04 用户定:以 enterprise-system 真实开发验证四条能力(M5),原「开发变量人终验」(V13)并入 M5;
intent-catalog 的 enterprise 试点继续冻结,先把四条跑稳。
- 观察边界:enterprise 主工作区有在制品,炼境侧只经 MCP 只读查询取证;要改 enterprise 就开临时 worktree、走 PR。
## 任务卡
### ✅ M2 — blueprint-buff 关账
- status: done
- complexity: S
- intent: INT-04@2.0
- files: .blueprint/modules/blueprint-buff.md, .blueprint/manifest.yaml
- acceptance: "agent_verify: [shell] grep -cE '^### (📋|🔵|💭|🔴)' .blueprint/modules/blueprint-buff.md → 0 且 grep -c '^### ✅' 同文件 → 8;git -C 主仓库 log 中 2026-10-04 的 ff 合并后 git status --porcelain -- .blueprint/modules 为空(零误标)并写入 B2 卡 human_verify 证据;manifest blueprint-buff 为 status: done、progress: 100,模块决策记录写明「剩余 14% 为未更新的进度数字,核心卡已全部完成」。"
- 验收变更(2026-10-04,按自验报告纪律报备,用户在会话中选定):执行中发现 buff 12:46 把主仓库 IC10 误标 🔵,「零误标、14% 只是数字」的前提被证伪。改为:B2 卡记终验否决与证据、决策记录写明剩余缺口为方案 C 并冻结、manifest 保持 in_progress 并改 progress 90;原 acceptance 中 status: done / progress: 100 与「主仓库 .blueprint/modules 空」两项不再适用。
- verification: "2026-10-04(INT-04 goal):blueprint-buff 8 张卡全 ✅(未完成标题计数 0);B2 human_verify 记 2026-10-04 否决与 IC10 实例;决策记录新增「剩余缺口与冻结」;manifest blueprint-buff progress 86 → 90、status in_progress。"
- 为什么:manifest 记 86%,但模块 8 张卡全 ✅;唯一缺 B2 终验记录,而 2026-10-04 主仓库 6 次快进合并后 .blueprint/modules 零误标,正是 B2 的终验现象。
### ✅ M3 — 本轮临时项目与 worktree 清理
- status: done
- complexity: S
- intent: INT-04@2.0
- files: docs/tasks/2026-10-03-coordination.md
- acceptance: "agent_verify: [shell] git worktree list 不含 tmp-p7skill-review、tmp-delivery-status-review、tmp-p10-verify-mut、dev-manager-tauri-wt-p8、dev-manager-tauri-wt-intent、dev-manager-tauri-wt-p8g;[MCP] list_all_projects 不含路径带 lj-p8 的登记。human_verify: 用户手动删除统筹文档 §5「待你手动删除」所列目录与文件。"
- verification: "2026-10-04(INT-04 goal):git worktree list 按六个已清理名称计数 → 0;全局 MCP list_all_projects 完整输出(29 个项目)中 lj-p8 → 0。human_verify(手动删除 §5 所列目录与文件)待用户。顺带发现:list_all_projects 中 dev-manager-tauri 出现两条(组 f2418a3b 与 ffa9e42d),超出本卡范围,未处理。"
### ✅ M4 — 常驻文档漂移修复
- status: done
- complexity: S
- intent: INT-04@2.0
- files: docs/ai-context/project-brief.md, AGENTS.md, docs/ai-context/agent-button-system.md, docs/templates/agents-meta-rules.md, docs/tasks/2026-09-30-dev-variables-materialize.md
- acceptance: "agent_verify: [shell] ① grep -c 'onboard/' docs/ai-context/project-brief.md → ≥1;② grep -lE '^#+ 炼境自己的 Agent 按钮清单' AGENTS.md docs/ai-context/agent-button-system.md → 恰好 1 个文件,另一处改为指针;③ grep -c '1.10.0' docs/templates/agents-meta-rules.md → ≥1,且其规则正文与 src-tauri/resources/onboarding/AGENTS.md.tmpl 的 ONBOARDING_MANAGED 块逐节对照无缺漏(差异写进卡片);④ grep -c '未合入 master' docs/tasks/2026-09-30-dev-variables-materialize.md → 0;⑤ grep -c '\\.agent/task\\.md' docs/ai-context/agent-button-system.md → 0 或改为与现行做法一致的说明;pnpm typecheck exit 0。"
- 说明:只改文档,不动 resources/onboarding/ 模板(模板改动会触发指纹测试与版本升级,超出本卡)。
- verification: "2026-10-04(INT-04 goal):① project-brief 架构速查补 mcp_inject.rs 与 onboard/ 两行;② 按钮清单以 AGENTS.md 块外区为单一来源(并入 agent-button-system 版多出的 pnpm test 与一键接入两行),agent-button-system 原节改为「按钮清单的位置」指针;③ agents-meta-rules 头部改 version 1.10.0 + aligned_with,能力包五条同步为模板原文、T1/T3/T4/自查措辞同步;④ dev-variables 简报头部改为 frozen、模块已在 master;⑤ agent-button-system 持久层去掉不存在的最小接入文件,改为与单档接入一致。"
- 差异清单(agents-meta-rules ↔ AGENTS.md.tmpl ONBOARDING_MANAGED 1.10.0,全文见 meta-rules「与分发模板的对照」节): "托管块 7 节中,核心开发约束、需求对齐协议、Git 工作流三节 meta-rules 无、以模板为准不复制;能力包一节已同步,Node/pnpm 工具链只留指针;agent 按钮与验证路径——meta-rules 缺载体就近选择表、完成的定义、侦察→驻军、agent_verify/human_verify 分层与三分定位启发式,多出分工原则、按钮清单模板、降级约定(已不在托管块内);多 AI CLI 协作与交接模板内容等价。托管块外四支柱、T1–T4、铁律、自查已同步。"
### 📋 M5 — enterprise-system 实战验证四条能力
- status: todo
- complexity: M
- intent: INT-04@2.0
- depends: M2, M3, M4
- files: .blueprint/modules/mvp-closure.md
- acceptance: "agent_verify: [MCP 只读,project_id 为 enterprise 的 canonical id] ① 能开工:verify_onboarding clients 三端 converged 且 probe_client_parity all_applicable_ready=true;② 能自验:炼境日志或会话证据中至少 1 次 read_project_test_account 成功;③ 能交付:get_delivery_status 至少 1 个 PR 的 CI passed 并已合并;④ 摩擦闭环:list_envoy_returns 中 enterprise 来源的回传均有处置回执。human_verify: 用户在 enterprise 开发中确认——新会话无需手工配置即可开工;需要登录时 agent 先查炼境不索要账号(原 V13);认可该次交付;回传内容是真问题。"
- 说明:随用户开发进度积累证据,不进 M2–M4 的 /goal;证据攒够后统筹会话一次性核对并出终验清单。

View File

@ -321,8 +321,10 @@ docs/templates/ 炼境接入包模板草案(设计层)
| 能力 | 调用方式 | 通过标准 | | 能力 | 调用方式 | 通过标准 |
|------|---------|---------| |------|---------|---------|
| TypeScript 类型检查 | `pnpm typecheck` | 无输出,exit 0 | | TypeScript 类型检查 | `pnpm typecheck` | 无输出,exit 0 |
| 前端单元测试 | `pnpm test` | exit 0,无 FAILED |
| Rust 单元测试 | `cargo test`(src-tauri/ 目录) | 无 FAILED | | Rust 单元测试 | `cargo test`(src-tauri/ 目录) | 无 FAILED |
| MCP 工具调用 | 见 `src-tauri/src/mcp_tools.rs` 工具列表 | 返回 JSON,无 error 字段 | | MCP 工具调用 | 见 `src-tauri/src/mcp_tools.rs` 工具列表 | 返回 JSON,无 error 字段 |
| 一键接入子项目 | MCP `plan_onboarding(project_id)` → 计划给用户看、用户确认 → `onboard_project(project_id, expected_digest=<计划 digest>, confirmed=true)`(两次选项相同;UI 投影为同名 Tauri command,同一本体) | 计划 `blocked` 为空;报告 `status=done`(`partial` 按 `steps`、`completion`、`next_actions` 修复后重跑即收敛;再跑一次全部 `converged`) |
| 蓝图状态读取 | 读 `.blueprint/manifest.yaml` | 文件可解析,字段完整 | | 蓝图状态读取 | 读 `.blueprint/manifest.yaml` | 文件可解析,字段完整 |
| 蓝图状态更新 | 编辑 `.blueprint/modules/<id>.md` | 文件写入成功,格式合法 | | 蓝图状态更新 | 编辑 `.blueprint/modules/<id>.md` | 文件写入成功,格式合法 |

View File

@ -88,9 +88,8 @@ acceptance 是 agent 自验的唯一判断依据,必须是可执行断言:
### 持久层 — 目标持久化 ### 持久层 — 目标持久化
让 agent 跨会话续接,不靠对话记忆: 让 agent 跨会话续接,不靠对话记忆:
- 炼境项目:蓝图(`.blueprint/`) - 炼境与已接入子项目:蓝图(`.blueprint/`),规范随接入包分发
- 子项目完整接入:随炼境分发的蓝图规范 - 接入包只有一档(见下文「分发给子项目的方案」),不设「最小接入」,也不另设轻量任务文件
- 子项目最小接入:`.agent/task.md`
蓝图在体系里的三个角色: 蓝图在体系里的三个角色:
1. **目标的结构化载体** — 把自然语言目标翻译成带 acceptance 的可执行任务卡 1. **目标的结构化载体** — 把自然语言目标翻译成带 acceptance 的可执行任务卡
@ -179,17 +178,9 @@ Gitea PR 继续使用既有 `create_pull_request` 有界操作;Windows 本机
### 原则三:acceptance 是体系的核心关节 ### 原则三:acceptance 是体系的核心关节
体系其他部分都能降级,acceptance 不能将就。acceptance 写得可执行,自验才是真自验;写得模糊,整个环路是假闭合,无人值守名存实亡。 体系其他部分都能降级,acceptance 不能将就。acceptance 写得可执行,自验才是真自验;写得模糊,整个环路是假闭合,无人值守名存实亡。
## 炼境自己的 Agent 按钮清单 ## 按钮清单的位置
| 能力 | 调用方式 | 通过标准 | 单一来源在 AGENTS.md「炼境自己的 Agent 按钮清单」节(常驻上下文,跨工具读取),此处不复制。
|------|---------|---------|
| TypeScript 类型检查 | `pnpm typecheck` | 无输出,exit 0 |
| 前端单元测试 | `pnpm test` | exit 0,无 FAILED |
| Rust 单元测试 | `cargo test`(src-tauri/ 目录) | 无 FAILED |
| MCP 工具调用 | 见 `src-tauri/src/mcp_tools.rs` 工具列表 | 返回 JSON,无 error 字段 |
| 一键接入子项目 | MCP `plan_onboarding(project_id)` → 计划给用户看、用户确认 → `onboard_project(project_id, expected_digest=<计划 digest>, confirmed=true)`(两次选项相同;UI 投影为同名 Tauri command,同一本体) | 计划 `blocked` 为空;报告 `status=done`(`partial` 按 `steps`、`completion`、`next_actions` 修复后重跑即收敛;再跑一次全部 `converged`) |
| 蓝图状态读取 | 读 `.blueprint/manifest.yaml` | 文件可解析,字段完整 |
| 蓝图状态更新 | 编辑 `.blueprint/modules/<id>.md` | 文件写入成功,格式合法 |
## 分发给子项目的方案 ## 分发给子项目的方案

View File

@ -0,0 +1,274 @@
# 意图目录编写与使用指南
> 适用对象:所有 agent(Claude Code、Codex、DSH 等)和人。本文件是意图目录语法与 goal 编译流程的**单一来源**。
> 模块:`.blueprint/modules/intent-catalog.md`。设计依据:`docs/tasks/2026-10-04-intent-catalog-design.md`(临时文件,IC3 后删除)。
> 试用期(P8 收口前)只用文档和 shell 单行命令;门控脚本 `intent-gate.cjs` 在 Phase 4 落地后替换「离线检查」一节。
意图目录 `.blueprint/catalog.md` 是蓝图之上由人持有的一层:每章写一个意图方向、怎么判断做对了、不做什么。任务卡单向挂到章上,agent 据此把意图编译成评估器能判定的 /goal。**书装意图,指向事实**:代码、状态、规格、凭据都不进目录,目录里只放指针。
| 角色 | 写什么 | 不写什么 |
|---|---|---|
| 人 | 章的意图、人看、不做;大版本修订;确认小版本、书签切换和 goal 确认卡 | 卡的状态(由 agent 判定);机器坐标的具体命令 |
| agent | 机器坐标指针、小版本提案、goal 编译、收口回执、卡上的 `- 终验:` 记录 | 章的完成状态(只能推导);替人改意图 |
| 炼境 | 无,只经 get_project_file 只读提供同一份文件 | 不编译 goal、不选模型、不判定完成 |
## 目录语法
**位置与骨架**:`.blueprint/catalog.md`,放在 modules/ 之外,依次为引言行、书签、各章、墓碑、附录。
```markdown
# 意图目录
> catalog_version: 1.0 | 前言 → path:AGENTS.md#项目定位 | 语法 → path:docs/ai-context/intent-catalog-guide.md
## 书签
- 当前 → path:docs/tasks/2026-10-03-coordination.md#0. 方针与本阶段终点
## INT-01 <章名:一个意图方向>
- rev: 1.0
- 意图: <一句话,人的原意>
- 人看: <人在投影上看到什么就算做对了>
- 机器: <可断言坐标的类型化指针,例如 card:<module>#<卡键>>
- 不做: <边界;多条用「;」分隔>
## INT-09(已撤销)
- 撤销: YYYY-MM-DD → module:<id>#决策记录
## 附录
- <名称> → <类型化指针>
```
**章导语字段**:
| 字段 | 必填 | 含义 |
|---|---|---|
| rev | 是 | 该章最后一次变更时的目录版本,不大于 catalog_version |
| 意图 | 是 | 人的原意,一句话 |
| 人看 | 是 | 人看的投影坐标(对应 human_verify) |
| 机器 | 是 | agent 可断言的坐标,只写指针,不写命令全文 |
| 不做 | 是 | 边界,agent 扩范围时的刹车 |
| 风险 | 否 | 低、中、高,或指向不可逆操作的说明 |
| 假设 | 否 | 指向既有的证伪落点(某张 spike 卡或复盘),目录里不存证伪状态 |
| 证据 | 否 | 指向已有证据(卡上的 verify 记录、PR) |
| 墙 | 否 | 关联的承重墙编号,例如 `W12,W13` |
| 形态 | 否 | `定型`(缺省)或 `探索`;只能由人确认修改,见「探索章与结晶」 |
**不必开章的情况**:只是修修补补的卡,照常做,不写 intent;属于某个已有章的,就挂上去,算补丁级。完全没有意图、直接做 MVP 的,先不开章,做两三轮以后再从试用反馈里提炼。目录和卡侧 intent 都是可选的,不会挡住任何工作。
**防膨胀(硬限制)**:
- 每个字段只写一行,不超过 120 字;
- 每个章块不超过 12 行;
- 全文件不超过 200 行、8KB;
- 禁止出现 `status`、`progress`、`doc`、`files`、`acceptance`、`model` 键,也不写模型名;
- 不设文件内修订历史,修订历史看 git log。
**类型化指针**(多个指针用「;」分隔):
| 前缀 | 写法 | 校验方式 |
|---|---|---|
| path: | `path:<相对路径>[#标题前缀]` | 文件存在;有 `#` 时标题能匹配 |
| module: | `module:<id>[#段名]` | `.blueprint/modules/<id>.md` 存在 |
| card: | `card:<module>#<卡键>` | 该模块里存在这张卡;卡键取标题去掉状态前缀后的第一个 token,例如 `IC6`、`P8e` |
| spec: | `spec:<路径>#标题` | 指向子项目已有的规格(例如 `.specify/specs/...`),只指向不复制 |
| cmd: | `cmd:<命令或工具名>` | 只校验格式,不执行 |
| W | `W1`–`W14` | 承重墙编号,定义见模块文件「承重墙」节 |
**ID 规则**:章用两位数 `INT-NN`,永不复用。撤销的章保留墓碑 `## INT-NN(已撤销)`,注意编号后面紧跟全角括号、没有空格。
**卡侧挂靠(单向)**:
- 卡上可选写一行 `- intent: INT-NN@X.Y`,放在 `- complexity:` 后面,表示这张卡服务哪一章、编译自目录哪一版。
- 模块头 blockquote 可选写 `| intent: INT-NN` 作为整个模块的默认挂靠,不带版本,影响分析里计为低置信。
- 章的「机器:」只是验收坐标,不登记成员名单。反向索引现算,不存储。
**终验记录**:卡上另起一行 `- 终验: YYYY-MM-DD 通过|否决:<理由>`,由 agent 记录人在会话里给出的裁决。不要写进 `- notes:`,因为多条 notes 后一条会覆盖前一条。
**解析器约束**:模块 md 里,「任务卡」段以外一律不用 `###`。未识别的 `##` 段下出现 `###` 会被当成任务卡。
## 修订与钉版
**版本**:引言里写一个 `catalog_version: X.Y`;每章有自己的 `rev`。这套版本号与 manifest.iteration 互不借号。
| 级别 | 什么时候 | 怎么做 | 版本变化 |
|---|---|---|---|
| 补丁 | 只改正文(卡、模块),目录不动 | agent 自主完成,照常走需求对齐协议 | 无 |
| 小版本 | 改某章的人看、机器或不做;由正文反推修改目录 | agent 提出 S 级三行确认卡,附 diff 和 base blob,人说「确认」 | Y+1;被改章的 rev = 新版本 |
| 大版本 | 增删章节、调整方向 | 人主导,agent 协助起草 | X+1、Y 归零;涉及的章更新 rev;删掉的章留墓碑;按 T4 检查 AGENTS.md「项目定位」 |
**提案**:附上目录 diff 和 base blob,base blob 用下面的命令取:
```bash
git rev-parse --short HEAD:.blueprint/catalog.md
```
人确认后提交,提交前再取一次 blob。如果已经不等于 base,说明目录被别人改过,必须重新提案,不能硬合。
**提交格式**:
- 首行:`docs(intent): <改了什么>`
- body:一句理由,必要时写来源,例如某次终验否决、某张卡的设计发现。
- 末尾:带 `Feature-Confirmed: true`。
- 目录改动单独小提交,不和代码混在一起。
**钉版**:卡写 `- intent: INT-NN@X.Y`;goal 标签写 `INT-NN@X.Y#<blob7>`。
**影响分析**:
| 判定 | 条件 | 处理 |
|---|---|---|
| stale | 卡钉的版本低于章 rev,且卡未完成 | 复核 acceptance。没变化就改钉,算补丁,并在简报里报告;有变化就按小版本走 |
| orphan | 卡钉在已撤销的章上 | 停下找人,决定改挂哪一章还是撤卡 |
| low_confidence | 卡只有模块默认挂靠,没有卡侧钉版 | 编译 goal 前补写卡侧 intent |
**在制品保护**:钉旧版的 🔵 卡照常做完,只复核 acceptance。章被撤销,或新的「不做」覆盖了这张卡时,停下找人。任何情况下都不自动改写卡。
## 探索章与结晶
意图常常不是一开始就清楚的,而是做 MVP、反复试用以后才长出来。探索章就是给这种情况用的:先写下在找什么、找多久,等意图结晶出来再改成定型章。
```markdown
## INT-04 <轮廓名>
- rev: 1.1
- 形态: 探索
- 轮廓: <人的原话,模糊也可以>
- 试探: <这一阶段想弄清的问题,例如「哪种交互最顺手」>
- 不做: <再模糊也要有的边界>
- 预算: <最多 N 轮 MVP 或 N 天>
- 收敛信号: <出现什么就说明方向定了,例如「连续两轮不再想改核心交互」>
- 证据: <各轮试验卡的指针>
```
| | 定型章 | 探索章 |
|---|---|---|
| 必填 | rev、意图、人看、机器、不做 | rev、形态: 探索、轮廓、试探、不做、预算、收敛信号 |
| 回答 | 做到什么样算对 | 我们在找什么、找多久 |
| goal 终点 | 交付终点 | 每轮试验的终点 |
| 度量 | goal 一次判对率 | 几轮收敛、是否守住预算、否决理由是否越来越少 |
**每轮试验**:
- 拆一张试验卡,挂到探索章上:`- intent: INT-NN@X.Y`。
- 人试用后,agent 把反应记成卡上的终验行:`- 终验: YYYY-MM-DD 保留|否决:<理由>`。
- 这些保留和否决的理由,就是结晶的原料。
**结晶(探索 → 定型)**:
- 收敛信号出现,或预算用完时,agent 汇总各轮终验行,起草「意图提炼」:建议的意图、人看、机器、不做,以及依据(哪几轮保留、哪几轮否决、为什么)。
- 人确认后,形态改为定型,按小版本修订:Y+1,本章 rev 更新,轮廓、试探、预算、收敛信号几行换成意图、人看、机器。
**预算用完仍未收敛**:由人三选一:
- 追加预算继续,小版本;
- 换方向重写轮廓,小版本;
- 放弃,大版本,留墓碑。
agent 不得自行延长预算。
## goal 编译
本流程只依赖读文件和 git,不依赖任何特定客户端或模型。Claude 的 /architect 只是可选包装,任何 agent 都可以照着手工执行。产出是一张目标确认卡加一段 /goal 文本。
1. **定位**
- 读 `.lian-jing/context.json` 取 project_id;记下当前分支、worktree 路径和 `git rev-parse --short HEAD`。
- 要求 `git status --porcelain -- .blueprint/catalog.md` 输出为空:目录有未提交改动时不编译。
- 取 catalog blob:`git rev-parse --short HEAD:.blueprint/catalog.md`。
2. **读书签**:书签指向当前章(P8 期间指向 coordination §0 的终点)。读该章的导语和 rev。
3. **校验**:跑「离线检查」一节的命令(Phase 4 后改为 `node .claude/hooks/intent-gate.cjs --report INT-NN --impact`)。
- 机器检查(第 1–7、9–11 条)必须全部通过。
- 第 8 条(钉版对照)和 `card:`、`#标题` 指针属于人工核对,核对结果写进确认卡;门控落地后改为全自动。
- 只要出现悬空指针、stale 或 orphan、防膨胀超限,就先修或先提案,不往下编译。
4. **收卡**
- 检查各纳入卡的 depends,未满足的写进确认卡的「前置」行。只要有未满足的前置,就只能做纸面编译,不能粘贴执行。
- depends 尽量写卡键或模块 id。像「P8 收口」这样的自然语言前置,要在确认卡里写明人工判定的结果。
- 取挂在本章、标题前缀为 📋 或 🔵 的卡。
- 没有可执行 agent_verify 的卡,列入「须先补 acceptance」,不进 goal。
5. **合成终点**
- 取各卡 agent_verify 的合取,改写成在会话里能判定的形式:贴出命令和预期输出、纳入卡前缀都是 ✅、回执已写入。
- human_verify 不进终点,单列为终验待办。
- 过程词黑名单命中数必须为 0:「按方针」「符合设计」「设计已完成」「基本完成」「符合预期」,以及任何无法从会话输出判定的形容词。
- 确认卡和 /goal 文本里的终点写法必须一致,都写「命令 → 预期输出」。不能 /goal 里写得精确,确认卡里却改写成「均符合预期」。
- **探索章**不编译「意图的终点」,只编译本轮试验的终点:
- 做出可试用的 MVP 变体,写明最小动作和可演示方式;
- 校验命令通过;
- 试验卡为 ✅ 且已写回执。
- 人的试用反馈作为终验待办,记到终验行。
- 确认卡写明这是第几轮、共几轮预算;超出预算就不编译,转入结晶或请人三选一。
6. **写停止条件**:遇到以下任一情况必须停下找人:
- human_verify;
- 写运行中的数据库;
- 删除文件、数据或分支;
- 凭据或机器状态变更;
- 超出纳入卡或本章范围;
- 需要修改目录;
- 出现 stale 或 orphan;
- 同一问题失败 3 次。
7. **输出**:一张目标确认卡(格式见下一节),加 /goal 文本,首行带同样的标签。人读完亲手粘贴就算确认;要改就重新编译。agent 不得自行启动 goal,也不得静默改写 goal 文本。
## 确认卡与回执
**目标确认卡**(兼作最小任务简报,新会话只读它就能开工):
```text
[INT-NN@X.Y#<blob7>] 目标确认卡
项目: <project_id> | 分支/worktree: <branch> @ <path> | HEAD: <sha7>
章意图: <一句> | 不做: <…>
前置: <各纳入卡的 depends 及是否满足;有未满足的,注明「仅纸面」>
形态: 定型 | 探索(第 k/N 轮;收敛信号: <…>)
纳入卡: <卡键>(来源 agent_verify 原文)、<卡键>(…)
终点(合取): 1) <命令> → <预期输出> 2) … 3) 纳入卡均 ✅ 且已写 Goal-Receipt
终验待办: <各卡 human_verify>
停止找人: <第 6 步清单>
能力入口: <校验命令,例如 pnpm typecheck / cargo test;可用的 MCP 工具>
没验什么: <编译时已知的盲区>
作废: 分支变化或 catalog blob ≠ <blob7>
```
由非 Claude 客户端编译时,在提交 body 里另加一行 `Compiled-By: <客户端名>`,用于跨 agent 验证。
**收口回执**:goal 收口时写进收口提交的 body;M 级同时复制到 PR body;炼境在线时可以再调一次 append_project_note。
```text
Goal-Receipt: INT-NN@X.Y#<blob7>
Goal-Cards: <纳入卡键列表>
Goal-Result: 判对|误判|中止(<原因>)
Goal-Rounds: <轮数>
Goal-Interventions: <人工介入次数>
Goal-Tokens: <客户端可得时填,否则 n/a>
Not-Verified: <没验什么>
Human-Pending: <待人终验项>
```
回执不写进模块决策记录,因为 UI 会把它当决策展示;也不要手改 `.blueprint/notes-archive.jsonl`,它以炼境 DB 为事实源,会被整文件重写。
## 离线检查
试用期的检查全部是 shell 单行命令,在仓库根目录执行。期望输出写在每条后面的注释里。
- **没有 Bash 时**:命令按 POSIX shell(Git Bash)写成。部分客户端的沙箱里起不了 Bash,这时可以用语义等价的命令(PowerShell 等),并在确认卡的「没验什么」里注明用了哪种替代。
- **一律逐行解析**:不要对整份文件跑一个正则,字符类会跨行吞掉换行符,把有效指针误报成悬空。
- **只读演练不写盘**:所有检查都用管道或内存字符串完成,不创建临时文件。
```bash
# 1. 版本行恰好一行
grep -c '^> catalog_version: ' .blueprint/catalog.md # → 1
# 2. 有效章数(墓碑不计)
grep -cE '^## INT-[0-9]{2} ' .blueprint/catalog.md # → 章数
# 3. 体量
wc -l < .blueprint/catalog.md; git cat-file -s HEAD:.blueprint/catalog.md # → ≤200 行、≤8192 字节(量提交里的 blob;工作区可能是 CRLF,wc -c 会多算换行)
# 4. 禁用键与模型名
grep -cE '^- (status|progress|doc|files|acceptance|model):' .blueprint/catalog.md # → 0
# 5. path 指针可解析(没有输出即通过)
grep -oE 'path:[^ #;|]+' .blueprint/catalog.md | sed 's/^path://' | sort -u | while read -r p; do test -e "$p" || echo "悬空: $p"; done
# 6. module 指针可解析(没有输出即通过)
grep -oE 'module:[a-z0-9-]+' .blueprint/catalog.md | sed 's/^module://' | sort -u | while read -r m; do test -e ".blueprint/modules/$m.md" || echo "悬空: $m"; done
# 7. 卡侧 intent 引用的章都存在且未撤销(没有输出即通过)
comm -23 <(grep -hoE '^- intent: INT-[0-9]{2}' .blueprint/modules/*.md | grep -oE 'INT-[0-9]{2}' | sort -u) <(grep -oE '^## INT-[0-9]{2} ' .blueprint/catalog.md | grep -oE 'INT-[0-9]{2}' | sort -u)
# 8. 钉版与章 rev 对照(人工比对:钉的版本低于 rev 且卡未完成,即为 stale)
grep -hoE 'intent: INT-[0-9]{2}@[0-9]+\.[0-9]+' .blueprint/modules/*.md | sort | uniq -c
awk '/^## INT-[0-9]{2} /{c=$2} /^- rev:/{print c, $3}' .blueprint/catalog.md
# 9. 改模块 md 前后的任务卡计数应相等(新增卡时等于新增数),防止误写 ###
cat .blueprint/modules/*.md | grep -c '^### '
# 10. 确认卡和 /goal 文本的过程词黑名单(用管道检查,不写临时文件)
printf '%s\n' "$GOAL_TEXT" | grep -cE '按方针|符合设计|设计已完成|基本完成|符合预期' # → 0
# 11. 探索章的必填字段齐全(没有输出即通过)
awk '/^## /{if(e&&!(b&&s))print "缺预算或收敛信号: "c; c=$2;e=0;b=0;s=0} /^- 形态: 探索/{e=1} /^- 预算:/{b=1} /^- 收敛信号:/{s=1} END{if(e&&!(b&&s))print "缺预算或收敛信号: "c}' .blueprint/catalog.md
```
card: 指针目前只能人工核对,到模块文件里搜索卡键,Phase 4 后由门控自动校验。指针中带 `#标题` 的部分,也是同样的人工核对方式。

View File

@ -30,6 +30,8 @@ src-tauri/src/credential_store.rs Windows 本机凭证引用、校验与兼容
src-tauri/src/mcp_server.rs MCP Server(agent 调用炼境的入口) src-tauri/src/mcp_server.rs MCP Server(agent 调用炼境的入口)
src-tauri/src/mcp_tools.rs MCP tool schema 与 dispatch src-tauri/src/mcp_tools.rs MCP tool schema 与 dispatch
src-tauri/src/envoy.rs 使者回传本体(三端回传写入、处置回执、待处置列表) src-tauri/src/envoy.rs 使者回传本体(三端回传写入、处置回执、待处置列表)
src-tauri/src/mcp_inject.rs 接入注入与三端适配(canonical context、Codex 项目配置、Claude local 条目、DSH 托管块、稳定 helper 入口)
src-tauri/src/onboard/ 一键接入本体(客户端适配器注册表、写入前计划、编排与报告、L1 三端检查;不依赖 Tauri、连接注入)
src-tauri/src/commands/dev_variables.rs 项目开发变量本体(Agent 登记、人填写、受认证单项读取) src-tauri/src/commands/dev_variables.rs 项目开发变量本体(Agent 登记、人填写、受认证单项读取)
src-tauri/src/commands/delivery_status.rs 项目交付信号聚合(Git / Gitea / 部署证据) src-tauri/src/commands/delivery_status.rs 项目交付信号聚合(Git / Gitea / 部署证据)
src-tauri/resources/onboarding/ 接入包分发模板 src-tauri/resources/onboarding/ 接入包分发模板

File diff suppressed because one or more lines are too long

View File

@ -1,8 +1,8 @@
# 测试账户落地到被忽略文件(project-dev-variables 增量) # 测试账户落地到被忽略文件(project-dev-variables 增量)
> status: todo | complexity: L(拆为 3 张 M 卡)| created: 2026-09-30 | blueprint: project-dev-variables(该模块尚在 `feat/project-dev-variables` 分支,V7 blocked,未合入 master) > status: frozen(2026-10-04 MVP 收口期冻结为扩展,见统筹文档 §3)| complexity: L(拆为 3 张 M 卡)| created: 2026-09-30 | blueprint: project-dev-variables(模块已在 master;对应卡 V14–V16 为 📋)
> ⚠️ 处置条款:本简报 done 后 24h 内删除;结论并入 `project-dev-variables` 模块的决策与任务卡,不让简报成为第二事实来源。 > ⚠️ 处置条款:本简报 done 后 24h 内删除;结论并入 `project-dev-variables` 模块的决策与任务卡,不让简报成为第二事实来源。
> 类型:Feature。开工前需用户确认本设计;且须等 `project-dev-variables` 合入 master 后在其模块内立卡。 > 类型:Feature。解冻后开工前需用户确认本设计(卡已在模块内立为 V14–V16)。
## 为什么(压缩背景 + 证据) ## 为什么(压缩背景 + 证据)

View File

@ -8,8 +8,16 @@
- **方针**(AGENTS.md「项目定位」「管家准入与退出」):炼境是 agent 开发子项目的管家;每个子项目都能在 - **方针**(AGENTS.md「项目定位」「管家准入与退出」):炼境是 agent 开发子项目的管家;每个子项目都能在
Claude Code、Codex、DSH 三端开发,重复配置尽量消除;不过度建设,能力按实测收益保留或撤销。 Claude Code、Codex、DSH 三端开发,重复配置尽量消除;不过度建设,能力按实测收益保留或撤销。
- **本阶段终点**:P8「一键接入」——新建或添加子项目后,一次确认即三端可用(P8 卡的 acceptance)。 - **本阶段终点(2026-10-04 起):炼境 MVP 收口**——agent 拿到子项目能开工、能自验、能交付,摩擦能闭环回传,四条都可用。
设计:`docs/tasks/2026-10-03-p8-onboarding-oneclick-design.md`;任务卡:agent-client-parity 的 P8-0、P8a–P8g、P4-0、P4a–P4e。 必做(用户 2026-10-04 定):
1. project-dev-variables 人终验;
2. 核实 blueprint-buff 剩余 14% 是否核心:是就做完,否则冻结;
3. 本轮临时项目与 worktree 清理(agent 侧已做,见 §5 待手动删除);
4. 修常驻文档漂移:project-brief 目录速查补 `onboard/`、Agent 按钮清单收敛到一处、agents-meta-rules 对齐托管块 1.10.0、
dev-variables 简报头部过期、agent-button-system 里 `.agent/task.md` 的矛盾。
其余一律冻结为扩展(§3「扩展(冻结)」),MVP 期间不派单。
- **上一阶段终点 ✅**:P8「一键接入」——2026-10-04 用户终验通过(证据见 agent-client-parity P8 / P8g 卡)。
设计:`docs/tasks/2026-10-03-p8-onboarding-oneclick-design.md`。
## 1. 角色与协议 ## 1. 角色与协议
@ -45,6 +53,7 @@
- **MCP**:一律 `http://127.0.0.1:27190`(不用 localhost)。会话里 lian-jing 没连上时,可用 node `fetch` 直接 POST `http://127.0.0.1:27190/mcp`(全局路由,`tools/call`),结果在 `result.structuredContent` 或 `result.content[0].text`。 - **MCP**:一律 `http://127.0.0.1:27190`(不用 localhost)。会话里 lian-jing 没连上时,可用 node `fetch` 直接 POST `http://127.0.0.1:27190/mcp`(全局路由,`tools/call`),结果在 `result.structuredContent` 或 `result.content[0].text`。
- **变异验证**:先 `git add` 暂存,再改源码做变异、跑测试,最后 `git checkout -- <文件>` 从暂存区还原。没暂存就 checkout 会丢掉改动(统筹会话踩过)。 - **变异验证**:先 `git add` 暂存,再改源码做变异、跑测试,最后 `git checkout -- <文件>` 从暂存区还原。没暂存就 checkout 会丢掉改动(统筹会话踩过)。
- **真实客户端**:`claude -p`、`codex exec`、DSH headless 可能跑 3 分钟以上,只在会话主线程或后台 bash 里跑,不交给 Workflow 子 agent(超过 180 秒会被判卡死)。嵌套 claude 前先 `unset CLAUDECODE CLAUDE_CODE_ENTRYPOINT CLAUDE_CODE_SSE_PORT`,stdin 重定向自 `/dev/null`。 - **真实客户端**:`claude -p`、`codex exec`、DSH headless 可能跑 3 分钟以上,只在会话主线程或后台 bash 里跑,不交给 Workflow 子 agent(超过 180 秒会被判卡死)。嵌套 claude 前先 `unset CLAUDECODE CLAUDE_CODE_ENTRYPOINT CLAUDE_CODE_SSE_PORT`,stdin 重定向自 `/dev/null`。
- **工作流看门狗**:Workflow 子 agent 超过 180 秒没有进展即判卡死重试——一次性生成大文件(如整个 React 组件)、或前台跑长命令都会触发(P8e 修复阶段、P8g 实现阶段各卡死 6 次)。写文件分小块(单次 Write/Edit 约 150 行内),长命令一律后台轮询;UI 等需要大段生成的卡改用后台 Agent 执行。
- **凭据**:不读、不打印任何 token、凭据、`.env` 值;不对真实 Windows Credential Manager 做并发压力实验。 - **凭据**:不读、不打印任何 token、凭据、`.env` 值;不对真实 Windows Credential Manager 做并发压力实验。
- **运行中的炼境 DB 写入**:自动模式下会被安全分类器拦截,这是对的。需要写 DB 的数据修复准备好脚本、备份和空跑结果,交用户执行。 - **运行中的炼境 DB 写入**:自动模式下会被安全分类器拦截,这是对的。需要写 DB 的数据修复准备好脚本、备份和空跑结果,交用户执行。
- **提交**:Conventional Commits;`feat:` 带 `Feature-Confirmed: true`;末尾带 `Co-Authored-By` 署名行。PR 描述按自验报告纪律写,含「没验什么」一节。M 级卡开 PR 前用一个只读子代理做独立审查,审查处置写进卡片。 - **提交**:Conventional Commits;`feat:` 带 `Feature-Confirmed: true`;末尾带 `Co-Authored-By` 署名行。PR 描述按自验报告纪律写,含「没验什么」一节。M 级卡开 PR 前用一个只读子代理做独立审查,审查处置写进卡片。
@ -60,11 +69,18 @@
| ~~3~~ | ~~P8d onboard_project 编排本体~~ ✅ | M | P8c、P4a 合并后 | 复用 `onboard::plan::write_project_files` 与 `onboard::clients::registry()`;apply 前先重算计划并核对 digest | | ~~3~~ | ~~P8d onboard_project 编排本体~~ ✅ | M | P8c、P4a 合并后 | 复用 `onboard::plan::write_project_files` 与 `onboard::clients::registry()`;apply 前先重算计划并核对 digest |
| 4 | P8e 投影收口与契约同步 | S | P8d 后 | | | 4 | P8e 投影收口与契约同步 | S | P8d 后 | |
| 5 | P8f register_project 控制面投影 | S | 已提前并行(只依赖 P8-0) | [MCP] 链路实测待 P8e 合并后做 | | 5 | P8f register_project 控制面投影 | S | 已提前并行(只依赖 P8-0) | [MCP] 链路实测待 P8e 合并后做 |
| 6 | P8g UI 一键接入 | M | P8e 后 | human_verify 交用户 | | ~~6~~ | ~~P8g UI 一键接入~~ ✅ | M | P8e 后 | human_verify 交用户 |
| ~~并行~~ | ~~删除项目登记时一并解绑 Gitea 仓库~~ ✅ G8 | S/M | master | 来自重复登记排查会话的推荐任务卡(轮询会继续往已删除的项目 ID 写数据),主要改 projects.rs / gitea.rs,可并行 | | ~~并行~~ | ~~删除项目登记时一并解绑 Gitea 仓库~~ ✅ G8 | S/M | master | 来自重复登记排查会话的推荐任务卡(轮询会继续往已删除的项目 ID 写数据),主要改 projects.rs / gitea.rs,可并行 |
| 后续 | P6(依赖 P8c)、P4c / P4d / P4e、A4→P4b、P5 | | | P8 完成后再排 | | MVP-1 | project-dev-variables 人终验 → 并入 mvp-closure M5 | — | — | 用户 2026-10-04 定:以 enterprise-system 真实开发验证四条能力(开工/自验/交付/摩擦闭环),原 V13 终验并入;炼境侧只经 MCP 只读取证 |
| MVP-2 | blueprint-buff 关账 → mvp-closure M2 ✅ | S | master | 8 张卡全 ✅,但 B2 终验被否决(IC10 误标),剩余为方案 C、冻结;模块保持 in_progress 90% |
| MVP-3 | 本轮清理 → mvp-closure M3 | — | — | 2026-10-04 agent 侧已完成(取消登记 2 个、删 worktree 5 个),剩 §5 的手动删除 |
| MVP-4 | 常驻文档漂移修复 → mvp-closure M4 | S | master | 纯文档可直推;碰 agents-meta-rules 时同步检查接入包模板版本 |
| 扩展(冻结) | 部署控制面(project-capability-control-plane)、P4b–P4e、P5、P6、治理缺口 ②③(governance-feedback-loop)、DSH 接管(dsh-takeover-readiness)、Codex 模型切换(codex-model-switch)、多维视图(manage-multi-view)、架构演进(architecture-evolution)、intent-catalog Phase 4+(IC6–IC13:门控脚本、接线、书签交接、enterprise 试点——用户 2026-10-04 定继续冻结)、project-dev-variables V14–V16(测试账户落地到被忽略文件)、blueprint-buff 方案 C(files 重叠改记 DB 信号,B2 终验 2026-10-04 被否决后的升级路径) | | | 2026-10-04 用户定:MVP 收口期间不派单,MVP 达成后再排 |
| 扩展(冻结) | 概念占位登记显式化(UI 不选目录的占位登记) | S | — | 用户 2026-10-04 定:MVP 保持现状;出现具体干扰(诊断、统计、接入入口把占位当普通项目)再出 S 级确认卡 |
| 后续小修 | P8f 审查转入:L4 路径归一函数统一到 crate::path_key(含 Codex 信任路径、WSL 发行版与 UNC 换算)、I1 update_project 有效根变化才查重并排除自身、I2 project_root_with_conn 拼接 UNC 形式 wsl_path 的已有缺陷 | S | master | 碰 mcp_inject.rs,P8 主线后再做 | | 后续小修 | P8f 审查转入:L4 路径归一函数统一到 crate::path_key(含 Codex 信任路径、WSL 发行版与 UNC 换算)、I1 update_project 有效根变化才查重并排除自身、I2 project_root_with_conn 拼接 UNC 形式 wsl_path 的已有缺陷 | S | master | 碰 mcp_inject.rs,P8 主线后再做 |
| 后续小修 | backfill_notes_archive 静默跳过非 UTF-8 旧笔记(dev-manager-tauri 有 4 条);PR #34 审查遗留 L3(保留他项目 Codex 块不留痕)、L4(沉默统计并列偏向非规范 ID,补测试)、I1(注释说明两处语义差异)、I2(沉默列表带 id) | S | master | 不碰 P8 热点文件的可并行 | | 后续小修 | backfill_notes_archive 静默跳过非 UTF-8 旧笔记(dev-manager-tauri 有 4 条);PR #34 审查遗留 L3(保留他项目 Codex 块不留痕)、L4(沉默统计并列偏向非规范 ID,补测试)、I1(注释说明两处语义差异)、I2(沉默列表带 id) | S | master | 不碰 P8 热点文件的可并行 |
| 后续小修 | P8g 审查 ④:L1 格子由本体带 pending_user(目前 onboardView.ts 写死 codex_project_untrusted 着色);面板状态机(过期响应、refused 回预览)补组件测试;终验记下的文案:新建文件「查看差异」只有一行概要改行内显示,git_hooks 与 Claude/DSH 行「已写入」标签重复或不准 | S | master | 碰 probe_l1.rs / onboardView.ts |
| 说明 | 上面三行「后续小修」在 MVP 期间同样冻结,除非某条被证实阻碍 MVP 四条可用性 | | | |
| 待用户 | beast-mode 同路径重复登记(beast-mode / 940dfbb4,无 Gitea 绑定) | — | — | 需写运行中 DB 与删除登记,按 U3 同法准备脚本后交用户执行 | | 待用户 | beast-mode 同路径重复登记(beast-mode / 940dfbb4,无 Gitea 绑定) | — | — | 需写运行中 DB 与删除登记,按 U3 同法准备脚本后交用户执行 |
## 4. 派单与 PR 流水(统筹维护) ## 4. 派单与 PR 流水(统筹维护)
@ -78,16 +94,25 @@
| 10-03 | 删除登记时解绑 Gitea(G8) | 工作流 wf_c121815d-6ea | PR #35(fccb767) | ✅ 审查可合并、5 条已处置;真机删除实测为可选人工验证(涉及删除与写 DB) | | 10-03 | 删除登记时解绑 Gitea(G8) | 工作流 wf_c121815d-6ea | PR #35(fccb767) | ✅ 审查可合并、5 条已处置;真机删除实测为可选人工验证(涉及删除与写 DB) |
| 10-03 | P4a L1 零模型三端检查 | 工作流 wf_b7092645-570(修复阶段被分类器拦截,统筹接手收尾) | PR #38(a79bcb7)→ cf2b5f0 | ✅ [MCP] 实测:enterprise 3.3 秒三端 18 格 ready;dev-manager-tauri 控制面 Claude/DSH not_applicable、Codex ready | | 10-03 | P4a L1 零模型三端检查 | 工作流 wf_b7092645-570(修复阶段被分类器拦截,统筹接手收尾) | PR #38(a79bcb7)→ cf2b5f0 | ✅ [MCP] 实测:enterprise 3.3 秒三端 18 格 ready;dev-manager-tauri 控制面 Claude/DSH not_applicable、Codex ready |
| 10-03 | P8d onboard_project 编排本体 | 工作流 wf_004ffc20-7cb | PR #39(2f2a9f1)→ d018d44 | ✅ 审查 10 条已处置;master 402 passed;⑩ 统筹决定:Codex 未信任计 next_action 不计入 done(P8e 实现) | | 10-03 | P8d onboard_project 编排本体 | 工作流 wf_004ffc20-7cb | PR #39(2f2a9f1)→ d018d44 | ✅ 审查 10 条已处置;master 402 passed;⑩ 统筹决定:Codex 未信任计 next_action 不计入 done(P8e 实现) |
| 10-03 | P8e 投影收口与契约同步 | 工作流 wf_551dc525-270 | `feat/agent-client-parity-p8e` | 执行中 | | 10-03 | P8e 投影收口与契约同步 | 工作流 wf_551dc525-270(修复阶段卡死 6 次,审查已可合并,统筹以 97578b2 开 PR) | PR #40 → d7f4816 | ✅ 端到端:新登记项目 done、重复执行全 converged;enterprise 因主工作区落后不 apply(偏差已报备) |
| 10-03 | P8g UI 一键接入 | 工作流 wf_531cfcda-b1a 实现阶段 6 次 180 秒无进展被判卡死(未产出代码,属执行方式问题、不计自验失败)→ 改派后台 Agent(无看门狗,分块写文件)也流卡死 → 10-04 新统筹会话主线程直做(续用半成品 onboardView.ts,分块写入) | PR #41(c28caf7)→ 3228b49 | ✅ 审查 merge、5 条:4 修 1 转后续小修(L1 格子带 pending_user);master typecheck 通过、vitest 29 passed、全量 cargo test 414 passed;human_verify 待用户 |
| 10-03 | P8f register_project 控制面投影(含登记拒绝同路径,承接 PR #34 审查 L1/L2) | 工作流 wf_2462357e-604(与 P4a 并行,开 PR 前合并 master) | `feat/agent-client-parity-p8f` | PR #37(04470bd)→ 55dc637 已合并;审查 10 条:7 修、1 部分修、M2 恢复 UI 概念占位原行为(产品问题待用户澄清)、2 转后续;卡片 🔵,[MCP] 链路实测待 P8e 合并 | | 10-03 | P8f register_project 控制面投影(含登记拒绝同路径,承接 PR #34 审查 L1/L2) | 工作流 wf_2462357e-604(与 P4a 并行,开 PR 前合并 master) | `feat/agent-client-parity-p8f` | PR #37(04470bd)→ 55dc637 已合并;审查 10 条:7 修、1 部分修、M2 恢复 UI 概念占位原行为(产品问题待用户澄清)、2 转后续;卡片 🔵,[MCP] 链路实测待 P8e 合并 |
| 10-03 | 重复登记修复 U1/U2 | 会话 `local_d2e1c156…`(「排查炼境 dev-manager-tauri 疑似重复登记」) | PR #34 → fc280db | ✅ 独立审查可合并、已合并,炼境已重编译;审查遗留 L1/L2 归 P8f(登记拒绝同路径),L3/L4/I1/I2 列入后续小修 | | 10-03 | 重复登记修复 U1/U2 | 会话 `local_d2e1c156…`(「排查炼境 dev-manager-tauri 疑似重复登记」) | PR #34 → fc280db | ✅ 独立审查可合并、已合并,炼境已重编译;审查遗留 L1/L2 归 P8f(登记拒绝同路径),L3/L4/I1/I2 列入后续小修 |
| 10-03 | 重复登记数据合并 U3 | 同上(用户执行 DB 写入) | master 91017b6;主仓库 .codex/config.toml 升级为稳定 helper 格式 06f20db | ✅ 无 2c5b54ef 残留、同路径 1 条登记、Gitea 绑定 1 行;备份 dev-manager.backup-20261003-before-dedupe.db | | 10-03 | 重复登记数据合并 U3 | 同上(用户执行 DB 写入) | master 91017b6;主仓库 .codex/config.toml 升级为稳定 helper 格式 06f20db | ✅ 无 2c5b54ef 残留、同路径 1 条登记、Gitea 绑定 1 行;备份 dev-manager.backup-20261003-before-dedupe.db |
| 10-04 | 意图目录线 IC1–IC4(并行线交接登记) | 另一会话 | PR #42–#45 → master 0ffaad0 | ✅ 设计 docs/tasks/2026-10-04-intent-catalog-design.md、指南 docs/ai-context/intent-catalog-guide.md、目录 .blueprint/catalog.md 1.0(INT-01–03,书签暂指本文件 §0);Codex 跨客户端纸面编译通过;模块进度 31%。IC5(首次真实 /goal)可用「MVP 收口」做;Phase 4+(IC6–IC13)冻结为扩展;目录改动按指南走(小版本须用户确认,提交带 Feature-Confirmed) |
| 10-04 | 阶段切换与清理 | 统筹会话 | master 直推 | P8 达成;§0 终点改为「MVP 收口」,扩展冻结登记进 §3;临时登记 2 条与 worktree 5 个已清理,手动删除项见 §5 |
## 5. 待用户处理(统筹会话汇总,按时机) ## 5. 待用户处理(统筹会话汇总,按时机)
- ~~重复登记数据合并~~:已由用户执行完毕并验收(见 §4)。 - ~~重复登记数据合并~~:已由用户执行完毕并验收(见 §4)。
- **临时文件待用户清理**(deny 规则禁止 agent 删除):E: mp erify_before.json;重复登记会话 %TEMP% 下的 merge_dup.py 等;统筹会话 %TEMP% 下的 lj-p4-0、lj-p7-probe、lj-p9-spike 等探针目录;已合并分支的 worktree(tmp-p7skill-review、tmp-delivery-status-review、tmp-p10-verify-mut、dev-manager-tauri-wt-p8)可用 git worktree remove 清理。 - ~~P8 human_verify~~:2026-10-04 用户终验通过(证据见 P8g 卡 human_verify),**本阶段终点 P8 达成**。
- **需求澄清(不阻塞主线)**:UI「添加项目」不选目录时可建「概念占位」登记(P8f 已保留原行为)。是否要把占位做成显式概念(单独入口、标记为占位、不参与接入),等你决定。 - **本轮清理(2026-10-04 用户确认删除,agent 侧已完成)**:unregister_project 删除 lj-p8-e2e-20261003(ac73a4bb…)与 lj-p8g-ui-test(5818aa5a…)两条登记(本地文件未动);git worktree remove:tmp-p7skill-review、tmp-delivery-status-review、tmp-p10-verify-mut(含审查探针测试,--force 丢弃)、dev-manager-tauri-wt-p8、dev-manager-tauri-wt-intent(已注销,空目录删不掉,可能被 Codex 侧边栏占用);dev-manager-tauri-wt-p8g 在本次文档提交后移除。
- **待你手动删除**(deny 规则禁止 agent 删除):
- 目录:`E:\code-project\lj-p8-e2e-20261003`、`E:\code-project\lj-p8g-ui-test`、`E:\code-project\lj-p8g-ui-cancel`(误建、未登记)、`E:\code-project\dev-manager-tauri-wt-intent`(空目录)、`E:\code-project\dev-manager-tauri-wt-p8g`(若移除后残留);
- 文件:`E:\verify_before.json`;
- `%TEMP%` 下:重复登记会话的 `merge_dup.py` 等,统筹会话的 `lj-p4-0`、`lj-p7-probe`、`lj-p9-spike` 等探针目录,`tmp.h9jWUlwgmv\`(意图目录探索章检查夹具);
- 可选:Codex 信任表(`~/.codex/config.toml`)里 `e:\code-project\lj-p8g-ui-test` 的信任条目。
- ~~需求澄清:概念占位登记~~:用户 2026-10-04 定 MVP 保持现状、列入扩展(§3)。
- **Codex 信任**:Codex 只在目录受信任后加载项目 `.codex/config.toml`(P4-0 H-P8-1)。一键接入会把它列进 next_actions,炼境不改 Codex 的信任表。 - **Codex 信任**:Codex 只在目录受信任后加载项目 `.codex/config.toml`(P4-0 H-P8-1)。一键接入会把它列进 next_actions,炼境不改 Codex 的信任表。
## 6. 当前已知事实(易变,以工具自省为准) ## 6. 当前已知事实(易变,以工具自省为准)
@ -95,3 +120,55 @@
- `verify_onboarding(enterprise)` 的 `clients` 三端均 converged。 - `verify_onboarding(enterprise)` 的 `clients` 三端均 converged。
- `list_all_projects`:除 enterprise 外,其余登记项目大多缺项目 token(历史接入早于 token 机制),这些正是一键接入要接的对象。 - `list_all_projects`:除 enterprise 外,其余登记项目大多缺项目 token(历史接入早于 token 机制),这些正是一键接入要接的对象。
- 使者回传:0 条待处置。 - 使者回传:0 条待处置。
## 7. 交接(2026-10-04,统筹会话上下文将满,换新会话继续)
> **已执行完毕(2026-10-04)**:本节的 P8g 与收尾全部完成,见 §4;下一阶段按 §0「MVP 收口」推进。本节保留作交接记录。
新会话即新的统筹会话:先读本文件 §1–§6,再按下面接手。旧统筹会话的 30 分钟巡检已停止。
**当前状态**
- ✅:P4a(PR #38)、P8c(#36)、P8d(#39)、P8e(#40)、P8f(#37),以及 G8(#35)、PR #34。
- 证据都写在 `.blueprint/modules/agent-client-parity.md` 各卡的 mcp_verify / merge_verify,以及 P8 卡的 e2e_verify:
- 新登记临时项目 `ac73a4bb-a601-4e21-bc0f-7eda71fae4aa`(目录 E:\code-project\lj-p8-e2e-20261003)走完 register → plan → onboard_project,得 done;
- 再执行一次 9 步全部收敛,文件 mtime 不变。
- master 最近一次全量回归:P8d 合并后 cargo test 402 passed。P8e(d7f4816)的分支自测为 413 passed,但合并后在 master 上还没跑全量,收尾时要跑。
**唯一未完成:P8g UI 一键接入(🔵)**
- worktree:E:/code-project/dev-manager-tauri-wt-p8g,分支 feat/agent-client-parity-p8g,基于 51a39d0,未提交、未推送。
- 已有的半成品改动:
- src-tauri/src/onboard/plan.rs(+38,执行 agent 称 Rust 侧 414 passed);
- src/lib/commands.ts(+2);
- P8g 卡已标 🔵;
- 新文件 src/components/dashboard/onboardView.ts 只写了一部分。
- 委派失败两次(工作流 180 秒看门狗卡死 6 次;后台 Agent 600 秒流卡死),都卡在一次性生成大文件。**在新会话主线程里直接做**:
- 先审一遍上面的半成品,保留就续写、不保留就从头写;
- 单次 Write/Edit 不超过约 150 行,长命令放后台轮询。
- 范围以 P8g 卡的 acceptance 为准:onboardView.ts 加 vitest 视图纯函数测试、OnboardPanel.tsx、各入口接线。
**收尾到 /goal 终点**
1. P8g:
- pnpm typecheck 与 pnpm test 通过;
- 做一次只读独立审查并处置;
- 开 PR,CI passed 后按完整 head SHA 合并;
- 主仓库 git merge --ff-only origin/master(不碰用户的 3 个未提交文件:notes-archive.jsonl、usage.json、Cargo.toml——前两个会被运行中的炼境自动写入,Cargo.toml 只差行尾)。
2. 在 master 上跑 pnpm typecheck 与全量 cargo test(CARGO_TARGET_DIR 用 parity 热缓存),结果写进 P8g 卡。
3. P8g 卡标 ✅(agent_verify 已过;human_verify 交给用户),更新 manifest 进度与本文件 §4。
4. 向用户汇报证据,并列出:
- human_verify:
- Codex 里信任 E:\code-project\lj-p8-e2e-20261003 后重跑 probe_client_parity,C–F 应变为 ready;
- Claude Code、Codex、DSH 桌面 GUI 各新开会话,调用 read_project_test_account(name=LJ_PROBE_NONEXISTENT),应返回「开发需求未登记」;
- P8g 界面终验;
- 删除确认:端到端临时项目(unregister_project 后手删目录);
- 各执行 agent 留下的临时文件。
**后续(P8 终点之后)**
- §3 的「后续小修」:
- P8e 审查的 3 条低优先级与 5 条信息项(修复半成品还在 E:/code-project/dev-manager-tauri-wt-p8e,未提交);
- 结构化工具应同时在 content 里返回序列化 JSON(MCP 规范建议,否则只读 content 的客户端看不到计划细节);
- backfill 跳过非 UTF-8 旧笔记;
- P8f 审查转入项。
- 其他:
- 接入包模板改为引导 plan_onboarding → onboard_project(需升版本);
- beast-mode 重复登记(需用户执行 DB 写入);
- 占位登记的需求澄清。

View File

@ -0,0 +1,353 @@
# 设计决策:意图目录(intent-catalog)· IC1
> status: 已确认(2026-10-04,五项待拍板全部采纳推荐)| complexity: L(本文只到设计,实现拆为 IC2–IC13)| created: 2026-10-04 | blueprint: intent-catalog
> 修订 2026-10-04:增加探索章(意图从迭代中结晶),见模块决策记录与指南「探索章与结晶」;本文未逐节同步。
> ⚠️ 处置条款:用户确认后,稳定结论回写 `.blueprint/modules/intent-catalog.md`(决策记录与任务卡),本文件在 IC3 完成后 24h 内删除,不做第二事实来源。
> 产出方式:/architect 评审团工作流 wf_60e4c430-bb1。3 个独立方案(最小文件优先、结构化优先、最大化复用)交 2 位评委(agent 友好度与成本、治理与风险)打分,由综合者定稿;关键代码事实已由主会话复核。
## 背景
- 需求本体见 `.blueprint/modules/intent-catalog.md`,包括两层模型、W1–W14 承重墙、13 个待设计问题和「不做什么」。
- 并入 `docs/tasks/2026-09-23-blueprint-agent-handoff-pilot.md` 的「信息归属与同步契约」与「最小任务简报的按需读取与回执」。
- 关联模块:
- blueprint-governance:前置,负责安全派发与状态语义收敛。
- agent-client-capability-packs:版本化 pack 机制。
- governance-feedback-loop:修订历史与否决理由的回流。
- agent-client-parity:P8 在制品,期间不碰其热点文件。
## 方案选择
| 方案 | 优点 | 缺点 | 结论 |
|---|---|---|---|
| **最小文件优先**:Markdown 目录 + 卡上 intent 行 + 只警告的 node 门控 + 模型无关的编译指南 | 试用只新增文件,撤销最便宜;离线、跨 agent、零依赖;不进 DB、不加 MCP | 原稿把门控放在试用期、在文件内记修订历史、双向存归属、简报缺定位信息 | ✅ 选为主体,按评委 must_fix 修正 |
| 结构化优先:schema 化 YAML + Rust 解析/lint + 只读 MCP | 可断言程度最高;类型化指针与影响分析严谨 | 权威校验在炼境 crate 内,子项目离线拿不到;YAML 写错会让 cargo test 变红;人维护负担重;撤销成本最高 | 不选;嫁接类型化指针、stale/orphan 分类、base 不符即重提、数据门控 |
| 最大化复用:放进既有载体 + 正文上行挂靠 + 并入托管 blueprint-gate | 单一事实源守得最严;简报、blob、回执复用既有载体 | Phase 4 就把检查分发给所有子项目,早于试点与去留决策;改 CONVENTIONS 的「意图层」会破坏分类轴并整文件广播 | 不选;嫁接简报/blob/回执、单向挂靠、章 rev、待裁决视图 |
评分:agent 友好度视角为最小 25/30、复用 25/30、结构化 19/30;治理与风险视角为最小 24/30、复用 21/30、结构化 18/30。两位评委都判最小方案无致命缺陷。
**选定**:以最小方案为主体,嫁接以下几点:
- 归属只从卡侧单向挂靠;
- 每章带 rev,修订审计交给 git;
- 目标确认卡兼作 handoff 的最小任务简报,包含 project_id、分支/worktree,并以 catalog blob 作 digest;
- 回执写进收口提交的 body;
- 人工终验独立成 `- 终验:` 行;
- 指针带类型前缀;
- 影响分析分 stale 与 orphan 两类;
- 代码化工作设数据门控。
试用期只新增两份文档、不写代码,门控脚本挪到 P8 收口后。
## 设计规格
### 1. 目录文件
- **位置**:`.blueprint/catalog.md`。它在 modules/ 之外,已核实以下机制都不会碰到它:
- `archive_project_docs` 只归档 modules/*.md;
- blueprint-gate 只扫描 modules/;
- `get_blueprint` 只按 manifest 读模块;
- `sync_blueprint_rules` 只整文件写 CONVENTIONS.md。
- **格式**:纯 Markdown 小语法,依次为引言行、`## 书签`、`## INT-NN 章名`(可有多章)、撤销墓碑、`## 附录`。
- **章导语字段**:必填 `rev`、`意图`、`人看`、`机器`、`不做`;可选 `风险`、`假设`、`证据`、`墙`。
- **防膨胀**:
- 每字段单行,不超过 120 字;
- 每个章块不超过 12 行;
- 全文件不超过 200 行、8KB;
- 禁止 `status`、`progress`、`doc`、`files`、`acceptance`、`model` 键;
- 不设文件内修订历史。
- **语法的单一来源**:`docs/ai-context/intent-catalog-guide.md`(IC2)。
示例(章名与内容仅作示意,1.0 由人在 IC3 定稿):
```markdown
# 意图目录
> catalog_version: 1.0 | 前言 → path:AGENTS.md#项目定位 | 语法 → path:docs/ai-context/intent-catalog-guide.md
## 书签
- 当前 → path:docs/tasks/2026-10-03-coordination.md#0. 方针与本阶段终点
## INT-01 一键接入三端可用
- rev: 1.0
- 意图: 新建或添加子项目后一次确认即在三端可开工
- 人看: 新项目首个会话无需手工配置即可调用炼境工具
- 机器: card:agent-client-parity#P8e
- 不做: 不替 agent 选模型;不让子项目依赖炼境在线
- 墙: W12,W13
## INT-09(已撤销)
- 撤销: YYYY-MM-DD → module:intent-catalog#决策记录
## 附录
- 承重墙 → path:.blueprint/modules/intent-catalog.md#承重墙
- 决策与否决 → 各模块「决策记录」;终验否决理由 → 卡上 `- 终验:` 行
```
### 2. 挂靠与指针
- **单向挂靠**:
- 卡上可选写一行 `- intent: INT-NN@X.Y`,紧跟在 complexity 后面。
- 模块头的 blockquote 可选写 `| intent: INT-NN` 作为默认挂靠,不带版本,影响分析里计为低置信。
- 章的「机器:」只是验收坐标指针,不登记成员;反向索引由门控现算,不存储。
- **类型化指针**:
- `path:<路径>[#标题前缀]`
- `module:<id>`
- `card:<module>#<卡键>`
- `spec:<路径>#标题`
- `cmd:<命令>`:只校验格式,不执行
- `W<n>`
多个指针用「;」分隔。卡键取标题去掉状态前缀后的第一个 token,例如 `IC6`、`P8e`。
- **解析器行为**(主会话已复核 `blueprint.rs:335-420` 与 `buff.rs:495-505`):
- `parse_module_md` 只认 status、complexity、files、depends、acceptance、notes、blocked_reason 这几个键,`- intent:` 与 `- 终验:` 不进任何字段。
- `- status:` 行会覆盖标题前缀。
- 多条 `- notes:` 时后一条覆盖前一条,所以终验另起 `- 终验:` 键。
- 未识别的 `##` 段(Section::None)下出现的 `###` 会被当成任务卡,所以**模块 md 里任务卡段以外一律不许用 `###`**。
- buff 自动标 🔵 只替换标题前缀和 `status: todo` 行,不碰 `intent`/`终验` 行。
### 3. 修订、钉版与影响分析
- **版本号**:引言里只写一个 `catalog_version: X.Y`;每章另有 `rev`,即该章最后一次变更时的版本。与 manifest.iteration 互不借号。
- **三级修订**:
| 级别 | 触发 | 谁改 | 版本变化 |
|---|---|---|---|
| 补丁 | 只改正文,目录不动 | agent 自主 | 无 |
| 小版本 | 改章导语的坐标,或由正文反推修改目录 | agent 出 S 级三行确认卡,附 diff 和 base blob(`git rev-parse --short HEAD:.blueprint/catalog.md`),人确认 | Y+1,被改章的 rev 设为新版本 |
| 大版本 | 增删章节、调整方向 | 人主导 | X+1、Y 归零;涉及的章更新 rev;删掉的章留墓碑;按 T4 检查 AGENTS.md「项目定位」 |
- **审计交给 git**:目录提交写成 `docs(intent): …`,body 写一句理由,并带 `Feature-Confirmed: true`。提交前如果 HEAD 里的 blob 已不等于提案的 base,就重新提案,沿用 W9 的 plan→digest→apply 语义。
- **钉版**:卡钉 `INT-NN@X.Y`;goal 标签写 `INT-NN@X.Y#blob7`。
- **影响分析**:
- stale:钉的版本低于章 rev,且卡未完成。
- orphan:钉在墓碑章上。
- low_confidence:只有模块默认挂靠。
- **在制品保护**:
- 钉旧版的 🔵 卡照常做完,只复核 acceptance。
- 章被撤销,或新的「不做」覆盖了该卡时,停下来找人。
- 不自动改写卡。agent 复核 acceptance 无变化后改钉,算补丁,在简报里报告。
### 4. goal 编译与目标确认卡(兼最小任务简报)
**编译七步**:模型无关,只依赖读文件,node 门控可选;/architect 只是引用指南的 Claude 包装。
1. **定位**:从 `.lian-jing/context.json` 取 project_id,记下当前分支、worktree、HEAD;要求 `git status --porcelain -- .blueprint/catalog.md` 为空,取 catalog blob。
2. **读书签**:定位当前章(P8 期间按 coordination §0 的终点),读该章导语和 rev。
3. **校验**:P8 收口后跑 `intent-gate.cjs --report INT-NN --impact`,在此之前用指南里的 shell 等价检查。遇到悬空指针、stale/orphan 或防膨胀警告,先修或先提案,不往下编译。
4. **收卡**:取挂在本章、状态为 📋/🔵 的卡。没有可执行 agent_verify 的,列入「须先补 acceptance」,不进 goal。
5. **合成终点**:
- 取各卡 agent_verify 的合取,改写成会话里可判定的形式:贴出命令和预期输出、纳入卡前缀均为 ✅、回执块已写入。
- 过程词黑名单(按方针、符合设计、设计已完成、基本完成)命中数必须为 0。
- human_verify 不进终点,单列为终验待办。
6. **写明停止找人的条件**:human_verify、写运行中 DB、删除、凭据或机器状态变更、超出纳入卡或本章、需改目录、stale pin、失败 3 次。
7. **输出确认卡和 /goal 文本**:人读完亲手粘贴即为确认。要改就重新编译,agent 不得自行启动或静默改动。
**目标确认卡模板**(/goal 文本首行带同样的标签):
```text
[INT-02@1.0#a1b2c3d] 目标确认卡
项目: <project_id> | 分支/worktree: <branch> @ <path> | HEAD: <sha7>
章意图: <一句> | 不做: <…>
纳入卡: IC6(来源 agent_verify 原文)、IC7(…)
终点(合取): 1) <命令> → <预期输出> 2) … 3) 纳入卡均 ✅ 且已写 Goal-Receipt
终验待办: <human_verify 项>
停止找人: <第 6 步清单>
能力入口: pnpm typecheck / cargo test / <MCP 工具>
没验什么: <…>
作废: 分支变化或 catalog blob ≠ a1b2c3d
```
**回执**:goal 收口时写进收口提交的 body,M 级同时复制到 PR body;炼境在线时可再调 append_project_note。格式为以下几行 trailer:
- `Goal-Receipt: <标签>`
- `Goal-Cards:`
- `Goal-Result: 判对|误判|中止(原因)`
- `Goal-Rounds:`
- `Goal-Interventions:`
- `Goal-Tokens: <客户端可得时填,否则 n/a>`
- `Not-Verified:`
- `Human-Pending:`
不写进模块决策记录,那会被 UI 当成决策展示;也不手改 `notes-archive.jsonl`,它以 DB 为事实源、会被整文件重写。
### 5. 书签
- **载体**:catalog.md 的 `## 书签` 段。
- **P8 期间**:只写一行指针,指向 coordination §0,终点仍以 §0 为唯一事实源。
- **P8 收口后(IC10)**:改为自持三行:`- 当前: INT-NN`、`- 终点 → card:<module>#<卡键>`、`- 确认: YYYY-MM-DD`。同一次提交把 coordination §0 改成指向书签(若文件已按处置条款删除则跳过),此后统筹文档只管派单与交接。
- **切换书签**:不升版本,但走与小版本相同的流程:附 `--report` 证据和 base blob,人确认,提交带 Feature-Confirmed。书签指针悬空时门控报警,这本身就是交接信号。
### 6. 机器校验
- **Phase 3(只新增文档,不写代码)**:检查全靠卡 acceptance 里的 shell 单行命令:
- grep 统计章数和禁用键;
- wc 检查体量;
- `grep -oE 'path:[^ #;]+' | xargs test -e` 校验路径指针;
- 新增前后用 `grep -c '^### '` 计数比对,作为 get_project_blueprint 的离线替代。
- **Phase 4(P8 收口后)**:新增零依赖的 `.claude/hooks/intent-gate.cjs`,恒 exit 0、只警告,`INTENT_CATALOG` 环境变量可以指向夹具,没有目录文件时静默。检查分六类:
1. 结构:版本行存在、INT 唯一、墓碑不被复用、rev 不大于 catalog_version。
2. 防膨胀:字段白名单、单行与体量上限、禁用键与模型名。
3. 类型指针可解析。
4. 卡侧:intent 指向的章存在且未撤销,钉的版本不高于当前版本。
5. 版本纪律:只读 `git diff --cached`,章文改了而 rev 或版本没升就警告。
6. 只读视图:
- `--report`:按解析器语义推导章的四态,标注 status_source;汇总 Goal-Receipt;审计缺 Feature-Confirmed 的目录提交。
- `--impact`:输出 stale/orphan/low_confidence。
- `--pending`:列出有 human_verify 但没有 `- 终验:` 行的卡,以及未提交的目录改动。
- `--self-test`:用内置坏样例自检。
- **接线**:lefthook pre-commit 以 `|| true` 接入;不进 CI 阻断,也不并入托管的 blueprint-gate。另加一条 cargo test,锁定解析器忽略 intent 与终验行。
- **数据门控**:Rust 解析、MCP 查询这类代码化工作,要同时满足钉版卡不少于 5 张、至少发生过 1 次小版本修订、enterprise 试点完成、且 IC13 决定保留之后才考虑。
### 7. 术语映射
- **方针层(前言)**:AGENTS.md「项目定位」。
- **目录层**:`.blueprint/catalog.md`,包括章、导语、附录、书签;索引就是 INT-NN。
- **正文层**:manifest、modules/*.md 和任务卡。
- **不改的词**:CONVENTIONS 里的「蓝图定位(意图层)」与「架构意图层」保留,解释为「.blueprint 全体(目录 + 正文)相对 git 事实层」。这样不触碰整文件分发的规则,也不破坏分类轴。
- **唯一改名点**:`docs/ai-context/agent-button-system.md:51` 的「意图层 — AGENTS.md」改为「方针层 — AGENTS.md」。该文件不在 resources/onboarding 内,已核实;在 Phase 4 由 IC8 执行。之后新文档不再单独使用「意图层」一词。
## 13 个待设计问题的化解
| # | 问题 | 化解 |
|---|---|---|
| 1 | 「意图层」三处归属 | 定死方针层、目录层、正文层三层;CONVENTIONS 的「意图层」保留并重新解释;全仓只改 agent-button-system.md:51 一处,由 IC8 执行。否决改 CONVENTIONS 的做法,因为它会破坏分类轴并触发整文件广播 |
| 2 | 红线:章完成不能手动切换 | 目录不设任何状态字段;章的四态(未开始、进行中、待人终验、已达成)只由 `--report` 从卡状态和 `- 终验:` 行临时推导,不落盘、不提供入口。书签切换属于方向决策,不算改状态 |
| 3 | 状态语义未收敛 | 推导按解析器语义来:先看前缀,有 status 行则以它为准,并标注 status_source;前缀与 status 行不一致时警告。正式收敛交给 blueprint-governance 前置,收敛前推导结果标为「参考」;stale/orphan 不依赖状态语义 |
| 4 | 四套分类轴的对应 | 补丁对应 Bug 和章内 S/M Feature,T1–T4 照旧;小版本对应改变章坐标的 Feature(S 级确认卡),触发 T5-minor;大版本对应 L 级或方向调整,触发 T5-major,并按 T4 检查项目定位。manifest.iteration 只计模块重构。T5 先写进炼境 AGENTS.md 托管块外,登记为有意的临时分叉,在 IC13 回收 |
| 5 | ID 前缀 | 章用 INT-NN,永不复用,撤销留墓碑;W1–W14 只出现在模块和设计文档里;卡从 IC2 起编号;钉版写 `INT-NN@X.Y`,goal 标签写 `INT-NN@X.Y#blob7`。2026-10-04 已用 git grep 确认这些前缀都没被占用 |
| 6 | goal 级确认代替逐卡确认 | 只起草,见下文「立法提案草案」。P8 期间只记账,P8 收口后由 IC11 带着数据交给用户裁决 |
| 7 | W11 资源:只记账不分配 | 由 Goal-Receipt 记录轮数、介入次数,token 可得时一并记录,`--report` 按章汇总;目录与 goal 文本都禁止出现模型名。CONVENTIONS 复杂度表映射到模型名的矛盾,交给前置收敛 |
| 8 | 防止容器化 | 只放 ID、一句话意图和类型化指针,加上白名单、体量上限、禁用键,不设文件内修订历史;goal 编译第 3 步把警告当作阻塞 |
| 9 | 书签与 coordination §0 | P8 期间书签只是一行指针;之后由 IC10 改为自持,agent 起草、人确认,同一次提交把 §0 改成指向书签 |
| 10 | 离线与降级 | 目录、指南、门控、回执都在项目 Git 里,离线可读可跑;不新增 MCP 工具,在线时用现有的 get_project_file 读同一份文件;跨项目索引受数据门控约束 |
| 11 | 跨 agent | 编译流程写进 intent-catalog-guide.md,作为唯一来源,/architect 只引用不复述;IC4 由 Codex 或 DSH 纸面试跑验证。保留后经 blueprint-baseline 包或安全派发并入 CONVENTIONS,不走整文件广播 |
| 12 | 子项目已有意图载体 | 用 `spec:.specify/specs/<id>/spec.md#标题` 指向;单行和体量上限从物理上防止抄录;在 IC12 验证 |
| 13 | 物理位置与前言 | 放在 `.blueprint/catalog.md`:属于启动就读的蓝图目录,又在 modules/ 之外。前言只写一个指针 `path:AGENTS.md#项目定位`。不放 AGENTS.md,避免常驻成本和托管块覆盖;不新开 docs/intent/,因为它不在启动读取路径上 |
## 承重墙四问
| 墙 | 落点 | 机制 | 机器检查 | 何时拆除 |
|---|---|---|---|---|
| W1 迭代 | 引言版本 + 各章 rev;卡和 goal 上的钉版 | 三级修订;钉版;审计交给 git;与 iteration 分开 | `--impact` 报 stale/orphan;章文改了而 rev 未升时警告 | IC13 时钉版卡少于 5 张,或从未触发复核,就撤销钉版,只留章 ID |
| W2 遗忘 | 书签 + 确认卡(兼简报) | 启动只读引言和书签约 10 行;用简报代替通读蓝图 | 书签所指章存在;确认卡 blob 等于 HEAD | 续接所需上下文没有下降,或被原生记忆覆盖 |
| W3 熵增 | 目录全文件 | 白名单、体量上限、只写指针、禁用键 | Phase 3 用 grep/wc;Phase 4 用门控;编译前把警告当阻塞 | 随目录整体撤销;阈值在 IC13 前按实测调整 |
| W4 意图鸿沟 | 章导语四个字段 + 卡侧 intent | 卡挂回章;确认卡写清「不做」与停止条件 | 卡引用的章存在;编译输出「须先补 acceptance」 | human_verify 否决率和方向返工没有下降 |
| W5 注意力稀缺 | 书签 + `--pending` | 人只确认书签、大小版本和 goal 确认卡 | `--pending` 列出待终验卡和未提交的目录改动 | 原生视图已能覆盖跨章待裁决 |
| W6 理解债 | 卡侧 intent + 章的机器指针 | 由门控现算「服务哪条意图」,不存储 | `--report INT-NN` 列出挂靠卡及来源 | 试用期内反查从未被用过 |
| W7 自评偏差 | 双坐标;回执的 Not-Verified | 章完成只能推导;终验结论由人给出 | 禁止 status 键;标注 status_source;回执 trailer 齐全 | 不拆,这是红线 |
| W8 不确定性 | 可选的「假设:」字段 | 只指向已有的证伪落点 | 指针可解析 | 试点中从未用过,就从白名单删除 |
| W9 并发冲突 | 目录文件 | 提案带 base blob,不符就重提;目录改动单独小提交 | 编译第 1 步要求目录无未提交改动 | 保留,成本极低 |
| W10 风险不对称 | 大小版本、书签;可选的「风险:」字段 | 提案、diff、blob 交人确认;停止清单是必填项 | 审计目录提交的 trailer | 不拆;立法若采纳则并入需求对齐协议 |
| W11 资源有限 | Goal-Receipt trailer | 只记账:轮数、介入次数、耗时、可得时的 token | 从 git log 按章汇总;禁止出现模型名 | 没有任何客户端提供用量,且轮数数据无助于决策 |
| W12 环境漂移 | 附录指针 | 用 cmd: 指针指向现有工具,不新建机制 | 只校验格式 | 无需拆,本身没有新增机制 |
| W13 异构 agent | intent-catalog-guide.md | 只依赖读文件;/architect 只是包装 | IC4 纸面编译;IC12 实跑 | 各客户端出现原生的同等能力 |
| W14 摩擦重复 | 回执、`- 终验:` 否决理由、envoy | 复用提交 body、append_project_note、report_envoy_return | 用 git log 统计 | 随目录整体撤销 |
## 受影响文件
| 阶段 | 文件 | 改动 | 用途 |
|---|---|---|---|
| 2 设计(本文,与 P8 并行) | docs/tasks/2026-10-04-intent-catalog-design.md | 新增 | 本设计 |
| 2 设计 | .blueprint/modules/intent-catalog.md | 修改 | 改 IC1 前缀、补决策记录、追加 IC2–IC13 卡(任务卡段以外不用 `###`) |
| 2 设计 | .blueprint/manifest.yaml | 修改 | 用户确认后只改本模块的 status 一行:concept → planned |
| 3 炼境自身试用(只新增文件) | docs/ai-context/intent-catalog-guide.md | 新增 | 目录语法、修订钉版、编译七步、确认卡与回执模板、离线检查 |
| 3 | .blueprint/catalog.md | 新增 | 1.0 骨架与首批 2–4 章;书签只写一行指针 |
| 4 P8 收口后 | .claude/hooks/intent-gate.cjs | 新增 | 只警告的门控和各个只读视图 |
| 4 | src-tauri/src/commands/blueprint.rs | 修改 | 只改 `#[cfg(test)]`:锁定解析器忽略 intent 与终验行 |
| 4 | lefthook.yml | 修改 | pre-commit 加 intent-gate(带 `\|\| true`);接入包对 lefthook 是「存在即跳过」(已核实 onboarding.rs:6),不会被覆盖 |
| 4 | AGENTS.md | 修改 | 只改托管块外:T1–T4 区加 T5;块外约定加「启动读目录引言和书签」一行 |
| 4 | docs/ai-context/agent-button-system.md | 修改 | 唯一改名点:第 51 行 |
| 4 | .blueprint/catalog.md、docs/tasks/2026-10-03-coordination.md | 修改 | IC10 书签交接;§0 改为指向书签 |
| 5 enterprise 试点 | enterprise 隔离 worktree 里的 .blueprint/catalog.md 和 intent-gate.cjs 试点副本 | 新增 | 规格只用 spec: 指向;副本首行标注到期 |
| 6 去留(保留时) | onboarding 模板(经 blueprint-baseline 包)、AGENTS.md.tmpl、agents-meta-rules.md、CONVENTIONS.md | 新增/修改 | 只在 IC13 决定保留后分发,配套升版本和指纹,回收 T5 临时分叉 |
| 6 去留(撤销时) | 见撤销清单 | 删除 | 删除 3 个文件、lefthook 键、T5 和启动读书签那一行;回退 §0;删除 enterprise 副本 |
## 系统边界变更
- **Phase 2**:无变化,只写文档。
- **Phase 3**:
- 新增项目级文件格式 `.blueprint/catalog.md`。
- 任务卡新增两个可选、解析器不读的键:`- intent:` 和 `- 终验:`,与 iteration:/replaces: 同属此类。
- 提交新增 `Goal-Receipt:` 等 trailer 约定。
- 不新增 Tauri command、MCP 工具、DB 表或结构体字段。
- **Phase 4**:新增本地 CLI `node .claude/hooks/intent-gate.cjs [--self-test|--report|--impact|--pending]`、lefthook 键和 AGENTS.md 块外的 T5;仍不涉及 command、MCP 或 DB。
- **Phase 6**:只有决定保留并过了数据门控,才可能新增 `BlueprintTask.intent` 字段或只读 MCP 工具,届时按 T1 契约变更另行设计。
## 风险点
| 风险 | 规避 |
|---|---|
| 目录膨胀成容器,或变成第二事实源 | 白名单、体量上限、只写指针、单向挂靠;编译前把警告当阻塞 |
| 只警告的门控被习惯性忽略 | 保持零警告基线、警告类别少而准;编译前要求本章零警告;是否升级为阻断由 IC13 依数据决定 |
| 会重写卡文件的工具丢掉 intent 或终验行 | 已复核解析器和 buff;其他写入路径未核实,由 IC9 锁定,并比对 IC5 前后的卡数 |
| /goal 评估器仍然过早判定达成 | 终点只写「命令 + 输出」的合取;过程词黑名单;Goal-Result 统计一次判对率 |
| 状态语义未收敛导致推导失真 | 标注 status_source、不一致时警告;推导结果标为参考、不落盘 |
| 把回执写进 notes-archive.jsonl 会被冲掉 | 主载体是提交 body;在线时只经 append_project_note 双写 |
| 归档 modules 后 card: 指针集体悬空 | 门控报出悬空后按小版本修订;归档本身就是触发信号 |
| 模块 md 的非任务卡段里用了 `###`,被当成卡 | 指南明令禁止;acceptance 比对 `^### ` 计数 |
| T5 和 enterprise 门控副本与模板分叉 | 登记为有意的临时分叉,在 IC13 统一回收 |
| 其他 agent 沙箱里没有 node,或 lefthook 静默失效 | 门控只是辅助,保留 shell 加人工读文件的降级路径 |
| 维护成本超过收益 | 由 IC13 依数据决定;撤销只需删 3 个文件和若干行 |
## 拆解建议
建议拆为 12 张卡,依赖顺序:
- IC2 → IC3 → IC4 → IC5(Phase 3,P8 期间可做,只新增文件)
- P8 收口 → IC6 → IC7;IC6 → IC8;IC9 不依赖其他卡;IC7 + IC8 → IC10;IC5 → IC11(以上为 Phase 4)
- IC9 + IC10 → IC12 → IC13(Phase 5、6)
| 卡 | 标题 | 复杂度 | 阶段 | acceptance 要点 |
|---|---|---|---|---|
| IC2 | 新增 intent-catalog-guide.md | S | 3 | [CLI] 5 个必备节标题都在;模型名 grep 为 0;git status 只有该文件新增 |
| IC3 | 新增 catalog.md:1.0 骨架与首批 2–4 章 | S | 3 | [CLI] 版本行、章数、体量、禁用键、path 悬空数为 0;`^### ` 计数前后相等。human_verify:用户逐章定稿,提交带 Feature-Confirmed |
| IC4 | 跨 agent 纸面编译(Codex 或 DSH) | S | 3 | [CLI] 提交 body 里确认卡 9 个字段齐全,有 `Compiled-By: <非 Claude>`;blob 一致;终点都能在来源卡里找到;黑名单为 0 |
| IC5 | 首次真实 /goal:编译 → 粘贴 → 回执 | S | 3→4 | [CLI] 至少 1 条完整的 Goal-Receipt;纳入卡均为 ✅;有 human_verify 的卡带 `- 终验:` 行。human_verify:人粘贴并判定 Goal-Result |
| IC6 | intent-gate 核心加 --self-test | M | 4 | [gate] self-test 的 5 类坏样例各命中 1 条警告;真实目录 0 警告;没有目录时静默 exit 0 |
| IC7 | 只读视图 --report/--impact/--pending 与审计 | M | 4 | [gate] 夹具覆盖 stale/orphan/low_confidence/divergence/待终验/缺 trailer 审计;运行前后文件 sha256 不变 |
| IC8 | 接线:lefthook、T5、启动读书签、单处改名 | S | 4 | [YAML] run 以 `\|\| true` 结尾;[cargo test] `cargo test onboarding` 0 failed;AGENTS.md 的 diff 都在托管块之前;改名残留为 0;临时 worktree 里实测会警告 |
| IC9 | cargo test 锁定解析器忽略 intent 与终验行 | S | 4 | [cargo test] `parse_module_md_ignores_intent_lines` 1 passed:带和不带这些行的样本逐字段相等;全量无 FAILED |
| IC10 | 书签交接 | S | 4 | [gate] 0 警告;书签三行齐全;§0 改为指向书签;提交带 Feature-Confirmed。human_verify:用户确认切换 |
| IC11 | 立法提案定稿 | S | 4 | [读文件] 决策记录有条文、例外清单、P8 与 IC5 数据;diff 不含 AGENTS.md 和 resources/。human_verify:用户裁决 |
| IC12 | enterprise 隔离试点 | M | 5 | [gate] 试点 worktree 0 警告、spec: 都可解析;只新增 2 个文件;enterprise 主工作区前后一致;至少 1 条 Goal-Receipt |
| IC13 | 去留决策 | S | 6 | [读文件] 五项度量的前后对比,样本至少 5 条;撤销时 `git grep` 只命中决策记录。human_verify:用户裁决 |
## 收益度量与退出条件
- **度量**:基线取 P8 期间没有目录时的数据,来源是 PR body 和统筹流水。
- /goal 一次判对率,取自 Goal-Result;
- 每个 goal 的人工介入次数;
- 续接所需的上下文量:读简报的字节数 vs. 读 coordination 加多个模块的字节数;
- human_verify 否决率与方向返工;
- 每阶段的轮数、耗时,token 可得时一并记录。
- **健康指标**:目录警告数、stale pin 数、目录体量、人每阶段改目录的次数。
- **去留**(初始阈值,用户可在 IC13 前调整):样本至少 5 个 goal,其中 enterprise 至少 1 个。一次判对率不低于 60%、人工介入不高于基线、人每阶段改目录不超过 1 次,就保留并另拆分发卡;实测无收益、已被 agent 原生能力覆盖,或维护成本超过收益,就按撤销清单整体撤销。
## 立法提案草案:「goal 级确认代替逐卡确认」
不在 P8 期间生效,P8 收口后由 IC11 用实测数据定稿。
1. **范围**:书签所指当前章内,目标确认卡「纳入卡」所列的 S/M 卡。
2. **确认方式**:人读完确认卡后亲手粘贴 /goal,即视为批量确认清单内各卡的 Feature 确认卡;agent 不得自行启动或改写 goal 文本。
3. **存证**:清单内卡的 feat: 提交照常带 `Feature-Confirmed: true`,并加 `Goal-Receipt: INT-NN@X.Y#blob`;缺这一行即视为逐卡确认未完成。
4. **例外**:以下仍须逐项找人:写运行中 DB;删除文件、数据或分支;human_verify;凭据与机器状态变更;超出纳入卡或当前章;修改目录;stale/orphan pin;失败 3 次。
5. **失效**:分支变化、catalog blob 变化或 goal 中止时,恢复逐卡确认。
6. **落点**:先在炼境 AGENTS.md 块外试行,采纳后再进 ONBOARDING_MANAGED「需求对齐协议」(升块版本和指纹),并同步 agents-meta-rules。试行期间任何一条例外被越过,就否决本条。
## 待用户拍板
1. **门控脚本的时机**:默认放在 P8 收口后的 Phase 4,试用期只放两份文档、不写代码。是否特批在试用期以新增文件的形式就写?
2. **IC5 首次真实 /goal 用哪个阶段**:P8 收尾,数据来得最早;还是 P8 收口后的第一个阶段,例如本模块 Phase 4 的卡,自举试用?
3. **炼境 1.0 首批章节方向**:草拟候选为「一键接入三端可用」「意图编译为可判定终点」「摩擦驱动沉淀与退出」。正式定稿在 IC3,由你逐章确认。
4. **去留阈值**是否认可:样本至少 5 个、一次判对率不低于 60%、人工介入不高于基线、改目录每阶段不超过 1 次?
5. **常驻成本**:Phase 4 在 AGENTS.md 块外加「会话开始读目录引言和书签(约 10 行)」,是否接受?
## 自验报告:没验什么
- **已复核**:archive 只归档 modules/*.md;parse_module_md 的段落与键规则(`blueprint.rs:335-420`);buff 自动标 🔵 的替换范围(`buff.rs:495-505`);lefthook「存在即跳过」(`onboarding.rs:6`);agent-button-system 不在分发模板内;W/IC/INT 前缀未被占用。
- **未复核,沿用评审团或 handoff 简报的结论**:
- `get_project_file` 在 mcp_tools.rs:38;
- notes-archive.jsonl 由 DB 整文件重写(mcp_tools.rs:87);
- 其他可能重写卡文件的路径;
- CONVENTIONS 状态语义冲突的具体行号。
- **侦察缺口**:侦察工作流 wf_6dc3756a-b72 中「蓝图全量」和「红线与记忆」两个侦察员卡死失败,相关约束由综合者补读和主会话已知规则补齐,可能有遗漏。
- **跨 agent**:/goal 能否作为三端通用的粘贴载体,未核实,留给 IC4、IC12 验证。
- **用量(W11 记账)**:侦察工作流约 178 万 token,其中两个侦察员各重试 6 次卡死,浪费明显;设计评审团约 55 万 token,6 个 agent 全部成功。

View File

@ -1,6 +1,7 @@
--- ---
version: 1.2.0 version: 1.10.0
updated: 2026-09-21 aligned_with: src-tauri/resources/onboarding/AGENTS.md.tmpl ONBOARDING_MANAGED 1.10.0
updated: 2026-10-04
usage: 炼境接入包分发时写入被管理项目 AGENTS.md 的元规则标准内容 usage: 炼境接入包分发时写入被管理项目 AGENTS.md 的元规则标准内容
--- ---
@ -9,12 +10,34 @@ usage: 炼境接入包分发时写入被管理项目 AGENTS.md 的元规则标
> 本节由炼境接入包分发,规则技术栈无关,适用于所有项目和所有 AI 工具。 > 本节由炼境接入包分发,规则技术栈无关,适用于所有项目和所有 AI 工具。
> 项目特定的路径映射见 `docs/ai-context/project-context.yaml`。 > 项目特定的路径映射见 `docs/ai-context/project-context.yaml`。
## 与分发模板的对照(ONBOARDING_MANAGED 1.10.0,2026-10-04 逐节核对)
分发实体是 `src-tauri/resources/onboarding/AGENTS.md.tmpl`,措辞以模板为准;本文件是设计层,补「为什么」,不重复模板全文。
| 模板小节(托管块内) | 本文件 | 差异 |
|---|---|---|
| 核心开发约束(包管理、代码规范、Playwright 版本固定) | 无 | 不复制,以模板为准 |
| 需求对齐协议(Bug/Feature 分流、S 级三行卡、M/L 完整卡、Feature-Confirmed、补录≠确认卡) | 无 | 不复制,以模板为准 |
| Git 工作流(git-workflow.md、Conventional Commits) | 无 | 不复制,以模板为准 |
| 炼境项目上下文与能力包 | 同名小节 | 五条已同步为模板原文;Node/pnpm 工具链小节只留指针 |
| agent 按钮与验证路径(1–6 条 + 收束) | 「Agent 按钮体系」 | 本文件有同源同边界、acceptance 写法、自验报告纪律及其「为什么」;缺载体就近选择表、完成的定义、侦察→驻军、agent_verify/human_verify 分层与三分定位启发式(以模板为准);本文件多出的分工原则、按钮清单模板、自验失败降级约定已不在托管块内(炼境自身见 AGENTS.md 块外区) |
| 多 AI CLI 协作 | 「跨 AI 工具交接模板」 | 内容等价,模板为编号三条 |
| 模板小节(托管块外) | 本文件 | 差异 |
|---|---|---|
| 四支柱、文档防腐 T1–T4、铁律、定期防腐自查 | 同名小节 | 已同步:T1 补「(若存在)」、T3/T4 改指「本文件(AGENTS.md)」、自查路径写全 `docs/ai-context/` |
## 炼境项目上下文与能力包 ## 炼境项目上下文与能力包
- 项目根目录 `.lian-jing/context.json` 是工具无关的 `project_id` 单一事实来源;客户端项目 UI、用户级插件和全局配置都不能替代它。 - `.lian-jing/context.json` 是项目 `project_id` 的工具无关单一事实来源;不要从客户端项目 UI、用户级插件或全局配置推断项目身份。
- `.claude/liangjing.json` 仅用于兼容已接入的旧 Claude 项目;发现 legacy-only 状态时,应通过炼境迁移,不应复制或猜测 ID。 - `.claude/liangjing.json` 只是旧项目的 Claude 兼容投影。只发现它时,调用 `inject_mcp(project_id)` 迁移,而不是手工复制或猜测 ID。
- `.lian-jing/capability-packs.json` 仅描述炼境托管基线的版本与自检。升级必须显式报告版本不符,并且不能覆盖项目自己的业务规则、测试、部署声明或手工 MCP 配置。 - `.lian-jing/capability-packs.json` 记录炼境托管基线的版本。`verify_onboarding(project_id)` 报告 `legacy`、`version_mismatch` 等状态时,按其 `detail` 中的升级提示处理。
- 子项目 agent(Claude、Codex、DSH)遇到炼境分发物的摩擦或验证出跨项目实践时,经同一 MCP 入口 `report_envoy_return` 回传;何时回传与字段规范只写在 lian-jing skill,AGENTS 托管块只留一行指路(skill 按需加载,AGENTS 三端必读)。 - `apply_onboarding_pack(project_id)` 只更新炼境明确托管的接入包文件;项目自己的业务规则、测试、部署声明和手工定义的同名 MCP server 仍归项目所有,不能被升级覆盖。
- 遇到炼境分发的模板、约定或 MCP 工具的摩擦,或验证出跨项目可复用的实践时,调用 `report_envoy_return` 回传炼境(只追加信号,不必逐条征得用户同意;Claude 会话结束时也可跑 `/envoy`);何时回传、字段怎么填见 lian-jing skill「遇到摩擦时回传炼境」一节。
### Node/pnpm 工具链
见模板同名小节(.nvmrc / packageManager 为版本事实源、mise 最小声明、get_toolchain_status 先查、prepare_toolchain 须用户确认);措辞以模板为准。
--- ---
@ -38,7 +61,7 @@ usage: 炼境接入包分发时写入被管理项目 AGENTS.md 的元规则标
### T1 外部契约变更(最高优先级) ### T1 外部契约变更(最高优先级)
其他代码、服务、或 agent 依赖的定义——接口、共享类型、数据结构、配置键名、环境变量名。 其他代码、服务、或 agent 依赖的定义——接口、共享类型、数据结构、配置键名、环境变量名。
→ 查 `docs/ai-context/project-context.yaml` 找到记录该契约的文档,检查并同步更新。 → 查 `docs/ai-context/project-context.yaml`(若存在)找到记录该契约的文档,检查并同步更新。
### T2 架构边界变更 ### T2 架构边界变更
模块划分、目录结构、依赖方向、包边界调整。 模块划分、目录结构、依赖方向、包边界调整。
@ -46,10 +69,10 @@ usage: 炼境接入包分发时写入被管理项目 AGENTS.md 的元规则标
### T3 工具链变更 ### T3 工具链变更
引入或替换库、框架、构建工具。 引入或替换库、框架、构建工具。
→ 更新 AGENTS.md 技术栈声明;通知炼境重新扫描并更新 `project-context.yaml`。 → 更新本文件(AGENTS.md)技术栈声明;通知炼境重新扫描并更新 `project-context.yaml`。
### T4 常驻上下文过期 ### T4 常驻上下文过期
AGENTS.md 或 `docs/ai-context/project-brief.md` 描述的现实已经改变。 本文件(AGENTS.md)或 `docs/ai-context/project-brief.md` 描述的现实已经改变。
→ 立即更新。这两份文档常驻 agent 上下文,过期危害最大。 → 立即更新。这两份文档常驻 agent 上下文,过期危害最大。
### 不触发检查 ### 不触发检查
@ -83,9 +106,9 @@ AGENTS.md 或 `docs/ai-context/project-brief.md` 描述的现实已经改变。
每隔一阵或大改后,对照以下清单: 每隔一阵或大改后,对照以下清单:
- [ ] AGENTS.md 里的技术栈声明还和代码一致吗? - [ ] AGENTS.md 里的技术栈声明还和代码一致吗?
- [ ] `project-brief.md` 最近 30 天有没有随架构改动更新? - [ ] `docs/ai-context/project-brief.md` 最近 30 天有没有随架构改动更新?
- [ ] 有没有两份文档说同一件事且打架? - [ ] 有没有两份文档说同一件事且打架?
- [ ] `project-context.yaml` 的契约路径还准确吗? - [ ] `docs/ai-context/project-context.yaml` 的契约路径还准确吗?
--- ---

View File

@ -1323,6 +1323,15 @@ pub(crate) fn sync_blueprint_rules_with(
root: &Path, root: &Path,
sink: &dyn crate::WriteSink, sink: &dyn crate::WriteSink,
) -> Result<SyncResult, crate::WriteFailure> { ) -> Result<SyncResult, crate::WriteFailure> {
if crate::mcp_inject::files_managed_by_next(root) {
return Ok(SyncResult {
success: true,
conventions_written: false,
claude_md_action: "skipped".into(),
agents_md_action: "skipped".into(),
message: crate::mcp_inject::FILES_MANAGED_BY_NEXT_SKIP.into(),
});
}
let bp_dir = root.join(".blueprint"); let bp_dir = root.join(".blueprint");
let project_name = root let project_name = root
.file_name() .file_name()
@ -2876,6 +2885,22 @@ pub fn archive_project_docs(project_path: String) -> Result<ArchiveResult, Strin
#[cfg(test)] #[cfg(test)]
mod tests { mod tests {
use super::*; use super::*;
// 共存期防回写:项目文件已由新炼境接管时,蓝图规则同步零写入
#[test]
fn sync_skips_projects_managed_by_next() {
let base = std::env::temp_dir().join(format!("lianjing_sync_guard_test_{}", std::process::id()));
let _ = std::fs::remove_dir_all(&base);
std::fs::create_dir_all(base.join(".lian-jing")).unwrap();
std::fs::create_dir_all(base.join(".blueprint")).unwrap();
std::fs::write(base.join(".lian-jing/context.json"), r#"{"project_id":"p1","files_managed_by":"lian-jing-next"}"#).unwrap();
let result = sync_blueprint_rules_with(&base, &crate::DiskSink).unwrap();
assert_eq!((result.agents_md_action.as_str(), result.claude_md_action.as_str()), ("skipped", "skipped"));
assert!(!result.conventions_written);
assert!(!base.join(".blueprint/CONVENTIONS.md").exists());
assert!(!base.join("AGENTS.md").exists() && !base.join("CLAUDE.md").exists());
let _ = std::fs::remove_dir_all(&base);
}
use rusqlite::Connection; use rusqlite::Connection;
use std::fs; use std::fs;

View File

@ -125,6 +125,10 @@ fn poll_all_buffs(app: &AppHandle) {
fn check_project(app: &AppHandle, project_path: &str) -> Result<(), String> { fn check_project(app: &AppHandle, project_path: &str) -> Result<(), String> {
let root = Path::new(project_path); let root = Path::new(project_path);
// 共存期防回写:项目文件已由新炼境接管,不再改写其任务卡
if crate::mcp_inject::files_managed_by_next(root) {
return Ok(());
}
// 获取当前 HEAD commit // 获取当前 HEAD commit
let current_commit = match get_head_commit(root) { let current_commit = match get_head_commit(root) {

View File

@ -199,6 +199,14 @@ pub(crate) fn dispatch_templates_with(
root: &Path, root: &Path,
sink: &dyn crate::WriteSink, sink: &dyn crate::WriteSink,
) -> Vec<TemplateResult> { ) -> Vec<TemplateResult> {
if crate::mcp_inject::files_managed_by_next(root) {
return vec![TemplateResult {
name: ".lian-jing/context.json".into(),
action: "skipped".into(),
detail: crate::mcp_inject::FILES_MANAGED_BY_NEXT_SKIP.into(),
warning: None,
}];
}
vec![ vec![
dispatch_versioned(root, "AGENTS.md", TMPL_AGENTS, sink), dispatch_versioned(root, "AGENTS.md", TMPL_AGENTS, sink),
dispatch_one(root, "lefthook.yml", TMPL_LEFTHOOK, sink), dispatch_one(root, "lefthook.yml", TMPL_LEFTHOOK, sink),
@ -1243,6 +1251,21 @@ pub fn silent_projects(conn: &rusqlite::Connection) -> Result<Vec<(String, i64)>
#[cfg(test)] #[cfg(test)]
mod tests { mod tests {
// 共存期防回写:项目文件已由新炼境接管时,接入包模板分发零写入
#[test]
fn dispatch_skips_projects_managed_by_next() {
let base = std::env::temp_dir().join(format!("lianjing_dispatch_guard_test_{}", std::process::id()));
let _ = std::fs::remove_dir_all(&base);
std::fs::create_dir_all(base.join(".lian-jing")).unwrap();
std::fs::create_dir_all(base.join(".blueprint")).unwrap();
std::fs::write(base.join(".lian-jing/context.json"), r#"{"project_id":"p1","files_managed_by":"lian-jing-next"}"#).unwrap();
let results = super::dispatch_templates(base.to_str().unwrap());
assert_eq!(results.len(), 1);
assert_eq!(results[0].action, "skipped");
assert!(!base.join("AGENTS.md").exists() && !base.join(".claude").exists() && !base.join("lefthook.yml").exists());
let _ = std::fs::remove_dir_all(&base);
}
use super::*; use super::*;
#[test] #[test]

View File

@ -235,6 +235,20 @@ fn write_json_with(
.map_err(|error| format!("写入 {label} 失败: {error}")) .map_err(|error| format!("写入 {label} 失败: {error}"))
} }
/// 新炼境(lian-jing-next)接管项目文件后写入 `.lian-jing/context.json` 的 `files_managed_by` 取值。
pub(crate) const FILES_MANAGED_BY_NEXT: &str = "lian-jing-next";
/// 共存期防回写守卫:项目文件已由新炼境接管时,旧炼境的模板分发、蓝图规则同步与 buff 轮询一律跳过,
/// 避免两边来回覆盖同一批托管文件。只读判断,文件缺失或不合法时视为未接管。
pub(crate) fn files_managed_by_next(root: &std::path::Path) -> bool {
std::fs::read_to_string(root.join(".lian-jing").join("context.json"))
.ok()
.and_then(|text| serde_json::from_str::<Value>(&text).ok())
.is_some_and(|ctx| ctx.get("files_managed_by").and_then(Value::as_str) == Some(FILES_MANAGED_BY_NEXT))
}
pub(crate) const FILES_MANAGED_BY_NEXT_SKIP: &str = "项目文件已由新炼境接管(.lian-jing/context.json 的 files_managed_by),旧炼境不再分发";
/// 写工具无关的项目身份锚点。项目根目录是边界,客户端项目 UI 或用户级配置均不是身份来源。 /// 写工具无关的项目身份锚点。项目根目录是边界,客户端项目 UI 或用户级配置均不是身份来源。
/// 合并写入:保留未来字段与项目定制字段,只有炼境拥有的身份字段会被刷新。 /// 合并写入:保留未来字段与项目定制字段,只有炼境拥有的身份字段会被刷新。
#[cfg(test)] #[cfg(test)]
@ -3623,6 +3637,26 @@ trust_level = "trusted"
); );
} }
#[test]
fn files_managed_by_next_guard_reads_context_and_survives_identity_rewrite() {
let base = std::env::temp_dir().join(format!("lianjing_files_guard_test_{}", std::process::id()));
let _ = std::fs::remove_dir_all(&base);
std::fs::create_dir_all(base.join(".lian-jing")).unwrap();
assert!(!files_managed_by_next(&base), "没有 context.json 视为未接管");
std::fs::write(
base.join(".lian-jing/context.json"),
r#"{"project_id":"p1","schema_version":1,"files_managed_by":"lian-jing-next"}"#,
)
.unwrap();
assert!(files_managed_by_next(&base));
// 旧炼境刷新身份时必须保留接管标记,否则守卫会被自己抹掉
write_canonical_context_at(&base, "p1").unwrap();
assert!(files_managed_by_next(&base), "身份合并写后接管标记仍在");
std::fs::write(base.join(".lian-jing/context.json"), r#"{"project_id":"p1","files_managed_by":"other"}"#).unwrap();
assert!(!files_managed_by_next(&base));
let _ = std::fs::remove_dir_all(&base);
}
#[test] #[test]
fn canonical_context_migrates_legacy_project_id_and_preserves_unknown_fields() { fn canonical_context_migrates_legacy_project_id_and_preserves_unknown_fields() {
let base = std::env::temp_dir().join(format!( let base = std::env::temp_dir().join(format!(

View File

@ -121,13 +121,27 @@ impl BlockReason {
} }
} }
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)] #[derive(Debug, Clone, PartialEq, Eq, Deserialize)]
pub struct BlockedItem { pub struct BlockedItem {
pub target: String, pub target: String,
pub reason: BlockReason, pub reason: BlockReason,
pub detail: String, pub detail: String,
} }
/// 序列化时附派生字段 skippable(= BlockReason::skippable):UI 与 agent 据此决定是否给「跳过」,
/// 可跳过判定只在本体一处(P8g,AGENTS.md「边界单点实现」)。反序列化忽略该字段;digest 不含它。
impl Serialize for BlockedItem {
fn serialize<S: serde::Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error> {
use serde::ser::SerializeStruct;
let mut item = serializer.serialize_struct("BlockedItem", 4)?;
item.serialize_field("target", &self.target)?;
item.serialize_field("reason", &self.reason)?;
item.serialize_field("detail", &self.detail)?;
item.serialize_field("skippable", &self.reason.skippable())?;
item.end()
}
}
/// 本机侧(不进仓库)的预计动作:token、稳定入口、三端客户端配置。 /// 本机侧(不进仓库)的预计动作:token、稳定入口、三端客户端配置。
/// status:noop(已就绪)| apply(apply 时会写)| not_installed | not_applicable | unavailable /// status:noop(已就绪)| apply(apply 时会写)| not_installed | not_applicable | unavailable
/// | manual_kept | other_project | needs_human(后三者阻断确认,见 machine_step_blocker)。 /// | manual_kept | other_project | needs_human(后三者阻断确认,见 machine_step_blocker)。
@ -1040,6 +1054,28 @@ mod tests {
let _ = std::fs::remove_dir_all(&root); let _ = std::fs::remove_dir_all(&root);
} }
/// 阻断项序列化带派生字段 skippable(P8g 界面据此给「跳过」,不在前端复制判定);反序列化忽略它。
#[test]
fn blocked_item_serializes_skippable_from_reason() {
for (reason, skippable) in [
(BlockReason::ManualEntry, true),
(BlockReason::SharedKey, true),
(BlockReason::MixedFile, false),
(BlockReason::IdentityConflict, false),
(BlockReason::NeedsHuman, false),
] {
let item = BlockedItem {
target: "t".into(),
reason,
detail: "d".into(),
};
let value = serde_json::to_value(&item).unwrap();
assert_eq!(value["skippable"], skippable, "{reason:?}");
assert_eq!(value["target"], "t");
assert_eq!(serde_json::from_value::<BlockedItem>(value).unwrap(), item);
}
}
/// 身份冲突、混合文件与需人工处理的项不可跳过(P8d 审查 ②):即使列进 skip_targets 也照旧阻断。 /// 身份冲突、混合文件与需人工处理的项不可跳过(P8d 审查 ②):即使列进 skip_targets 也照旧阻断。
#[test] #[test]
fn identity_conflict_and_needs_human_cannot_be_skipped() { fn identity_conflict_and_needs_human_cannot_be_skipped() {

View File

@ -2,6 +2,7 @@ import { useState, useEffect } from "react";
import { OverviewPage } from "./components/overview/OverviewPage"; import { OverviewPage } from "./components/overview/OverviewPage";
import { Dashboard } from "./components/dashboard/Dashboard"; import { Dashboard } from "./components/dashboard/Dashboard";
import { ProjectModal } from "./components/dashboard/ProjectModal"; import { ProjectModal } from "./components/dashboard/ProjectModal";
import { OnboardPanel } from "./components/dashboard/OnboardPanel";
import { ResourcesPage } from "./components/resources/ResourcesPage"; import { ResourcesPage } from "./components/resources/ResourcesPage";
import { ToolsPage } from "./components/tools/ToolsPage"; import { ToolsPage } from "./components/tools/ToolsPage";
import { SettingsPage } from "./components/settings/SettingsPage"; import { SettingsPage } from "./components/settings/SettingsPage";
@ -75,6 +76,7 @@ export default function App() {
</main> </main>
<ProjectModal /> <ProjectModal />
<OnboardPanel />
<Toast /> <Toast />
</div> </div>
); );

View File

@ -1,10 +1,47 @@
import { useState } from "react"; import { useState } from "react";
import { useQuery, useQueryClient } from "@tanstack/react-query"; import { useQuery, useQueryClient } from "@tanstack/react-query";
import { open } from "@tauri-apps/plugin-dialog"; import { open } from "@tauri-apps/plugin-dialog";
import { batchCreateProjects, getSpaces, scanSubfolders, type SubFolder } from "../../lib/commands"; import { batchCreateProjects, getSpaces, scanSubfolders, type OnboardStatus, type SubFolder } from "../../lib/commands";
import { useUIStore } from "../../store/ui"; import { useUIStore } from "../../store/ui";
import { Dialog } from "../ui/Dialog"; import { Dialog } from "../ui/Dialog";
/** 本次添加成功的项目:批量只给入口、不自动接入(P8g),每个项目各自预览确认 */
interface AddedProject {
id: string;
name: string;
/** 本次面板里的接入结果;cancelled = 打开后未执行接入 */
onboard?: OnboardStatus | "cancelled";
}
const ONBOARD_STATUS_LABEL: Record<OnboardStatus | "cancelled", string> = {
done: "✓ 接入完成",
partial: "⚠ 部分完成",
failed: "✗ 预检失败",
refused: "⚠ 已拒绝,需重新确认",
busy: "… 正在接入中",
cancelled: "未接入",
};
function AddedProjects({ added, onOnboard }: { added: AddedProject[]; onOnboard: (project: AddedProject) => void }) {
return (
<div className="px-6 py-4 space-y-2">
<p className="text-sm text-gray-700">已添加 {added.length} 个项目。一键接入需逐个预览并确认,不会自动写入子项目:</p>
{added.map((project) => (
<div key={project.id} className="flex items-center gap-3 border border-gray-100 rounded-lg px-3 py-2">
<span className="flex-1 min-w-0 truncate text-sm text-gray-800">{project.name}</span>
<span className="text-xs text-gray-500">{project.onboard ? ONBOARD_STATUS_LABEL[project.onboard] : "未接入"}</span>
<button
onClick={() => onOnboard(project)}
className="px-3 py-1 rounded-lg border border-blue-200 text-xs text-blue-700 hover:bg-blue-50 shrink-0"
>
{project.onboard === "done" ? "重新检查" : "一键接入"}
</button>
</div>
))}
</div>
);
}
// Windows 路径转 WSL 路径(仅 /mnt/x/... 形式,不处理 UNC) // Windows 路径转 WSL 路径(仅 /mnt/x/... 形式,不处理 UNC)
function winToWsl(p: string): string { function winToWsl(p: string): string {
const norm = p.replace(/\\/g, "/"); const norm = p.replace(/\\/g, "/");
@ -22,7 +59,19 @@ interface FolderItem extends SubFolder {
export function BatchAddModal({ onClose }: { onClose: () => void }) { export function BatchAddModal({ onClose }: { onClose: () => void }) {
const showToast = useUIStore((s) => s.showToast); const showToast = useUIStore((s) => s.showToast);
const openOnboard = useUIStore((s) => s.openOnboard);
const qc = useQueryClient(); const qc = useQueryClient();
const [added, setAdded] = useState<AddedProject[] | null>(null);
const onboardOne = (project: AddedProject) =>
openOnboard({
projectId: project.id,
projectName: project.name,
onClosed: (report) =>
setAdded((prev) =>
prev?.map((p) => (p.id === project.id ? { ...p, onboard: report?.status ?? p.onboard ?? "cancelled" } : p)) ?? prev,
),
});
const { data: spaces = [] } = useQuery({ queryKey: ["spaces"], queryFn: getSpaces }); const { data: spaces = [] } = useQuery({ queryKey: ["spaces"], queryFn: getSpaces });
const currentSpace = spaces.find((s) => s.is_current); const currentSpace = spaces.find((s) => s.is_current);
@ -103,7 +152,12 @@ export function BatchAddModal({ onClose }: { onClose: () => void }) {
} else { } else {
showToast(`成功添加 ${selected.length} 个项目 ✓`); showToast(`成功添加 ${selected.length} 个项目 ✓`);
} }
onClose(); // 没有目录的登记(概念占位)不给接入入口
const created = payload
.filter((p) => !skipped.includes(p.id) && (p.win_path || p.wsl_path))
.map((p) => ({ id: p.id, name: p.name }));
if (created.length > 0) setAdded(created);
else onClose();
} catch (e) { } catch (e) {
showToast(`❌ ${e}`); showToast(`❌ ${e}`);
} finally { } finally {
@ -113,6 +167,19 @@ export function BatchAddModal({ onClose }: { onClose: () => void }) {
const checkedCount = items.filter((i) => i.checked).length; const checkedCount = items.filter((i) => i.checked).length;
if (added) {
return (
<Dialog title="批量添加项目" onClose={onClose} size="lg">
<AddedProjects added={added} onOnboard={onboardOne} />
<div className="flex justify-end px-6 py-4 border-t border-gray-100">
<button onClick={onClose} className="px-4 py-2 rounded-lg text-sm border border-gray-200 text-gray-600 hover:bg-gray-50">
完成
</button>
</div>
</Dialog>
);
}
return ( return (
<Dialog title="批量添加项目" onClose={onClose} size="lg"> <Dialog title="批量添加项目" onClose={onClose} size="lg">
<div className="px-6 py-4 space-y-4"> <div className="px-6 py-4 space-y-4">

View File

@ -20,7 +20,6 @@ import {
getBlueprintStatus, getBlueprintStatus,
syncBlueprintRules, syncBlueprintRules,
generateBlueprintPrompt, generateBlueprintPrompt,
applyOnboardingPack,
getCommitStats, getCommitStats,
removeBlueprintBuff, removeBlueprintBuff,
getBuffStatus, getBuffStatus,
@ -31,10 +30,10 @@ import {
type BlueprintStatus, type BlueprintStatus,
type SyncResult, type SyncResult,
type BuffStatus, type BuffStatus,
type TemplateResult,
type HookActivation,
type CommitStats, type CommitStats,
type OnboardReport,
} from "../../lib/commands"; } from "../../lib/commands";
import { useUIStore } from "../../store/ui";
interface Props { interface Props {
projectName: string; projectName: string;
@ -54,19 +53,6 @@ const STATUS_CONFIG: Record<string, { color: string; bg: string; label: string }
abandoned: { color: "#52525B", bg: "#FAFAFA", label: "已退役" }, abandoned: { color: "#52525B", bg: "#FAFAFA", label: "已退役" },
}; };
// 接入包模板分发五态(对应 onboarding.rs TemplateResult.action)
// label 为 null 时展示后端 detail(updated/appended/failed 的 detail 含版本信息)
const TEMPLATE_ACTION_STYLE: Record<
string,
{ icon: string; color: string; label: string | null }
> = {
written: { icon: "✓", color: "text-green-600", label: "已写入" },
updated: { icon: "↑", color: "text-blue-600", label: null },
appended: { icon: "+", color: "text-blue-600", label: null },
skipped: { icon: "○", color: "text-gray-400", label: "已存在" },
failed: { icon: "✗", color: "text-red-600", label: null },
};
const TASK_PREFIX: Record<string, string> = { const TASK_PREFIX: Record<string, string> = {
done: "✅", done: "✅",
in_progress: "🔵", in_progress: "🔵",
@ -1058,8 +1044,9 @@ function GovernancePanel({
const [buffError, setBuffError] = useState<string | null>(null); const [buffError, setBuffError] = useState<string | null>(null);
const [buffInitPrompt, setBuffInitPrompt] = useState<string | null>(null); const [buffInitPrompt, setBuffInitPrompt] = useState<string | null>(null);
const [buffInitCopied, setBuffInitCopied] = useState(false); const [buffInitCopied, setBuffInitCopied] = useState(false);
const [packTemplates, setPackTemplates] = useState<TemplateResult[] | null>(null); /** 最近一次一键接入的结果摘要(详情在接入面板里看过) */
const [packHook, setPackHook] = useState<HookActivation | null>(null); const [onboardSummary, setOnboardSummary] = useState<string | null>(null);
const openOnboard = useUIStore((s) => s.openOnboard);
const [promptMode, setPromptMode] = useState<"init" | "sync" | null>(null); const [promptMode, setPromptMode] = useState<"init" | "sync" | null>(null);
const [prompt, setPrompt] = useState(""); const [prompt, setPrompt] = useState("");
@ -1067,28 +1054,29 @@ function GovernancePanel({
const [promptError, setPromptError] = useState<string | null>(null); const [promptError, setPromptError] = useState<string | null>(null);
const [copied, setCopied] = useState(false); const [copied, setCopied] = useState(false);
const handleApplyBuff = async () => { /** 接入面板关闭后:未执行接入不动;执行过则刷新 buff,尚无蓝图时给 init prompt */
const afterOnboard = async (report: OnboardReport | null) => {
if (!report) return;
setOnboardSummary(`${report.status}:${report.summary}`);
refetchBuff();
if (report.status !== "done" && report.status !== "partial") return;
// 只有尚无蓝图时才展示 init prompt;已有蓝图则 Buff 直接激活无需初始化
if (bpStatus?.status === "none") {
try {
setBuffInitPrompt(await generateBlueprintPrompt(projectPath, "init"));
} catch (e) {
setBuffError(String(e));
}
}
};
// 「应用接入包」改为一键接入:先 plan 预览、人确认后再 apply(P8g),与新建项目走同一面板
const handleApplyBuff = () => {
if (!projectId) return; if (!projectId) return;
setBuffLoading(true);
setBuffError(null); setBuffError(null);
setBuffInitPrompt(null); setBuffInitPrompt(null);
setPackTemplates(null); setOnboardSummary(null);
setPackHook(null); openOnboard({ projectId, projectName, onClosed: (report) => void afterOnboard(report) });
try {
const report = await applyOnboardingPack(projectPath, projectId);
setPackTemplates(report.templates);
setPackHook(report.hook);
refetchBuff();
// 只有尚无蓝图时才展示 init prompt;已有蓝图则 Buff 直接激活无需初始化
if (bpStatus?.status === "none") {
const p = await generateBlueprintPrompt(projectPath, "init").catch(() => null);
if (p) setBuffInitPrompt(p);
}
} catch (e) {
setBuffError(String(e));
} finally {
setBuffLoading(false);
}
}; };
const handleRemoveBuff = async () => { const handleRemoveBuff = async () => {
@ -1098,8 +1086,7 @@ function GovernancePanel({
await removeBlueprintBuff(projectPath); await removeBlueprintBuff(projectPath);
refetchBuff(); refetchBuff();
setBuffInitPrompt(null); setBuffInitPrompt(null);
setPackTemplates(null); setOnboardSummary(null);
setPackHook(null);
} catch (e) { } catch (e) {
setBuffError(String(e)); setBuffError(String(e));
} finally { } finally {
@ -1296,7 +1283,7 @@ function GovernancePanel({
)} )}
</div> </div>
<p className="text-[11px] text-gray-500 leading-relaxed"> <p className="text-[11px] text-gray-500 leading-relaxed">
应用接入包:种入 AGENTS.md / lefthook / git-workflow 标准模板(不覆盖已有),并挂 buff 自动监听 git 提交、采集飞轮数据。 一键接入:先预览将写入的接入包文件(AGENTS.md / lefthook / git-workflow 等)与本机三端配置,确认后再写入,并挂 buff 自动监听 git 提交、采集飞轮数据。
</p> </p>
{buffStatus?.last_sync_at && ( {buffStatus?.last_sync_at && (
<p className="text-[10px] text-gray-400">上次同步:{buffStatus.last_sync_at}</p> <p className="text-[10px] text-gray-400">上次同步:{buffStatus.last_sync_at}</p>
@ -1304,54 +1291,27 @@ function GovernancePanel({
{buffError && ( {buffError && (
<p className="text-[11px] text-red-600 font-mono break-all">{buffError}</p> <p className="text-[11px] text-red-600 font-mono break-all">{buffError}</p>
)} )}
{packTemplates && ( {onboardSummary && (
<div className="space-y-0.5 pt-0.5"> <p className="text-[10px] text-gray-500 break-all">最近一次一键接入:{onboardSummary}</p>
<p className="text-[10px] text-gray-500 font-semibold">模板分发</p>
{packTemplates.map((t) => {
const style =
TEMPLATE_ACTION_STYLE[t.action] ?? TEMPLATE_ACTION_STYLE.failed;
return (
<div key={t.name}>
<p className="text-[10px] font-mono flex items-center gap-1">
<span className={style.color}>{style.icon}</span>
<span className="text-gray-600 truncate flex-1">{t.name}</span>
<span className="text-gray-400">{style.label ?? t.detail}</span>
</p>
{t.warning && (
<p className="text-[10px] text-amber-600 leading-relaxed pl-3">⚠ {t.warning}</p>
)}
</div>
);
})}
{packHook && (
<p className="text-[10px] font-mono flex items-center gap-1">
<span
className={
packHook.status === "activated"
? "text-green-600"
: packHook.status === "missing_binary"
? "text-amber-500"
: "text-red-500"
}
>
{packHook.status === "activated" ? "✓" : packHook.status === "missing_binary" ? "⚠" : "✗"}
</span>
<span className="text-gray-600 truncate flex-1">lefthook hook</span>
<span className="text-gray-400 truncate" title={packHook.detail}>
{packHook.detail}
</span>
</p>
)}
</div>
)} )}
{buffStatus?.status === "active" ? ( {buffStatus?.status === "active" ? (
<button <div className="flex gap-2">
onClick={handleRemoveBuff} <button
disabled={buffLoading} onClick={handleApplyBuff}
className="w-full py-1.5 rounded-lg border border-red-200 text-red-600 text-xs hover:bg-red-50 disabled:opacity-50 transition-colors" disabled={buffLoading || !projectId}
> title={!projectId ? "需要传入 projectId" : "重新计划并预览,确认后补齐缺失项"}
{buffLoading ? "处理中…" : "撤销 Buff"} className="flex-1 py-1.5 rounded-lg border border-purple-200 text-purple-700 text-xs hover:bg-purple-50 disabled:opacity-50 transition-colors"
</button> >
重新检查接入
</button>
<button
onClick={handleRemoveBuff}
disabled={buffLoading}
className="flex-1 py-1.5 rounded-lg border border-red-200 text-red-600 text-xs hover:bg-red-50 disabled:opacity-50 transition-colors"
>
{buffLoading ? "处理中…" : "撤销 Buff"}
</button>
</div>
) : ( ) : (
<button <button
onClick={handleApplyBuff} onClick={handleApplyBuff}
@ -1359,7 +1319,7 @@ function GovernancePanel({
title={!projectId ? "需要传入 projectId" : undefined} title={!projectId ? "需要传入 projectId" : undefined}
className="w-full py-1.5 rounded-lg bg-purple-600 text-white text-xs hover:bg-purple-700 disabled:opacity-50 transition-colors" className="w-full py-1.5 rounded-lg bg-purple-600 text-white text-xs hover:bg-purple-700 disabled:opacity-50 transition-colors"
> >
{buffLoading ? "施加中…" : "⚡ 施加 Buff"} ⚡ 一键接入(先预览再确认)
</button> </button>
)} )}
{/* 已有蓝图时施加 Buff:直接激活,无需初始化 */} {/* 已有蓝图时施加 Buff:直接激活,无需初始化 */}

View File

@ -0,0 +1,189 @@
// 一键接入面板(agent-client-parity P8g):plan_onboarding 预览 → 人确认 → onboard_project → 分步结果。
// 全局挂载在 App,由 useUIStore.openOnboard 打开。判定全部来自后端,映射见 onboardView.ts。
import { useCallback, useEffect, useRef, useState } from "react";
import { useQueryClient } from "@tanstack/react-query";
import { onboardProject, planOnboarding, type OnboardReport, type OnboardingPlan } from "../../lib/commands";
import { useUIStore } from "../../store/ui";
import {
DEFAULT_SELECTION,
buildPlanView,
buildReportView,
confirmRequest,
selectionOptions,
setBypass,
toggleSkip,
type OnboardSelection,
} from "./onboardView";
import { PlanPreview, ReportResult } from "./OnboardSections";
type Phase =
| { kind: "planning" }
| { kind: "preview"; plan: OnboardingPlan; planned: OnboardSelection }
| { kind: "applying"; plan: OnboardingPlan; planned: OnboardSelection }
| { kind: "report"; report: OnboardReport }
| { kind: "error"; message: string };
export function OnboardPanel() {
const target = useUIStore((s) => s.onboardTarget);
if (!target) return null;
// key:换项目即重置面板状态
return <OnboardPanelBody key={target.projectId} />;
}
function OnboardPanelBody() {
const target = useUIStore((s) => s.onboardTarget)!;
const closeOnboard = useUIStore((s) => s.closeOnboard);
const showToast = useUIStore((s) => s.showToast);
const qc = useQueryClient();
const [phase, setPhase] = useState<Phase>({ kind: "planning" });
const [selection, setSelection] = useState<OnboardSelection>(DEFAULT_SELECTION);
const lastReport = useRef<OnboardReport | null>(null);
const requestSeq = useRef(0);
const plan = useCallback(
async (chosen: OnboardSelection) => {
const seq = ++requestSeq.current;
setPhase({ kind: "planning" });
try {
const next = await planOnboarding(target.projectId, selectionOptions(chosen));
if (seq === requestSeq.current) setPhase({ kind: "preview", plan: next, planned: chosen });
} catch (e) {
if (seq === requestSeq.current) setPhase({ kind: "error", message: String(e) });
}
},
[target.projectId],
);
useEffect(() => {
void plan(DEFAULT_SELECTION);
}, [plan]);
const applyConfirmed = async () => {
if (phase.kind !== "preview") return;
const request = confirmRequest(phase.plan, phase.planned, selection);
if (!request) return;
const seq = ++requestSeq.current;
setPhase({ kind: "applying", plan: phase.plan, planned: phase.planned });
try {
const report = await onboardProject(request.projectId, request.expectedDigest, request.confirmed, request.options);
if (seq !== requestSeq.current) return;
lastReport.current = report;
setPhase({ kind: "report", report });
showToast(buildReportView(report).toast, 4000);
void qc.invalidateQueries({ queryKey: ["projects"] });
} catch (e) {
if (seq === requestSeq.current) setPhase({ kind: "error", message: String(e) });
}
};
/** refused 附当前计划:回到预览,按新计划重新确认(选项沿用后端拒绝时的那组) */
const reviewReplan = (next: OnboardingPlan) => {
if (phase.kind !== "report") return;
setPhase({ kind: "preview", plan: next, planned: selection });
};
const close = () => {
if (phase.kind === "applying") return; // 写入进行中不允许关闭,避免误以为已取消
requestSeq.current += 1;
const report = lastReport.current;
closeOnboard();
target.onClosed?.(report);
};
const title = `一键接入${target.projectName ? ` · ${target.projectName}` : ""}`;
return (
<div className="fixed inset-0 z-[60] flex items-center justify-center bg-black/50">
<div className="bg-white rounded-xl shadow-2xl w-full max-w-3xl mx-4 flex flex-col" style={{ maxHeight: "88vh" }}>
<div className="flex items-center justify-between px-6 py-4 border-b border-gray-100 shrink-0">
<h2 className="text-base font-semibold text-gray-900">{title}</h2>
<button
onClick={close}
disabled={phase.kind === "applying"}
className="text-gray-400 hover:text-gray-600 text-xl leading-none disabled:opacity-30"
aria-label="关闭"
>
×
</button>
</div>
<div className="flex-1 min-h-0 overflow-y-auto px-6 py-4 space-y-4 text-sm">
{phase.kind === "planning" && <p className="text-gray-400">正在生成接入计划(只读,不写任何文件)…</p>}
{phase.kind === "error" && (
<p className="text-red-600 font-mono text-xs break-all">❌ {phase.message}</p>
)}
{(phase.kind === "preview" || phase.kind === "applying") && (
<PlanPreview
view={buildPlanView(phase.plan, phase.planned, selection)}
disabled={phase.kind === "applying"}
onToggleSkip={(item) => setSelection((s) => toggleSkip(s, item))}
onBypass={(on) => setSelection((s) => setBypass(s, on))}
/>
)}
{phase.kind === "report" && (
<ReportResult view={buildReportView(phase.report)} onReviewReplan={reviewReplan} />
)}
</div>
<PanelFooter
phase={phase}
selection={selection}
onCancel={close}
onReplan={() => void plan(selection)}
onConfirm={() => void applyConfirmed()}
/>
</div>
</div>
);
}
const btnCls = "px-4 py-2 rounded-lg text-sm border transition-colors disabled:opacity-50";
function PanelFooter({
phase,
selection,
onCancel,
onReplan,
onConfirm,
}: {
phase: Phase;
selection: OnboardSelection;
onCancel: () => void;
onReplan: () => void;
onConfirm: () => void;
}) {
const view = phase.kind === "preview" ? buildPlanView(phase.plan, phase.planned, selection) : null;
return (
<div className="flex items-center justify-end gap-3 px-6 py-4 border-t border-gray-100 shrink-0">
{view?.confirm.reason && <p className="flex-1 text-xs text-amber-700">{view.confirm.reason}</p>}
{phase.kind === "applying" && (
<p className="flex-1 text-xs text-gray-500">正在接入:首次可能 30 秒以上,完成前请勿关闭…</p>
)}
{phase.kind === "report" ? (
<button onClick={onCancel} className={`${btnCls} border-gray-200 text-gray-700 hover:bg-gray-50`}>
关闭
</button>
) : (
<button
onClick={onCancel}
disabled={phase.kind === "applying"}
className={`${btnCls} border-gray-200 text-gray-600 hover:bg-gray-50`}
title={phase.kind === "error" ? "关闭面板;若错误发生在确认接入之后,可能已有部分写入,请重新计划核对" : "取消不写入任何文件"}
>
取消
</button>
)}
{(phase.kind === "error" || (view && (view.needsReplan || view.blockingCount > 0))) && (
<button onClick={onReplan} className={`${btnCls} border-blue-200 text-blue-700 hover:bg-blue-50`}>
{phase.kind === "error" ? "重试" : "重新计划"}
</button>
)}
{(phase.kind === "preview" || phase.kind === "applying") && (
<button
onClick={onConfirm}
disabled={phase.kind === "applying" || !view?.confirm.enabled}
className={`${btnCls} border-transparent bg-blue-600 text-white hover:bg-blue-700`}
>
{phase.kind === "applying" ? "接入中…" : "确认接入"}
</button>
)}
</div>
);
}

View File

@ -0,0 +1,277 @@
// 一键接入面板的呈现块(P8g):计划预览与接入结果。只渲染 onboardView 的视图模型,不做判定。
import type { ReactNode } from "react";
import type { OnboardBlockedItem, OnboardingPlan } from "../../lib/commands";
import { PARITY_CHECKS, CHECK_LABEL, type OnboardTone, type PlanView, type ReportView } from "./onboardView";
const TONE_CLS: Record<OnboardTone, string> = {
ok: "text-green-700 bg-green-50 border-green-200",
info: "text-blue-700 bg-blue-50 border-blue-200",
muted: "text-gray-500 bg-gray-50 border-gray-200",
pending: "text-violet-700 bg-violet-50 border-violet-200",
warn: "text-amber-700 bg-amber-50 border-amber-200",
danger: "text-red-700 bg-red-50 border-red-200",
};
function ToneBadge({ tone, children }: { tone: OnboardTone; children: ReactNode }) {
return (
<span className={`inline-block shrink-0 text-[10px] px-1.5 py-0.5 rounded border ${TONE_CLS[tone]}`}>{children}</span>
);
}
function Section({ title, extra, children }: { title: string; extra?: ReactNode; children: ReactNode }) {
return (
<section className="space-y-1.5">
<div className="flex items-center gap-2">
<p className="text-xs font-semibold text-gray-500">{title}</p>
{extra}
</div>
{children}
</section>
);
}
function Row({ label, tone, badge, detail, mono }: { label: ReactNode; tone: OnboardTone; badge: string; detail?: string; mono?: boolean }) {
return (
<div className="flex items-start gap-2 text-xs">
<span className={`flex-1 min-w-0 truncate text-gray-700 ${mono ? "font-mono" : ""}`}>{label}</span>
{detail && <span className="max-w-[55%] text-gray-400 truncate" title={detail}>{detail}</span>}
<ToneBadge tone={tone}>{badge}</ToneBadge>
</div>
);
}
// ── 计划预览 ──────────────────────────────────────────────────────────────────
export function PlanPreview({
view,
disabled,
onToggleSkip,
onBypass,
}: {
view: PlanView;
disabled: boolean;
onToggleSkip: (item: OnboardBlockedItem) => void;
onBypass: (on: boolean) => void;
}) {
const { fileCounts } = view;
return (
<>
<p className="text-xs text-gray-500">
将写入 <span className="font-mono text-gray-700">{view.root}</span>
<span className="ml-2 text-gray-300 font-mono" title={view.digest}>digest {view.digest.slice(0, 8)}</span>
</p>
{view.blocked.length > 0 && (
<Section title="阻断项" extra={view.blockingCount > 0 && <ToneBadge tone="danger">{view.blockingCount} 项阻断确认</ToneBadge>}>
{view.blocked.map((row) => (
<div key={`${row.target}:${row.item.reason}`} className={`rounded-lg border p-2 space-y-1 ${TONE_CLS[row.tone]}`}>
<div className="flex items-center gap-2 text-xs">
<span className="font-mono flex-1 min-w-0 truncate">{row.target}</span>
<span>{row.reasonLabel}</span>
<ToneBadge tone={row.tone}>{row.stateLabel}</ToneBadge>
{row.toggleLabel && (
<button
onClick={() => onToggleSkip(row.item)}
disabled={disabled}
className="px-2 py-0.5 rounded border border-current text-[11px] hover:bg-white/60 disabled:opacity-50"
>
{row.toggleLabel}
</button>
)}
</div>
<p className="text-[11px] opacity-80 break-all">{row.detail}</p>
<p className="text-[11px] opacity-70">{row.hint}</p>
</div>
))}
</Section>
)}
<Section title="需要你留意">
<div className={`rounded-lg border p-2 space-y-1 ${TONE_CLS[view.bypass.tone]}`}>
<label className="flex items-center gap-2 text-xs">
{view.bypass.toggleable && (
<input
type="checkbox"
checked={view.bypass.selected}
disabled={disabled}
onChange={(e) => onBypass(e.target.checked)}
/>
)}
<span className="font-medium">{view.bypass.label}</span>
</label>
<p className="text-[11px] opacity-80">{view.bypass.detail}</p>
</div>
<div className={`rounded-lg border p-2 space-y-1 ${TONE_CLS[view.codexTrust.tone]}`}>
<p className="text-xs font-medium">{view.codexTrust.label}</p>
{view.codexTrust.detail && <p className="text-[11px] opacity-80 break-all">{view.codexTrust.detail}</p>}
</div>
</Section>
<Section
title={`项目文件(${view.files.length})`}
extra={<span className="text-[11px] text-gray-400">新建 {fileCounts.create} · 更新 {fileCounts.update} · 不变 {fileCounts.noop}</span>}
>
{view.files.map((file) => (
<div key={file.path} className="space-y-0.5">
<Row label={file.path} mono tone={file.tone} badge={file.actionLabel} />
{file.warning && <p className="text-[11px] text-amber-700 pl-2">⚠ {file.warning}</p>}
{file.diff && file.action !== "noop" && (
<details className="pl-2">
<summary className="text-[11px] text-gray-400 cursor-pointer">查看差异</summary>
<pre className="text-[10px] bg-gray-50 border border-gray-100 rounded p-2 overflow-x-auto max-h-48">{file.diff}</pre>
</details>
)}
</div>
))}
</Section>
<Section title="本机配置(不进仓库)">
{view.machineSteps.map((step) => (
<Row key={step.step} label={step.label} tone={step.tone} badge={step.statusLabel} detail={step.detail} />
))}
</Section>
{view.nextActions.length > 0 && (
<Section title="接入后由你完成(不阻断)">
{view.nextActions.map((action) => (
<Row key={action.action} label={action.label} tone={action.tone} badge="待办" detail={action.detail} />
))}
</Section>
)}
</>
);
}
// ── 接入结果 ──────────────────────────────────────────────────────────────────
function L1Matrix({ l1 }: { l1: NonNullable<ReportView["l1"]> }) {
return (
<div className="overflow-x-auto">
<table className="w-full text-[11px] border-collapse">
<thead>
<tr className="text-gray-400">
<th className="text-left font-normal py-1 pr-2">检查项</th>
{l1.columns.map((column) => (
<th key={column.client} className="text-left font-normal py-1 px-1">
{column.label}
{column.version && <span className="ml-1 text-gray-300 font-mono">{column.version}</span>}
</th>
))}
</tr>
</thead>
<tbody>
{PARITY_CHECKS.map((check) => (
<tr key={check} className="border-t border-gray-50">
<td className="py-1 pr-2 text-gray-600">
{check} {CHECK_LABEL[check]}
</td>
{l1.columns.map((column) => {
const cell = column.cells[check];
return (
<td key={column.client} className="py-1 px-1" title={`${cell.evidenceLabel}:${cell.detail}`}>
<ToneBadge tone={cell.tone}>{cell.label}</ToneBadge>
</td>
);
})}
</tr>
))}
</tbody>
</table>
{l1.note && <p className="text-[10px] text-gray-400 mt-1">{l1.note}</p>}
</div>
);
}
export function ReportResult({
view,
onReviewReplan,
}: {
view: ReportView;
onReviewReplan: (plan: OnboardingPlan) => void;
}) {
const { commit } = view;
return (
<>
<div className={`rounded-lg border p-3 space-y-1 ${TONE_CLS[view.tone]}`}>
<div className="flex items-center gap-2">
<span className="text-sm font-semibold">{view.statusLabel}</span>
<span className="text-[11px] opacity-70">用时 {view.durationLabel}</span>
</div>
<p className="text-xs">{view.summary}</p>
{view.reason && <p className="text-xs break-all">原因:{view.reason}</p>}
{view.replan && (
<button
onClick={() => onReviewReplan(view.replan!)}
className="mt-1 px-3 py-1 rounded border border-current text-xs hover:bg-white/60"
>
查看当前计划并重新确认
</button>
)}
</div>
{view.steps.length > 0 && (
<Section title="分步结果">
{view.steps.map((step) => (
<Row
key={step.step}
label={step.note ? `${step.label}(${step.note})` : step.label}
tone={step.tone}
badge={step.statusLabel}
detail={step.detail}
/>
))}
</Section>
)}
{view.l1 && (
<Section title="三端检查(L1 零模型)" extra={view.l1.allApplicableReady && <ToneBadge tone="ok">适用格全部就绪</ToneBadge>}>
<L1Matrix l1={view.l1} />
</Section>
)}
{commit.state === "available" && (
<Section title={commit.title}>
{commit.files.map((file) => (
<p key={file.path} className="text-xs font-mono text-gray-700">
<span className="text-gray-400 mr-2 whitespace-pre">{file.code}</span>
{file.path}
</p>
))}
{commit.otherWarning && <p className="text-[11px] text-amber-700">⚠ {commit.otherWarning}</p>}
{commit.suggestedMessage && (
<p className="text-[11px] text-gray-500">
建议提交信息:<span className="font-mono text-gray-700">{commit.suggestedMessage}</span>
</p>
)}
</Section>
)}
{commit.state === "unavailable" && <p className="text-[11px] text-gray-400">无法列出改动:{commit.reason}</p>}
{view.head && <p className={`text-[11px] ${view.head.unchanged ? "text-gray-400" : "text-amber-700"}`}>{view.head.label}</p>}
{(view.pendingUser.length > 0 || view.nextActions.length > 0) && (
<Section title="待你操作">
{view.pendingUser.map((row) => (
<Row key={row.item} label={row.item} tone={row.tone} badge={row.label} detail={row.detail} />
))}
{view.nextActions.map((action) => (
<Row key={action.action} label={action.label} tone={action.tone} badge="待办" detail={action.detail} />
))}
</Section>
)}
{view.completion.length > 0 && (
<details>
<summary className="text-xs text-gray-500 cursor-pointer">
完成判定明细({view.completion.filter((row) => row.ready).length}/{view.completion.length} 就绪)
</summary>
<div className="mt-1.5 space-y-1">
{view.completion.map((row) => (
<Row key={`${row.source}:${row.item}`} label={row.item} tone={row.tone} badge={row.label} detail={row.detail} />
))}
</div>
</details>
)}
<p className="text-[10px] text-gray-400">{view.l3}</p>
</>
);
}

View File

@ -19,6 +19,7 @@ export function ProjectModal() {
const editTarget = useUIStore((s) => s.editTarget); const editTarget = useUIStore((s) => s.editTarget);
const closeEdit = useUIStore((s) => s.closeEdit); const closeEdit = useUIStore((s) => s.closeEdit);
const showToast = useUIStore((s) => s.showToast); const showToast = useUIStore((s) => s.showToast);
const openOnboard = useUIStore((s) => s.openOnboard);
const qc = useQueryClient(); const qc = useQueryClient();
const { data: spaces = [] } = useQuery({ queryKey: ["spaces"], queryFn: getSpaces }); const { data: spaces = [] } = useQuery({ queryKey: ["spaces"], queryFn: getSpaces });
@ -93,6 +94,12 @@ const pickFolder = async (field: "wsl_path" | "win_path") => {
qc.invalidateQueries({ queryKey: ["projects"] }); qc.invalidateQueries({ queryKey: ["projects"] });
qc.invalidateQueries({ queryKey: ["tagMaps"] }); qc.invalidateQueries({ queryKey: ["tagMaps"] });
closeEdit(); closeEdit();
// create_project 本身无副作用;选了目录的新项目弹出接入预览(P8g),由人确认后才写入。不选目录的概念占位不接入
// 与后端登记同口径:按 platform 只看有效根目录那一列(另一列残留不算)
const effectiveRoot = form.platform === "wsl" ? form.wsl_path : form.win_path;
if (isNew && effectiveRoot?.trim()) {
openOnboard({ projectId: form.id!, projectName: form.name?.trim() });
}
} catch (e) { } catch (e) {
showToast(`❌ ${e}`); showToast(`❌ ${e}`);
} finally { } finally {

View File

@ -0,0 +1,290 @@
import { describe, expect, it } from "vitest";
import type {
ClientParityL1Report,
OnboardBlockedItem,
OnboardReport,
OnboardingPlan,
ParityCell,
ParityCheck,
} from "../../lib/commands";
import {
DEFAULT_SELECTION,
buildPlanView,
buildReportView,
confirmRequest,
l1MatrixView,
selectionOptions,
setBypass,
toggleSkip,
type OnboardSelection,
} from "./onboardView";
const manualCodex: OnboardBlockedItem = {
target: ".codex/config.toml",
reason: "manual_entry",
detail: "已有手写的 lian-jing 条目",
skippable: true,
};
const mixedAgents: OnboardBlockedItem = {
target: "AGENTS.md",
reason: "mixed_file",
detail: "托管块外有未提交改动",
skippable: false,
};
function plan(overrides: Partial<OnboardingPlan> = {}): OnboardingPlan {
return {
project_id: "p1",
root: "E:\\code-project\\demo",
files: [
{ path: "AGENTS.md", action: "create", content_sha256: "a" },
{ path: ".claude/settings.json", action: "update", content_sha256: "b", before_sha256: "c" },
{ path: ".lian-jing/context.json", action: "noop", content_sha256: "d" },
],
machine_changes: [
{ step: "token", status: "apply", detail: "将生成项目 token" },
{ step: "claude", status: "noop", detail: "已配置" },
{ step: "codex", status: "not_installed", detail: "未找到 codex" },
{ step: "dsh", status: "not_applicable", detail: "控制面项目" },
],
blocked: [],
skipped: [],
bypass_permissions: true,
codex_trust: "untrusted",
next_actions: [{ action: "codex_trust", detail: "在 Codex 里信任 E:\\code-project\\demo" }],
digest: "digest-1",
...overrides,
};
}
const sel = (overrides: Partial<OnboardSelection> = {}): OnboardSelection => ({ ...DEFAULT_SELECTION, ...overrides });
describe("buildPlanView 阻断与确认", () => {
it("blocked 非空时确认禁用,并逐项列出文件与原因", () => {
const view = buildPlanView(plan({ blocked: [mixedAgents, manualCodex] }), sel(), sel());
expect(view.confirm.enabled).toBe(false);
expect(view.confirm.reason).toContain("2 项阻断");
expect(view.blockingCount).toBe(2);
expect(view.blocked.map((row) => [row.target, row.reasonLabel, row.detail, row.state])).toEqual([
["AGENTS.md", "混合文件:托管块外有未提交改动", "托管块外有未提交改动", "blocking"],
[".codex/config.toml", "手写同名条目", "已有手写的 lian-jing 条目", "blocking"],
]);
expect(view.blocked.every((row) => row.tone === "danger")).toBe(true);
expect(confirmRequest(plan({ blocked: [mixedAgents] }), sel(), sel())).toBeNull();
});
it("只有后端标 skippable 的项给「跳过」,不可跳过的项切换无效", () => {
const view = buildPlanView(plan({ blocked: [mixedAgents, manualCodex] }), sel(), sel());
expect(view.blocked[0].toggleLabel).toBeUndefined();
expect(view.blocked[0].hint).toContain("禁止字符串手术");
expect(view.blocked[1].toggleLabel).toBe("跳过");
expect(toggleSkip(sel(), mixedAgents)).toEqual(sel());
expect(toggleSkip(sel(), manualCodex).skipTargets).toEqual([".codex/config.toml"]);
expect(toggleSkip(sel({ skipTargets: [".codex/config.toml"] }), manualCodex).skipTargets).toEqual([]);
});
it("选了跳过但未重新计划时确认禁用;按跳过重新计划后可确认", () => {
const chosen = toggleSkip(sel(), manualCodex);
const pending = buildPlanView(plan({ blocked: [manualCodex] }), sel(), chosen);
expect(pending.needsReplan).toBe(true);
expect(pending.blocked[0].state).toBe("skip_pending");
expect(pending.confirm).toEqual({ enabled: false, reason: "选项已改:须按当前选择重新计划后才能确认" });
const replanned = buildPlanView(plan({ blocked: [], skipped: [manualCodex] }), chosen, chosen);
expect(replanned.confirm.enabled).toBe(true);
expect(replanned.blocked[0]).toMatchObject({ state: "skipped", tone: "muted", toggleLabel: "取消跳过" });
expect(replanned.blockingCount).toBe(0);
});
it("确认请求携带计划 digest 与生成计划时的选项", () => {
const planned = sel({ skipTargets: [".codex/config.toml", ".codex/config.toml"] });
const request = confirmRequest(plan({ skipped: [manualCodex], digest: "digest-xyz" }), planned, planned);
expect(request).toEqual({
projectId: "p1",
expectedDigest: "digest-xyz",
confirmed: true,
options: { bypass_permissions: true, skip_targets: [".codex/config.toml"] },
});
});
it("selectionOptions 去重排序,计划与应用两次逐字一致", () => {
expect(selectionOptions(sel({ skipTargets: ["b", "a", "b"] }))).toEqual({
bypass_permissions: true,
skip_targets: ["a", "b"],
});
});
});
describe("buildPlanView 灰色说明与单列项", () => {
it("not_installed / not_applicable 显示为灰色说明,不是红色失败", () => {
const view = buildPlanView(plan(), sel(), sel());
const byStep = Object.fromEntries(view.machineSteps.map((row) => [row.step, row]));
expect(byStep.codex).toMatchObject({ statusLabel: "未安装", tone: "muted" });
expect(byStep.dsh).toMatchObject({ statusLabel: "不适用", tone: "muted" });
expect(byStep.token).toMatchObject({ label: "项目 MCP token", statusLabel: "将写入", tone: "info" });
expect(view.machineSteps.some((row) => row.tone === "danger")).toBe(false);
expect(view.fileCounts).toEqual({ create: 1, update: 1, noop: 1 });
});
it("bypassPermissions 单独列出:将写入可取消,取消后须重新计划", () => {
const view = buildPlanView(plan(), sel(), sel());
expect(view.bypass).toMatchObject({ willWrite: true, toggleable: true, tone: "warn" });
expect(view.bypass.label).toContain("bypassPermissions");
const off = setBypass(sel(), false);
expect(buildPlanView(plan(), sel(), off).confirm.enabled).toBe(false);
const cancelled = buildPlanView(plan({ bypass_permissions: false }), off, off);
expect(cancelled.bypass).toMatchObject({ willWrite: false, selected: false, toggleable: true });
expect(cancelled.bypass.label).toBe("已按项目取消 bypassPermissions");
expect(confirmRequest(plan({ bypass_permissions: false }), off, off)?.options.bypass_permissions).toBe(false);
const existing = buildPlanView(plan({ bypass_permissions: false }), sel(), sel());
expect(existing.bypass).toMatchObject({ toggleable: false, tone: "muted" });
});
it("Codex 信任单独列出:未信任为「待你操作」而非阻断", () => {
const view = buildPlanView(plan(), sel(), sel());
expect(view.codexTrust).toMatchObject({ state: "untrusted", tone: "pending" });
expect(view.codexTrust.detail).toContain("信任");
expect(view.confirm.enabled).toBe(true);
expect(buildPlanView(plan({ codex_trust: "not_installed", next_actions: [] }), sel(), sel()).codexTrust.tone).toBe("muted");
});
});
function cell(state: ParityCell["state"], extra: Partial<ParityCell> = {}): ParityCell {
return { state, evidence: "protocol", detail: `${state} detail`, ...extra };
}
function cells(fill: (check: ParityCheck) => ParityCell): Record<ParityCheck, ParityCell> {
return Object.fromEntries((["A", "B", "C", "D", "E", "F"] as ParityCheck[]).map((c) => [c, fill(c)])) as Record<
ParityCheck,
ParityCell
>;
}
const l1: ClientParityL1Report = {
project_id: "p1",
tier: "l1",
probe_spec_version: 1,
profile: "project",
expected_route: "http://127.0.0.1:27190/mcp/projects/p1",
expected_tools: 12,
nonce: "n",
clients: [
{ client: "claude", version: "2.1.90", route: null, cells: cells(() => cell("ready")), duration_ms: 1 },
{
client: "codex",
version: "0.50",
route: null,
cells: cells((c) => (c < "C" ? cell("ready") : cell("fail", { cause: "codex_project_untrusted" }))),
duration_ms: 1,
},
{ client: "dsh", version: null, route: null, cells: cells(() => cell("not_installed")), duration_ms: 1 },
],
all_applicable_ready: false,
duration_ms: 3,
note: "",
};
function report(overrides: Partial<OnboardReport> = {}): OnboardReport {
return {
project_id: "p1",
status: "done",
summary: "9 步完成",
bypass_permissions: true,
steps: [
{ step: "project_files", status: "applied", detail: "写入 14 个文件" },
{ step: "dsh", status: "not_applicable", reason: "not_installed", detail: "未安装 DSH" },
{ step: "codex", status: "blocked", dep: "token", detail: "token 未就绪" },
],
completion: [
{ item: "Claude MCP 已配置", source: "clients", ready: true, detail: "", pending_user: false },
{ item: "Codex 信任", source: "l1", ready: false, detail: "待信任", pending_user: true },
],
l1,
l3: "L3 尚未提供",
written_files: ["AGENTS.md"],
repo_changes: {
state: "available",
status_porcelain: [],
diff_stat: "2 files changed",
onboard_files: [
{ path: "AGENTS.md", code: "??" },
{ path: ".claude/settings.json", code: " M" },
],
other_changes: 1,
},
head: { before: "abc", after: "abc", unchanged: true },
suggested_commit_message: "chore(lian-jing): 一键接入",
next_actions: [{ action: "commit", detail: "git add -- AGENTS.md" }],
duration_ms: 7900,
...overrides,
};
}
describe("buildReportView", () => {
it("分步结果:not_applicable 灰色、blocked 注明依赖", () => {
const view = buildReportView(report());
expect(view.steps.map((row) => [row.step, row.statusLabel, row.tone, row.note])).toEqual([
["project_files", "已写入", "ok", undefined],
["dsh", "不适用", "muted", "未安装"],
["codex", "未执行", "warn", "依赖「项目 MCP token」未完成"],
]);
expect(view.toast).toBe("一键接入接入完成 ✓");
expect(view.durationLabel).toBe("7.9 秒");
});
it("待你提交的 N 个文件与 Codex 信任单列,不计入完成", () => {
const view = buildReportView(report());
expect(view.commit).toMatchObject({ state: "available", title: "待你提交的 2 个文件", otherChanges: 1 });
expect(view.commit.state === "available" && view.commit.otherWarning).toContain("不要 git add -A");
expect(view.completion.map((row) => row.item)).toEqual(["Claude MCP 已配置"]);
expect(view.pendingUser).toEqual([
{ item: "Codex 信任", source: "l1", ready: false, label: "待你操作", tone: "pending", detail: "待信任" },
]);
expect(view.head).toMatchObject({ unchanged: true, tone: "ok" });
});
it("refused 附当前计划供重新确认,提示以 ❌ 开头且不报告改动", () => {
const replan = plan({ digest: "digest-2" });
const view = buildReportView(
report({ status: "refused", reason: "digest 不符", plan: replan, repo_changes: undefined, l1: undefined }),
);
expect(view.replan).toBe(replan);
expect(view.tone).toBe("warn");
expect(view.toast).toBe("❌ 一键接入已拒绝(零写入):digest 不符");
expect(view.commit).toEqual({ state: "none" });
expect(view.l1).toBeUndefined();
});
});
describe("l1MatrixView", () => {
it("未安装为灰色,Codex 未信任为「待你信任」而非红色失败", () => {
const view = l1MatrixView(l1);
const [claude, codex, dsh] = view.columns;
expect(claude.cells.F).toMatchObject({ label: "就绪", tone: "ok" });
expect(codex.cells.A.tone).toBe("ok");
expect(codex.cells.C).toMatchObject({ label: "待你信任", tone: "pending", cause: "codex_project_untrusted" });
expect(dsh.cells.A).toMatchObject({ label: "未安装", tone: "muted" });
expect(Object.values(dsh.cells).every((c) => c.tone === "muted")).toBe(true);
expect(dsh.label).toBe("DSH");
});
it("依赖步骤未完成的格注明步骤;真实失败为红色", () => {
const report = {
...l1,
clients: [
{
...l1.clients[0],
cells: cells((c) =>
c === "A" ? cell("blocked", { cause: "dependency", dep: "claude" }) : cell("fail", { cause: "auth_failed" }),
),
},
],
};
const [claude] = l1MatrixView(report).columns;
expect(claude.cells.A).toMatchObject({ label: "未检查:Claude Code 步骤未完成", tone: "warn" });
expect(claude.cells.F).toMatchObject({ label: "失败", tone: "danger" });
});
});

View File

@ -0,0 +1,672 @@
// 一键接入(agent-client-parity P8g)视图模型:把 OnboardingPlan / OnboardReport 转成界面要展示的结构。
// 只做呈现映射,不复制本体判定(AGENTS.md「边界单点实现」):阻断与否看 plan.blocked、能否跳过看
// blocked[].skippable、完成与否看 report.status 与 completion[].pending_user,全部由后端给出。
// 界面自己只管一件事:当前选择(bypass / 跳过项)与生成计划时所用的选择是否一致——不一致必须重新计划,
// 因为 onboardProject 须带同一组选项与 digest(否则后端 refused)。
import type {
ClientParityL1Report,
CodexTrust,
OnboardBlockReason,
OnboardBlockedItem,
OnboardCompletionItem,
OnboardFileAction,
OnboardNextAction,
OnboardOptions,
OnboardPendingFile,
OnboardReport,
OnboardStatus,
OnboardStepReport,
OnboardingPlan,
ParityCause,
ParityCell,
ParityCellState,
ParityCheck,
ParityEvidence,
} from "../../lib/commands";
/** 呈现色调。muted 是灰色说明(未安装 / 不适用 / 已跳过 / 不变),不是失败;pending 是「待你操作」 */
export type OnboardTone = "ok" | "info" | "muted" | "pending" | "warn" | "danger";
// ── 选项:计划与应用必须一致 ──────────────────────────────────────────────────
export interface OnboardSelection {
/** 勾选 = 保持默认:项目 .claude/settings.json 还没有 permissions 时写入 bypassPermissions */
bypassPermissions: boolean;
/** 人逐项选「跳过」的阻断项 target(只对 skippable 的项生效) */
skipTargets: string[];
}
export const DEFAULT_SELECTION: OnboardSelection = { bypassPermissions: true, skipTargets: [] };
function normalizeTargets(targets: readonly string[]): string[] {
return [...new Set(targets)].sort();
}
/** 选择 → 传给 planOnboarding / onboardProject 的选项(跳过项去重排序,两次调用逐字一致) */
export function selectionOptions(selection: OnboardSelection): OnboardOptions {
return {
bypass_permissions: selection.bypassPermissions,
skip_targets: normalizeTargets(selection.skipTargets),
};
}
export function sameSelection(a: OnboardSelection, b: OnboardSelection): boolean {
if (a.bypassPermissions !== b.bypassPermissions) return false;
const x = normalizeTargets(a.skipTargets);
const y = normalizeTargets(b.skipTargets);
return x.length === y.length && x.every((target, i) => target === y[i]);
}
/** 切换某阻断项的「跳过」。后端没标 skippable 的项不响应(只能中止或处理后重新计划) */
export function toggleSkip(selection: OnboardSelection, item: OnboardBlockedItem): OnboardSelection {
if (!item.skippable) return selection;
const has = selection.skipTargets.includes(item.target);
return {
...selection,
skipTargets: has
? selection.skipTargets.filter((target) => target !== item.target)
: [...selection.skipTargets, item.target],
};
}
export function setBypass(selection: OnboardSelection, bypassPermissions: boolean): OnboardSelection {
return { ...selection, bypassPermissions };
}
// ── 文案映射(只翻译后端给的枚举,不推断) ─────────────────────────────────────
interface Badge {
label: string;
tone: OnboardTone;
}
const FILE_ACTION: Record<OnboardFileAction, Badge> = {
create: { label: "新建", tone: "info" },
update: { label: "更新", tone: "info" },
noop: { label: "不变", tone: "muted" },
};
const BLOCK_REASON_LABEL: Record<OnboardBlockReason, string> = {
mixed_file: "混合文件:托管块外有未提交改动",
identity_conflict: "身份冲突:目录已属于别的项目",
manual_entry: "手写同名条目",
shared_key: "共享项目键:生效条目属于别的项目",
needs_human: "需人工处理",
};
/** 不可跳过的项怎么办(可跳过的项统一给「跳过 / 中止」) */
const BLOCK_REASON_HINT: Record<OnboardBlockReason, string> = {
mixed_file: "先在子项目提交或丢弃块外改动,再重新计划(禁止字符串手术);或中止",
identity_conflict: "核对 .lian-jing/context.json 的归属后重新计划;或中止",
manual_entry: "处理后重新计划;或中止",
shared_key: "处理后重新计划;或中止",
needs_human: "按说明处理后重新计划;或中止",
};
export const STEP_LABEL: Record<string, string> = {
identity: "项目身份",
project_files: "项目文件",
git_hooks: "Git hooks(lefthook install)",
product_group_buff: "产品组与 buff",
token: "项目 MCP token",
shim: "稳定 helper 入口",
claude: "Claude Code",
codex: "Codex",
dsh: "DSH",
};
/** 计划里本机七步的预计动作 */
const MACHINE_STATUS: Record<string, Badge> = {
noop: { label: "已就绪", tone: "ok" },
apply: { label: "将写入", tone: "info" },
not_installed: { label: "未安装", tone: "muted" },
not_applicable: { label: "不适用", tone: "muted" },
unavailable: { label: "无法判定", tone: "warn" },
manual_kept: { label: "手写同名条目", tone: "warn" },
other_project: { label: "属于别的项目", tone: "warn" },
needs_human: { label: "需人工处理", tone: "danger" },
};
const CODEX_TRUST: Record<CodexTrust, Badge> = {
trusted: { label: "Codex 已信任该目录", tone: "ok" },
untrusted: { label: "待你操作:在 Codex 里信任该目录", tone: "pending" },
not_installed: { label: "未安装 Codex", tone: "muted" },
unknown: { label: "待你确认:无法判断 Codex 是否信任该目录", tone: "pending" },
};
export const NEXT_ACTION_LABEL: Record<string, string> = {
codex_trust: "在 Codex 里信任该目录",
commit: "提交接入文件",
gitea_repo: "建 Gitea 仓库",
ci: "配置 CI",
flywheel: "飞轮数据",
toolchain: "准备工具链",
delivery_profile: "交付配置",
lefthook: "安装 lefthook",
restart_dsh_gui: "重启 DSH 桌面 GUI",
claude_trust: "Claude 首次打开目录时确认信任",
reopen_sessions: "重开已打开的会话",
repo_layout: "仓库布局说明",
};
// ── 计划预览 ──────────────────────────────────────────────────────────────────
export interface FileRow {
path: string;
action: OnboardFileAction;
actionLabel: string;
tone: OnboardTone;
diff?: string;
warning?: string;
}
export interface MachineStepRow {
step: string;
label: string;
status: string;
statusLabel: string;
tone: OnboardTone;
detail: string;
}
/** blocking 阻断中;skip_pending 已选跳过、待重新计划;skipped 计划已按跳过生成;unskip_pending 已取消跳过、待重新计划 */
export type BlockedRowState = "blocking" | "skip_pending" | "skipped" | "unskip_pending";
export interface BlockedRow {
item: OnboardBlockedItem;
target: string;
reasonLabel: string;
detail: string;
/** 来自后端 skippable:为 true 才给「跳过」按钮 */
skippable: boolean;
state: BlockedRowState;
stateLabel: string;
tone: OnboardTone;
hint: string;
/** 可跳过的项的按钮文案;不可跳过为空(只能中止或处理后重新计划) */
toggleLabel?: string;
}
export interface BypassView {
/** 本次计划会新写入 permissions.defaultMode=bypassPermissions(后端 plan.bypass_permissions) */
willWrite: boolean;
/** 当前选择:勾选 = 保持默认写入 */
selected: boolean;
/** 生成本计划时的选择 */
planned: boolean;
label: string;
detail: string;
tone: OnboardTone;
/** 会写入或已按项目取消时给开关;项目已有 permissions 时开关无意义,不给 */
toggleable: boolean;
}
export interface CodexTrustView {
state: CodexTrust;
label: string;
tone: OnboardTone;
detail: string;
}
export interface NextActionRow {
action: string;
label: string;
detail: string;
tone: OnboardTone;
}
export interface PlanView {
projectId: string;
root: string;
digest: string;
files: FileRow[];
fileCounts: Record<OnboardFileAction, number>;
machineSteps: MachineStepRow[];
/** plan.blocked 与 plan.skipped 合并展示 */
blocked: BlockedRow[];
/** 仍阻断确认的项数(= plan.blocked.length) */
blockingCount: number;
bypass: BypassView;
codexTrust: CodexTrustView;
nextActions: NextActionRow[];
/** 当前选择与生成计划时不同:必须重新计划才能确认 */
needsReplan: boolean;
confirm: { enabled: boolean; reason?: string };
}
const BLOCKED_STATE: Record<BlockedRowState, Badge> = {
blocking: { label: "阻断", tone: "danger" },
skip_pending: { label: "将跳过(需重新计划)", tone: "warn" },
skipped: { label: "已跳过:保留现状,该端不写", tone: "muted" },
unskip_pending: { label: "将恢复阻断(需重新计划)", tone: "warn" },
};
function blockedRow(item: OnboardBlockedItem, inPlanSkipped: boolean, selected: boolean): BlockedRow {
const skippable = item.skippable === true;
const state: BlockedRowState = inPlanSkipped
? selected ? "skipped" : "unskip_pending"
: skippable && selected ? "skip_pending" : "blocking";
const badge = BLOCKED_STATE[state];
return {
item,
target: item.target,
reasonLabel: BLOCK_REASON_LABEL[item.reason] ?? item.reason,
detail: item.detail,
skippable,
state,
stateLabel: badge.label,
tone: badge.tone,
hint: skippable
? "可逐项「跳过」:保留现状、该端不写(跳过不等于该端可用);或中止"
: BLOCK_REASON_HINT[item.reason] ?? "处理后重新计划;或中止",
toggleLabel: skippable ? (selected ? "取消跳过" : "跳过") : undefined,
};
}
function bypassView(plan: OnboardingPlan, planned: OnboardSelection, selection: OnboardSelection): BypassView {
const base = { willWrite: plan.bypass_permissions, selected: selection.bypassPermissions, planned: planned.bypassPermissions };
if (plan.bypass_permissions) {
return {
...base,
label: "将写入 permissions.defaultMode=bypassPermissions",
detail: "项目 .claude/settings.json 还没有 permissions:按炼境默认写入,Claude Code 在本项目跳过权限确认。可按项目取消(取消后须重新计划)。",
tone: "warn",
toggleable: true,
};
}
if (!planned.bypassPermissions) {
return {
...base,
label: "已按项目取消 bypassPermissions",
detail:
"不写入 bypassPermissions。settings.json 缺 permissions 时会写显式 defaultMode=default 记住选择(之后的重注入不会补回);已有 permissions 则原样不动。",
tone: "muted",
toggleable: true,
};
}
return {
...base,
label: "不新写入 bypassPermissions",
detail: "项目 .claude/settings.json 已有 permissions 设置,本次不改。",
tone: "muted",
toggleable: false,
};
}
function nextActionRow(action: OnboardNextAction): NextActionRow {
return {
action: action.action,
label: NEXT_ACTION_LABEL[action.action] ?? action.action,
detail: action.detail,
tone: action.action === "codex_trust" ? "pending" : "info",
};
}
/**
* 计划 → 预览视图。planned 是生成本计划时的选择,selection 是界面当前的选择。
* 确认按钮:plan.blocked 非空一律禁用(后端也会 refused);选择改过未重新计划也禁用。
*/
export function buildPlanView(
plan: OnboardingPlan,
planned: OnboardSelection,
selection: OnboardSelection,
): PlanView {
const selected = new Set(selection.skipTargets);
const fileCounts: Record<OnboardFileAction, number> = { create: 0, update: 0, noop: 0 };
const files = plan.files.map((file): FileRow => {
fileCounts[file.action] = (fileCounts[file.action] ?? 0) + 1;
const badge = FILE_ACTION[file.action] ?? { label: file.action, tone: "warn" };
return {
path: file.path,
action: file.action,
actionLabel: badge.label,
tone: file.warning ? "warn" : badge.tone,
diff: file.diff,
warning: file.warning,
};
});
const machineSteps = plan.machine_changes.map((step): MachineStepRow => {
const badge = MACHINE_STATUS[step.status] ?? { label: step.status, tone: "warn" };
return {
step: step.step,
label: STEP_LABEL[step.step] ?? step.step,
status: step.status,
statusLabel: badge.label,
tone: badge.tone,
detail: step.detail,
};
});
const blocked = [
...plan.blocked.map((item) => blockedRow(item, false, selected.has(item.target))),
...(plan.skipped ?? []).map((item) => blockedRow(item, true, selected.has(item.target))),
];
const trust = CODEX_TRUST[plan.codex_trust] ?? { label: plan.codex_trust, tone: "warn" };
const trustAction = plan.next_actions.find((action) => action.action === "codex_trust");
const needsReplan = !sameSelection(planned, selection);
const blockingCount = plan.blocked.length;
const reason = needsReplan
? "选项已改:须按当前选择重新计划后才能确认"
: blockingCount > 0
? `有 ${blockingCount} 项阻断,确认已禁用:可跳过的项选「跳过」后重新计划,其余处理后重新计划或中止`
: undefined;
return {
projectId: plan.project_id,
root: plan.root,
digest: plan.digest,
files,
fileCounts,
machineSteps,
blocked,
blockingCount,
bypass: bypassView(plan, planned, selection),
codexTrust: {
state: plan.codex_trust,
label: trust.label,
tone: trust.tone,
detail: trustAction?.detail ?? (plan.codex_trust === "trusted" ? "Codex 会加载项目 .codex/config.toml" : ""),
},
nextActions: plan.next_actions.map(nextActionRow),
needsReplan,
confirm: { enabled: reason === undefined, reason },
};
}
export interface OnboardConfirmRequest {
projectId: string;
/** 用户确认过的计划 digest */
expectedDigest: string;
confirmed: true;
/** 生成该计划时的选项(不是界面当前选择) */
options: OnboardOptions;
}
/** 确认接入的调用参数;确认按钮应禁用时返回 null(不发请求) */
export function confirmRequest(
plan: OnboardingPlan,
planned: OnboardSelection,
selection: OnboardSelection,
): OnboardConfirmRequest | null {
if (!buildPlanView(plan, planned, selection).confirm.enabled) return null;
return {
projectId: plan.project_id,
expectedDigest: plan.digest,
confirmed: true,
options: selectionOptions(planned),
};
}
// ── 接入报告 ──────────────────────────────────────────────────────────────────
const STATUS: Record<OnboardStatus, Badge> = {
done: { label: "接入完成", tone: "ok" },
partial: { label: "部分完成", tone: "warn" },
failed: { label: "未执行:预检失败(零写入)", tone: "danger" },
refused: { label: "已拒绝(零写入)", tone: "warn" },
busy: { label: "该项目正在接入中(零写入)", tone: "info" },
};
const STEP_STATUS: Record<OnboardStepReport["status"], Badge> = {
converged: { label: "已一致", tone: "ok" },
applied: { label: "已写入", tone: "ok" },
skipped: { label: "已跳过", tone: "muted" },
not_applicable: { label: "不适用", tone: "muted" },
blocked: { label: "未执行", tone: "warn" },
failed: { label: "失败", tone: "danger" },
needs_human: { label: "需人工处理", tone: "warn" },
};
/** 步骤 reason 的常见取值(其余原样展示) */
const STEP_REASON: Record<string, string> = {
not_installed: "未安装",
control_plane: "控制面项目",
wsl: "WSL 项目",
manual_kept: "保留手写配置",
other_project: "属于别的项目",
deferred: "延后",
};
export interface StepRow {
step: string;
label: string;
status: OnboardStepReport["status"];
statusLabel: string;
tone: OnboardTone;
/** reason 或 dep 的说明 */
note?: string;
detail: string;
}
export interface CompletionRow {
item: string;
source: OnboardCompletionItem["source"];
ready: boolean;
label: string;
tone: OnboardTone;
detail: string;
}
export const PARITY_CHECKS: ParityCheck[] = ["A", "B", "C", "D", "E", "F"];
export const CHECK_LABEL: Record<ParityCheck, string> = {
A: "项目规则",
B: "lian-jing skill",
C: "MCP 工具集",
D: "get_diagnostics",
E: "列出开发变量",
F: "敏感读取认证链",
};
const CELL_STATE: Record<ParityCellState, Badge> = {
ready: { label: "就绪", tone: "ok" },
fail: { label: "失败", tone: "danger" },
unknown: { label: "未知", tone: "warn" },
not_installed: { label: "未安装", tone: "muted" },
not_applicable: { label: "不适用", tone: "muted" },
blocked: { label: "未检查", tone: "warn" },
timeout: { label: "超时", tone: "danger" },
};
export const EVIDENCE_LABEL: Record<ParityEvidence, string> = {
static: "静态",
client_introspection: "客户端自省",
protocol: "协议重放",
session_event: "会话事件",
server_trace: "服务端轨迹",
};
/** 只等用户在客户端里操作的归因(与后端 completion 的 pending_user 同口径,仅用于着色) */
const PENDING_USER_CAUSES: ParityCause[] = ["codex_project_untrusted"];
export interface L1CellView {
state: ParityCellState;
label: string;
tone: OnboardTone;
evidence: ParityEvidence;
evidenceLabel: string;
cause?: ParityCause;
detail: string;
}
export interface L1ColumnView {
client: string;
label: string;
version: string | null;
route: string | null;
cells: Record<ParityCheck, L1CellView>;
}
export interface L1MatrixView {
profile: ClientParityL1Report["profile"];
allApplicableReady: boolean;
note: string;
columns: L1ColumnView[];
}
function cellView(cell: ParityCell): L1CellView {
const badge = CELL_STATE[cell.state] ?? { label: cell.state, tone: "warn" };
const pendingUser = cell.state !== "ready" && cell.cause !== undefined && PENDING_USER_CAUSES.includes(cell.cause);
const label = pendingUser
? "待你信任"
: cell.state === "blocked" && cell.dep
? `未检查:${STEP_LABEL[cell.dep] ?? cell.dep} 步骤未完成`
: badge.label;
return {
state: cell.state,
label,
tone: pendingUser ? "pending" : badge.tone,
evidence: cell.evidence,
evidenceLabel: EVIDENCE_LABEL[cell.evidence] ?? cell.evidence,
cause: cell.cause,
detail: cell.detail,
};
}
export function l1MatrixView(report: ClientParityL1Report): L1MatrixView {
return {
profile: report.profile,
allApplicableReady: report.all_applicable_ready,
note: report.note,
columns: report.clients.map((column) => {
const cells = {} as Record<ParityCheck, L1CellView>;
for (const check of PARITY_CHECKS) {
const cell = column.cells[check];
cells[check] = cell
? cellView(cell)
: { state: "unknown", label: "缺失", tone: "warn", evidence: "static", evidenceLabel: EVIDENCE_LABEL.static, detail: "报告未给出该格" };
}
return {
client: column.client,
label: STEP_LABEL[column.client] ?? column.client,
version: column.version,
route: column.route,
cells,
};
}),
};
}
export type CommitView =
| {
state: "available";
/** 「待你提交的 N 个文件」 */
title: string;
files: OnboardPendingFile[];
otherChanges: number;
/** 有非接入改动时提醒勿混进接入提交 */
otherWarning?: string;
suggestedMessage?: string;
diffStat: string;
}
| { state: "unavailable"; reason: string }
/** 未执行写入(refused / busy / failed)时不报告改动 */
| { state: "none" };
export interface ReportView {
status: OnboardStatus;
statusLabel: string;
tone: OnboardTone;
summary: string;
reason?: string;
steps: StepRow[];
/** 计入「完成」的项(不含 pending_user) */
completion: CompletionRow[];
/** 「待你操作」:只等你在客户端里操作、不计入完成判定的项(目前只有 Codex 信任) */
pendingUser: CompletionRow[];
l1?: L1MatrixView;
l3: string;
bypassWritten: boolean;
writtenFiles: string[];
commit: CommitView;
nextActions: NextActionRow[];
head?: { unchanged: boolean; label: string; tone: OnboardTone };
/** refused 且附当前计划:须回到预览、按新计划重新确认 */
replan?: OnboardingPlan;
durationLabel: string;
/** 结果提示:失败类状态以「❌」开头 */
toast: string;
}
function stepRow(step: OnboardStepReport): StepRow {
const badge = STEP_STATUS[step.status] ?? { label: step.status, tone: "warn" };
let note: string | undefined;
if (step.status === "blocked") {
note = `依赖「${STEP_LABEL[step.dep] ?? step.dep}」未完成`;
} else if ("reason" in step && step.reason) {
note = STEP_REASON[step.reason] ?? step.reason;
}
return {
step: step.step,
label: STEP_LABEL[step.step] ?? step.step,
status: step.status,
statusLabel: badge.label,
tone: badge.tone,
note,
detail: step.detail,
};
}
function completionRow(item: OnboardCompletionItem): CompletionRow {
const pending = !item.ready && item.pending_user;
return {
item: item.item,
source: item.source,
ready: item.ready,
label: item.ready ? "就绪" : pending ? "待你操作" : "未就绪",
tone: item.ready ? "ok" : pending ? "pending" : "danger",
detail: item.detail,
};
}
function commitView(report: OnboardReport): CommitView {
const changes = report.repo_changes;
if (!changes) return { state: "none" };
if (changes.state === "unavailable") return { state: "unavailable", reason: changes.reason };
return {
state: "available",
title: `待你提交的 ${changes.onboard_files.length} 个文件`,
files: changes.onboard_files,
otherChanges: changes.other_changes,
otherWarning:
changes.other_changes > 0
? `另有 ${changes.other_changes} 处不属于接入的改动:只 add 上面的文件,不要 git add -A`
: undefined,
suggestedMessage: report.suggested_commit_message,
diffStat: changes.diff_stat,
};
}
const FAILURE_STATUSES: OnboardStatus[] = ["failed", "refused", "busy"];
/** 报告 → 结果视图(分步结果、L1 矩阵、待你操作、待提交文件、next_actions) */
export function buildReportView(report: OnboardReport): ReportView {
const badge = STATUS[report.status] ?? { label: report.status, tone: "warn" };
const completion = report.completion.map((item) => ({ item, row: completionRow(item) }));
const failure = FAILURE_STATUSES.includes(report.status);
return {
status: report.status,
statusLabel: badge.label,
tone: badge.tone,
summary: report.summary,
reason: report.reason,
steps: report.steps.map(stepRow),
completion: completion.filter(({ item }) => !item.pending_user).map(({ row }) => row),
pendingUser: completion.filter(({ item }) => item.pending_user).map(({ row }) => row),
l1: report.l1 ? l1MatrixView(report.l1) : undefined,
l3: report.l3,
bypassWritten: report.bypass_permissions,
writtenFiles: report.written_files ?? [],
commit: commitView(report),
nextActions: report.next_actions.map(nextActionRow),
head: report.head
? report.head.unchanged
? { unchanged: true, label: "HEAD 未变(炼境不 add、不 commit)", tone: "ok" }
: { unchanged: false, label: "HEAD 已变化:写入期间有别的提交,请核对", tone: "warn" }
: undefined,
replan: report.status === "refused" ? report.plan : undefined,
durationLabel: `${(report.duration_ms / 1000).toFixed(1)} 秒`,
toast: failure
? `❌ 一键接入${badge.label}:${report.reason ?? report.summary}`
: `一键接入${badge.label} ✓`,
};
}

View File

@ -28,7 +28,10 @@ const EXEC_STEPS = [
export function NewProjectModal({ spaceId, onClose }: Props) { export function NewProjectModal({ spaceId, onClose }: Props) {
const showToast = useUIStore((s) => s.showToast); const showToast = useUIStore((s) => s.showToast);
const openOnboard = useUIStore((s) => s.openOnboard);
const qc = useQueryClient(); const qc = useQueryClient();
/** 模板创建成功的项目 ID:自动弹接入预览(P8g),取消后可从完成页再次打开 */
const [createdId, setCreatedId] = useState<string | null>(null);
// ── Step 1 ──────────────────────────────────────────────────────────────── // ── Step 1 ────────────────────────────────────────────────────────────────
const [platform, setPlatform] = useState<"win" | "wsl">("win"); const [platform, setPlatform] = useState<"win" | "wsl">("win");
@ -128,7 +131,7 @@ export function NewProjectModal({ spaceId, onClose }: Props) {
const variantCmd = selectedVariants.length > 0 const variantCmd = selectedVariants.length > 0
? selectedVariants[selectedVariantIdx]?.initCommands ? selectedVariants[selectedVariantIdx]?.initCommands
: undefined; : undefined;
await createProjectFromTemplate( const result = await createProjectFromTemplate(
selectedTemplateId, selectedTemplateId,
parentPath, parentPath,
projectName.trim(), projectName.trim(),
@ -138,6 +141,8 @@ export function NewProjectModal({ spaceId, onClose }: Props) {
); );
qc.invalidateQueries({ queryKey: ["projects"] }); qc.invalidateQueries({ queryKey: ["projects"] });
setStep("done"); setStep("done");
setCreatedId(result.projectId);
openOnboard({ projectId: result.projectId, projectName: projectName.trim() });
} catch (e) { } catch (e) {
setLogs((prev) => [...prev, `❌ 创建失败: ${e}`]); setLogs((prev) => [...prev, `❌ 创建失败: ${e}`]);
setHasError(true); setHasError(true);
@ -449,6 +454,14 @@ export function NewProjectModal({ spaceId, onClose }: Props) {
)} )}
</div> </div>
<div className="flex gap-3"> <div className="flex gap-3">
{step === "done" && createdId && (
<button
onClick={() => openOnboard({ projectId: createdId, projectName: projectName.trim() })}
className="px-4 py-2 text-sm border border-blue-200 rounded-lg text-blue-700 hover:bg-blue-50"
>
一键接入
</button>
)}
<button <button
onClick={onClose} onClick={onClose}
disabled={step === "executing"} disabled={step === "executing"}

View File

@ -7,7 +7,7 @@ export function Toast() {
const isError = toast.startsWith("❌"); const isError = toast.startsWith("❌");
return ( return (
<div className={`fixed bottom-10 left-1/2 -translate-x-1/2 z-50 text-sm px-4 py-2 rounded-lg shadow-lg animate-fade-in flex items-center gap-2 max-w-[80vw] ${ <div className={`fixed bottom-10 left-1/2 -translate-x-1/2 z-[70] text-sm px-4 py-2 rounded-lg shadow-lg animate-fade-in flex items-center gap-2 max-w-[80vw] ${
isError ? "bg-red-900 text-white pointer-events-auto" : "bg-gray-900 text-white pointer-events-none" isError ? "bg-red-900 text-white pointer-events-auto" : "bg-gray-900 text-white pointer-events-none"
}`}> }`}>
<span className="break-all">{toast}</span> <span className="break-all">{toast}</span>

View File

@ -1770,6 +1770,8 @@ export interface OnboardBlockedItem {
target: string; target: string;
reason: OnboardBlockReason; reason: OnboardBlockReason;
detail: string; detail: string;
/** 本体派生(BlockReason::skippable):可在确认时逐项「跳过」;界面据此给按钮,不自行判定 */
skippable: boolean;
} }
/** 本机七步:token、shim、claude、codex、dsh、product_group_buff、git_hooks */ /** 本机七步:token、shim、claude、codex、dsh、product_group_buff、git_hooks */

View File

@ -1,5 +1,13 @@
import { create } from "zustand"; import { create } from "zustand";
import type { Project } from "../lib/commands"; import type { OnboardReport, Project } from "../lib/commands";
/** 一键接入预览的目标(agent-client-parity P8g):新建、模板创建、批量添加、蓝图治理都打开同一面板 */
export interface OnboardTarget {
projectId: string;
projectName?: string;
/** 面板关闭时回调;未执行接入(取消 / 计划失败)时 report 为 null */
onClosed?: (report: OnboardReport | null) => void;
}
interface UIState { interface UIState {
// Toast // Toast
@ -10,6 +18,11 @@ interface UIState {
editTarget: Project | null | undefined; // undefined = closed, null = new, obj = edit editTarget: Project | null | undefined; // undefined = closed, null = new, obj = edit
openEdit: (project?: Project | null) => void; openEdit: (project?: Project | null) => void;
closeEdit: () => void; closeEdit: () => void;
// 一键接入面板(全局挂载:新建弹窗保存后即卸载,面板须独立存在)
onboardTarget: OnboardTarget | null;
openOnboard: (target: OnboardTarget) => void;
closeOnboard: () => void;
} }
export const useUIStore = create<UIState>((set) => ({ export const useUIStore = create<UIState>((set) => ({
@ -22,4 +35,8 @@ export const useUIStore = create<UIState>((set) => ({
editTarget: undefined, editTarget: undefined,
openEdit: (project) => set({ editTarget: project ?? null }), openEdit: (project) => set({ editTarget: project ?? null }),
closeEdit: () => set({ editTarget: undefined }), closeEdit: () => set({ editTarget: undefined }),
onboardTarget: null,
openOnboard: (target) => set({ onboardTarget: target }),
closeOnboard: () => set({ onboardTarget: null }),
})); }));