设置项详解
本页是设置与偏好的逐项详解版，说明每个设置的作用、你会看到的选项，以及何时该改动它。用设置顶部的搜索框，可按名称直接跳到任意项。
设置存放在哪里。 少数设置属于本台电脑上的 Violoop 应用（不随设备走）。大多数属于设备——设备的配置是唯一权威来源，因此这些偏好会跟随设备到任何一台电脑。下面每一项都会注明它属于哪一类。
保存方式。 几乎所有设置在你改动的一瞬间就自动保存——一个小小的保存中 → 已保存指示会加以确认。少数需要点按钮才生效的例外会另行说明。
两个不同的代理——以及为什么有两个
这是最常见的困惑点，值得说清楚。Violoop 有两套相互独立的网络代理设置，因为有两台各自联网的机器：
- 你的电脑，运行着 Violoop 桌面应用。
- 你的设备，它有自己的网络（自己的 Wi-Fi），并发起自己的出站连接——去往 AI 供应商和 Violoop 云端。
它们在不同的地方配置，路由不同的流量。设置其中一个，对另一个毫无影响。
| 网络代理（应用） | 设备网络代理 | |
|---|---|---|
| 位置 | 设置 → 这台电脑 / 通用 | 设置 → 设备 |
| 谁的流量 | 桌面应用自身的出站连接（从这台电脑发出） | 设备的全部出站 HTTP/HTTPS——AI 供应商 API、云端，以及设备上运行的进程 |
| 存放于 | 这台电脑 | 设备 |
| 选项 | 关闭 / 手动 / 自动（跟随系统） | 启用开关 + 代理地址 |
网络代理（应用的代理）
位于这台电脑 / 通用。它控制桌面应用自身如何从你的电脑访问网络。三种模式：
- 关闭 — 应用的所有连接都直连，不走代理。
- 手动 — 你填写一个代理地址，例如
http://127.0.0.1:7890。按回车或点到别处时保存（半途输入的地址永远不会被保存）。 - 自动（系统） — 应用跟随操作系统配置的代理。检测到的系统代理会显示出来，方便你确认它将使用哪个；若未检测到，则直连。
环境变量覆盖。 如果设置了
VIOLOOP_HTTP_PROXY环境变量，它会覆盖此设置。此时应用会带警示地显示当前实际生效的代理，让「我的设置怎么没生效」的疑问自己就有了答案。
当桌面应用在受限网络中需要通过代理才能访问它自己的服务（更新、登录等）时，用这个。
设备网络代理
位于设备。一个简单的启用开关加一个代理地址输入框。启用后，它把设备的全部出站 HTTP/HTTPS 流量都经由该代理——包括对 AI 供应商 API、Violoop 云端的调用，以及设备启动的任何进程。它接受 http:// 或 https:// 地址，并自动保存。
当设备的联网必须经过代理时（例如企业网络，或你有意要把 AI 流量导向某个特定代理），用这个。
多数人两个都不需要，或只需要一个。当需要被路由的是 AI／云端 流量时，用设备代理；当是 桌面应用本身 出不去时，用应用代理。
这台电脑
针对本台电脑上 Violoop 应用的设置。这些不随设备走。
通用
- 助手语言 — 助手回复所用的语言，也是应用界面本身的语言。保持自动以跟随系统，或选一种固定语言。
- 浮岛显示器 — 若你有多块屏幕，悬浮状态浮岛显示在哪一块上。
- 网络代理 — 应用的出站代理。见上文两个不同的代理。
- 重新开始引导 — 重新运行首次设置向导。这会重置本台电脑上的本地设置（有确认提示）；它不会抹掉你设备上的数据。
运行时
应用执行某些任务所用的内置小组件的状态。每个都显示就绪 / 初始化中 / 失败 / 空闲、安装位置及任何报错。通常无需操作；若某个失败，你可以重新初始化它，或点刷新重新检查。该面板会自动轮询状态。
系统权限（仅 macOS）
Violoop 操作电脑所需的 macOS 隐私权限——辅助功能、自动化、屏幕录制，以及可选的完全磁盘访问。每一行都显示已授权/被拒状态及「必需或可选」标签，并有按钮用于授权或打开对应的系统设置面板。各项用途见操控你的电脑。在 Windows 和 Linux 上，此面板只会说明无需对应权限。
版本与更新
两个子区——PC 应用与设备固件——各自显示当前与最新版本、更新状态药丸、下载进度，以及更新说明链接。你可以检查更新、立即安装／更新，或忽略此版本。更新设备需要它处于连接状态。固件更新流程见连接与故障排查。
助手智能
关乎助手如何思考、能触及什么。这些存放在设备上。
模型
选择 AI 在哪里运行、用哪个模型：
- Violoop 云 — 最简单的方式。显示你的账户余额，并让你选择模型和推理强度（思考得多用力；越高越周全但越慢）。
- 自定义 — 用你自己的：为供应商添加 API 密钥、添加自定义模型，或使用本地模型（会自动检测你机器上运行的本地 Ollama）。
待定的模型选择只有在你点应用后才提交，因此你可以先排好改动，而不必在思考中途切换。
工具
助手可用的内置工具清单，每个都有开/关。你可以筛选「仅已启用」或「仅需确认」，每个工具都会显示它在运行前会、可能、从不，还是被禁止征询你。关掉某个工具即彻底移除该能力。
技能
助手习得的可复用技能，以卡片呈现。可逐个启用、停用或删除，搜索列表，并用打开文件夹查看存放位置。技能是助手对重复性任务的「操作手册」知识。
语音与语言
- 语音识别语言 — 你与 Violoop 对话时所用的语言（自动，或固定一种）。
- 文字转语音 — 标注为即将推出；尚未启用。
MCP 服务器
接入使用 Model Context Protocol 的外部工具服务器以扩展助手能力。可添加、编辑、启用或移除服务器；选择其传输方式（本地命令或 URL）；查看连接状态及它暴露的工具。推荐目录让你一键搜索并安装常用服务器。
插件
安装并管理为助手添加新能力和新入口的插件。每个插件都可启动或停止、开关、打开其自身设置、查看它请求的权限，以及查看状态（运行中／已安装／未安装）。
主动建议
控制 Violoop 是否主动出手相助：
- 启用 — 打开或关闭主动建议。
- 采样间隔 — 它多久观察一次当前状况（秒）。
- 触发阈值 — 它在开口前需要多有把握，从宽松（建议更多）到严格（只在高置信时）。
- 隐私控制 — 暂停/恢复引擎，选择加入或退出上传诊断数据，立即上传，或清除已收集的数据。状态读数显示引擎是否在运行、已处理了多少。
权限
位于设备设置 → 权限——控制助手在你电脑上可以做什么。这是与安全最相关的面板。它存放在设备上。
- 访问预设 — 一键设定合理基线的档位：安全、推荐或信任。
- 文件访问 — 助手到底能否读写文件（读与写各自独立）。
- 命令执行 — 运行终端命令是拒绝、总是先询问，还是允许。
- 路径沙箱 — 一个开关和一种模式（拒绝或询问），管辖白名单之外的文件访问，外加允许的目录清单本身。添加一个文件夹，文件工具便可在其中工作；未列出的位置对文件编辑一律不可见。这正是操控你的电脑中所说的白名单。
收紧这些，给 Violoop「拴短绳」；放宽它们，让它更少打扰地行动。
你的设备
针对硬件本身的设置。这些存放在设备上。
- Wi-Fi — 让设备连上无线网络以访问云端：扫描、选网、查看信号强度、输入密码（或手动输入隐藏的 SSID）。
- 时区 — 设备的时区，从可搜索的列表中选取；点应用生效。
- 音量 — 设备扬声器音量（0–100%）；松开滑块时生效。
- 代理（设备网络代理） — 设备的出站代理。见两个不同的代理。
- 安全 — 只读的信任信息：设备自身的公钥（它的信任锚）与在它这里登记的客户端设备清单。可复制，无可编辑项。
账户与备份
账户
你的个人资料卡（昵称、邮箱），含编辑资料（昵称、简介）、修改密码和退出登录。
备份与恢复
守护并迁移助手的数据与记忆：
- 备份到云端 — 把一切保存到云端；显示上次备份的时间。
- 从云端恢复 — 选择一个此前的备份来恢复。恢复会替换设备当前的数据。
- 导出／导入 — 把备份保存为本地文件，或再把它载入。
预算
- 不限额开关，或以美元计的每日消费上限。
- 今日花费相对上限的仪表、按供应商的细分，以及 7 天历史。
统计
只读的用量与性能分析——请求数与会话数、输入/输出令牌用量（含缓存）、延迟趋势，以及按模型的细分。无可配置项，仅供洞察。
高级
- 上下文压缩 — 对于很长的对话，助手会浓缩较早的上下文以留在限额之内。这里你可以查看每个会话相对其阈值的上下文占用、手动强制一次压缩，并导出会话记录（Markdown 或 JSONL）。
- 图标模型 — 管理为帮助助手识别屏幕内容而缓存的按应用小型视觉模型：查看缓存、按应用下载或重新获取，以及清除条目。
- Edge 状态 — 设备连接的诊断面板——连接/信令状态、设备的网络细节，以及一个重连按钮。
开发者模式。 连续点击设置底部的版本号七次，可解锁开发者模式，从而显示额外面板（例如系统提示词编辑器）。日常使用无需用到它——除非你确知需要，否则保持关闭。