diff --git a/.blueprint/modules/agent-infrastructure.md b/.blueprint/modules/agent-infrastructure.md index 60b3e22..4efeaad 100644 --- a/.blueprint/modules/agent-infrastructure.md +++ b/.blueprint/modules/agent-infrastructure.md @@ -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 排查方法论的教训：查询字段不全就下结论 = 证据链断裂） + diff --git a/.blueprint/usage.json b/.blueprint/usage.json index c9cb97c..26a7ab1 100644 --- a/.blueprint/usage.json +++ b/.blueprint/usage.json @@ -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 + } } ] } \ No newline at end of file