## 查看版本

AI Light 的版本和高级服务信息位于应用侧栏底部的“高级信息”区域。提交问题前，请先记录应用版本。

## 更新应用

当前版本采用手动安装包分发。取得新版本后，请按照对应发布说明更新。在线自动更新属于后续能力，当前手册不假设应用会自动下载或安装更新。

更新前建议：

- 退出正在运行的 AI Light；
- 保留自己的主题源文件；
- 阅读发布说明中的兼容性和平台提示。

## 卸载前先区分四件事

| 操作 | 影响 |
|---|---|
| 卸载 AI Light 应用 | 删除桌面程序本体 |
| 断开 Claude Code / Codex | 删除 AI Light 管理的工具 Hook |
| 卸载配套组件 | 删除用于工具接入的命令行组件 |
| 删除用户数据 | 删除设置、设备记忆、主题和运行信息 |

这些动作彼此独立。只卸载桌面应用，不代表已经清理 AI 编程工具中的接入配置或用户数据。

## 推荐卸载顺序

1. 在“接入”页面分别断开 Claude Code 和 Codex。
2. 从托盘菜单退出 AI Light。
3. 按操作系统正常方式卸载 AI Light 应用。
4. 如果不再使用任何 AI Light 接入，再卸载配套组件。
5. 只有在确认不需要设置和自定义主题后，才删除用户数据。

## 用户数据

AI Light 的共享用户数据默认位于：

```text
~/.ailight/
```

其中可能包含：

- 应用设置；
- 已记住设备的信息；
- 当前运行服务的本机信息；
- AI 编程工具配置备份和诊断数据。

用户主题存储位置可能受操作系统应用配置目录影响。需要迁移主题时，优先保留原始 `.ailight-theme.json` 文件，或从主题功能提供的导出入口操作（如果当前版本提供）。

删除整个用户数据目录会使设置和设备记忆无法恢复。操作前先退出 AI Light，并自行备份需要保留的内容。

## 隐私与网络边界

- AI Light 在本机处理任务状态和主题映射；
- 状态服务只监听本机回环地址，不向局域网公开；
- AI 编程工具通过本机配套组件向 AI Light 投递状态；
- 蓝牙用于 AI Light 应用和实体设备之间的通信；
- 首次安装或更新配套组件时，npm 可能需要访问软件源；
- 主题文件和本地设置保存在电脑上。

AI Light 处理的是状态事件，不应把完整任务内容作为普通状态字段发送。使用自定义接入时，应自行审查传入内容，避免包含密码、令牌或代码正文。

维护与数据管理