Reasonix — DeepSeek 原生 AI 编程助手

标题：Reasonix — DeepSeek 原生 AI 编程代理

URL 来源：https://esengine.github.io/DeepSeek-Reasonix/

发布日期：2026 年 5 月 24 日 星期日 15:33:54 GMT

Markdown 内容： §00 · Reasonix v0.50.0 · 开源

一个 _DeepSeek_ 原生的

编程 _代理_，

适用于你的终端。

Reasonix 直接与 api.deepseek.com 通信。循环是追加式的，围绕 DeepSeek 的字节稳定前缀缓存设计——长时间会话缓存命中率超过 90%，输入 token 成本下降至约 1/5。以终端为中心，让它持续运行。

94% 缓存命中率

2.5× 成本降低

2837 测试用例

MIT 许可证

§01· 安装

两步操作。无需全局安装。

Node ≥ 22 在 macOS / Linux / Windows 上（PowerShell · Git Bash · Windows Terminal）。首次启动时会引导你粘贴 DeepSeek API 密钥。

$ npx reasonix code

// 无需全局安装 —— 在你的项目目录中运行

01 — API 密钥

获取 DeepSeek API 密钥

前往 DeepSeek 平台 创建密钥。按使用量付费；缓存的 token 按正常费率的 1/5 收费。

$0.07 /Mtok · $0.014 /Mtok 缓存

02 — 工作区

进入你的项目

$ cd /path/to/my-project

// 工具沙箱化到启动目录

03 — 运行

启动 TUI

$ npx reasonix code

// 首次启动向导会配置密钥

§02· 三大支柱

Reasonix 只针对 DeepSeek，因为循环的不变量是基于 DeepSeek 的缓存机制设计的。相同的模型，相同的 API —— 变化的只是循环工程立场。

缓存优先循环 一个字节稳定的循环

P1

R1 思维收获 推理链收获

P2

工具调用修复 工具调用修复

P3

缓存优先循环

一个字节稳定的循环

DeepSeek 的前缀缓存从字节 0 开始指纹化提示。Reasonix 循环是追加式的 —— 不重新排序，不依赖标记压缩 —— 所以每次工具调用都会保留缓存前缀。

94% 缓存命中 · 长时间会话

01_仅追加_ —— 消息和工具结果被追加；历史记录从不被修改

02_无标记_ —— 不依赖如 cache_control 标记之类的触发器

03_稳定顺序_ —— 工具调用顺序和时间戳完全确定

04_前缀存活_ —— 即使多次工具调度，前缀依然命中

§03· 功能

围绕 _DeepSeek API_ 的工程立场。

十几个工具组合成看起来像简单 CLI 的东西 —— 但每一层下面都在努力维持缓存命中率、成本和稳定性。

F-01

终端原生 TUI

不是另一个 IDE 插件。git diff 处理差异，ls 处理文件树 —— 你的终端就是工作区。

TypeScript + Ink TUI

F-02

V4 两层架构

默认使用 V4-Flash 实现低成本迭代；/pro 将单次调用提升至 V4-Pro；/preset max 使整个会话运行在 Pro 模式下。

默认 Flash · 按需 /pro

F-03

MCP 一级支持

一行命令 —— --mcp "name=cmd args" —— 外部服务器即可接入；其工具将合并到同一注册表中，带有前缀。

stdio · SSE · 可流式 HTTP

F-04

沙箱 + 计划门

每个内置工具都沙箱化到启动目录；/plan 将会话置于只读审计门后 —— 必须批准计划后才允许写入。

沙箱 + /plan 门

F-05

可组合技能

在 .reasonix/skills/<name>.md 中放置一个 Markdown 文件；frontmatter 支持 runAs: subagent 和 allowed-tools 实现隔离执行。

Markdown 技能脚本

F-06

回放与事件

每个事件都写入磁盘 —— 可回放任意过去的会话，对 token / 缓存 / 成本运行统计，审计循环行为。

reasonix replay / events / stats

§04· 配置

扩展、内存、配置 —— _纯文本_ 足够了。

Reasonix 将可扩展性简化为少数几个定义明确的目录和文件。没有注册表，没有魔法 —— 所有内容都是可读、可对比、可追踪的纯文本。

/mcp

模型上下文协议

外部工具服务器

/skills

技能

可重用的 Markdown 操作手册

/memory

内存

项目 + 全局内存

/config

配置

全局 + 项目配置

/slash

斜杠命令

TUI 快捷命令

模型上下文协议 · 外部工具服务器

MCP 是将外部能力集成进 Reasonix 的一级通道 —— 支持 stdio、SSE 和可流式 HTTP 传输。每个服务器的工具在统一注册表中合并，前缀透明于模型。

