consultant-cli：让AI助手随时召唤更强推理模型的轻量级工具

consultant-cli是面向自动化代理（如Claude Code）设计的命令行工具，核心目标是解决开发者在现有工作流中快速获取更强推理模型建议的需求，无需切换会话或修改环境变量。它支持按调用配置参数、能力标签路由、文件/图像附件，且完全管道友好，为AI协作提供了灵活高效的增强方案。

在AI辅助编程和自动化工作流普及的今天，开发者常面临困境：当前AI助手（如Claude Code）在复杂推理场景下力不从心，传统切换会话或修改全局变量的方式繁琐且打断工作流。consultant-cli应运而生，旨在让自动化代理在关键时刻"请教专家"，无需改变自身运行环境。

consultant-cli围绕四个关键特性设计：

1. 每次调用的精细化控制：允许独立指定模型和推理强度，同一脚本可灵活切换轻量/深度推理模式。
2. 能力标签而非具体模型：通过-t reasoning/chinese/vision等标签描述需求，抽象层使底层模型可灵活切换，上层代码无需修改。
3. 灵活的文件与图像输入：支持--file/--image标志或@path语法内联引用，满足自动化与交互式使用需求。
4. 管道友好的输出：答案默认输出到stdout，推理过程独立处理，可无缝融入Unix管道生态。

架构：采用模块化设计，核心模块包括cli.py（参数解析）、tags.py（标签映射）、inputs.py（附件处理）、outputs.py（输出管理）、sessions.py（会话持久化）及providers（DeepSeek/OpenRouter客户端）。 标签映射：将抽象标签映射为（提供商，模型，推理强度）三元组，如reasoning对应openrouter/openai/gpt-5.5/xhigh，修改映射只需更新tags.py。 会话持久化：通过--session NAME参数，会话历史以JSONL格式存储于sessions/<NAME>.jsonl，采用原子写入确保完整性，锁定首轮系统提示并要求标签一致性。

consultant-cli适用于多种场景：

1. 代码审查与建议：./consultant -f src/auth.py -f src/db.php "is this safe under concurrent writes?"，自动化脚本中获取安全审查意见。
2. 多语言内容生成：./consultant -t chinese -e max "深度审稿：这篇论文的创新点是否充分？"，调用DeepSeek V4 Pro的中文能力。
3. 图像理解与架构分析：./consultant -t vision -i diagram.png "explain this architecture"，路由到支持图像的模型。
4. 复杂任务迭代精炼：通过--session参数分阶段推进创作任务，保持上下文连贯性。

consultant-cli的价值体现在：

• 分层推理架构：在自动化代理与强推理模型间建立轻量桥梁，使能力调用决策外部化、可配置化，类似微服务编排理念。
• 避免供应商锁定：标签抽象允许底层模型提供商切换，上层业务逻辑不受影响，利于长期项目维护。
• 增强现有工具链：不取代现有工具，作为增强层与Claude Code、Cursor等配合使用，提升工作流效率。

consultant-cli通过简洁的CLI接口，在保持简洁性的同时提供强大功能，其按调用控制、能力标签、管道友好的设计理念值得借鉴。对于构建自动化工作流的开发者，它提供了优雅升级推理能力的参考实现。随着多模型生态成熟，这种灵活调用模式将愈发重要。