# 隐私与偏好保存

## 插件保存什么

浏览器 localStorage 键 `dsh-model-shelf.preferences.v1` 保存：

- `version`：偏好格式版本。
- `uncommon`：用户手动移入不常用列表的 `(provider ID, model ID)`。
- `collapsed`：用户折叠的 `(列表类型, provider ID)`。
- `favorites`（1.1.0）：手动收藏的 `(provider ID, model ID)`，独立于主列表 / 不常用分类。
- `providerNotes`（1.1.0）：按服务商配置 ID 保存的账号备注，最多 120 字符；空备注不保存。

收藏和备注兼容已有 v1 数据：旧数据缺少新字段时，收藏和备注默认为空，原分类、折叠保持不变。备注只按用户输入显示，不自动读取账号身份；请勿输入密钥、密码或令牌。备注可能包含你输入的私人信息，因此也属于本地用户偏好，不会写入发布包、截图或 Git 提交。

不同服务商的相同模型 ID 会单独处理。目录暂时缺少某款模型时，不自动删除其分类偏好。

仅在新键不存在时，从早期本地原型的 `dsh-model-organizer.preferences.v1` 导入合法偏好，并尝试写入新键。旧键不删除，已有新偏好不覆盖。该迁移不会访问文件、API 密钥或其他站点存储。

## 不保存什么

本插件不保存 API 密钥、会话内容、模型调用次数、使用频率、Token 用量或账户余额，不做自动分类。

## 网络与宿主行为

插件不新增外部网络请求。模型目录加载、模型切换以及思考强度修改使用 DSH 原有接口。宿主或服务商可能有自己的网络请求、分析或日志策略；本插件不控制或取代这些策略。

## 保存范围

偏好属于当前浏览器、当前 origin（协议、域名和端口），不属于 DSH profile 配置文件。换设备、换浏览器或改变访问 origin 后不自动迁移。当前未实现跨设备同步；DSH 插件备份也不包含这份浏览器偏好。

## 重置与卸载

卸载插件不会主动清空偏好。若需单独重置，可在当前 DSH 页面的浏览器开发者工具中，删除 `dsh-model-shelf.preferences.v1`；若曾使用旧原型，也删除 `dsh-model-organizer.preferences.v1`，避免首次读取时再次导入旧偏好，然后刷新页面。不要为了重置本插件而清空全部站点数据，以免同时影响登录状态和其他插件。

## 公开演示素材

公开说明中的截图仅来自离线测试页面，全部目录数据为示例。真实 GUI 截图、安装前备份、生成的测试页面和本机配置均被排除在 Git 提交候选和 npm 包内容之外。