设置详解#
设置窗口从聊天页右上角的齿轮按钮打开，左侧五项导航。
备注
设置改动即时生效，并同步到所有窗口。
常规设置#
选项 |
说明 |
|---|---|
界面语言 |
简体中文 / 繁體中文 / English / 日本語 |
主题配色 |
跟随系统 / 亮色 / 暗色 |
关闭时最小化到系统托盘 |
默认开启 |
「关闭时最小化到系统托盘」开启后，点关闭按钮不会退出程序， 主窗口隐藏到托盘，后台会话继续运行。托盘图标双击打开界面， 右键菜单可退出。
终端#
命令执行所用的终端。
选项 |
说明 |
|---|---|
命令行终端 |
自动探测本机可用终端，从中选择 |
输出编码 |
选定终端后自动探测，只读显示 |
Windows 上可选项通常为 CMD、Windows PowerShell、pwsh、Git Bash； 其他平台为 sh、bash、zsh。
小技巧
如果命令输出出现中文乱码，换一个终端再试。不同终端的默认输出编码不同。
搜索设置#
联网搜索工具的服务配置。
字段 |
说明 |
|---|---|
搜索服务 |
exa 或 perplexity |
API Key |
只保存在本机 |
接口地址（可选） |
覆盖默认端点，留空用默认 |
结果条数上限 |
1–20，默认 8 |
未配置 API Key 时，联网搜索工具对模型不可用。 留空保存等于清除搜索配置。
MCP#
管理 MCP server，让模型调用外部工具。面板位于设置窗口左侧导航的 MCP 项， 上方是 server 列表（每行显示状态点、工具数、启停开关与编辑 / 删除按钮）， 右上角是 添加 Server。
操作 |
说明 |
|---|---|
添加 Server |
右上角按钮，填内联表单 |
编辑 |
列表行内 编辑 |
删除 |
列表行内 删除，需确认 |
启停 |
列表行内开关 |
两种传输方式#
方式 |
需要填写 |
|---|---|
stdio（本地命令） |
启动命令、参数（每行一个）、环境变量（每行 |
HTTP（Streamable） |
服务地址、请求头（每行 |
状态说明#
状态 |
含义 |
|---|---|
就绪 |
连接成功，工具可用 |
连接中 |
正在建立连接 |
错误 |
连接失败，展开查看原因 |
停用 |
手动关闭 |
未连接 |
尚未启动 |
备注
已存在的 server 不能改名。需要重命名时，删除后重新添加。
ACP#
配置本应用与外部 agent 的互通。
选项 |
说明 |
|---|---|
关闭 |
使用内部模型对话（默认） |
ACP 客户端 |
把对话转发给外部 ACP agent |
ACP 服务器 |
允许本应用作为 ACP agent 被外部编辑器连接 |
选「ACP 客户端」时需填写 Agent 命令（可执行文件或 PATH 上的命令）、
启动参数（每行一个）与 环境变量（每行 KEY=VALUE）。
警告
ACP 客户端模式下，API Key 需在环境变量里显式配置，不会继承父进程。
选「ACP 服务器」时，在应用目录执行：
VIrobotics Harness.exe --acp
然后把该命令配置到外部编辑器作为 ACP agent。保存后对新启动生效。
主题与语言（模型管理窗口）#
模型 API 管理窗口右上角也有一组主题循环按钮和语言下拉，作用与设置窗口一致。