Reasonix：可在终端、桌面与编辑器中运行的本地开源编码智能体

用途

Reasonix 是一个开源 AI 编码助手（MIT 许可）。程序运行在用户自己的电脑上，AI 模型则是用户配置的外部服务，模型会接收到它读取的内容。用户用自然语言描述任务，它会在指定项目文件夹内读取代码、编辑文件、运行命令与测试，并展示每一步操作。

模型与配置

模型由用户选择：内置 DeepSeek 预设，任何 OpenAI 兼容服务都只需增加一条配置项，费用直接支付给模型提供方。项目为配置驱动，提供方、智能体、启用的工具和插件在 reasonix.toml 中声明，没有硬编码模型。可选让执行器与规划器两个模型在不同会话中协同工作。

关键机制

• 权限分级：可设置为每步询问，或允许日常操作自行执行；禁止规则始终生效；计划模式会先给出方案，待批准后才开始工作。
• 回退：文件在修改前会被保存，可按对话轮次回退，且不触碰 git 历史。注意回退仅覆盖其编辑工具改动的文件，不包含 shell 命令造成的变化。
• 插件：MCP 服务器可提供工具、提示与资源；Extension Protocol v1 的 sidecar 还能拦截运行时事件、提供 Provider 与结构化界面。

使用方式

同一程序提供四种入口：桌面应用 Studio（入门推荐）、终端全屏界面（reasonix run "task" 可用于脚本）、通过 reasonix web 启动的本机网页界面、以及在 VS Code 中安装扩展；其他支持 ACP 协议的编辑器可连接 reasonix acp。此外，DeepSeek Harness（dsh）可通过 ACP 将任务交给 Reasonix 作为子智能体执行。

版本说明

项目分为两条线：2.x 在 studio 分支上活跃开发，桌面应用即 Reasonix Studio；1.x 在 main-v2 分支上维护稳定，继续接收缺陷与兼容性修复，但核心架构不再扩展。1.x 的 CLI 可通过 npm 或 macOS 的 Homebrew 安装，2.x 提供各平台安装包，部分候选版本标记为预发布。构建 2.x 的 CLI 需要 Go 1.25+，构建 Studio 另需 Node 24+ 与 pnpm 10。

本介绍依据项目 README，具体安装与配置步骤以官方文档为准。