设置页按平台、账号状态和构建模式显示不同入口。找不到某项时，先确认当前系统、是否已登录，以及安装包是否包含该能力。名称以界面为准；下面使用的就是当前页面标题。
设置入口
| 设置页 | 主要用途 | 相关文档 |
|---|---|---|
| 账户 | 个人信息。只有带登录的构建、并且已经登录时才出现 | 安装、升级与数据迁移 |
| 通用设置 | 应用行为、网络代理、开发者选项、引导和诊断 | 故障排查 |
| 远程连接 | 配对手机、外网访问、按手机点电脑图标允许操作桌面 | 远程连接与移动端 |
| 外观 | 明暗模式、语言、主题、侧栏、指针和装饰 | 主题系统 |
| Agent配置 | 个性化、图片、扩展功能和运行时 | 上下文、工具与权限 |
| 模型配置 | 服务商、模型、默认项和思考档位 | 配置模型 |
| SSH 主机 | 登记远程主机，供添加远程项目 | 项目、工作区与会话 |
| Claw | IM 总开关、渠道、模型、日志和状态 | Astravia Claw |
| 消息推送 | Webhook 渠道和测试消息 | 配置消息推送 |
| 已归档 | 查看归档的项目和会话 | 项目、工作区与会话 |
| 快捷键 | 全局快捷键和快捷面板 | 见本页 |
| 应用快照 | macOS 快捷触发和系统权限 | 使用应用快照 |
| 应用环境 | 内置 Node.js、Python、Git 和镜像源 | 管理应用环境 |
| 知识库设置 | 后台加工、模型、重试和整理记录 | 使用知识库 |
| Astravia Vivi | 桌宠显示、窗口和气泡样式 | 使用桌宠 |
| 权限管理 | macOS 系统权限状态 | 安全与数据边界 |
| 更多选项 | 已安装插件提供的页面。插件自己的配置在各自页面里 | 使用能力 |
MCP 不在设置里。发现、安装和管理在侧栏 能力 → 连接器。
平台和构建差异
- 远程连接和 SSH 主机在 Windows、macOS、Linux 上都显示。
- 应用快照和 权限管理只在 macOS 显示。
- 账户需要登录。开源 serv-less 构建没有商业账户，这一页不会出现。
- 主题列表受构建开关和随应用打包的主题影响。
- 标有 BETA 的入口，字段和行为仍可能随版本变化。远程连接目前没有这个标记。
修改设置的通用方法
- 先在设置页改完并保存。不要把直接编辑内部 JSON 当作第一步。
- 改完模型、MCP、IM、Webhook、SSH 或远程连接后，做一次对应的测试连接或最小任务。
- 要迁移或诊断时，先停掉相关任务，再看配置与数据路径。
- 只复制不含密钥的结构。Token、Cookie、OAuth 状态、Webhook URL、配对二维码和连接码不要进项目或问题报告。
常见误区
| 现象 | 正确判断 |
|---|---|
| 系统终端的 Node、Python 或 Git 正常 | 不代表 Astravia 里的运行时或检测到的 Git 已就绪 |
| 输入了 API Key | 不代表该模型已能完成真实调用，需要单独验证 |
| 打开了插件权限 | 不代表插件代码处于安全沙箱，插件仍运行在 Desktop 界面进程里 |
| 创建了自动化 | 不代表错过的时间点会自动补跑 |
| 撤销了 IM 渠道 | 不代表第三方平台账号或本机所有状态都已删除 |
| 手机能看会话 | 不代表它一定能看到桌面。远程画面还要外网访问，以及这部手机旁边电脑图标的右下角是绿色对勾 |