DeepSeek-Reasonix 上手：靠「前缀缓存稳定」把长会话 token 成本打到约 1/5

项目在文档里说得很坦率：缓存稳定不是一个可以开关的功能，而是整个循环围绕它设计的不变量。这就是它坚持 DeepSeek-only 的原因——每一层都针对 DeepSeek 的字节稳定前缀缓存机制调优，而不是维护一套泛化兼容层。

缓存失效通常不是玄学，而是有明确诱因。Reasonix 的四条机制逐一对症：

上下文处理管线

  startup 注入（稳定前缀）
        ↓
  snip     ── 剪掉过期工具输出
        ↓
  prune    ── 去噪
        ↓
  summarize ── 到 80% 阈值才压缩

关键不变量：
  每次请求重放的前缀，字节逐一相同
  模型只需计算「新增的那部分」

项目 README 中给出了一个真实用户的单日数据（2026-05-01）：

单日实测（官方 README 记录的案例）

  输入 token 量   4.35 亿（435M）
  缓存命中率      99.82%
  实际花费        约 12 美元
  无缓存等价成本  约 61 美元（v4-flash 口径）

  → 约五分之一

项目文档另称：长会话缓存命中率可达 90% 以上，
   输入 token 成本约为冷启动等价成本的 1/5。

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

# 推荐方式：npx（总是拉最新版，无需预装）
npx reasonix code
# 首次运行时粘贴 DeepSeek API Key，之后自动持久化

# 需要 Node >= 22
# 已在 macOS / Linux / Windows（PowerShell、Git Bash、Windows Terminal）测试

# 如果打算天天用，想把 reasonix 放进 PATH：
reasonix update      # 会替你执行 npm install -g

# 其他安装方式
npm i -g reasonix
brew install esengine/reasonix/reasonix   # macOS

常用子命令速查：

MCP 与插件

  插件在 reasonix.toml 中声明
  传输方式：stdio / SSE / Streamable HTTP
  外部工具合并进统一注册表（带前缀区分）
  MCP prompts   → 变成斜杠命令
  MCP resources → 用 @server:uri 引用
  兼容 .mcp.json（Claude Code 的 mcpServers schema）

内置子代理：explore / research / review / security-review
沙箱：文件写入边界由 OS 级后端强制
      macOS 用 Seatbelt，Linux 用 bubblewrap
      并解析符号链接以防路径穿越逃逸

联网搜索：默认 Mojeek（零配置）
  /search-engine searxng http://localhost:8080   # 切换到自建 SearXNG
  （写入 ~/.reasonix/config.json，重启后仍生效）

✅ 适合
  已经在用 DeepSeek 或 OpenAI 兼容端点
  长会话、多步骤的编码与重构任务
  成本敏感、需要把 token 账单压下来
  想把 Agent 嵌进 CI / 本地开发循环 / IM 机器人

❌ 先别急
  需要开箱即用的多云大模型抽象
    （Anthropic、Google、带私有扩展的 Azure OpenAI 需自写 provider 插件）
  需要成熟的企业级 UI 与审计日志
    （桌面端相对年轻，生产环境建议以 CLI 为主）
  期待即插即用的 SaaS 连接器
    （MCP 兼容，但工具接入需要显式包装）
  缺少安全的密钥管理设施
    （API Key 走环境变量或 Reasonix 主目录的 .env，无内存加密说明）