docs: define preferred debug port allocation

This commit is contained in:
QiuSW
2026-07-27 09:12:10 +08:00
parent 45ea8f3194
commit 3f382a431d
7 changed files with 51 additions and 6 deletions
+3
View File
@@ -17,6 +17,7 @@
| BR-013 | 用户可以刷新已保存实例的状态,并编辑未运行实例的名称、浏览器类型、user data dir 和启动 URL;刷新和编辑不得扩大到未授权的浏览器进程。 | P1 |
| BR-014 | 用户可以在完整代理地址下拉框中维护无认证代理,并在创建或编辑实例时选择代理;代理认证信息不得保存、记录或进入启动参数。 | P1 |
| BR-015 | GUI 实例主操作在 Chub 托管运行态提供优雅停止、在可启动状态提供启动;外部关联或未知外部实例不得获得生命周期控制。 | P1 |
| BR-016 | 每个已保存实例有独立、持久化的首选远程调试端口;它与运行时实际端口分离,未启动实例仍可在列表看到建议端口。 | P1 |
## 验收标准
@@ -28,6 +29,8 @@
- 关闭操作不会影响其他 Chrome/Edge 实例。
- 工具重启后,无法确认身份的外部进程只能报告 UNKNOWN,不得被关闭。
- 异常退出后状态在合理时间内变为 EXITED/FAILED。
- 新建实例从全局起始端口推荐一个未被其他 Chub 实例逻辑预留或实际使用的首选端口;启动优先使用它,并在后台复检 loopback 可用性与 CDP 端点。
- 外部端口冲突时只能回退到未被其他 Chub 实例预留的端口;成功验证后更新当前实例首选端口,失败或外部关联不得改写配置。
- 参数中不出现密码、Cookie、Token 或代理 userinfo。
- UI 覆盖加载、空、占用、启动失败、关闭中、成功和权限错误。
- 刷新仅检查 Chub 已保存的实例;任务执行中不可重复触发,过期结果不得覆盖已经删除或编辑后的记录。