chore: 导入清理前的完整工程状态（含 Capacitor 原生壳，作为回滚备份点）

docs/dev/cli.md

@@ -0,0 +1,120 @@
+# Cook CLI
+
+Cook CLI 是一个命令行工具,用于管理菜谱数据。
+
+## 安装
+
+项目依赖已在 workspace 中配置,无需单独安装。
+
+## 数据源
+
+菜谱数据保存在本地 `packages/data/recipe.csv`，直接用编辑器或 Excel 维护，提交 PR 即可。
+
+## 命令
+
+### convert
+
+将本地 CSV 数据转换为 JSON 格式。
+
+```bash
+pnpm convert
+```
+
+**功能:**
+
+- 读取 `packages/data/recipe.csv`
+- 转换为 JSON 格式
+- 生成 `packages/data/recipe.json`
+
+**使用场景:**
+
+- 手动编辑 CSV 后需要重新生成 JSON
+- 确保 CSV 和 JSON 数据同步
+
+## 工作流程
+
+### 更新菜谱数据
+
+```bash
+# 1. 编辑 packages/data/recipe.csv
+
+# 2. 转换为 JSON
+pnpm convert
+
+# 3. 启动开发服务器查看效果
+pnpm dev
+```
+
+## 数据格式
+
+### CSV 格式
+
+```csv
+name,stuff,bv,difficulty,tags,methods,tools,id
+宫保鸡丁,鸡肉、花生米,BV1234567890,简单,川菜、家常菜,炒、煎,一口大锅,0
+```
+
+### JSON 格式
+
+```json
+[
+  {
+    "name": "宫保鸡丁",
+    "stuff": ["鸡肉", "花生米"],
+    "bv": "BV1234567890",
+    "difficulty": "简单",
+    "tags": ["川菜", "家常菜"],
+    "methods": ["炒", "煎"],
+    "tools": ["一口大锅"],
+    "id": 0
+  }
+]
+```
+
+## 故障排查
+
+### CSV 解析错误
+
+**错误信息:**
+
+```
+Error: Failed to parse CSV
+```
+
+**解决方案:**
+
+1. 检查 CSV 文件格式是否正确
+2. 确认字段分隔符为逗号
+3. 检查是否有未闭合的引号
+4. 验证编码是否为 UTF-8
+
+## 相关文档
+
+- [开发指南](/dev/app)
+- [使用说明](/guide/getting-started)
+
+## 测试
+
+### 运行测试
+
+```bash
+# 运行所有测试
+pnpm test
+
+# 运行 CLI 相关测试
+pnpm test packages/cook
+
+# 运行特定测试文件
+pnpm test packages/cook/src/utils/csv.test.ts
+```
+
+### 测试覆盖
+
+CLI 工具包含以下测试：
+
+- **CSV 解析测试** (`csv.test.ts`)
+  - ✅ BV 号清洗和 URL 处理
+  - ✅ CSV 格式解析
+  - ✅ 空值和边界情况处理
+  - ✅ 数组字段过滤空值
+  - ✅ CSV 往返一致性（parse → stringify → parse）