设置页按平台、账号状态和构建模式显示不同入口。找不到某项时，先确认当前系统、是否已登录以及是否使用了包含该能力的构建。
设置入口
| 设置页 | 主要用途 | 相关文档 |
|---|---|---|
| 通用设置 | 应用行为、开发者选项、引导和诊断 | 故障排查 |
| 远程连接 | Windows Desktop 手机配对和远程输入权限 | 远程连接与移动端 |
| 外观 | 明暗模式、语言、主题、侧栏和指针 | 主题系统 |
| Agent 配置 | 个性化、上下文和实验能力 | 核心工作流 |
| 模型配置 | Provider、模型、默认项和思考档位 | 配置模型 |
| Claw | IM 总开关、渠道、模型、日志和状态 | Vetta Claw |
| 消息推送 | Webhook 渠道和测试消息 | 配置消息推送 |
| 已归档 | 查看归档的项目和会话 | 项目、工作区与会话 |
| 快捷键 | 全局快捷键和快捷面板 | 见下文 |
| 应用快照 | macOS 快捷触发和系统权限 | 见下文 |
| 应用环境 | 内置 Node.js、Python 和镜像源 | 管理应用环境 |
| 工具配置 | 已安装能力的运行配置 | 使用能力 |
| 知识库设置 | 后台加工、模型、重试和整理记录 | 使用知识库 |
| Vetta Vivi | 桌宠显示、窗口和气泡样式 | 使用桌宠 |
| 权限管理 | macOS 系统权限状态 | 安全与数据边界 |
MCP 的发现、安装和管理入口位于 能力，不需要在设置页寻找独立的 MCP 顶级标签。
平台和状态差异
- 远程连接当前只在 Windows Desktop 设置中显示。
- 应用快照和部分权限管理只在 macOS 显示。
- 账户需要登录；开源 serv-less 构建不包含商业账户能力。
- 主题选择可能受构建开关和已随应用打包的主题影响。
- 标有 BETA 或实验性质的入口，其字段和行为可能随版本变化。
修改设置的通用方法
- 先在设置页完成修改并保存，不要直接编辑内部 JSON 作为第一选择。
- 修改模型、MCP、IM、Webhook 或权限后执行对应的测试连接或最小任务。
- 需要迁移或诊断时，先停止相关任务，再阅读配置与数据路径。
- 只复制不含密钥的配置结构；Token、Cookie、OAuth 状态和 Webhook URL 不应进入项目或问题报告。
常见误区
| 现象 | 正确判断 |
|---|---|
| 系统终端的 Node/Python 正常 | 不代表 Vetta 内置运行时已就绪 |
| 输入了 API Key | 不代表该模型已能完成真实调用，需要单独验证 |
| 打开了插件权限 | 不代表插件代码处于安全沙箱，插件仍运行在 Desktop renderer realm |
| 创建了自动化 | 不代表错过的时间点会自动补跑 |
| 撤销了 IM 渠道 | 不代表第三方平台账号或本机所有状态都已删除 |