# 设置参考

> 按当前设置页查找模型、远程连接、SSH 主机、外观、权限和集成配置。

Canonical page: /product/settings



设置页按平台、账号状态和构建模式显示不同入口。找不到某项时，先确认当前系统、是否已登录，以及安装包是否包含该能力。名称以界面为准；下面使用的就是当前页面标题。

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

| 设置页           | 主要用途                       | 相关文档                                                     |
| ------------- | -------------------------- | -------------------------------------------------------- |
| 账户            | 个人信息。只有带登录的构建、并且已经登录时才出现   | [安装、升级与数据迁移](/getting-started/installation-and-updates/) |
| 通用设置          | 应用行为、网络代理、开发者选项、引导和诊断      | [故障排查](/troubleshooting/)                                |
| 远程连接          | 配对手机、外网访问、按手机点电脑图标允许操作桌面   | [远程连接与移动端](/product/remote-control/)                     |
| 外观            | 明暗模式、语言、主题、侧栏、指针和装饰        | [主题系统](/themes/overview/)                                |
| Agent配置       | 个性化、图片、扩展功能和运行时            | [上下文、工具与权限](/core/context-tools-and-permissions/)        |
| 模型配置          | 服务商、模型、默认项和思考档位            | [配置模型](/product/models/)                                 |
| SSH 主机        | 登记远程主机，供添加远程项目             | [项目、工作区与会话](/core/workspaces-and-sessions/)              |
| Claw          | IM 总开关、渠道、模型、日志和状态         | [Astravia Claw](/product/claw/)                          |
| 消息推送          | Webhook 渠道和测试消息            | [配置消息推送](/product/webhook/)                              |
| 已归档           | 查看归档的项目和会话                 | [项目、工作区与会话](/core/workspaces-and-sessions/)              |
| 快捷键           | 全局快捷键和快捷面板                 | 见本页                                                      |
| 应用快照          | macOS 快捷触发和系统权限            | [使用应用快照](/product/app-snapshot/)                         |
| 应用环境          | 内置 Node.js、Python、Git 和镜像源 | [管理应用环境](/product/application-environment/)              |
| 知识库设置         | 后台加工、模型、重试和整理记录            | [使用知识库](/product/knowledge-base/)                        |
| Astravia Vivi | 桌宠显示、窗口和气泡样式               | [使用桌宠](/product/desktop-pet/)                            |
| 权限管理          | macOS 系统权限状态               | [安全与数据边界](/reference/security-and-data/)                 |
| 更多选项          | 已安装插件提供的页面。插件自己的配置在各自页面里   | [使用能力](/product/abilities/)                              |

MCP 不在设置里。发现、安装和管理在侧栏 **能力 → 连接器**。

## 平台和构建差异 [#平台和构建差异]

* **远程连接**和 **SSH 主机**在 Windows、macOS、Linux 上都显示。
* **应用快照**和 **权限管理**只在 macOS 显示。
* **账户**需要登录。开源 serv-less 构建没有商业账户，这一页不会出现。
* 主题列表受构建开关和随应用打包的主题影响。
* 标有 **BETA** 的入口，字段和行为仍可能随版本变化。远程连接目前没有这个标记。

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

1. 先在设置页改完并保存。不要把直接编辑内部 JSON 当作第一步。
2. 改完模型、MCP、IM、Webhook、SSH 或远程连接后，做一次对应的测试连接或最小任务。
3. 要迁移或诊断时，先停掉相关任务，再看[配置与数据路径](/reference/configuration-paths/)。
4. 只复制不含密钥的结构。Token、Cookie、OAuth 状态、Webhook URL、配对二维码和连接码不要进项目或问题报告。

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

| 现象                         | 正确判断                                         |
| -------------------------- | -------------------------------------------- |
| 系统终端的 Node、Python 或 Git 正常 | 不代表 Astravia 里的运行时或检测到的 Git 已就绪              |
| 输入了 API Key                | 不代表该模型已能完成真实调用，需要单独验证                        |
| 打开了插件权限                    | 不代表插件代码处于安全沙箱，插件仍运行在 Desktop 界面进程里           |
| 创建了自动化                     | 不代表错过的时间点会自动补跑                               |
| 撤销了 IM 渠道                  | 不代表第三方平台账号或本机所有状态都已删除                        |
| 手机能看会话                     | 不代表它一定能看到桌面。远程画面还要外网访问，以及这部手机旁边电脑图标的右下角是绿色对勾 |

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