居然没有DeepSeek，其实DeepSeek编程也相当不错，其他语言没怎么试过，PHP跟Python很不错

还请多多指教～😁

根据有网友需要用到Deepseek-V4模型，这里有两款原生编程代理工具，都是人气很旺的。

---

项目安装指南

目录

1. CodeWhale
2. DeepSeek-Reasonix

---

1. CodeWhale

项目简介

CodeWhale - DeepSeek + MiMo terminal 编码助手（终端 TUI）

• GitHub: https://github.com/Hmbown/CodeWhale
• 基于 Rust 构建的交互式终端 UI 编码代理
• 支持多种 API 提供商，包括 DeepSeek、OpenRouter 等

系统要求

• 操作系统: Linux, macOS, Windows
• 语言运行环境: Rust (用于编译), Node.js/npm (备用方案)
• 架构支持: x86_64, ARM64, musl, riscv64, FreeBSD 等 Tier-1 Rust target

---

🐧 Linux 安装方法

方法一：使用 npm（推荐）

# 全局安装 codewhale
npm i -g codewhale

# 验证安装
codewhale --version

确保 ~/.npm-global/bin 路径已添加到系统的 PATH 环境变量中。

方法二：使用预编译二进制文件

从 GitHub Releases 下载适用于你系统的预编译二进制文件。

China / Mirror-friendly Installation（中国镜像源）

如果从中国境内下载 GitHub 或 npm 速度慢，可以使用 Cargo registry 镜像：

# 设置 Cargo 镜像（根据需要选择）
cargo config set -q build.rustflags "--cfg tokio_unstable"

# 然后安装两个二进制文件（dispatch 和 TUI）

可以使用环境变量指定镜像地址：

export DEEPSEEK_TUI_RELEASE_BASE_URL=<你的镜像 URL>

方法三：从源码编译

# 克隆仓库
git clone https://github.com/Hmbown/CodeWhale.git
cd CodeWhale

# 编译并安装（需要 Rust 环境）
cargo install --path crates/codewhale

---

🪟 Windows 安装方法

方法一：使用 Scoop（Windows 包管理器）

# 先更新 Scoop
scoop update

# 安装 codewhale
scoop install codewhale

# 验证版本
codewhale --version

⚠️ 注意：Scoop 的 manifest 更新可能滞后于 GitHub/npm/Cargo 发布。如需最新版本，建议使用 npm 或直接下载 GitHub release。

方法二：使用 npm

# 全局安装
npm i -g codewhale

# 验证安装
codewhale --version

确保 npm 的全局 bin 路径已在 PATH 环境变量中（通常是 %USERPROFILE%\AppData\Roaming\npm）。

方法三：使用预编译二进制文件

从 GitHub Releases 下载 .exe 二进制文件，手动解压到任意目录并添加到系统 PATH。

---

⚙️ 配置

配置文件位置：

• 用户级配置: ~/.codewhale/config.toml
• 旧版兼容: ~/.deepseek/config.toml
• 项目级配置: /.codewhale/config.toml

示例配置可参考：config.example.toml

重要说明：

• 项目和用户配置层都禁止直接设置 api_key, base_url, provider, mcp_config_path
• API Key 应通过环境变量或用户配置设置

---

🚀 基本使用

# 启动 Codewhale TUI
codewhale

# 启动前打开帮助
codewhale --help

常用命令

命令	说明
codewhare fork	分支化现有会话
codewhale sessions	列出所有保存的会话
codewhale resume --last	恢复最近的会话
codewhale --continue	继续上一个会话

快捷键

快捷键	功能
Tab	补全/或@条目；运行时作为 follow-up 队列
Shift+Tab	循环推理强度：off → high → max
F1	可搜索的帮助覆盖层
Esc	返回/关闭
Ctrl+K	命令面板
Ctrl+R	恢复之前的会话
Alt+R	搜索提示词历史并恢复清空的草稿
Ctrl+S	暂存当前草稿 (/stash list,/stash pop恢复)

工作模式

模式	图标	说明
Plan	🔍	只读调查 - 模型在做出更改前先探索并提出计划
Agent	🤖	默认交互模式 - 多步骤工具使用带审批闸口
YOLO	⚡	在可信工作区自动批准所有工具

---

2. DeepSeek-Reasonix

项目简介

DeepSeek-Reasonix - DeepSeek 原生的 AI 终端编码代理

• GitHub: https://github.com/esengine/DeepSeek-Reasonix
• 专为 DeepSeek API 优化的编码助手
• 基于字节稳定前缀缓存机制，94%+ 缓存命中率

系统要求

• Node.js: ≥ 20.10（macOS/Linux/Windows）
• Windows 额外要求: Git for Windows
• Shell: PowerShell / Git Bash / Windows Terminal

---

🐧 Linux/macOS 安装方法

方式一：使用 npx（推荐，无需全局安装）

# 进入你的项目目录
cd /path/to/my-project

# 直接运行，首次运行会引导你输入 API Key
npx reasonix code

# 或者直接指定目录
npx reasonix code my-project

优势：无需全局安装，在项目中运行，沙盒工具限制在项目目录。

