docs: define portable directory defaults
This commit is contained in:
@@ -24,6 +24,7 @@
|
||||
| BR-020 | 用户可为无认证代理维护必填、唯一的代理名称;新建实例默认使用实际 `chub.exe` 同级 `user_data_dirs\\<稳定实例 ID>`,实例列表在用户数据目录与调试端口之间显示代理名称。 | P1 |
|
||||
| BR-021 | 设置中的 Chrome 与 Edge 可执行文件路径必须支持 Windows 原生 `.exe` 文件选择;标准安装路径搜索必须在对应字段旁可感知地报告搜索、取消、确认当前路径、更新路径或失败,且不丢失已有输入。 | P1 |
|
||||
| BR-022 | 删除实例确认框默认只删除 Chub 实例配置;用户可显式、默认未勾选地选择同时删除该实例的 User Data Dir。数据删除必须在后台重新确认目标目录未被 Chub 或外部浏览器占用,并通过绝对路径、非卷根及非链接边界校验;失败时保留实例配置和目录。 | P1 |
|
||||
| BR-023 | 默认 User Data Dir 与日志目录以实际 `chub.exe` 所在的程序目录为基准,分别解析为 `user_data_dirs` 与 `logs`;新建实例名称必须唯一,且默认 profile 子目录须由安全化名称与稳定 ID 组成。 | P1 |
|
||||
|
||||
## 验收标准
|
||||
|
||||
@@ -55,6 +56,9 @@
|
||||
- 默认配置路径必须由实际可执行文件路径解析,而非当前工作目录;迁移只在新位置不存在且旧配置存在、可读取、可校验时执行。迁移使用现有原子写入并保留旧配置恢复备份;目标目录不可写或旧配置畸形时,不创建半成品配置、不静默回退或混合两个配置来源,并给出可恢复诊断。
|
||||
- 设置页的 Chrome/Edge“选择”必须打开仅允许现有 `.exe` 的 Windows 原生文件选择器;取消、选择失败或不合规结果必须保留原输入。搜索标准安装路径时,结果即使与当前路径相同,也必须在同一字段旁明确表示“已确认当前路径可用”;搜索、取消、成功和失败不得依赖页面下方的全局反馈。
|
||||
- 删除实例确认框默认不删除 User Data Dir。只有用户勾选“同时删除 User Data Dir 中的数据”并再次点击具体的“删除实例及数据”后,才允许删除该目录;对运行中、启动/停止中、外部关联、外部占用或未知占用实例,数据删除选项禁用并说明需先停止/刷新。后台须在实际删除前重新检查 Chub registry 与外部占用,拒绝相对路径、卷根、普通文件和符号链接/重解析点。数据删除成功后才移除实例配置;检查、占用或删除失败时实例配置和目录均保留,并给出可恢复提示。
|
||||
- “程序目录”始终指实际 `chub.exe` 的父目录,不能使用快捷方式、终端或服务改变的当前工作目录。设置页默认以“跟随程序目录”模式展示 `<exe-dir>\\user_data_dirs` 与 `<exe-dir>\\logs`;用户选择自定义绝对目录后仅影响后续新建实例或后续日志写入,已有实例目录绝不自动移动。旧配置中的空值或历史内置默认迁移为跟随程序目录,其他非空值保留为自定义目录。
|
||||
- 创建和编辑实例均要求名称去首尾空白后在 Windows 不区分大小写语义下唯一;重复名称在名称字段旁提示“实例名称已存在,请更换”,不清除输入。创建时默认目录为 `<default-user-data-dir>\\instance-<安全化名称>-<短稳定 ID>`;安全化必须拒绝或替换 Windows 非法字符、保留设备名、尾部空格/句点和路径过长,安全化后冲突也必须拒绝。实例改名不得重命名、复制或删除既有 User Data Dir。
|
||||
- 浏览器启动前必须在后台创建并验证目标 User Data Dir 的可写性;目录创建、权限、路径或长度失败时不得启动浏览器,并给出不含敏感信息的可恢复错误。日志目录同样在后台验证;无法写入时保留设置输入并提示用户改为可写目录,不能静默改用当前工作目录或泄露代理、Cookie、Token。
|
||||
|
||||
## 不做
|
||||
|
||||
|
||||
Reference in New Issue
Block a user