dev-manager-tauri/CLAUDE.md

炼境 (Dev Manager Tauri)

Git 多空间开发管理器，Tauri v2 + React + TypeScript + Rust。

技术栈

• 前端：React 19 + TypeScript + TailwindCSS + React Query + Zustand + React Flow
• 后端：Rust + Tauri v2 + SQLite (rusqlite + r2d2)
• 包管理：pnpm（禁止 npm/yarn）
• Git 后端：自建 Gitea（GitHub 已退役，见 .blueprint/modules/github-decommission.md）
• CI/CD：Gitea 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 实现
src-tauri/resources/onboarding/ 接入包分发模板（AGENTS.md、git-workflow、lefthook）
.blueprint/                   项目蓝图（manifest + 模块详情 + 任务卡）
.claude/rules/                路径注入规则（tauri-contract / db-schema / onboarding-sync）
AGENTS.md                     跨工具 AI 上下文（四支柱 + 元规则，单一来源）
docs/ai-context/              AI 速查文档（project-brief.md、project-context.yaml）
docs/templates/               炼境接入包模板草案（agents-meta-rules 等）

命令执行规则

• 所有命令直接用 Bash tool 执行，禁止输出命令让用户手动运行
• pnpm tauri build / cargo build --release 等 Rust 构建用 run_in_background: true + timeout: 600000（首次编译可能需要 10 分钟）
• 超过 10 分钟的任务（如完整 release build）改为输出单行完整命令，让用户 ! <命令> 一键执行

技能使用规则

根据任务卡 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

项目蓝图

蓝图工作流规则统一维护在 @AGENTS.md 的 BLUEPRINT_MANAGED 区（跨工具单一来源，勿在此复制）。

对话开始时必须执行：

1. 读取 .blueprint/manifest.yaml 了解项目全景和当前状态
2. 读取 .blueprint/CONVENTIONS.md 了解完整工作流规则
3. 遵循 AGENTS.md 中的蓝图工作流（需求→蓝图同步、复杂度决策、两阶段提交）

炼境自身附加启动步骤（块外，勿移入托管块——块升级会覆盖）： 4. 调用 mcp__lian-jing__list_envoy_returns 检查子项目使者回传——若有待处理条目，在开始其他任务前先列出，询问是否立即处置