方式二：全局安装

# 全局安装（推荐日常频繁使用者）
npm install -g reasonix

# 验证安装
reasonix --help

# 使用命令
reasonix code my-project
# 或简写
reasonix my-project

首次运行时会自动弹出向导让你粘贴 DeepSeek API Key，密钥持久化存储在 ~/.reasonix/config.json。

---

🪟 Windows 安装方法

方式一：使用 PowerShell / Git Bash（推荐）

# PowerShell
cd C:\path\to\your-project
npx reasonix code

或使用 Git Bash：

cd /c/path/to/your-project
npx reasonix code

方式二：全局安装

# PowerShell
npm install -g reasonix

# 使用
reasonix code C:\path\to\project

确保 Node.js 已正确安装并添加到系统 PATH。

---

💻 桌面客户端安装

除了 CLI，还可以使用原生 Tauri 桌面客户端：

# 访问官网下载
https://esengine.github.io/DeepSeek-Reasonix

# 特点
- 捆绑 Node 运行时，无需单独 npm 安装
- 共享 ~/.reasonix 配置
- 多标签会话
- 实时显示成本/缓存/Token 指标
- 侧边面板显示会话读取/写入的文件列表

桌面客户端已打包所有依赖，开箱即用。

---

⚙️ 配置

配置文件：~/.reasonix/config.json

自托管 DeepSeek 端点支持

从 v0.30 开始，Reasonix 接受非标准密钥前缀以支持自托管的 DeepSeek 端点：

{
  "baseUrl": "https://your.internal.deepseek.endpoint",
  "apiKey": "your-api-key"
}

只需将 baseUrl 指向内部地址即可，缓存策略和工具协议保持不变。

---

🚀 基本使用

# 进入项目目录
cd /path/to/project

# 启动 Reasonix 代码代理
reasonix code
# 或简写为
reasonix

# 查看帮助
reasonix code --help

命令行参数

命令	说明
reasonix或reasonix code [dir]	编码代理（默认 mode）
reasonix chat	聊天模式（无文件系统/Shell 工具）

code 是唯一的具有文件系统/Shell 工具和 SEARCH/REPLACE 审查模式的模式。

两种模式对比

模式	可用性	功能
code	✅ 默认	拥有文件系统、Shell 工具、SEARCH/REVIEW审查
chat	❌ 限制	仅基础对话，无代码编辑能力

---

🎯 核心特性

1. 缓存优先机制
   • 针对 DeepSeek 的前缀缓存优化
   • 长会话保持 94%+ 缓存命中率
   • 输入 Token 成本降至约 1/5
2. 定价优势
   • 普通 Token: $0.07/Mtok
   • 缓存 Token: $0.014/Mtok（仅需 1/5 价格）
3. 终端优先设计
   • 无需 IDE 插件
   • 使用 git diff 进行差异对比
   • 使用 ls 浏览文件树

---

对比总结

特性	CodeWhale	DeepSeek-Reasonix
主要 API	DeepSeek, OpenRouter 等	DeepSeek 专用
实现语言	Rust	Node.js
Linux 安装	npm/Scoop/源码编译	npx/全局 npm
Windows 安装	Scoop/npm/二进制	PowerShell/Git Bash/npx
配置方式	TOML	JSON
桌面客户端	否（TUI）	是（Tauri）
缓存优化	基础	深度优化（94%+）
费用优化	标准费率	缓存费率 1/5

---

常见问题

CodeWhale

Q: 在中国大陆安装慢怎么办？ A: 使用 Cargo 镜像，或设置 DEEPSEEK_TUI_RELEASE_BASE_URL 环境变量使用镜像地址。

Q: 如何切换不同的 API 提供商？ A: 在 TUI 中输入 /provider 打开提供商选择器，或使用 /provider openrouter 直接切换。

DeepSeek-Reasonix

Q: 为什么必须用 Node.js 22+？ A: 这是最新的兼容性要求，确保所有功能正常工作。

Q: 能否使用自托管的 DeepSeek 端点？ A: 可以，从 v0.30 开始支持自定义 baseUrl 指向内部部署的 DeepSeek 服务。

Q: CLI 和桌面客户端有什么区别？ A: 相同的循环和协议，但桌面客户端提供图形界面，捆绑 Node 运行时，无需单独安装 npm。

---

参考资料

• CodeWhale
  • GitHub: https://github.com/Hmbown/CodeWhale
  • 文档：https://github.com/Hmbown/CodeWhale/tree/main/docs
  • 发行版：https://github.com/Hmbown/CodeWhale/releases
• DeepSeek-Reasonix
  • GitHub: https://github.com/esengine/DeepSeek-Reasonix
  • 官方文档：https://esengine.github.io/DeepSeek-Reasonix
  • API 文档：https://api-docs.deepseek.com/quick_start/agent_integrations/reasonix

---

https://www.codewhale.ai/

楼主可以考虑迭代加上这个，基于DeepSeek的，V4的编程能力现在也很强了

就是那个喊中国网友为“鲸鱼兄弟”的老外，开发的那款软件？改名了？