信息卡

一句话定位

"A DeepSeek-native AI coding agent for your terminal"——只绑定 DeepSeek 一家的终端编程 Agent，把前缀缓存稳定性（prefix-cache stability）当作整个循环的设计不变量，让长会话、长时间挂机的 token 成本保持在极低水平。

趋势解读：为什么火

在"全家桶多模型 Agent"泛滥的当下，它反着走：官方数据宣称单日 435M input tokens 达到 99.82% cache hit，同样工作量成本约 $12 对比无缓存方案约 $61。性价比叙事 + 国产模型红利叠加，是本月榜单上最纯粹的 DeepSeek 生态卡位。

核心功能拆解

• code mode：文件/shell 工具、SEARCH/REPLACE 编辑提案经 `/apply` 审核落盘，附 Plan mode、`/todo`。
• chat mode：无磁盘与终端权限的轻量对话模式，可挂 MCP 与 web search。
• Skills 系统：Markdown playbook，可 `runAs: subagent` 隔离执行，兼容 Claude 格式 `.claude/skills/` 目录。
• Memory：`remember`/`recall_memory` 分 user/feedback/project/reference 四类。
• Hooks 生命周期钩子：PreToolUse 门控、PostToolUse 等 shell 命令注入点。
• 可切换搜索引擎：Bing 默认，支持 Baidu AI Search、自托管 SearXNG、Tavily、Exa 等 9 种。
• 本地语义索引 `reasonix index`：接 Ollama 或任意 OpenAI-compatible embedding 端点。
• 附带 web dashboard、auto-checkpoints、QQ channel 远程接入与 Tauri 桌面客户端预览版。

架构与技术栈浅析

亮点在架构三大支柱：Cache-first loop（字节级稳定的上下文前缀）、Tool-call repair、Cost control。注意版本迁移信息：当前默认分支 main-v2 已是 Go 重写版，旧 TypeScript 线（0.x，npm 包 `reasonix`）进入维护期仅收 bug fix；榜单标注语言为 Go 正对应这次重写。

安装与环境要求

TypeScript 版需 Node ≥ 22，支持 macOS/Linux/Windows：

npm install -g reasonix
reasonix code my-project   # 首次运行粘贴 DeepSeek API key

API key 从 platform.deepseek.com/api_keys 获取。Go v2 版本见 main-v2 分支的 `docs/MIGRATING.md` 迁移指南。

快速上手示例

reasonix run "refactor this function"   # 单次任务流式输出，适合管道
reasonix doctor                          # 健康检查
/skill new my-skill --global             # 创建全局技能

进阶使用要点

• `/search-engine` 切换到自托管 SearXNG 可实现全链路自主可控。
• per-workspace shell allowlist（exact-prefix 匹配）精细控制危险命令。
• 用 `npx openspec init --tools claude` 后可直接调用 Claude 生态技能。
• 会话持久化于 `/.reasonix/`，`replay` 子命令可回放 transcript。
• 桌面端底部有实时 cost/cache/token 计量条，适合成本敏感团队。

典型应用场景

• 大规模重构长会话：缓存命中率高，跑几小时不心疼 token。
• CI 管道集成：`reasonix run` 纯 stdout 流式输出天然适合脚本拼接。
• 多项目并行：per-workspace 配置隔离 + QQ channel 远程遥控。
• 低成本个人编码助手：DeepSeek API 定价 × 高缓存命中率双杀。

同类生态位对比

对比 Claude Code / Cursor：闭源且按订阅计费，Reasonix 开源 MIT 且成本可控一个数量级；对比 Aider：同为开源终端工具，但 Aider 走多 provider 路线，Reasonix 押注单厂商换极致缓存优化。单模型押注是把双刃剑——生态锁定换取了深度的工程优化空间。

资源导航

文档站 esengine.github.io/DeepSeek-Reasonix（含中文配置指南）、双语 Discord、GitHub Discussions（CLI/Dashboard 设计讨论）、AtomGit 镜像。