DeepSeek-Reasonix连接VS Code：ACP编辑器集成的完整上手教程
【免费下载链接】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 是一款 DeepSeek 原生的 AI 编码智能体，围绕前缀缓存稳定性设计，专为终端而生。本文带你用最少的步骤完成 ACP 编辑器集成，把它接入 VS Code，让 AI 直接在你的编辑器里读文件、改代码、跑命令，全程可控、可撤销。
什么是 ACP？为什么它适合 VS Code 集成
ACP（Agent Client Protocol，智能体客户端协议）是编辑器与 AI 智能体之间的标准通信协议。简单理解：
- Reasonix 侧：执行
reasonix acp后，它以"标准输入/输出 + NDJSON JSON-RPC 2.0"的方式运行，成为一个标准 ACP agent； - 编辑器侧：VS Code 扩展负责启动这个进程、打开工作区会话，并把流式消息、工具活动、计划、权限请求回显在界面上。
也就是说，你不需要理解协议细节——协议层由扩展和 Reasonix 自动完成握手（initialize能力协商），你只管用。协议实现的核心代码在internal/acp/server.go、internal/acp/dispatch.go与internal/acp/protocol.go，完整的接入说明见 docs/ACP.zh-CN.md（本地文档，供进阶阅读）。
三步完成环境配置
✅第 1 步：安装 Reasonix 本体
Reasonix 是一个零依赖的静态 Go 二进制，一条命令装好：
npm i -g reasonix✅第 2 步：初始化 Provider
首次使用需要配置模型提供商（例如 DeepSeek 的 API Key）：
reasonix setup配置会写入reasonix.toml，官方提供了一个可参考的示例配置reasonix.example.toml，涵盖 provider、agent、工具与插件的声明式配置。
✅第 3 步：在 VS Code 中安装扩展
在 VS Code 扩展市场搜索扩展 IDSivanLiu.reasonix-agent并安装（VSCodium / Theia 用户可在 Open VSX 找到同名扩展）。该扩展不内置 CLI，而是直接启动你本机的reasonix acp后端——这也意味着它和终端、桌面端共享同一套本地引擎，行为完全一致。
安装后，在 VS Code 中打开任意项目，打开 Reasonix 聊天面板即可开始对话。
ACP 连接如何工作？
连接建立后，每个 ACP 会话都拥有独立的控制器、工作区根目录、模型、协作模式、审批模式和持久化历史，会话之间互不泄漏状态。你会在日常使用中体验到这些设计：
| 能力 | 说明 |
|---|---|
| 流式回显 | 思考过程、消息、工具调用状态实时流式展示 |
| 未保存 buffer 感知 | 编辑器当前未保存的改动也会被 Agent 正确读写，而不是操作磁盘上的旧副本 |
| 编辑器终端执行 | 前台命令可落在你编辑器持有的终端中执行 |
| 计划可见 | 任务执行前生成完整计划，供你确认后开始 |
| 会话持久化 | session/load可回放历史，session/resume可静默恢复 |
工具审批与权限控制：放心让它动手
权限是长时自治运行的底线。工具审批有ask、auto、yolo三档，通过配置项tool_approval切换，无需重启会话：
- ask（默认）：受控工具调用会弹出审批条，如上图所示，可"允许一次 / 本会话允许 / 拒绝"，命令内容一目了然；
- auto：常规操作自动放行，高风险操作仍询问；
- yolo：全自动，适合熟悉的沙箱环境。
配合协作模式（normal/plan/goal），在计划模式下 Agent 会先给出修改方案：
你可以选择"修改计划"、"开始执行"或"退出计划"，审批流程透明、随时可打断。
会话中还能做什么？
切换模型与推理强度
模型（provider/model）与推理强度（effort）同样是独立的配置轴，在会话中通过配置选项即可切换。切换时 Reasonix 会重建会话控制器但保留完整历史——这是前缀缓存友好的关键设计：稳定前缀不被破坏，长会话也不会"失忆"。
回合中引导（Steer）
Reasonix 提供了一个厂商扩展方法_reasonix.io/session/steer，允许你在 Agent 正在执行回合时插入一条新指令（比如"把用户名改成邮箱"），而不是干等当前回合结束。实现位于internal/acp/inbox.go。若当前回合无法立即接受，消息会持久化为后续跟进项，不会丢失。
MCP 与技能
会话同样支持挂载 MCP server（stdio / HTTP），技能与插件会以斜杠命令形式出现在命令列表中：
上下文面板
右侧"当前前文下文"面板实时展示 Token 用量、Cache Hit 比例、已读文件与已改动文件，配合docs/project-topic-tabs-context.png中的多项目标签页，长时运行的状态始终可见。
常见问题与排查
❓启动时提示尚未配置 provider？先运行reasonix setup。ACP 初始化响应中也会声明一个引导reasonix setup的终端认证方式。
❓想指定启动模型？使用reasonix acp --model deepseek-pro，--model仅在客户端未覆盖时生效。
❓看到奇怪的诊断信息？标准输出专用于 ACP 消息，诊断信息统一写入标准错误流，两者不应合并——正常通过扩展使用时无需关心这一点。
❓历史会话找不到了？持久化 ACP 历史是独立于终端/桌面端隔离保存的；session/close只释放资源不删历史，session/delete才会删除，操作前请确认。
❓同一引擎的其他入口？CLI/TUI、桌面端、浏览器（reasonix serve）与 VS Code 扩展共享同一套本地引擎与配置，任意入口产生的会话行为一致。
总结
- 一条命令安装：
npm i -g reasonix，零依赖静态二进制； - 一个扩展接入：
SivanLiu.reasonix-agent自动启动本机reasonix acp后端； - 三条控制轴：协作模式、模型/推理强度、工具审批相互独立、随时切换；
- 缓存友好：前缀稳定设计让你可以放心把会话"留着一直跑"。
如果你正在寻找一款能嵌入现有编辑器工作流、且为长时间自治运行而生的 AI 编码助手，DeepSeek-Reasonix 的 ACP 集成值得现在就试起来。
【免费下载链接】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
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
