docs: define proxy labels and default profiles

This commit is contained in:
QiuSW
2026-07-27 12:00:38 +08:00
parent eeb7950806
commit a8b7277dab
9 changed files with 58 additions and 6 deletions
+5
View File
@@ -16,6 +16,7 @@
| US-012 | 用户可以查看已验证运行实例的 CDP 页面目标标题、脱敏 URL 和类型,而不会向浏览器发送控制命令。 | P1 |
| US-013 | 用户可以从 Windows 通知区域快速显示 Chub、刷新已保存实例状态或明确退出应用,而不会在菜单中误操作浏览器实例。 | P1 |
| US-014 | 用户复制或升级 Chub 后,实例配置与程序一同保存在可执行文件目录;首次升级会安全带入旧 AppData 配置且不丢失已有新配置。 | P1 |
| US-015 | 用户可以用易读名称维护代理,并在实例列表快速确认每个实例使用的代理;新建实例会得到程序目录内独立的默认 User Data Dir。 | P1 |
## 验收场景
@@ -62,3 +63,7 @@ CLI/API 返回稳定错误码和结构化数据;未知 PID、身份不匹配
### US-014 便携配置迁移
给定用户从 `build\\chub.exe` 或已发布目录启动 Chub,配置读取和后续保存均使用同级 `config.json`,不受启动脚本或当前工作目录影响。给定目标配置不存在且旧 `%APPDATA%\\chub\\config.json` 合法,Chub 校验旧配置并原子写入目标,旧文件作为恢复备份保留。给定目标配置已存在,Chub 只读取目标,不覆盖、合并或删除它。给定目标目录不可写或旧配置畸形,Chub 不创建新文件、不丢失旧文件,显示可恢复的配置诊断;不得静默切回 AppData 造成后续配置分叉。
### US-015 代理名称与独立默认目录
给定用户在设置中选择已有代理,Chub 回填代理名称和完整无认证地址;用户保存时必须同时通过名称必填/不区分大小写唯一和地址格式/重复校验。给定已有实例选择该代理,用户修改其名称或地址后,实例保留相同 `proxyId`,列表立即显示最新名称,后续启动使用最新地址,已运行浏览器不被修改。给定用户打开新建实例表单,Chub 先分配稳定实例 ID,再填入实际 `chub.exe` 同级 `user_data_dirs\\<实例 ID>`;每次新建得到不同子目录。目录不可写或被用户改为空/非法路径时,保留表单输入并提供可恢复提示,不创建目录、不回退到当前工作目录,也不影响已有实例。