olares-settings

settings（Olares Settings UI 镜像）

**统一入口：**加载 ../olares-shared/SKILL.md，了解套件路由、活动配置文件选择、平台入口，以及身份验证继续/停止判断。仅在确实需要登录、切换配置文件、存储令牌或恢复身份验证时，才加载其中的身份验证参考。

当版本语义会影响任务时，加载共享的平台模型。使用 olares-cli settings <area> <verb> --help 查看语法。

适用场景

• 镜像 Settings UI 配置：用户、应用入口/环境/域名/策略、集成、VPN、网络、加速器、搜索索引、备份/还原、外观、视频和高级状态。
• 查看当前身份、Olares 版本、更新或 SSO 会话。
• 执行受支持的安装后配置写入。

思维模型：settings 涵盖 Olares Settings SPA 提供的配置——安装后逐应用配置、网状网络 / VPN、备份、账户和系统外观。生命周期与运行时由相邻技能负责。

快捷入口

任务	阅读	首条命令
查明此配置文件对应的身份及其版本	本文件	olares-cli settings me version -o json
查看或更改某个应用的配置	安装后应用配置	olares-cli settings apps get <app> -o json
查看是否绑定了云账户	集成账户	olares-cli settings integration accounts list -o json
列出此 Olares 上的用户	用户生命周期与密码处理	olares-cli settings users list -o json

动词索引

区域	动词 / 资源	触发时阅读
me	whoami、version、check-update、sso list	me version 用于回答其他技能携带的版本门槛问题
users	me、list、get、create、delete	用户生命周期和密码处理
apps	list/get、entrances、env、suspend/resume	安装后应用配置
apps（一个入口）	domain、policy、auth-level	每个入口的配置
vpn	devices、隐藏的 routes enable/disable、SSH、子路由（隐藏的 enable/disable）、ACL、public-domain-policy	VPN 和 ACL 决策
integration	account list/get/add/delete、cookie import/list/rm/validate	集成账户；Cookie 存储
backup	plans、snapshots、password	备份决策
appearance	get（整个页面）、language set、widget set、wallpaper list/set/style/upload/delete、layout reset	外观和壁纸
network	reverse-proxy、FRP、hosts-file、overlay gateway/app	Overlay 写入是异步的，针对单个应用的操作可能会重启应用；gateway master 和 reverse-proxy set 仅限 owner
gpu / compute	旧版 GPU 列表 / 加速器列表、unbind、set-type	具体使用哪个取决于版本：1.12.5 使用 gpu，1.12.6+ 使用 compute
video	config get	只读。这里没有可设置的内容
search	status、rebuild、dirs list/add/rm	有关索引覆盖范围，请参阅 olares-search
restore	plans list/check-url/create-from-snapshot/create-from-url/cancel	从这里开始恢复，但用于恢复的快照列在 backup 下
advanced	status、registries、images、system/user env	仅限管理员；env 写入动词为 env system set 和 env user set（没有“env update”），且都接受 --var KEY=VALUE，不接受位置参数 KEY=VALUE。其镜像列表是 olares-doctor 添加工作负载引用注释的对象

角色缓存 + 管理员 / 普通用户权限底线

• 角色分为 normal、admin 和 owner。当前配置文件会缓存其角色；没有缓存或角色发生变化时，以服务端为准。
• 管理员区域包括用户管理、加速器管理、高级机器状态以及特权 VPN / 网络读取操作。Overlay gateway master 的启用 / 禁用和 reverse-proxy set 仅限 owner。
• profile whoami、settings users me 和 settings me whoami 是等价的身份视图。不要将它们相互重定向，仿佛其中一个更具权威性。

版本和异步操作决策

• Olares 1.12.5 使用旧版 gpu list；1.12.6+ 使用 compute。
• Overlay gateway 和单个应用的 overlay 操作需要 1.12.6+。
• appearance widget set 和 appearance layout reset 需要 1.12.6+；appearance get 则会降级处理，并报告 widget 部分受版本限制。appearance language set 接受的 7 种语言中，有 5 种需要 1.12.7+。
• Overlay 写入是异步的。--watch 会观察 gateway / 应用状态直至稳定；通过 Market 更改单个应用的 overlay 时，可能会重启正在运行的应用。
• 搜索索引和重建是异步的。请求成功并不意味着新索引的内容会立即可搜索。

安全与升级处理

• 切勿在聊天或命令历史记录中暴露访问令牌、SSO 会话字段、初始密码、集成凭据、备份密码或 VPN 密钥。
• 从所选动词支持的标准输入或环境变量中读取密钥。
• 将请求的配置更改视为任务范围内的授权；对于该范围内的每次幂等写入，无需再次询问。
• 对具有破坏性或影响范围更广的操作另行确认：删除用户、替换 ACL、更改加速器绑定或类型、重启或停止应用、重建索引，以及更改网关范围的覆盖设置。
• 将应用生命周期请求视为 olares-market 的处理范围，而非设置配置。
• 因缺少登录信息而失败的下载或收集操作，在此处应作为 Cookie 导入（settings integration cookie）处理，而非 olares-knowledge 问题——请参阅 Cookie 存储。
• 没有主题相关动词：桌面端的浅色／深色状态是 SPA 从不向上游发送的 Cookie，因此 CLI 无法更改。请如实说明，不要继续寻找相关动词，也不要写入 OLARES_USER_THEME，因为没有任何程序会读取它。
• 如果请求的动词未注册、角色权限不足、目标用户／应用／设备不明确，或操作需要 CLI 无法执行的 JWS／设备交互，请停止操作。