7028efeb5e
- Merge packages/types into packages/cook/src/types - Add CLI search command with ingredient alias support - Add build config (unbuild) and GitHub Actions publish workflow - Add Cook Skill documentation (SKILL.md, README.md) - Update all imports from @cook/types to @yunyoujun/cook - Bump @nuxt/test-utils 4.0.0 → 4.0.2, update lastDbUpdated
@yunyoujun/cook
Cook CLI 工具 - 用于管理菜谱数据和检索菜谱的命令行工具。
功能
- 🔍 按食材/厨具/难度/标签/做法检索菜谱（支持食材别名）
- 🚀 从飞书 Wiki 拉取菜谱数据
- 📝 CSV ↔ JSON 双向转换
- ✅ 完整的单元测试覆盖
- 🔄 数据格式一致性保证
命令
search
检索菜谱（支持 AI Skill 调用）：
# 按食材搜索
pnpm search --stuff "鸡蛋,番茄"
# 组合筛选
pnpm search --stuff "鸡蛋,番茄" --tool "电饭煲" --difficulty "简单"
# 支持别名（西红柿 → 番茄）
pnpm search --stuff "鸡蛋,西红柿"
参数：
--stuff <items>: 食材，逗号/顿号分隔--tool <tool>: 厨具（电饭煲/烤箱/空气炸锅/微波炉/一口大锅）--difficulty <level>: 难度（简单/普通/困难）--tag <tag>: 标签（懒人/下饭/减脂 等）--method <method>: 做法（炒/煎/蒸/煮/烤/炸 等）--limit <n>: 最大返回数（默认 10）
fetch
从飞书 Wiki 拉取最新菜谱数据：
pnpm fetch
功能：
- 获取飞书电子表格数据（API 返回二维数组）
- 自动清洗和格式化
- 使用 papaparse 生成标准 CSV（自动处理特殊字符）
- 同时生成 CSV 和 JSON 文件
为什么不直接下载 CSV？
- 飞书 API 没有提供直接导出 CSV 的接口
- API 返回的是原始表格数据（二维数组），需要转换为 CSV
- 使用 papaparse 确保生成的 CSV 符合标准，能正确处理字段中的逗号、引号、换行符等特殊字符
convert
将本地 CSV 转换为 JSON：
pnpm convert
功能：
- 读取
app/data/recipe.csv - 解析并验证数据
- 生成
app/data/recipe.json - 更新
lastDbUpdated时间戳
数据格式
CSV 结构
name,stuff,bv,difficulty,tags,methods,tools,
宫保鸡丁,鸡胸肉、花生米,BV1234567890,简单,川菜、家常菜,炒、煎,炒锅,
字段说明：
name: 菜名（必填）stuff: 食材列表（用、分隔）bv: B站视频 BV 号difficulty: 难度（简单/普通/困难）tags: 标签列表（用、分隔）methods: 烹饪方式（炒/煎/烘/炸，用、分隔）tools: 所需工具（用、分隔）
JSON 结构
{
"name": "宫保鸡丁",
"stuff": ["鸡胸肉", "花生米"],
"bv": "BV1234567890",
"difficulty": "简单",
"tags": ["川菜", "家常菜"],
"methods": ["炒", "煎"],
"tools": ["炒锅"]
}
测试
运行测试：
# 运行所有测试
pnpm test
# 运行 CLI 测试
pnpm test packages/cook
# 测试覆盖率
pnpm test:coverage
测试内容：
- ✅ CSV 解析和格式化
- ✅ BV 号清洗（URL 前缀去除）
- ✅ 空值和边界情况处理
- ✅ 数组字段空值过滤
- ✅ CSV/JSON 往返一致性
- ✅ fetch/convert 输出格式一致性
开发
项目结构
packages/cook/
├── src/
│ ├── commands/
│ │ ├── fetch.ts # 飞书数据拉取
│ │ ├── convert.ts # CSV 转 JSON
│ │ └── search.ts # 菜谱检索
│ ├── utils/
│ │ ├── alias.ts # 食材别名映射
│ │ ├── config.ts # 配置和常量
│ │ ├── csv.ts # CSV 处理工具
│ │ ├── csv.test.ts # CSV 测试
│ │ ├── feishu.ts # 飞书 API 封装
│ │ └── search.ts # 检索核心逻辑
│ └── index.ts # CLI 入口
├── types.ts # 类型定义
├── package.json
└── tsconfig.json
技术栈
- CLI 框架: cac
- 交互提示: @clack/prompts
- 日志输出: consola
- 飞书 SDK: @larksuiteoapi/node-sdk
- 运行时: tsx
配置
需要配置飞书应用凭证（.env 文件）：
FEISHU_APP_ID=cli_xxxxxxxxxxxxxxxx
FEISHU_APP_SECRET=xxxxxxxxxxxxxxxxxxxxxxxx
获取方式：飞书开放平台
许可
MIT