# 设置参考

> 按设置页入口查找模型、外观、权限、快捷键、环境、知识库和集成配置。

Canonical page: /product/settings



设置页按平台、账号状态和构建模式显示不同入口。找不到某项时，先确认当前系统、是否已登录以及是否使用了包含该能力的构建。

## 设置入口 [#设置入口]

| 设置页        | 主要用途                        | 相关文档                                          |
| ---------- | --------------------------- | --------------------------------------------- |
| 通用设置       | 应用行为、开发者选项、引导和诊断            | [故障排查](/troubleshooting/)                     |
| 远程连接       | Windows Desktop 手机配对和远程输入权限 | [远程连接与移动端](/product/remote-control/)          |
| 外观         | 明暗模式、语言、主题、侧栏和指针            | [主题系统](/themes/overview/)                     |
| Agent 配置   | 个性化、上下文和实验能力                | [核心工作流](/core/context-tools-and-permissions/) |
| 模型配置       | Provider、模型、默认项和思考档位        | [配置模型](/product/models/)                      |
| Claw       | IM 总开关、渠道、模型、日志和状态          | [Vetta Claw](/product/claw/)                  |
| 消息推送       | Webhook 渠道和测试消息             | [配置消息推送](/product/webhook/)                   |
| 已归档        | 查看归档的项目和会话                  | [项目、工作区与会话](/core/workspaces-and-sessions/)   |
| 快捷键        | 全局快捷键和快捷面板                  | 见下文                                           |
| 应用快照       | macOS 快捷触发和系统权限             | 见下文                                           |
| 应用环境       | 内置 Node.js、Python 和镜像源      | [管理应用环境](/product/application-environment/)   |
| 工具配置       | 已安装能力的运行配置                  | [使用能力](/product/abilities/)                   |
| 知识库设置      | 后台加工、模型、重试和整理记录             | [使用知识库](/product/knowledge-base/)             |
| Vetta Vivi | 桌宠显示、窗口和气泡样式                | [使用桌宠](/product/desktop-pet/)                 |
| 权限管理       | macOS 系统权限状态                | [安全与数据边界](/reference/security-and-data/)      |

MCP 的发现、安装和管理入口位于 **能力**，不需要在设置页寻找独立的 MCP 顶级标签。

## 平台和状态差异 [#平台和状态差异]

* **远程连接**当前只在 Windows Desktop 设置中显示。
* **应用快照**和部分**权限管理**只在 macOS 显示。
* **账户**需要登录；开源 serv-less 构建不包含商业账户能力。
* **主题选择**可能受构建开关和已随应用打包的主题影响。
* 标有 **BETA** 或实验性质的入口，其字段和行为可能随版本变化。

## 修改设置的通用方法 [#修改设置的通用方法]

1. 先在设置页完成修改并保存，不要直接编辑内部 JSON 作为第一选择。
2. 修改模型、MCP、IM、Webhook 或权限后执行对应的测试连接或最小任务。
3. 需要迁移或诊断时，先停止相关任务，再阅读[配置与数据路径](/reference/configuration-paths/)。
4. 只复制不含密钥的配置结构；Token、Cookie、OAuth 状态和 Webhook URL 不应进入项目或问题报告。

## 常见误区 [#常见误区]

| 现象                   | 正确判断                                        |
| -------------------- | ------------------------------------------- |
| 系统终端的 Node/Python 正常 | 不代表 Vetta 内置运行时已就绪                          |
| 输入了 API Key          | 不代表该模型已能完成真实调用，需要单独验证                       |
| 打开了插件权限              | 不代表插件代码处于安全沙箱，插件仍运行在 Desktop renderer realm |
| 创建了自动化               | 不代表错过的时间点会自动补跑                              |
| 撤销了 IM 渠道            | 不代表第三方平台账号或本机所有状态都已删除                       |

<Callout title="设置入口不是跨版本 API" type="info">
  设置名称、可见性和表单字段属于用户界面。脚本和集成应优先使用公开 SDK、RPC、CLI 或明确承诺的配置字段，不要依赖未公开的 DOM、内部路径或菜单顺序。
</Callout>
