资讯动态

DeepSeek-Reasonix连接VS Code:ACP编辑器集成的完整上手教程

发布时间:2026/8/29 12:54:09 来源:尧图企业网站定制
DeepSeek-Reasonix连接VS CodeACP编辑器集成的完整上手教程【免费下载链接】DeepSeek-ReasonixDeepSeek-native AI coding agent for your terminal. Engineered around prefix-cache stability — leave it running.项目地址: https://gitcode.com/GitHub_Trending/de/DeepSeek-ReasonixDeepSeek-Reasonix 是一款 DeepSeek 原生的 AI 编码智能体围绕前缀缓存稳定性设计专为终端而生。本文带你用最少的步骤完成 ACP 编辑器集成把它接入 VS Code让 AI 直接在你的编辑器里读文件、改代码、跑命令全程可控、可撤销。什么是 ACP为什么它适合 VS Code 集成ACPAgent 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 Keyreasonix 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 会重建会话控制器但保留完整历史——这是前缀缓存友好的关键设计稳定前缀不被破坏长会话也不会失忆。回合中引导SteerReasonix 提供了一个厂商扩展方法_reasonix.io/session/steer允许你在 Agent 正在执行回合时插入一条新指令比如把用户名改成邮箱而不是干等当前回合结束。实现位于internal/acp/inbox.go。若当前回合无法立即接受消息会持久化为后续跟进项不会丢失。MCP 与技能会话同样支持挂载 MCP serverstdio / 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),仅供参考

读完文章,也想定制专属网站?

尧图设计师 24 小时内与您沟通定制方案

免费获取报价