Claude Code 的终端 UX 没什么好争的,行业天花板。但用它接 DeepSeek , 问题就来了——Claude Code 的上下文压缩围绕 Anthropic 的 cache_control API 设计,System Prompt 被重写、消息中间插入摘要,前缀断裂,缓存命中率直线下降。
DeepSeek 的前缀匹配定价大家应该都清楚:
- 缓存命中:0.025–0.05 元/百万 token
- 缓存未命中:3–6 元/百万 token
- 价差:最高 120 倍
架构不对,同一个任务账单能差出几倍。
有一些专门为 DeepSeek 缓存优化的 Agent ,缓存做得不错。 但它们往往没有对标 Claude Code 的交互体验,也不在 .claude/ 生态兼容上投入。 从 Claude Code 切过去,skills 、hooks 、MCP 全得重配一遍。
反过来,兼容 Claude Code 的 Agent ,缓存策略又没为 DeepSeek 优化过。
Waveloom 特别在意这三件事的交集:
Claude Code 级别的 TUI 交互
- DeepSeek 缓存命中 95% 以上
- .claude/ 生态完整兼容( skills / hooks / MCP / plugins )
如果你也觉得这三件事缺一不可,Waveloom 可能是目前最对口的终端 Agent 。
DeepSeek 缓存优化
不是调了几个参数,是架构层面为前缀稳定性全链路设计:
- 不可变 System Prompt — messages[0] 整个会话期间 0 字节变化
- 追加式消息历史 — 新消息只追加到末尾,从不插入或重写
- 四级水位线原地压缩 — Snip → Prune → Summarize → Hard Limit 。 关键不变量:已压缩的字节序列永不变化,前缀缓存持续命中
- 实测日常开发缓存命中率 95–99%
其他 Agent 也可以在 DeepSeek 上做缓存优化。Waveloom 选择了另一个方向: 把缓存做到这个程度的同时,保留 Claude Code 级别的 UX 和生态兼容。 这个组合市面上不多见。
Claude Code 兼容(迁移零成本)
我们在这个方向上投入了不少精力:
.claude/skills/SKILL.md → 直接可用,9 个 frontmatter 字段完整支持($ARGUMENTS`、`paths`、`` !`cmd` `` 动态注入、`$转义等).claude/plugins/已安装插件 → 自动发现加载.claude.jsonMCP 配置 → 直接兼容,SSE + Streamable HTTP 双传输.claude/settings.jsonhooks 配置 → PreToolUse / PostToolUse 等 5 种事件类型 + permission_mode 字段完整兼容,~/.claude/hooks/下的脚本直接复用- TUI 体验对标 Claude Code:流式推理语法高亮、rich diff 、
@模糊文件选择器、/命令面板、权限确认对话框、明暗/色盲主题切换、中英双语界面、Shift+Tab 进出 Plan Mode
说人话:之前用 Claude Code 的,把 provider 切成 DeepSeek V4 ,skills / hooks / MCP / plugins 配置不用动,体验不会有断层。
多 Provider
- DeepSeek V4 (主力) — 缓存优化最到位。
/model切 pro / flash ,/provider随时换 - Kimi K3 (尝鲜) —
/provider kimi一键切换,kimi-k3 已适配,thinking 推理流式输出完整支持 - OpenAI — 完整兼容
Claude Code 也能接 K3 API ,但 Claude Code 的上下文策略围绕 Anthropic 设计,接第三方模型核心能力打折扣。Waveloom 反过来——先为 DeepSeek 优化,同时兼容 Claude Code 生态,K3 作为多 Provider 的自然延伸。
其他亮点
- 14 个内置工具( read / write / edit / bash / web_search / web_fetch / agent / …)
- Subagent 系统:Fork 热启动继承上下文 + Cold 冷启动(代码评审 / 对抗验证 / 只读探索)
- Plan Mode:先规划后执行,Guard 强制写保护
- 会话持久化:
waveloom --continue恢复关闭前完整上下文 - Checkpoint / Rewind:回退到任意历史消息,文件状态完整恢复
- Advisor Mode:flash 处理日常任务,pro 自动切入 Plan Mode 和 Code Review
- 后台任务管理 + 跨 turn 通知注入
- 完整中英双语 UI + i18n

技术栈:Go 1.25 + Bubble Tea v2 + Glamour + Lipgloss ,单二进制 ~20MB ,零运行时依赖(不需要 Node.js / Python 虚拟环境)。
当前 v0.2.0-beta.2 ,两百多个 commit 。日常用它开发它自己,核心循环、压缩引擎、权限管线已经比较稳了,但边缘场景仍有粗糙边角。
- GitHub: https://github.com/Menfre01/waveloom
- 一键安装:
curl -fsSL https://raw.githubusercontent.com/Menfre01/waveloom/main/install.sh | sh - Homebrew:
brew install menfre01/tap/waveloom - 缓存设计详解: https://github.com/Menfre01/waveloom/blob/main/docs/prefix-cache.md
DeepSeek 用户如果被缓存命中率折磨过,欢迎试试。代码不经过第三方服务器,自备 API Key 。也欢迎拍砖 🙏