lanrtop/dev-manager-tauri
1
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity

chore(blueprint): 双工作区诊断错误复盘——用户纠错，git 同源取证，sha 主键边界记录

Browse Source
This commit is contained in:
lanrtop 2026-07-03 09:10:40 +09:00
parent 23de433ee4
commit 3692b00480
2 changed files with 251 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
.blueprint/modules/agent-infrastructure.md
View File

@ -137,3 +137,11 @@
auto_applied_rules: R11
rule_effectiveness: R11=有效（首次实战触发：诊断建议执行后未解决问题 → 修指引 + 记录失败案例）
【陷阱记录】双工作区数据合并的诊断错误（2026-07-03，用户纠错）
是否返工: 是（诊断结论侥幸正确，推理过程错误，被用户当场抓住）
返工原因: 排查 enterprise-system 双 project_id 时，SQL 只 SELECT 了 win_path 未查 wsl_path，把 WSL 工作区（\wsl.localhost\...）误判为"无路径的废弃注册"。实际为同项目的 WSL 旧副本（56 commit 停在 2026-05-19，全部 ⊂ Windows 副本 302 commit，git 同源）。合并操作在"同源仓库"事实下恰好合理（同一套历史归主工作区），但若两副本真是独立项目，该操作会造成数据污染
有效策略: 用户质疑后用 git sha 集合交集取证（WSL 56 ∩ Windows 302 = 56 → 同源实锤），证据先于结论
遗留边界（记入设计约束）: commit_metrics 以 sha 为全局主键，隐含假设"一个 commit 归一个项目"——同源多工作区（win+wsl 双副本）打破该假设，无论数据怎么分配都无法两侧完整。当前裁决：同源归主工作区；若未来出现真·多工作区并行开发场景，需评估复合主键 (sha, project_id) + profile 级去重
auto_applied_rules: 无
rule_effectiveness: —（本条是 Claude 排查方法论的教训：查询字段不全就下结论 = 证据链断裂）

243
.blueprint/usage.json
View File