• 一行挂载：--mcp 'name=cmd args'
• MCP 工具与内置工具共享相同沙箱
• /mcp 列出已挂载服务器 · 健康状态 · 工具
• 故障时自动重连，指数退避

~/.reasonix/config.json

{ "model": "deepseek-v4-flash", "mcpServers": { "github": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-github"], "env": { "GITHUB_TOKEN": "ghp_*" } }, "filesystem": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-filesystem", "/data"] }, "postgres": { "transport": "sse", "url": "https://mcp.internal/pg/sse", "headers": { "Authorization": "Bearer *" } } } }

或通过 CLI 参数

$ reasonix code \ --mcp 'github=npx -y @modelcontextprotocol/server-github' \ --mcp 'pg=https://mcp.internal/pg/sse'

§07· 路线图

一个 _公开_ 的产品节奏。

每个里程碑都存在于 GitHub Discussions 的愿望清单中。议题投票决定优先级；PR 决定节奏。

已发布 #### 已发布

• 缓存优先循环 · 字节稳定前缀
• R1 思维收获 · 捕获逃逸的工具调用
• 工具调用修复 · 基于模式的自愈
• MCP 一级支持（stdio / SSE / HTTP）
• 技能 · Markdown frontmatter 脚本
• 原生 Tauri 桌面端

v0.44.x #### 进行中

• /skill new <name> 脚手架
• 设置向导主题选择器 + 实时预览
• “你是否想输入 /…?” 模糊纠错
• 安装源感知的 reasonix update
• 中文（简体）覆盖扩展至卡片组件

下一步 #### 路线图

• reasonix init · 项目脚手架 CLI
• 跨设备上下文同步
• 插件系统（兼容 .claude-plugin）
• 仓库地图 · 语义化仓库索引
• TUI 浅色主题

愿望清单 #### 愿望清单

• 多智能体协作 · 持久化工作进程
• 跨提供商编排（codex + deepseek）
• Composer 语音输入
• 托管服务模式
• 更多语言的国际化支持

§08· 常见问题

常见问题

仍然卡住了？在 GitHub Discussions 中开启一个讨论帖。

01 为什么只使用 DeepSeek？我能换成 Claude / GPT 吗？

这是设计选择，而非限制。DeepSeek 的前缀缓存会从字节 0 开始指纹化提示；Reasonix 循环围绕这一不变量构建——长会话的缓存命中率约为 94%。指向 Anthropic 兼容端点虽然能获得便宜的 token，但会破坏缓存控制标记。通用后端（Aider / Cline / Continue）会压缩历史记录，这会破坏字节稳定性。绑定到单一后端反而是个特性。

02 是免费的吗？

Reasonix 本身采用 MIT 许可证，完全免费。DeepSeek API 密钥是付费的：V4-Flash 未缓存时为 $0.07/Mtok，缓存后为 $0.014/Mtok。在长时间会话中，费用通常仅为同类通用工具的约 1/3。

03 会有 IDE 插件吗？

没有。Reasonix 是以终端优先的设计。git diff 用于差异比较；ls 用于文件树展示。桌面端只是 CLI 的视觉补充，而不是 Cursor 的替代品。

04 我能指向自托管 / 私有 DeepSeek 端点吗？

可以。从 0.30 版本开始，我们接受非标准密钥前缀用于自托管的 DeepSeek 端点。只需将 baseUrl 指向内部地址即可——循环、缓存策略和工具协议均保持不变。

05 CLI 和桌面版有什么关系？

相同的循环、相同的协议、相同的 ~/.reasonix 配置。桌面端（Tauri）自带 Node 运行时——无需单独安装 npm。支持多标签页会话、侧边栏显示本次会话读取或写入的文件、底部实时显示成本 / 缓存 / token 计数器。

06 如何编写自己的技能？

没有远程注册表——只需创建一个文件。在 TUI 中运行 /skill new my-skill 来生成项目本地的技能；加上 --global 参数则将其放入 ~/.reasonix/skills 下，可在多个项目间复用。技能是带 frontmatter 的 Markdown 文件（包含描述、runAs、allowed-tools）；runAs: subagent 会在隔离的子循环中运行主体内容。

07 工具调用安全吗？

所有内置工具（read_file / write_file / edit_file / run_command …）都沙箱化至启动目录或通过 --dir 设置的目录。SEARCH/REPLACE 编辑会排队等待；只有在执行 /apply 后才会写入磁盘。/plan 模式是一个只读审计门——计划未经批准前不允许任何写操作。

08 我能在会话中途切换工作目录吗？

不行——内存路径会与过时的根目录纠缠。请退出并使用 reasonix code --dir <path> 重新启动。