CodeWhale

活跃
GitHub Rust MIT

简介

CodeWhale 是一个基于 DeepSeek 和 MiMo 的终端编码 Agent,提供高性能代码生成与推理能力,专为开发者打造的 AI 编程助手。

核心特性

  • 宪法架构 — 九层权威等级体系(Constitution),用户意图 > 验证结果 > 置信度,确保模型在冲突信息中遵循正确的决策链
  • 子代理并发执行 — 最多 20 个子代理并行运行,支持异步任务委派,结果通过完成哨兵内联返回
  • LSP 诊断集成 — 每次编辑后自动运行 rust-analyzer、pyright、typescript-language-server 等,将诊断反馈注入下一轮推理
  • 三种操作模式 — Plan(只读规划)、Agent(需审批的破坏性操作)、YOLO(受信工作区自动批准),灵活控制操作空间
  • 工作区快照与回滚 — 每轮对话生成 side-git 快照,/restore 和 revert_turn 支持完整工作区回滚
  • 自动模型路由 — Fin 闪光调用自动选择模型,--model auto 默认启用,DeepSeek V4 前缀缓存大幅降低推理成本

适用场景

💡 大规模代码重构 — 利用子代理并行处理多个模块的重构任务,LSP 诊断确保类型安全,工作区快照支持安全回滚
💡 跨语言项目开发 — 支持 Rust、Python、TypeScript、Go 等语言的 LSP 集成,统一终端编码体验
💡 安全敏感代码修改 — Plan 模式先审查方案,Agent 模式逐审批执行,宪法架构防止危险操作
💡 AI 辅助调试 — 将非零退出码、类型错误和沙箱拒绝作为纠正向量,模型自动分析并修复自身偏差
💡 团队协作开发 — 工作区快照和回滚机制支持多人协作,每轮变更可追溯,降低合并冲突风险

快速开始

```bash
# 安装
cargo install codewhale-cli --locked
cargo install codewhale-tui --locked

# 设置 API Key
export DEEPSEEK_API_KEY="your-key-here"

# 启动
codewhale
# 或在当前目录启动 Agent 模式
codewhale --mode agent
```

相关项目