# DevFlow 开发规则

## 技术栈

- 桌面端: Tauri v2 + Vue 3 + TypeScript + Pinia
- 后端: Rust Workspace (8 crate) / SQLite
- 包管理: bun (前端) / cargo (Rust)
- 路径: `E:/wk-lab/devflow`

## 架构原则

1. **治本不治标**：修复问题时找到根因，不做表面补丁
2. **DRY 原则**：不重复代码，抽象出可复用逻辑
3. **长远考虑**：不追求局部最优，考虑整体架构演进
4. **修改收敛**：同类改动合并到一个批次提交，不零散提交

## 代码规范

1. **Rust 后端**：提交前运行 `cd src-tauri && cargo check`
2. **前端 TypeScript/Vue**：提交前运行 `npx vue-tsc --noEmit`
3. **完整构建**：提交前运行 `npx vite build`（验证构建不报错）
4. **TypeScript 文件名**：camelCase（`fileExplorer.ts`）
5. **Vue 组件文件名**：PascalCase（`FileExplorer.vue`）

## i18n

- 中英文双语言同步：`src/i18n/en/` 和 `src/i18n/zh-CN/`
- 新增组件时同时添加对应语言的翻译文件
- 国际化文件自动聚合（`src/i18n/*/index.ts` 自动导入所有模块文件）