VS Code 扩展本身只是个壳，不带 Reasonix CLI——它起的是你本机的 reasonix acp 后端，然后做聊天面板、工作区会话、编辑器上下文、审批卡片这些活。如果你在终端里跑不通 reasonix --version，扩展也救不了你。
安装
- 打开「扩展」侧栏（
Ctrl+Shift+X），搜SivanLiu.reasonix-agent，点安装。VSCodium 和 Eclipse Theia 在 Open VSX Registry 装同一个。 - 打开一个项目目录。扩展会按工作区启动一个 ACP 后端；多根工作区每个根一个 client。
- 打开 Reasonix 活动栏视图，再
Reasonix: Open Settings，如果reasonix不在$PATH上就手动设 CLI 路径。留空 = 从$PATH自动找。 Reasonix: New Session开会话，挑模型，工具审批模式选 Ask / Auto / Yolo。第一次发消息时通常会弹确认框，问要不要附带编辑器上下文。- 用
@src/file.ts或@src/引用工作区里的文件，把有限的资源上下文带进去。/explain/fix/tests/search/mcp/skills这些斜杠命令和 TUI 里用法一致。
配置写法
两个文件：TOML 放非敏感配置，.env 放 key 字符串。解析顺序是 flag > ./reasonix.toml > ~/.reasonix/config.toml > 内置默认。
# 用 VS Code CLI 装扩展
code --install-extension SivanLiu.reasonix-agent
# 如果 npm 全局目录不在 $PATH 默认位置，要在扩展设置里手动指定
# (Settings → Extensions → Reasonix → Binary Path)
# "/home/you/.npm-global/bin/reasonix"
# 扩展实际执行的就是这条
reasonix acp --model deepseek-pro --profile delivery命令和设置
| 命令 | 作用 |
|---|---|
| Reasonix: Open Chat | 打开活动栏里的聊天面板，背后是 reasonix acp。 |
| Reasonix: New Session | 关掉当前工作区的 ACP client，起一个新会话。 |
| Reasonix: Send Selection | 把当前文件路径、语言、选区或光标附近内容作为一轮的上下文。 |
| Reasonix: Cancel Turn | 给当前 Reasonix 会话发 session/cancel。 |
| Reasonix: Pick Model | 基于 Reasonix ACP 的模型列表打开选单。 |
| Reasonix: Pick UI Language | 在 Auto / English / 简体中文 之间切聊天 UI 语言。 |
| Reasonix: Open Settings | 打开扩展内的设置视图（CLI 路径、模型、语言、上下文模式、自动启动、trace）。 |
| Reasonix: Show Output | 打开 Reasonix OutputChannel 看 ACP 诊断日志。 |
设置项
| 设置 | 作用 |
|---|---|
| reasonix.binaryPath | CLI 绝对路径。留空 = 从 $PATH 找 reasonix。 |
| reasonix.model | 传给 reasonix acp --model 的可选 provider/model。留空用配置里的默认。 |
| reasonix.uiLanguage | Auto / en / zh-CN。 |
| reasonix.autoStart | 打开聊天面板时自动起 ACP。 |
| reasonix.trace | 把 ACP JSON-RPC 流量写到 OutputChannel。仅调试时开。 |
| reasonix.includeSelectionMode | off / selectionOnly / nearby。控制提示词里要不要带编辑器上下文。 |
常见问题
- 提示
Reasonix CLI was not found—— 先装 Reasonix，要么把~/.npm-global/bin加进$PATH，要么在扩展设置里手动填reasonix.binaryPath。 - 聊天面板显示
Disconnected—— 开Reasonix: Show Output，十有八九是 ACP 进程因为 provider 没配好挂了。跑一遍reasonix setup。 Model list unavailable—— 老版本不暴露model/list扩展。升到 1.8.1+，或就用配置里的默认模型。- Diff 预览打不开 —— 部分改动没法安全预览（二进制文件、模糊替换）。审批卡片还是会显示工具原始输入，allow 之前自己看一遍。
- 编辑器上下文从来不出现在提示里 —— 检查
reasonix.includeSelectionMode没设成off，并且当前有选区。
评论