企业官网建设流程全解析

DeepSeek-Reasonix从0.x到1.0迁移指南：TypeScript旧版到Go重写的完整过渡

【免费下载链接】DeepSeek-ReasonixDeepSeek-native AI coding agent for your terminal. Engineered around prefix-cache stability — leave it running.项目地址: https://gitcode.com/GitHub_Trending/de/DeepSeek-Reasonix

DeepSeek-Reasonix 1.0是一次从零开始的Go 重写，它取代了早期的 0.x TypeScript 版本，成为终端里可以"挂着跑"的 AI 编程智能体。如果你还在使用旧版 TypeScript 构建，本迁移指南会用最短的路径带你完成过渡：一键安装 Go 版、自动导入旧配置与历史会话，并逐项确认哪些能力保留、哪些发生了变化——全程无需手工整理任何数据文件。

为什么要迁移：1.0 到底改了什么

"v1"（旧版 TypeScript）和"v2"（Go 重写版）代表的是代码库代际，而不是传统语义化版本：旧版从未发布过 1.0，所以 Go 重写版直接启用了1.x版本号。核心差异一览：

好消息是：npm 仍是主安装渠道，npm 包只是"安装器"，会拉取预编译的 Go 二进制文件（和 esbuild 的玩法一样），Node 不再是运行时依赖。

一键安装 1.0：npm、归档、源码三条路

最快配置方法——直接装官方 1.x：

npm i -g reasonix # 当前正式 1.x 版本 npm i -g reasonix@0.53.2 # 如需保留旧版，可固定到 0.x TypeScript 构建

npm 的latest标签已从 1.17.5 起切换到 Go 版本；旧的next、canary标签只是同一正式版本的兼容别名。旧版 0.x 依然可装，只是需要显式指定版本号。

除了 npm，还有两条独立渠道：

• 预编译归档：每个 release 附带reasonix-<os>-<arch>.tar.gz/.zip和桌面安装包。桌面安装与 npm CLI 互不干扰，shell 里的 0.53 和 1.x 桌面应用可以共存，不算冲突。
• 源码构建（需要 Go 1.25+）：

git clone https://gitcode.com/GitHub_Trending/de/DeepSeek-Reasonix cd DeepSeek-Reasonix && make build # 产物：bin/reasonix(.exe)

数据迁移：配置、凭据、历史会话全自动

这是本次迁移最省心的部分。从 v1.8.1 起，首次启动会自动执行一次非破坏性导入，无需任何 setup 模式：

1. 扫描旧配置路径（macOS 的~/Library/Application Support/reasonix/config.toml、Linux 的~/.config/reasonix/config.toml、~/.reasonix/reasonix.toml，以及 0.x 的~/.reasonix/config.json）；
2. 导入 API key、base URL、语言、MCP server 等配置，缺失的凭据迁入新 Reasonix home 的.env；
3. 导入历史会话，并依据旧版 sidecar 元数据把每条会话放回它原本所属的工作区，摘要沿用为标题；
4. 所有旧文件原样保留，导入完成后打印启动提示。

两个实用细节：

• 自动导入只在尚不存在新配置时运行。如果你先开了新版 CLI 才整理旧数据，新配置不会被覆盖，缺失值需手工补齐。
• 交互式会话里可随时补跑/migrate命令：它会再次扫描旧配置、凭据、记忆与会话，仅导入尚未导入的内容，绝不覆盖已有文件。若旧版会话存放在自定义 Windows 目录，可用/migrate --from "D:\OldReasonix"显式指定来源。看到unknown command时，说明当前版本不含该命令，先升级即可。

📌 注意：/migrate仅存在于 Go 构建中，旧版 0.x TypeScript 行内没有此命令。

配置文件变化：JSON 变 TOML，路径也统一了

新版采用统一的 Reasonix home 目录存放全局配置：

不确定 TOML 怎么写？仓库根目录提供了完整示例 reasonix.example.toml，全部路径细节见官方文档 CONFIG_PATHS.zh-CN.md。

哪些能力保留，哪些变了

原样保留（迁移后体验不变）：Agent 核心循环、read/write/edit/glob/grep/bash 工具集、子智能体（task、explore/research/review）、Skills、Hooks、Plan 模式、MCP 客户端，以及针对 DeepSeek前缀缓存优化的上下文设计——这正是"可以挂着跑"的关键。

主要变化：

• 代码智能：Go 版改用 LSP 辅助代码读取 + grep/read_file/glob 理解本地代码；旧版的语义搜索与 tree-sitter 符号索引尚未移植。
• Plan 模式增强：新增complete_step证据化步骤确认，Plan 与权限策略（Ask/Auto/YOLO + Sandbox）相互独立。
• MCP 大升级：服务器"添加即用"、stdio 连接持久化（有状态服务器不再丢会话）、项目身份与凭据轮换解耦。

• 界面推荐：Web Dashboard（reasonix serve）仍可用，但日常可视化优先选择桌面端；终端党继续用 CLI/TUI。
• 文件编码：UTF-8、UTF-16、GB18030 等编辑行为与旧版一致，编辑 GB18030 文件后磁盘上仍是 GB18030。

迁移完成后的验证清单

✅ 按这份清单快速确认迁移成功：

1. reasonix --version显示 1.x；
2. 历史面板里能看到导入的旧会话，--resume可正常恢复；
3. Provider 配置生效，能正常发起对话；
4. 记忆体系检查（Context Engine v2 自动升级，无需 re-index）：

/memory # 总览 /memory instructions # 常驻指令来源 /memory recall # 召回测试 /memory archived # 归档条目（可从 Context Center 恢复）

🎉 全部通过后，你的旧配置、凭据、记忆和历史会话就已经完整"搬家"完毕。遇到问题请按实际使用版本（v2= Go 版）提交 Issue，更多迁移细节可查阅 MIGRATING.zh-CN.md 与 CHANGELOG.md。

【免费下载链接】DeepSeek-ReasonixDeepSeek-native AI coding agent for your terminal. Engineered around prefix-cache stability — leave it running.项目地址: https://gitcode.com/GitHub_Trending/de/DeepSeek-Reasonix