@ -8558,6 +8558,249 @@
"todo": 7,
"total": 201
}
},
{
"at": "2026-07-03T00:02:57Z",
"blocked_reasons": [],
"conventions_version": "1.9.0",
"delta": {
"newly_blocked": [],
"newly_done": [
"blueprint-governance/跨工具规则分发：AGENTS.md 单一来源",
"flywheel-intelligence/R1. Rules-Applied commit trailer 被动自吸（规则有效性数据源）",
"gitea-integration/G6. 远端轮询采集（webhook 不可达时的降级路径）",
"gitea-integration/Gitea Actions workflow 生成",
"gitea-integration/R0. 炼境自身发版链路迁移（本机 act_runner + Gitea Actions）",
"ui-restructure/N3. 洞察页：飞轮跨项目内容迁出 BlueprintModal + 健康中心并入",
"ui-restructure/N4. Gitea 实例管理迁设置页（GiteaPanel 拆全局/项目级两半）",
"ui-restructure/N5. 仓库注册表并入项目页管理 tab + 总览收敛为行动项"
],
"unblocked": []
},
"iteration": 1,
"modules": {
"blocked": 0,
"concept": 0,
"done": 49,
"in_progress": 2,
"planned": 0,
"stalled": [
"flywheel-intelligence"
],
"total": 53
},
"task_ids": {
"blocked": [],
"done": [
"agent-infrastructure/A. 框架层扫描 + 契约路径推断",
"agent-infrastructure/B. 三件套文件生成",
"agent-infrastructure/C. 文档腐化评分",
"agent-infrastructure/D. 栈确认 UI + 生成按钮",
"agent-infrastructure/E. 看板腐化指示器",
"agent-infrastructure/F3. Agent 健康诊断 + 可复制修正指令",
"api-keys/API 密钥 CRUD 与安全展示",
"auto-update/Capabilities 权限配置",
"auto-update/下载 & 安装",
"auto-update/更新检测",
"auto-update/自动检查更新",
"auto-update/错误提示",
"blueprint-buff/BlueprintView 跨项目切换",
"blueprint-buff/Buff 生命周期 Rust 命令",
"blueprint-buff/blueprint_buffs 数据表",
"blueprint-buff/git watcher + 任务匹配写回 + 飞轮快照",
"blueprint-buff/前端 Buff 管理 UI",
"blueprint-buff/前端实时刷新",
"blueprint-feedback/归档 command",
"blueprint-feedback/归档候选展示",
"blueprint-feedback/梦核分析入口（蓝图弹窗）",
"blueprint-feedback/梦核提示词增加停滞模块数据",
"blueprint-flywheel/get_flywheel_stats command",
"blueprint-flywheel/get_flywheel_stats 支持迭代感知",
"blueprint-flywheel/usage.json 埋点写入",
"blueprint-flywheel/梦核提示词生成 command",
"blueprint-flywheel/飞轮健康面板",
"blueprint-governance/CLAUDE.md 模板定义",
"blueprint-governance/CONVENTIONS.md 版本化",
"blueprint-governance/GovernancePanel 规则编辑器 UI",
"blueprint-governance/get_blueprint_status command",
"blueprint-governance/sync/梦核/summary 切换为 effective 内容",
"blueprint-governance/sync_blueprint_rules command",
"blueprint-governance/批量同步所有项目规则",
"blueprint-governance/用户版 CONVENTIONS 存储层初始化",
"blueprint-governance/用户版 CONVENTIONS 读写 command",
"blueprint-governance/跨工具规则分发：AGENTS.md 单一来源",
"blueprint-onboarding/generate_blueprint_prompt command",
"blueprint-onboarding/蓝图操作弹窗",
"blueprint-onboarding/项目列表蓝图状态徽章",
"blueprint-reader/合并返回完整蓝图数据",
"blueprint-reader/读取 manifest.yaml",
"blueprint-reader/读取 modules/*.md",
"blueprint-view/.blueprint/ 数据结构设计",
"blueprint-view/React Flow 节点图渲染",
"blueprint-view/blocked 状态支持",
"blueprint-view/下一步汇总面板",
"blueprint-view/任务卡复制派发",
"blueprint-view/批量执行提示词入口",
"blueprint-view/智能连线路由",
"blueprint-view/模块详情面板",
"blueprint-view/统计汇总条",
"blueprint-view/蓝图治理面板",
"blueprint-view/蓝图读取 Command",
"blueprint-view/边高亮与模块聚焦",
"blueprint-view/顶部状态行扩展",
"blueprint-view/项目卡片蓝图入口",
"cicd-workflow/Actions 运行历史",
"cicd-workflow/CI/CD 配置 CRUD",
"cicd-workflow/Tauri OSS 分发模板",
"cicd-workflow/Web SSH 部署模板",
"cicd-workflow/Workflow 文件生成",
"claude-autonomy-config/Beast 全局状态读取与展示",
"cloud-db-instances/云数据库实例信息管理",
"cloud-docker-apps/Docker 应用列表与状态管理",
"cloud-products/DB 迁移：cloud_products 表",
"cloud-products/Dashboard 接入：云产品标签页",
"cloud-products/Rust CRUD：cloud_products.rs",
"cloud-products/前端 Panel：CloudProductsPanel.tsx",
"cloud-products/接线：mod.rs + lib.rs + commands.ts",
"deploy-info/项目部署信息记录面板",
"devtools-scan/WSL 工具扫描",
"devtools-scan/Windows 工具扫描",
"devtools-scan/工具信息持久化",
"flywheel-intelligence/F1. Git 健康度后端——全量历史导入 + 跨项目聚合",
"flywheel-intelligence/F2. 飞轮面板——Git 健康度区块 + 全量导入按钮",
"flywheel-intelligence/MCP Server 支持 SSE 传输",
"flywheel-intelligence/R1. Rules-Applied commit trailer 被动自吸（规则有效性数据源）",
"flywheel-intelligence/R2. CONVENTIONS 规则边界字段 + R11 失败记录规则",
"flywheel-intelligence/复盘笔记覆盖率可见性",
"flywheel-intelligence/独立项目自动创建产品组",
"flywheel-intelligence/补测试：飞轮存量函数安全网",
"flywheel-intelligence/阶段一：复盘笔记接入梦核飞轮",
"flywheel-intelligence/阶段二：usage.json 扩展采集维度",
"git-ops/上游状态检测",
"git-ops/分支管理",
"git-ops/基础操作",
"gitea-integration/G1. DB schema + Gitea 实例 CRUD",
"gitea-integration/G2. 仓库创建 / 迁移 / 绑定",
"gitea-integration/G3. Webhook 接收端（MCP Server 扩展）",
"gitea-integration/G4. Webhook 注册命令",
"gitea-integration/G5. Gitea 治理面板 UI",
"gitea-integration/G6. 远端轮询采集（webhook 不可达时的降级路径）",
"gitea-integration/Gitea Actions workflow 生成",
"gitea-integration/R0. 炼境自身发版链路迁移（本机 act_runner + Gitea Actions）",
"github-auth/OAuth Device Flow",
"github-auth/Token 管理",
"github-decommission/D1. 免登录改造（去掉 GitHub OAuth 登录门槛）",
"github-decommission/D2. 移除 GitHub 发布 / 导入 / PR / CI 状态入口",
"github-decommission/D3. 删除 spacesSync（单机化，跨空间 GitHub 云同步下线）",
"github-decommission/D4. git_ops 凭据去 GitHub 化",
"github-publish/GitHub 仓库创建与推送",
"health-center/T1 · Backend 健康检查聚合命令",
"health-center/T2 · 质量指标聚合",
"health-center/T3 · 前端健康中心页面",
"health-center/T4 · 扩展 MCP get_diagnostics",
"host-apps/宿主机应用清单与快启",
"mcp-config-inject/加入产品组时注入配置",
"mcp-config-inject/端口变更时重新注入所有配置",
"mcp-config-inject/退出产品组时清除配置",
"mcp-server/MCP 端口可配置（Rust 侧）",
"mcp-server/启动时绑定 HTTP 端口",
"mcp-server/实现 MCP JSON-RPC 基础协议",
"mcp-server/实现产品组上下文工具",
"onboarding-pack/A 模板分发引擎",
"onboarding-pack/B apply_onboarding_pack 编排 + 前端入口",
"onboarding-pack/C1 commit_metrics 表 + Conventional 解析器",
"onboarding-pack/C2 挂接 buff watcher + 飞轮快照",
"onboarding-pack/D 数据可信度提示",
"product-group-mcp/产品组详情显示 MCP 注入状态",
"product-group-mcp/设置页添加 MCP 端口配置",
"project-dashboard/分组画布",
"project-dashboard/项目卡片列表",
"project-dashboard/项目发现面板",
"project-dashboard/项目快捷操作",
"project-env-scan/环境信息持久化",
"project-env-scan/项目环境检测",
"project-mentor/T1 · 后端聚合 command（MentorContext）",
"project-mentor/T10 · 启动健康扫描 + 前端 Alert Banner",
"project-mentor/T11 · 项目历史快照",
"project-mentor/T2 · MCP 项目导师查询接口",
"project-mentor/T3 · 前端导师面板",
"project-mentor/T4 · 炼境自指接入",
"project-mentor/T5 · project_notes 数据层 + 后端命令",
"project-mentor/T6 · MCP append_project_note 工具",
"project-mentor/T7 · MentorPanel 展示 AI 笔记",
"project-mentor/T8 · 后端全组巡检命令",
"project-mentor/T9 · 前端全组巡检按钮",
"project-mgmt/子文件夹扫描",
"project-mgmt/批量导入项目",
"project-mgmt/项目 CRUD",
"project-mgmt/项目档案（Profile）",
"project-templates/P1+P3 模板扩充（React 生态全覆盖）",
"project-templates/从模板创建项目",
"project-templates/内置模板种植",
"project-templates/模板 CRUD",
"project-tools/工具 CRUD",
"project-tools/工具启动",
"repo-registry/仓库导入",
"repo-registry/仓库挂载",
"repo-registry/仓库注册表管理",
"runtime-diagnostics/T1 · SQLite runtime_logs 表",
"runtime-diagnostics/T2 · 替换 eprintln! 为结构化日志",
"runtime-diagnostics/T3 · MCP Server 新增 get_diagnostics 工具",
"runtime-diagnostics/T4 · 注入失败结果返回前端",
"runtime-diagnostics/T5 · 设置页 MCP 真实健康检查",
"server-registry/服务器 CRUD 与项目关联",
"server-software/服务器软件扫描与展示",
"service-config/服务配置 CRUD 与环境分组",
"settings-page/WSL 发行版选择",
"settings-page/关于 & 更新",
"settings-page/终端配置",
"settings-page/编辑器检测",
"shell-launch/打开终端",
"shell-launch/打开编辑器",
"source-library/源码库分类管理与项目详情",
"sqlite-db/数据库迁移",
"sqlite-db/连接池初始化",
"ssh-config-sync/SSH Config 写入与同步",
"tags-groups/分组管理",
"tags-groups/标签管理",
"tray-service/关闭窗口最小化到托盘",
"tray-service/系统托盘图标与菜单",
"tray-service/集成 tauri-plugin-single-instance",
"ui-restructure/N1. 资源/工具一级页 + Sidebar 六组重组 + Dashboard 瘦身",
"ui-restructure/N2. ProjectCard 操作分层（4 明按钮 + ⋯ 更多下拉）",
"ui-restructure/N3. 洞察页：飞轮跨项目内容迁出 BlueprintModal + 健康中心并入",
"ui-restructure/N4. Gitea 实例管理迁设置页（GiteaPanel 拆全局/项目级两半）",
"ui-restructure/N5. 仓库注册表并入项目页管理 tab + 总览收敛为行动项",
"user-project-todos/前端：备忘清单 UI 组件",
"user-project-todos/数据层：user_project_todos 表 + Rust commands",
"v2rayn-import/当前节点读取",
"v2rayn-import/数据库路径检测",
"v2rayn-import/节点列表扫描",
"vscode-remote/VS Code Remote SSH 一键连接",
"workspace-mgmt/空间 CRUD",
"workspace-mgmt/空间级设置",
"workspace-mgmt/部署命令管理",
"wsl-proxy/代理一致性测试",
"wsl-proxy/代理同步",
"wsl-proxy/代理清除",
"wsl-proxy/代理状态检测"
]
},
"tasks": {
"avg_rounds_M": null,
"blocked": 0,
"complexity_dist": {
"L": 6,
"M": 83,
"S": 53
},
"dispatched": 0,
"done": 192,
"in_progress": 0,
"rework_count": 25,
"todo": 2,
"total": 206
}
}
]
}