usewhale/Whale

Whale – 面向 DeepSeek 的 AI 编程助手

它是什么 – Whale 是一个终端优先、针对 DeepSeek 优化的 AI 代理，可以读取、编辑和运行代码，浏览网页，并调用工具。它以单个二进制文件（或 npm 包）形式发布，并提供 TUI、一次性 CLI 以及用于 CI/CD 的无头模式。

主要功能

• 提示缓存（约 98% 命中率） – 重用之前发送的上下文，使大多数交互仅花费几美分。
• DeepSeek 原生 – 针对 DeepSeek 的 1M token 上下文、工具调用和定价模型量身定制。
• 动态工作流 – 编写 JavaScript 脚本，编排多个代理（并行研究、综合等）。与 Claude Code 脚本兼容。
• MCP、技能和插件 – 连接数千个 MCP 服务器（文件操作、git、web、数据库），加载社区“技能”（代码审查、git worktree），或添加自定义插件和钩子。
• 多种界面 – 交互式 TUI（whale）、快速 CLI（whale ask "…"）以及用于自动化的无头模式。

安装

# npm（跨平台）
npm install -g @usewhale/whale
# macOS 通过 Homebrew
brew install usewhale/tap/whale
# Linux 一行命令
curl -fsSL https://raw.githubusercontent.com/usewhale/Whale/main/scripts/install.sh | sh
# Windows PowerShell
irm https://raw.githubusercontent.com/usewhale/Whale/main/scripts/install.ps1 | iex

安装后，运行 whale setup 存储你的 DeepSeek API 密钥，然后使用 whale 启动代理。

典型工作流

1. 启动 TUI（whale）。
2. 输入自然语言请求（例如，“重构这个函数”）。
3. Whale 读取相关文件，调用 DeepSeek 模型，可能调用工具（shell、git、web 搜索），并返回编辑后的代码。
4. 对于脚本化管道，放置一个 .whale/workflows/*.js 文件，并在配置中启用 动态工作流。

项目状态 – 该仓库不再维护。README 引导用户使用官方的 DeepSeek Harness 作为维护的替代方案。代码仍然可用，但不会有进一步的更新或官方支持。

适用人群 – 希望获得快速、低成本的 AI 编程助手，直接从终端工作并嵌入 CI 管道，而无需完整 IDE 集成的开发者。