lanrtop/dev-manager-tauri
1
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity
eb346ae1fd
dev-manager-tauri/.blueprint/modules/project-mentor.md
lanrtop eb346ae1fd feat: add runtime diagnostics, health center, and project mentor 
运行时可观测性：
- 新增 runtime_logs SQLite 表，提供全局 log_event 写入函数（保留最近 500 条）
- mcp_server/mcp_inject/groups 关键路径接入结构化日志
- MCP 新增 get_diagnostics 工具，返回注入摘要与近期错误
- add_group_member 注入失败时前端显示黄色 toast 警告

健康中心：
- 新增 run_health_check 命令（6 项并行检查：MCP/Git 路径/项目路径/GitHub Token/编辑器/DB 延迟）
- 新增质量指标聚合（休眠项目/孤立项目/注入异常组/无路径项目）
- 侧边栏新增健康中心页面，支持手动刷新和诊断报告复制
- 设置页 MCP 状态改为真实 HTTP ping 检测

项目导师：
- 新增 get_mentor_context 后端命令，聚合健康状态/蓝图摘要/近期错误
- MCP 新增 get_project_mentor_context 工具（含产品组归属校验）
- 项目卡片底部新增 🎓 导师按钮，面板支持复制结构化 Markdown 报告
- 修复 WSL 项目路径识别：wsl_path 存 UNC 格式时自动提取 distro 和 Linux 路径，改用 wsl 命令检查路径存在性（规避 Path::exists() 对 \wsl.localhost\... 不可靠的问题）

AI 工作流：
- 新增 AI-WORKFLOW.md、.claude/skills/ 技能体系配置
- 更新 CLAUDE.md 补充蓝图驱动开发规范
2026-04-04 19:58:49 +09:00

3.5 KiB
Raw Blame History

项目导师

炼境作为所管理项目的贴身导师——持续感知每个项目的功能运转状态、模块质量与成长方向，借助 Claude 将数据转化为有观点的引导。炼境自身亦被纳入其中，形成自指闭环。

核心定位

功能运转感知（代码做）
  → 各模块是否在正常运转？有无停滞、失效、报错？

功能质量理解（Claude 做）
  → 各模块实现质量如何？在整体中分量几何？

成长方向引导（代码 + Claude 协作）
  → 下一步该聚焦什么？风险在哪？优化路径是什么？

三层能力作用于炼境管理的每一个项目，也作用于炼境自身—— 工具与被工具服务的对象合而为一，闭环成立。

自指闭环说明

炼境 感知其他项目 → 积累模式与洞察
                           ↓
              同样机制作用于炼境自身
                           ↓
              Claude 读炼境蓝图 + 运行指标
              → 给出炼境自身的优化建议
                           ↓
              炼境变得更强 → 更好地理解项目
                           ↓
              包括更好地理解自己 ↺

炼境通过管理别的项目认识自己，通过认识自己成为更好的导师。

数据基础（上游依赖）

数据源 提供什么 来自哪个模块
blueprint 规划态 模块设计意图、任务完成度 blueprint-flywheel
runtime_logs 执行层历史、注入成功率 runtime-diagnostics
usage.json 飞轮 跨项目趋势、飞轮持续率 blueprint-feedback
健康中心指标 Git 活跃度、CI 状态、路径有效性 health-center
MCP 接口 Claude 可查询任意维度 mcp-server

任务卡

✅ T1 · 后端聚合 command（MentorContext）

  • status: done
  • complexity: M
  • files: src-tauri/src/commands/mentor.rs, src-tauri/src/lib.rs
  • acceptance: get_mentor_context(project_id) 返回包含 health、blueprint_summary、recent_errors、mentor_markdown 的 MentorContext 结构体，可通过 Tauri invoke 调用成功

✅ T2 · MCP 项目导师查询接口

  • status: done
  • complexity: S
  • files: src-tauri/src/mcp_server.rs
  • depends: T1
  • acceptance: MCP 新增 get_project_mentor_context 工具，Claude 调用后返回 mentor_markdown 字符串，内容包含健康摘要与近期错误

✅ T3 · 前端导师面板

  • status: done
  • complexity: M
  • files: src/components/mentor/MentorPanel.tsx, src/lib/commands.ts, src/components/dashboard/ProjectCard.tsx
  • depends: T1
  • acceptance: 项目卡片底部出现"🎓"导师按钮，点击展示健康摘要和近期错误，"生成导师报告"按钮点击后将 mentor_markdown 复制到剪贴板

📋 T4 · 炼境自指接入

  • status: todo
  • complexity: S
  • files: src-tauri/src/commands/mentor.rs
  • depends: T1
  • acceptance: 炼境自身（dev-manager-tauri）作为项目注册后，get_mentor_context 能正常返回其蓝图摘要和健康数据，不产生递归调用

决策记录

  • 项目导师是洞察与引导层，health-center 是数据基础层，两者是上下游关系，不合并为一个模块
  • Claude 是智能层的唯一执行者，代码只负责数据采集与结构化，不在代码层做质量推断
  • 炼境自指是设计意图，不是边缘 case——从一开始就将其纳入系统，而非事后兼容
  • 任务卡保持 concept 状态直到 health-center 完成，避免在数据基础未就绪时过早实现上层