核心用法
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 服务器，离线场景不可用。