docs: define preferred debug port allocation

2026-07-27 09:12:10 +08:00
parent 45ea8f3194
commit 3f382a431d
7 changed files with 51 additions and 6 deletions
@@ -8,7 +8,7 @@
 | US-004 | 用户可以优雅关闭实例；无响应时在确认后强制终止。 | P0 |
 | US-005 | 用户可以重启指定实例，并确认旧实例已经退出。 | P0 |
 | US-006 | 用户可以通过 CLI/API 查询、启动和关闭实例。 | P1 |
-| US-007 | 用户可以看到实例关联的本地调试端口；同目录外部浏览器已启用调试时，Chub 只关联并展示状态。 | P1 |
+| US-007 | 用户可以看到实例的首选或实际本地调试端口；同目录外部浏览器已启用调试时，Chub 只关联并展示状态。 | P1 |
 | US-008 | 用户可以刷新已保存实例的运行状态，并通过对话框编辑非运行实例的基本配置而不影响其他浏览器。 | P1 |
 | US-009 | 用户可以在设置中通过完整代理地址下拉框维护无认证代理，并在新建或编辑实例时从下拉选择器选择代理。 | P1 |
 | US-010 | 用户可以通过实例行的同一主操作启动或优雅停止 Chub 托管的浏览器，而不会关闭外部浏览器。 | P1 |
@@ -30,7 +30,7 @@ CLI/API 返回稳定错误码和结构化数据；未知 PID、身份不匹配

 ### US-007 本地 CDP 与外部关联

-给定未占用的 user data dir，启动时从设置中的起始端口分配一个 loopback CDP 端口，并显示实际端口。给定同目录已由外部浏览器占用，只有 `DevToolsActivePort` 与 `/json/version` 可验证时才显示“外部已关联”；否则拒绝第二次启动。无论哪种外部状态，Chub 都不提供生命周期控制。
+给定未占用的 user data dir，实例先保存一个首选 loopback CDP 端口；新建时从设置中的起始端口推荐一个不与其他 Chub 实例预留或实际端口冲突的值。启动优先使用该端口，并在后台检查实际可用性；若仅外部端口冲突，跳过 Chub 预留端口后回退到下一个可验证端口并更新当前实例的首选端口。列表区分建议、准备、实际和外部端口。给定同目录已由外部浏览器占用，只有 `DevToolsActivePort` 与 `/json/version` 可验证时才显示“外部已关联”；否则拒绝第二次启动。无论哪种外部状态，Chub 都不提供生命周期控制。

 ### US-008 刷新与编辑实例