docs: define portable directory defaults

This commit is contained in:
QiuSW
2026-07-27 23:50:24 +08:00
parent cab7e6ac7b
commit 92091a6690
10 changed files with 70 additions and 9 deletions
+5
View File
@@ -19,6 +19,7 @@
| US-015 | 用户可以用易读名称维护代理,并在实例列表快速确认每个实例使用的代理;新建实例会得到程序目录内独立的默认 User Data Dir。 | P1 |
| US-016 | 用户可以从设置页选择 Chrome 或 Edge 的本机可执行文件,或搜索标准安装位置,并立即知道当前路径是否已确认或被更新。 | P1 |
| US-017 | 用户删除实例时默认只移除配置;在浏览器已停止且明确勾选后,可以同时删除该实例的 User Data Dir。 | P1 |
| US-018 | 用户可让新实例数据与日志默认跟随 chub.exe 所在目录,并通过唯一实例名称获得可读、独立且可写的默认 User Data Dir。 | P1 |
## 验收场景
@@ -77,3 +78,7 @@ CLI/API 返回稳定错误码和结构化数据;未知 PID、身份不匹配
### US-017 删除实例及 User Data Dir
给定用户点击实例删除图标,确认框默认只说明删除 Chub 配置,User Data Dir 保留。用户可以勾选默认未选中的“同时删除 User Data Dir 中的数据”;框内显示对象名称、目录路径和不可恢复提示,确认按钮变为“删除实例及数据”。仅当实例显示为“已退出”或“启动失败”时该选项可用;运行、启动/停止、外部关联、外部占用和未知占用状态明确提示先停止并刷新。确认后 Chub 在后台再次检查该目录的 Chub registry 与外部浏览器占用,并校验目录边界;删除成功才从列表和配置移除实例。用户取消、占用、目录边界、权限或 I/O 失败时,实例配置和 User Data Dir 都保持,用户可关闭浏览器、检查权限后重试。
### US-018 便携默认目录与唯一实例名称
给定用户在设置页保持“跟随程序目录”,新建实例时默认 User Data Dir 显示为实际 `chub.exe` 所在目录下的 `user_data_dirs\\instance-<安全化实例名>-<短ID>`,日志目录显示为同级 `logs`;快捷方式的工作目录不会影响二者。用户改选自定义目录后,只有之后新建实例与之后的日志写入受影响,已有 profile 不移动。提交新建或编辑实例时,名称去首尾空白并按 Windows 不区分大小写规则验证;若与其他实例重复,名称字段就地提示并保留输入。启动前后台创建并检查 profile 目录可写;若程序目录受保护或路径无效,浏览器不启动,用户可改选可写目录。