From 1bb4ce978e28bd1a83513b5a0a48fa8ea5944d31 Mon Sep 17 00:00:00 2001 From: lanrtop Date: Sun, 23 Aug 2026 15:46:16 +0900 Subject: [PATCH] =?UTF-8?q?chore(blueprint):=20=E6=B2=89=E6=B7=80=E5=BC=80?= =?UTF-8?q?=E5=8F=91=E4=BE=A7=E4=B8=96=E7=95=8C=E6=A8=A1=E5=9E=8B=E9=80=8F?= =?UTF-8?q?=E9=95=9C=20+=20staleness=20=E5=8D=A1=E6=94=B6=E5=AE=98=20+=20n?= =?UTF-8?q?otes=20=E6=A1=A3=E6=A1=88=E5=8D=A1=E5=B0=B1=E7=BB=AA?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .blueprint/manifest.yaml | 5 +-- .../modules/governance-feedback-loop.md | 36 ++++++++++++++++++- .blueprint/modules/mcp-server.md | 7 ++++ 3 files changed, 45 insertions(+), 3 deletions(-) diff --git a/.blueprint/manifest.yaml b/.blueprint/manifest.yaml index c78253f..d5a799b 100644 --- a/.blueprint/manifest.yaml +++ b/.blueprint/manifest.yaml @@ -6,7 +6,7 @@ description: > 成为每个项目的贴身导师。炼境本身亦被纳入其中， 形成可自我进化的开发智能闭环。 iteration: 1 -updated: 2026-07-04 +updated: 2026-08-23 agent_button_carrier: tauri @@ -422,7 +422,8 @@ modules: area: backend status: concept progress: 0 - note: "老板-员工手册隐喻：用户反馈子项目问题 → 结构化落账 → 梦核蒸馏进规则/模板 → 批量分发 → 飞轮观测生效。三缺口：反馈入口、反馈进梦核高权重输入、接入包批量重分发" + note: "老板-员工手册隐喻：反馈→落账→梦核蒸馏→批量分发→飞轮观测。2026-08-23 沉淀「开发侧世界模型透镜」：三闸门（跨项目edges/全局地图/模式库）+ 三投影准入律；📋 notes 档案落地卡就绪（可拆除性唯一硬违规修复）" + updated: 2026-08-23 position: [1250, 650] - id: mcp-single-server diff --git a/.blueprint/modules/governance-feedback-loop.md b/.blueprint/modules/governance-feedback-loop.md index 546f946..b27f345 100644 --- a/.blueprint/modules/governance-feedback-loop.md +++ b/.blueprint/modules/governance-feedback-loop.md @@ -69,6 +69,40 @@ MANAGED 块警示（5b0b068）、Bug Fix/Feature 分类 + S 级轻量卡 + 汇 - ~~src-tauri/ 下空路径污染残留~~ → 2026-07-18 辩证收缩后三步收官：①9 个污染文件已移出（暂存 `%TEMP%\liangjing-pollution-20260718`）；②两条空路径僵尸登记（agent编排界面(opencode)/银龙集团应用）已 unregister（磁盘无对应目录，实为死登记）；③辩证挖出 **inject 链路漏拦同一空路径洞**（`project_root()` 对空串 win_path 穿透写 cwd，正是 settings.json/liangjing.json 污染的来源）——已单点补 `validate_registered_path`（拒空+拒相对路径）+ 2 条回归测试。空路径事故至此两链路（apply/inject）全堵 - envoy.md 硬门槛已进模板，**需重建安装炼境后 apply 才会分发到子项目**（模板打包在二进制资源） +## 开发侧世界模型透镜（2026-08-23 辩证收敛） + +> 源头：enterprise-system 使者回传「炼境=开发侧世界模型容器」（2026-08-23）+ 业务侧四载体 +> （vision-world-model.md / estate1-world-model.md / hub-relation-catalog.md / hub-matrix-biz-ecology.md）回顾。 +> **合题：世界模型是透镜，不是工程**——用透镜照出真实病灶就修，其余全部挂闸门。 + +### 同构映射（业务侧 ↔ 开发侧） + +R 规则层=CONVENTIONS 规则库（炼境强项，业务侧反而隐式）｜E 实体层=项目/模块/任务卡/服务器（实体丰富、跨项目关系贫乏）｜A 资产层=接入包（唯一模式雏形）｜地图=单项目蓝图画布（无全局）｜可拆除性=资产纯文件 git（notes 是唯一违规点）。 + +### 两处判断修正（辩证结论，防后续会话重新推演） + +1. **「独立世界仓库」被否**：现在只有一个住户（notes 档案），为一个住户建仓库违反晋升阶梯（第二个场景才晋升）。炼境自身仓库本来就是事实上的元仓库，跨项目资产先住这里。 +2. **可拆除性缺口比直觉窄**：飞轮数据可从 git 历史重生（ingest_git_history=重生配方），不违规；**唯一硬违规是 project_notes**（复盘笔记+使者回传，原创不可再生，只活在 SQLite）——即下方 A 卡。 + +### 三个闸门（等真实场景敲门，禁止提前建设） + +| 候选 | 闸门条件 | 备注 | +|------|---------|------| +| 跨项目 edges | 第一个真实跨项目查询需求（最可能从梦核来） | 方案已定：自省派生 ∪ 显式声明（继承 hub-relation-catalog） | +| 全局地图视图 | edges 落地之后 | 开闸时先辩证「矩阵 vs 画布」——manage-multi-view 已承载一半需求，勿撞车；节点须双承载（入口+健康度） | +| 模式库 | 第三个模式候选出现（满三建制） | 接入包=第一个模式，库=接入包机制泛化；现有候选：DSH 接入模板、子主题规范 | + +### 三投影准入律（新资产类型的验收清单） + +任何新世界模型资产类型，三投影不齐不算入模：**文件形态**（git 可拆除）+ **MCP 工具**（agent 可消费）+ **UI 投影**（人可终验）。 + ## 任务卡 -（concept 阶段，L 级——待 /architect 设计确认后由 /splitter 拆卡） +### 📋 notes 档案落地（可拆除性修复：双写 + 存量回填） +- status: todo +- complexity: M +- files: src-tauri/src/mcp_tools.rs, src-tauri/src/db.rs +- acceptance: agent_verify: [Tauri command] append_project_note(pid, content) → DB 有记录**且** `.blueprint/notes-archive.jsonl` 尾行 JSON 可解析出同一 content；存量回填命令执行后 JSONL 行数 = project_notes 表行数；cargo test 覆盖双写 + 并发追加不交错 +- 备注：project_notes 是全系统唯一不在 git 的原创资产（飞轮全部原料）。格式选 JSONL 而非 md——机器可重放重建 DB，才是真「重生配方」。归宿：炼境仓库 `.blueprint/notes-archive.jsonl`，沿 usage.json「炼境自动写文件 + chore commit」先例。这即本模块缺口①「结构化落账」的地基 + +（其余 concept 阶段，L 级——待 /architect 设计确认后由 /splitter 拆卡） diff --git a/.blueprint/modules/mcp-server.md b/.blueprint/modules/mcp-server.md index 6822953..3883c46 100644 --- a/.blueprint/modules/mcp-server.md +++ b/.blueprint/modules/mcp-server.md @@ -55,6 +55,13 @@ > 完成记录（2026-07-03）：能力双投影概念的首次实践。cargo test 全绿；实测验证由 agent 通过 MCP 端点亲自按下这三颗按钮完成。 +### ✅ 飞轮派生数据工具输出 staleness 标注 +- status: done +- complexity: S +- files: src-tauri/src/db.rs, src-tauri/src/commands/gitea.rs, src-tauri/src/mcp_webhook.rs, src-tauri/src/mcp_tools.rs +- acceptance: agent_verify: [cargo test] touch_sync_state 后 read_sync_state 返回时间与分钟数、未知 domain 返回 None；get_pr_events / get_commit_metrics 输出首行含「⏱ 飞轮数据最近同步」；cargo test 通过 +- 备注：世界模型自洽——模型可以过期，不能不知道自己过期。实锤：get_pr_events 延迟致 /ship 误判无 open PR（enterprise-system 2026-07-28 回传）。get_ci_status 是实时 Gitea API 调用，不在范围内。sync_state 单行 domain='flywheel'，轮询成功与 webhook 落库两处 touch + ### 💭 能力双投影：后续扩展（R12 规则化 + 更多按钮） - status: concept - 侦察→驻军（2026-07-03）: agent 走流程验证=侦察（智能、贵、一次性验收），vitest/cargo test=驻军（固化、免费、高频回归）；agent 验证通过的关键路径顺手固化为测试（接宪章"坑驱动增量"），一次性验收不固化（少而稳>多而脆）。不引入 BDD/spec 框架——acceptance 字段已是人机共读的 spec