feat: add preferred debug port planning

docs/tasks/T-309.md

@@ -3,7 +3,7 @@ id: T-309
 title: 实例首选调试端口与安全推荐分配
 phase: 3
 deps: [T-302, T-303, T-308]
-status: DOING
+status: DONE
 created: 2026-07-27
 owner: codex
 ---
@@ -33,7 +33,7 @@ owner: codex
 
 ## 执行记录
 
-- 状态：DOING
-- 变更：待实施。
-- 验证：待执行。
+- 状态：DONE
+- 变更：新增实例持久首选调试端口；配置恢复为旧记录按稳定顺序补齐端口并拒绝无效/重复端口。Gio 创建/编辑表单可查看或修改该值，列表以“建议 / 准备 / 实际 / 外部”表达端口语义；后台启动从实例首选端口开始，避开其他实例预留或正在使用的端口，成功回退后回写首选端口。HTML 原型同步该交互。
+- 验证：`gofmt -w cmd/chub/main.go cmd/chub/main_test.go internal/platform/config/store.go internal/platform/config/store_test.go internal/ui/shell.go internal/ui/shell_test.go`、`go test ./...`、`go test -race ./cmd/chub ./internal/ui`、`go vet ./...`、`go build -o build/chub.exe ./cmd/chub`、Node 内联脚本语法检查、`powershell -ExecutionPolicy Bypass -File scripts/smoke-windows.ps1` 通过。
 - 阻塞：无。