核心用法
tmx-cli 是一款专为 Thermomix/Cookidoo 用户设计的 Python CLI 工具,通过命令行实现完整的烹饪工作流管理。用户完成 OAuth 登录后,可执行食谱搜索(支持时间、难度、设备型号等多维过滤)、周计划编排(增删改移)、购物清单自动生成与导出,以及收藏夹管理。所有操作均支持 --json 输出便于程序化处理,且配置偏好会自动应用于搜索结果。
显著优点
零依赖架构:纯 Python 标准库实现,无需安装任何第三方包,部署极简且杜绝供应链攻击风险。功能闭环完整:覆盖从食谱发现、计划制定到采购清单的全链条,支持德语原版 Cookidoo 生态。交互设计友好:危险操作(如清空购物清单)带 ⚠️ 警示,日期/参数有基础校验,错误信息不泄露敏感数据。AI 集成友好:JSON 输出格式与结构化数据设计,天然适配 Claude 等 AI 助手的自动化工作流。
潜在缺点与局限性
地域限制:深度绑定 Cookidoo 德语区服务(cookidoo.de),非德语用户或国际版 Thermomix 用户可能遇到兼容问题。凭证管理粗放:登录凭证以明文 JSON 存储于本地,缺乏加密保护,不适合共享设备或高安全需求场景。功能边界:作为非官方工具,依赖 Cookidoo 私有 API,存在因官方接口变更导致功能失效的风险;不支持食谱图片下载或离线烹饪模式。生态规模:个人开发者维护(T3 来源),长期更新与社区支持能力有限。
适合的目标群体
- 德语区 Thermomix 重度用户,追求命令行效率的极客型家庭主厨
- 需要将烹饪计划与 AI 助手(如 Claude)集成的自动化爱好者
- 注重隐私、拒绝臃肿 App 的极简主义者
- 小型餐饮工作室或营养师,需批量管理食谱与采购清单
使用风险
API 稳定性风险:非官方工具,Cookidoo 接口变更可能导致功能中断。凭证泄露风险:明文本地存储的登录信息,若设备被入侵或共享使用可能导致账号被盗。数据同步延迟:计划修改依赖手动 sync 命令,多端使用时可能出现状态不一致。网络依赖:所有核心功能需实时连接 Cookidoo 服务器,离线场景不可用。