Whale
面向 DeepSeek 的终端优先 AI 编程代理，支持长上下文、工具与工作流。
按维度查看评分与理由
证据显示：README 提到需要用户确认（approval）和 hooks 执行 shell 命令，SECURITY.md 指出凭据文件位置和 DEEPSEEK_API_KEY 优先级，但未详细说明权限最小化、数据流透明或外部影响。扣分：缺少具体权限模型、数据流说明和外部影响评估。
证据显示：README 和 CI 配置一致，依赖列表完整，但失败消息未在文档中说明。扣分：失败处理文档不足。
证据显示：README 明确目标用户（开发者）和使用场景（终端、CI），并列出非目标（多模型、IDE 替代），但触发精度（如命令触发条件）未详细说明。扣分：触发条件文档不足。
证据显示：README 结构清晰，安装说明详细，有示例和已知限制，MIT 许可证明确，但版本变更日志未提供，维护责任未明确。扣分：缺少变更日志和维护责任说明。
证据显示：README 强调输出可用性（TUI、CLI、headless），边际价值（缓存、DeepSeek 原生），成本效益（缓存降低费用），但未提供具体数据或对比。扣分：缺乏实证数据。
证据显示：README 中的声明（如 98% 缓存命中率）未提供来源，CI 配置存在但未验证，事实与推断未明确区分。扣分：声明缺乏可追溯性，未区分事实与推断。
- 发布者身份未验证，需谨慎对待。
- README 中的性能声明（如 98% 缓存命中率）缺乏可验证来源。
- 安全边界文档（SECURITY.md）提到 hooks 可执行 shell 命令，但未提供具体权限控制细节。
- 版本变更日志缺失，维护责任不明确。
这个 Agent 能做什么，适合哪些场景？
Whale 是一个为 DeepSeek 构建的终端优先 AI 编程代理，而非通用多模型外壳。它提供交互式 `whale` TUI、一次性 `whale ask "..."` 命令，以及用于 CI/CD 或自动化任务的 `whale --headless` 模式。代理可读取文件、运行命令、编辑代码并搜索网页；其扩展机制包括 MCP 服务器、Skills、Subagents、Plugins 和 Hooks。Dynamic Workflows 允许用 JavaScript 编排多个代理，并可用于并行研究、评审和处理管道。项目仍在积极开发，文档建议将其用于个人项目、实验性仓库，以及可审查和回滚变更的工作流。
安装并配置 DeepSeek API key 后，运行 whale 可启动交互式 TUI，输入问题后由代理读取文件、运行命令、编辑代码和搜索网页。whale ask "..." 用于一次性提问、快速代码审查或单个命令场景，whale --headless 面向 CI/CD、自动 PR 审查和定时任务。用户可连接 MCP Servers 来接入数据库、API 或浏览器自动化等工具，也可加载 Skills、定义 Subagents、安装 Plugins 或通过 Hooks 运行生命周期脚本。启用 Dynamic Workflows 后，可在 .whale/workflows/ 中用 JavaScript 调用 parallel 和 agent 来扇出多个子任务，再让一个代理汇总结果。
- 使用 DeepSeek API 的个人开发者，在终端中让代理查看仓库文件、执行命令并修改代码。
- 需要快速获得单次代码审查或命令式答复的工程师，使用
whale ask "..."完成短任务。 - 在 CI/CD 中运行自动 PR 审查、定时任务或其他非交互任务的团队，使用
whale --headless。 - 希望把数据库、API 或浏览器自动化能力接入编程代理的开发者，配置 MCP Servers。
- 要将调研、多个视角的评审和汇总串成流程的用户，启用 Dynamic Workflows 并编写 JavaScript 工作流。
这个 Agent 有哪些优点和局限？
- 专为 DeepSeek 的长上下文、工具调用和缓存机制设计，README 声称提示词缓存命中率约为 98%。
- 同时提供交互 TUI、一次性 CLI 和 headless 自动化入口，覆盖本地交互与 CI/CD 两类运行方式。
- Dynamic Workflows 使用 JavaScript 编排多代理，并明确支持直接运行 Claude Code 的工作流脚本。
- MCP、Skills、Subagents、Plugins 与 Hooks 提供多种扩展路径。
- 核心定位为 DeepSeek-first，而不是可自由切换提供商的通用多模型工具；使用前需要 DeepSeek API key。
- Dynamic Workflows 默认禁用，使用前必须通过
/config或.whale/config.local.toml显式开启。 - 项目处于积极开发阶段，README 仅建议用于个人项目、实验性仓库或可审查、可回滚的变更流程。
- README 未提供针对 ChatGPT、Codex、OpenAI API 或 Claude API 的原生集成说明。
如何安装或部署这个 Agent？
任一平台可运行：npm install -g @usewhale/whale。macOS 也可运行：brew install usewhale/tap/whale。随后执行 whale setup 设置 DeepSeek API key，再运行 whale 启动交互式 TUI。Linux 安装命令为 curl -fsSL https://raw.githubusercontent.com/usewhale/Whale/main/scripts/install.sh | sh；Windows 10、Windows Server 2016 或更高版本可在 PowerShell 中运行 irm https://raw.githubusercontent.com/usewhale/Whale/main/scripts/install.ps1 | iex。
如何使用这个 Agent？
完成 whale setup 后运行 whale，在 TUI 中输入任务。一次性调用可使用 whale ask "审查这段代码"；自动化场景可使用 whale --headless。Dynamic Workflows 默认关闭：在 TUI 执行 /config 启用 Dynamic workflows，或在 .whale/config.local.toml 添加 [workflows] enabled = true。
这个 Agent 与同类方案有什么区别？
Whale 明确不是“通用多模型 shell”，而是 DeepSeek-first 工具。它声明 Claude Code 的工作流脚本可原样在 Whale 中运行；这项兼容性针对工作流脚本，不等同于完整的 Claude Code 产品集成。
常见问题
使用 Whale 需要什么凭证？
whale setup。它能在自动化环境中运行吗？
whale --headless 用于 CI/CD、自动 PR 审查和定时任务。Dynamic Workflows 是否默认可用？
/config 中启用，或在 .whale/config.local.toml 设置 [workflows] enabled = true。