44 lines
1.8 KiB
Markdown
44 lines
1.8 KiB
Markdown
# 炼境 — 速查卡
|
||
|
||
**定位**：Git 多空间开发管理器 + 项目 Agent 化改造引擎。Tauri v2 桌面 App，管理多个开发项目，为每个项目注入 Agent 友好基础设施，形成智能成长飞轮。
|
||
|
||
## 技术栈
|
||
|
||
| 层 | 技术 |
|
||
|----|------|
|
||
| 前端 | React 19 + TypeScript + TailwindCSS + React Query + Zustand + React Flow |
|
||
| 后端 | Rust + Tauri v2 |
|
||
| 数据 | SQLite（rusqlite + r2d2） |
|
||
| MCP | 内嵌 HTTP Server（供 Claude Code 调用） |
|
||
| 包管理 | pnpm |
|
||
|
||
## 关键约定（改代码前必看）
|
||
|
||
1. **Tauri command ↔ 前端封装**：新增 command 必须同步更新 `src/lib/commands.ts`
|
||
2. **DB 变更必须有 migration**：在 `src-tauri/src/db.rs` 的 `migrate()` 里补语句，否则旧版本升级报错
|
||
3. **Rust 业务函数依赖注入**：禁止内部 `pool().get()`，连接由调用方传入
|
||
4. **接入包模板 = 分发给被管理项目的规则**：改 `resources/onboarding/` 务必同步 `docs/templates/`
|
||
|
||
## 目录速查
|
||
|
||
```
|
||
src/lib/commands.ts 前后端契约（唯一前端入口）
|
||
src-tauri/src/commands/ Rust 后端实现（一功能一文件）
|
||
src-tauri/src/db.rs 数据库 schema + migration
|
||
src-tauri/src/mcp_server.rs MCP Server（agent 调用炼境的入口）
|
||
src-tauri/src/mcp_tools.rs MCP tool schema 与 dispatch
|
||
src-tauri/src/commands/delivery_status.rs 项目交付信号聚合（Git / Gitea / 部署证据）
|
||
src-tauri/resources/onboarding/ 接入包分发模板
|
||
.blueprint/ 项目蓝图
|
||
docs/ai-context/ AI 上下文文档（本文件、契约映射）
|
||
docs/templates/ 接入包模板草案（设计层）
|
||
```
|
||
|
||
## 验收命令
|
||
|
||
```bash
|
||
pnpm typecheck # TypeScript 类型检查
|
||
pnpm tauri dev # 启动开发环境
|
||
cargo test # Rust 单元测试（src-tauri/ 目录下运行）
|
||
```
|