运行时可观测性:
- 新增 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 补充蓝图驱动开发规范
63 lines
2.4 KiB
Markdown
63 lines
2.4 KiB
Markdown
# 炼境 (Dev Manager Tauri)
|
||
|
||
Git 多空间开发管理器,Tauri v2 + React + TypeScript + Rust。
|
||
|
||
<!-- 手动维护区:只放技术栈、目录结构、技能规则。蓝图工作流由下方 MANAGED 块统一管理,勿在此重复。 -->
|
||
|
||
## 技术栈
|
||
- 前端:React 19 + TypeScript + TailwindCSS + React Query + Zustand + React Flow
|
||
- 后端:Rust + Tauri v2 + SQLite (rusqlite + r2d2)
|
||
- 包管理:pnpm(禁止 npm/yarn)
|
||
- CI/CD:GitHub Actions + 阿里云 OSS(详见 docs/tauri-cicd-guide.md)
|
||
- 客户端更新:tauri-plugin-updater(详见 docs/tauri-updater-guide.md)
|
||
|
||
## 目录结构
|
||
```
|
||
src/ 前端源码
|
||
src/components/ React 组件(按功能分目录)
|
||
src/lib/commands.ts Tauri command 调用封装
|
||
src-tauri/src/ Rust 后端
|
||
src-tauri/src/commands/ Tauri command 实现
|
||
.blueprint/ 项目蓝图(manifest + 模块详情 + 任务卡)
|
||
docs/ 部署和更新指南
|
||
```
|
||
|
||
## 技能使用规则
|
||
|
||
根据任务卡 complexity 决定执行后的检查:
|
||
|
||
| complexity | 执行后必跑 |
|
||
|-----------|-----------|
|
||
| S(简单增删改) | /code-review → /smart-commit |
|
||
| M(中等逻辑) | /Dev-edge-case → /code-review → /smart-commit |
|
||
| L(复杂,应先拆) | /architect → /splitter → 拆成 S/M |
|
||
|
||
- 新功能设计阶段:/architect
|
||
- 代码重构/简化:/simplify → /code-review
|
||
- 发现深层问题:/Dev-deep-think
|
||
|
||
<!-- BLUEPRINT_MANAGED_START version="1.3.0" -->
|
||
## 项目蓝图
|
||
|
||
本项目使用 `.blueprint/` 目录维护项目全景架构图,驱动需求讨论和任务管理。
|
||
|
||
**每次对话都应遵循以下流程:**
|
||
|
||
### 1. 了解当前状态
|
||
对话开始时,先读取 `.blueprint/manifest.yaml` 了解项目模块和状态。
|
||
|
||
### 2. 讨论需求时更新蓝图
|
||
- 确认了新需求 → 在 manifest.yaml 新增模块,创建 `.blueprint/modules/<id>.md`
|
||
- 拆分了大需求 → 在模块文件中添加任务卡
|
||
- 调整了方向 → 更新模块关系(edges)
|
||
|
||
### 3. 完成实现后标记蓝图
|
||
- 完成了功能 → 更新对应任务卡状态为 `done`(前缀改为 ✅)
|
||
- 更新 manifest.yaml 顶部的 `updated` 日期
|
||
|
||
### 4. 任务卡规范
|
||
详见 `.blueprint/CONVENTIONS.md`,核心规则:
|
||
- 任务卡同时具备 `files` + `acceptance` + complexity `S/M` → 标记为 📋 可派发
|
||
- 可派发的任务卡可以直接交给 Claude Agent 独立完成
|
||
<!-- BLUEPRINT_MANAGED_END -->
|