写在前面
Reasonix 最近几个版本的变化非常密集，尤其是从 v0.x 到 v1.x 的重构，不是一次普通的小版本升级，而是一次底层架构换代。简单说：旧版更像一个基于 TypeScript/Node 的 AI 编程助手，新版则逐渐演进成了一个以 Go 单二进制、内置 CodeGraph、完整 Agent Runtime、桌面端工作台和 CLI 专业工具为核心的本地 AI 编程工作台。
本文结合官方 GitHub Releases、官方 v1.0 迁移说明，以及整理文档，对 Reasonix 从 v0.x 旧版到 v1.4.0 的主要优化和新增功能做一次系统梳理。
一句话总结
Reasonix 1.x 的核心变化可以概括为：底层从 TypeScript/Node 切到 Go，代码智能从 Embedding 搜索切到内置 CodeGraph，产品形态从命令行 AI Agent 扩展为桌面端 + CLI + MCP/Skill/Subagent 的完整 AI 编程工作台。
旧版 v0.x 与新版 v1.x 的核心差异
| 维度 | v0.x 旧版 | v1.x 重构后 |
|---|---|---|
| 技术栈 | TypeScript / Node.js | Go，单静态二进制文件 |
| 运行依赖 | 依赖 Node / npm 环境 | 无需 Node，单个可执行文件即可运行 |
| 代码智能 | 偏 Embedding 语义搜索，可能依赖向量服务 | 内置 CodeGraph，基于 tree-sitter 的符号/调用图分析 |
| 开发分支 | 旧 TypeScript 线进入维护状态 | main-v2 成为默认活跃开发分支 |
| Agent 能力 | 能力相对分散 | 内置 tools、subagents、skills、hooks、MCP client、plan mode |
| 产品形态 | 更偏 CLI / Agent 工具 | CLI、桌面端、MCP、Skill、Subagent 协同的工作台 |
v1.0.0：Go 重写后的新起点
v1.0.0 是 Reasonix 1.x 的分水岭。官方明确说明，Reasonix 1.0 是一次从头开始的 Go 重写，并且默认分支切换到 main-v2。这意味着它不是 v0.x TypeScript 版本的渐进升级，而是一套围绕 Go kernel 重新设计的新代码库。
- Go 单二进制：告别 Node/npm 运行依赖，部署和分发更轻。
- CodeGraph 内置：用 tree-sitter 做符号与调用图分析，降低对外部 Embedding 服务的依赖。
- Agent Runtime 成型：内置工具、子代理、技能、Hooks、MCP Client 和 Plan Mode。
- 桌面端与 CLI 重构：为后续桌面工作台化和 CLI 专业化打下基础。
这一步最重要的价值，是把 Reasonix 从“依赖 Node 生态的 AI 工具”变成了“可独立分发、可跨平台运行、可持续扩展的本地 Agent 底座”。
v1.1.0：迁移适配与基础体验打磨
v1.1.0 的重点是让旧用户能平滑迁移，同时补齐新架构下的基础体验。
- v0.x 自动迁移：首次启动时自动迁移旧版配置、API Key、MCP 服务器和会话历史。
- 保留兼容入口：
reasonix code保留为reasonix chat的旧别名。 - 桌面端体验增强：支持文件拖拽到 Composer、关闭到系统托盘、Windows 标题栏融合等。
- MCP 启动分层：支持 lazy、background、eager 等 MCP 启动策略，提升启动和运行体验。
- CLI 增强：新增
--dir指定工作目录，主题持久化、Git 状态显示等也得到改进。 - 审批持久化：减少重复授权提示，让长任务更顺滑。
可以理解为，v1.1.0 是新架构上线后的“过渡桥”：既照顾 v0.x 老用户，也开始把桌面端、MCP、CLI 体验统一起来。
v1.2.0 / v1.2.1：性能、上下文与稳定性
v1.2.x 主要围绕性能和可靠性展开，尤其是长会话、上下文压缩、缓存诊断、流式传输和测试稳定性。
- Prompt Cache 诊断：新增 prompt-cache churn 前缀诊断，帮助定位缓存失效问题。
- 结构化经济压缩：Agent compaction 更可控，降低长会话成本。
- 历史与上下文缓存：
/history和/context增加 ETag 缓存。 - 桌面端工具增强：加入项目主题标签页、上下文检查器等能力。
- 渲染与网络稳定性：优化长文本渲染、SSE 保活、流中断恢复、请求缓冲池等细节。
- v1.2.1 小修：修复 Windows 更新覆盖当前安装、macOS 不启动系统托盘等问题。
这个阶段的关键词是“能跑更久、更稳、更省”。对于 AI 编程 Agent 来说，长会话稳定性和上下文压缩质量会直接影响真实项目可用性。
v1.3.0：桌面端工作台化与本地化增强
v1.3.0 是桌面端变化非常明显的一版，Reasonix 开始更像一个完整的 AI 编程工作台，而不只是一个 CLI Agent。
- 设置中心重构：恢复并整合完整配置 UI，支持字体选择与 CJK 优化预设。
- 历史与会话管理：重构历史、回收站、会话轮次操作和历史过程事件预览。
- 流式体验增强：加入流式状态指示器、启动动画、内联通知中心和 InlineDiff。
- 附件与媒体体验：支持媒体预览、图片附件去重、附件按真实文件类型分类。
- Agent 配置增强：Subagent 可单独配置模型与推理强度，工具调用耗时、bash 前台超时等也更透明。
- 中文与本地化：Web UI i18n、CJK 字体优化、中文文案补齐等体验更友好。
- MCP / Skill 生态：引入
install_sourcemeta tool，用于 MCP/Skill 安装，支持活动会话刷新已安装技能。
如果说 v1.2 是底层稳定性，那么 v1.3 就是产品体验的大升级，尤其适合需要长期在桌面端进行项目管理、AI 协作、代码修改和知识沉淀的用户。
v1.4.0：生产力、CLI 专业工具与跨平台打磨
v1.4.0 是目前最新的稳定版本，重点更偏高级用户工作流、桌面端生产力、CLI 专业命令、跨平台细节和发布流程。
- Composer 引用过往聊天：支持 past chats reference flow，在当前任务里引用历史对话。
- 命令面板可用：桌面端 ⌘K 命令面板正式接入，操作入口更集中。
- Git 工作流增强：Changes 面板加入分支切换器。
- 附件体验增强：外部文件拖拽变成附件卡片，并按真实文件类型识别。
- CLI 新增代码审核&查验：
reasonix review子命令让代码审阅成为独立工作流。 - 会话与沙盒：
--resume精确恢复指定会话，/sandbox status查看沙盒状态，/clear快速开启新上下文。 - 移动端/Termux 优化：修复手机键盘、聊天上下文移动等问题。
- 网络与模型：
web_fetch支持 SSRF 安全的 HTTP CONNECT / SOCKS5 代理隧道，MiniMax-M3 支持思考级别调整。 - 发布更成熟：加入 Canary 更新通道，macOS Developer ID 签名与公证，Windows 代码签名等发布级能力。
- Agent 可靠性：修复执行器交接角色混淆、减少证据验证误报，审批授权按规则复用。
v1.4.0 的整体感觉是：Reasonix 不再只是在“能跑”和“能用”层面打磨，而是在向“专业工作流”和“稳定生产环境”靠近。
相比重构前，最值得关注的 7 个变化
1. 部署成本降低
Go 单二进制让安装、升级、复制到服务器或移动端环境都更轻，特别适合 CLI 用户、自动化脚本和多平台使用者。
2. 代码理解方式升级
旧版偏 Embedding 搜索，新版内置 CodeGraph，用符号、调用关系和结构信息理解代码。对于大型项目，结构化代码图往往比单纯相似度搜索更适合做定位、分析和修改规划。
3. Agent 能力体系更完整
tools、subagents、skills、hooks、MCP client、plan mode 都进入核心能力范围，Reasonix 更像一个可编排的 Agent Runtime。
4. 桌面端从壳子变成工作台
设置中心、历史/回收站、上下文检查器、命令面板、附件卡片、Git 面板、媒体预览、实时 Markdown 渲染等能力，让桌面端更适合高频开发工作。
5. CLI 从聊天入口变成专业工具集
reasonix review、--resume、/sandbox status、/clear 等功能，让 Reasonix 更适合代码审核&查验、会话恢复、沙盒管理和自动化工作流。
6. 中文与跨平台体验明显增强
CJK 字体优化、Web UI i18n、Termux 修复、Windows/macOS/Linux 细节打磨，使它不再只是“能在本地跑”，而是逐步接近“每天可用”。
7. 发布流程更像成熟软件
Canary 通道、稳定版审批、macOS 公证、Windows 签名，说明项目开始重视正式分发和更新安全，而不仅仅是开发者自用工具。
适合谁关注？
- 正在寻找本地 AI 编程 Agent 的开发者；
- 希望减少 Embedding 服务依赖和 API 成本的团队；
- 喜欢 CLI，但也需要桌面端工作台的用户；
- 需要 MCP、Skill、Subagent 组合工作流的高级用户；
- 重视代码结构理解、长上下文、可恢复会话和本地部署的人。
结语
Reasonix 从 v0.x 到 v1.4.0 的演进，非常像一个 AI 编程工具从“实验性 Agent”走向“日常生产力工作台”的过程。Go 重写解决了运行与分发底座，CodeGraph 解决了代码理解方式，MCP/Skill/Subagent 打开了生态扩展空间，而桌面端和 CLI 的持续打磨，则让它逐渐具备真实项目里的长期使用价值。
如果你关注 AI 编程工具、代码智能、Agent Runtime 或本地化 AI 工作流，Reasonix 1.x 这条路线值得继续观察。
评论