# 客户端设置
> 桌面客户端设置页：查看客户端与网页资源版本、检查并执行更新，以及管理本机外观设置。

## 1. 页面信息

- 网页地址：https://9kvr.cn/app/setting
- 所属模块：客户端
- 页面用途：桌面客户端的设置页，仅在客户端运行环境生效，可查看客户端与网页资源的版本、检查并执行更新，以及管理保存在本机的个性化设置（如应用背景图）。
- 适用用户：桌面客户端用户
- 访问条件：公开访问（仅桌面客户端内生效）

## 2. 功能说明

- 仅在桌面客户端内可用，网页环境会回到首页
- 展示安装器版本、当前渲染版本、最新版本与最近检查时间
- 版本状态提示与「检查更新 / 下载并安装更新」操作
- 设置应用背景图（选择、移除、恢复默认）与背景透明度

## 3. 业务说明

### 适用场景

仅在桌面客户端内可用，供用户查看客户端版本、检查并安装更新，以及设置保存在本机的外观（应用背景图与透明度）。

### 版本管理

分别展示「安装器版本（客户端本体）」与「渲染版本（网页资源热更新）」，两者独立显示；检查到更新后可下载并安装，安装器更新需退出应用安装，渲染资源更新需重启应用生效。

### 外观设置

可选择本机图片作为应用背景、调整背景透明度、移除背景或恢复默认；相关设置保存在本机目录（如 ~/.9kvr/assent/），不上传服务器。

## 4. 使用说明

1. 在桌面客户端内打开设置页
2. 查看版本信息并检查更新
3. 按需设置应用背景图与背景透明度

## 5. 规则与限制

- 相关设置保存在本机，仅客户端环境可用

## 6. 状态与异常

- 未检查 / 已是最新 / 发现更新三种版本状态
- 下载中展示进度；背景图未设置、已启用或预览解析失败等状态
- 在网页环境打开时会回到首页；版本检查或背景设置失败时给出提示

## 7. 相关文档

- [静态编译测试页](https://9kvr.cn/site/app/demo.md)
- 上级目录索引：[/app](https://9kvr.cn/site/app/llms.txt)

## 8. 文档信息

- 事实来源：芊云全景官网页面核验
- 文档构建时间：2026-10-20 19:04:23
- 数据获取/快照时间：不适用（静态产品知识）
- 可信状态：已核验