简介
Reasonix 是一款专为终端设计的开源 AI 编程代理，为开发者提供了一种经济高效的工作流。
什么是 Reasonix？
Reasonix 是一款专为 DeepSeek API 构建的原生终端 AI 编程助手。它被设计成一个开源 AI 代理，开发者可以直接在其项目目录的命令行中运行。Reasonix 的核心创新在于其缓存优先循环，该机制经过精心设计，旨在充分利用 DeepSeek 的字节稳定前缀缓存。这种工程重点使其成为一种高度经济高效的 AI 编程工具，因为在长时间编码会话中，它能将缓存命中率保持在 90% 以上，从而大幅降低令牌成本。它解决了使用大型语言模型进行长期开发工作所产生的高昂运营成本问题，非常适合个人开发者和团队使用，他们希望在现有的基于终端的工作流中集成一个强大且价格合理的 AI 结对程序员。
Reasonix 的主要特性
缓存优先循环
代理的核心循环是仅追加且字节稳定的，确保缓存的提示前缀能在包含多个工具调用的长时间会话中持续存在，这是实现高缓存命中率和低令牌成本的关键。
原生终端 TUI
Reasonix 作为您终端中的一等公民运行，使用诸如 git diff 和 ls 等原生命令进行操作，使其成为一个无缝的终端 AI 助手，无需 IDE 插件。
DeepSeek V4 双层级模型支持
默认情况下，它使用经济高效的 DeepSeek-V4-Flash 模型进行迭代，并且能够使用简单的斜杠命令，将单轮对话或整个会话瞬间切换到更强大的 V4-Pro 模型。
一流的 MCP 支持
您可以通过简单的命令行标志轻松集成外部工具服务器，将其功能直接合并到代理的工具注册表中以扩展功能。
沙箱化执行和计划模式
所有内置工具都沙箱化到项目启动目录以确保安全，而 /plan 模式则充当只读审核关卡，防止任何磁盘写入操作，直到提议的计划获得批准。
可组合的 Markdown 技能
用户可以通过将带有特定 frontmatter 的 Markdown 文件放入 .reasonix/skills/ 目录来创建可重复使用的工作流，从而实现类似脚本的自动化和隔离的子代理执行。
会话回放与分析
每次交互和事件都会记录到磁盘，允许用户回放过去的会话、运行关于令牌使用情况、缓存性能和成本的详细统计数据，并审核代理的行为。
Reasonix 的用例
长时间编码与重构会话
从事大规模代码重构、错误排查或功能实现的开发人员，可以在整个会话中使用 Reasonix 作为持久、经济高效的 AI 结对程序员。
学习与探索新代码库
该代理可以帮助快速理解不熟悉的项目，通过读取文件、解释逻辑和生成摘要，所有这些操作都在终端内完成。
自动化代码生成与任务执行
通过其技能系统和工具集成，Reasonix 可以被配置来自动化重复性编码任务、生成样板代码或执行复杂的多步骤流程。
安全、经过审核的代码修改
使用 /plan 模式，开发人员可以在应用所有提议的更改之前进行审查和批准，这使其非常适合对关键的生产代码进行谨慎的修改。
如何使用 Reasonix
- 确保 Node.js 22+ 已安装在您的 macOS、Linux 或 Windows 系统上。
- 导航到您的项目目录 使用终端命令
cd /path/to/your/project。 - 运行代理 使用命令
npx reasonix code。首次启动包含一个设置向导，将引导您添加 DeepSeek API 密钥。 - 与 TUI 交互 使用自然语言请求编码帮助，并使用诸如
/plan进入安全模式或/pro切换模型等斜杠命令。
Reasonix 的目标用户
- 主要在终端工作的开发者和工程师。
- 寻求将经济高效的 AI 编程助手集成到其工作流中的团队。
- 偏好透明、可修改工具的开源贡献者和爱好者。
- 寻求不被锁定在特定 IDE 中的 AI 结对程序员的任何人。
Reasonix 是免费的吗？
Reasonix 本身是完全免费和开源的，基于 MIT 许可证发布。使用该软件无需任何费用。
但是，它需要一个 DeepSeek API 密钥才能运行，该密钥采用按量付费模式。成本取决于使用情况和 Reasonix 提供的缓存效率。
| 模型 | 输入令牌成本 | 输入令牌成本 |
|---|---|---|
| DeepSeek-V4-Flash | 每 100 万令牌 $0.07 | 每 100 万令牌 $0.014 |
Reasonix 中的缓存优先循环旨在最大化缓存令牌的使用，与使用通用客户端调用 API 相比，显著降低了运营成本。
Reasonix 的优点与缺点
| 方面 | 优点 | 缺点 |
|---|---|---|
| 成本效益 | 由于高缓存命中率，对于长时间会话极其经济高效。 | 需要付费的 DeepSeek API 密钥。 |
| 集成与工作流 | 无缝的终端集成；无需离开开发者的原生环境进行上下文切换。 | 没有 IDE 插件可用；不适合偏好重度 GUI 工具的开发者。 |
| 灵活性与安全性 | 通过 MCP 和技能高度可配置；计划模式等功能确保安全的代码修改。 | 该工具目前仅专用于 DeepSeek，不是多提供商代理。 |
| 易用性 | 安装简单（npx），两步完成，首次启动有引导设置。 | 需要熟悉终端和命令行界面。 |
关于 Reasonix 的常见问题
为什么 Reasonix 只支持 DeepSeek？
这是一个有意的工程选择，而非限制。整个缓存优先循环都是围绕 DeepSeek 字节稳定前缀缓存的具体机制设计的，以实现最佳性能和成本降低。使用其他后端会破坏这一核心优化。
有桌面版本或 IDE 插件吗？
有一个原生的 Tauri 桌面应用程序，提供具有多标签会话和实时指标的可视化伴侣。然而，Reasonix 仍然是一个终端优先的 AI 代理，并不旨在取代 IDE 插件；它利用的是您现有的终端工具。
工具调用和文件写入的安全性如何？
安全性是首要考虑。所有内置工具都沙箱化到您的启动目录。至关重要的是，/plan 模式将会话置于只读审核状态，SEARCH/REPLACE 编辑将保持为待处理更改，直到使用 /apply 明确应用，从而防止意外修改。
我可以将 Reasonix 与自托管的 DeepSeek 端点一起使用吗？
可以。自 0.30 版本起，您可以通过在配置中设置自定义 baseUrl 来配置 Reasonix 指向私有的 DeepSeek 兼容端点，从而允许您在内部基础设施上使用相同的优化循环。
如何创建我自己的自定义技能？
创建Reasonix 技能很简单。您可以在 TUI 中使用 /skill new 命令来搭建一个新的技能文件。技能只是放置在 .reasonix/skills/ 文件夹中的 Markdown 文件，其中的 frontmatter 定义了它们的行为，例如作为隔离的子代理运行。
我可以在会话中途更改工作目录吗？
不可以，您不能在活动会话期间切换工作目录，因为这会复杂化沙箱路径和内存上下文。要在不同的目录上工作，您应该退出并使用 --dir <路径> 标志重新启动 Reasonix。
Reasonix 标签
Reasonix, AI 编程代理, 终端 AI 助手, 开源 AI 代理, DeepSeek 编程, 缓存优先循环, 经济高效的 AI 编程, 终端 TUI, MCP 集成, 开发者工具, AI 结对程序员, 代码自动化, Markdown 技能, 会话回放, 安全代码编辑
