README 启动示例仍推荐 --port 8765，与 WorkBuddy Copilot 端口冲突 已关闭
t-20260714-e17685 · Bug · 创建于 2026-07-14 03:17:20 · macOS 15
问题描述
README「启动」小节的示例命令是 scripts/studio_web.py --port 8765 --open。但默认端口已经因为与 WorkBuddy Copilot 冲突改为系统自动分配（见工单 t-20260713-6317d1 与提交 29440fd），示例却仍引导用户手动绑回 8765，照抄示例会把冲突问题原样复现。期望：示例改用一个不冲突的端口（或直接演示默认的自动分配行为），并顺带说明 8765 已被其他常驻服务占用的背景。
分诊结论
结论：accept
- 已核实 README.md 第9行示例仍为 `--port 8765`，与 t-20260713-6317d1/提交 29440fd 中已改为系统自动分配端口的决策矛盾
- 问题描述具体、可复现（照抄示例即复现端口冲突），且给出了明确的期望行为（换用不冲突端口或演示自动分配）
修复摘要
README.md「启动」示例和 docs/agent-prerequisites.md 验证流程示例都改为不再硬编码 --port 8765，改用默认自动分配端口并注明 8765 已被 WorkBuddy Copilot 占用；README 额外给出需要固定端口时的替代示例（--port 8899）。
改动文件：
README.mddocs/agent-prerequisites.md
合并提交 dbfbe5dc1c3683891933fa2f802c6a4c7a16a97a
代码 diff（vibeloop/t-20260714-e17685 vs 主线）
diff --git a/README.md b/README.md
index a9c2625..a5684e8 100644
--- a/README.md
+++ b/README.md
@@ -6,7 +6,8 @@
```bash
scripts/studio_web.py --open
-# 或指定端口：scripts/studio_web.py --port 8765 --open
+# 默认端口 0 = 系统自动分配（8765 已被 WorkBuddy Copilot 占用，不要手动指定 8765）
+# 需要固定端口时可自行指定其他值，例如：scripts/studio_web.py --port 8899 --open
```
打开页面后拖入视频（或粘贴本机路径），系统自动完成：
diff --git a/docs/agent-prerequisites.md b/docs/agent-prerequisites.md
index 2ea586c..b040e98 100644
--- a/docs/agent-prerequisites.md
+++ b/docs/agent-prerequisites.md
@@ -50,7 +50,9 @@ scripts/run_tests.py
2. 启动 Studio 并导入测试视频（`samples/video/`，来源与规格见 `samples/manifests/video_samples.json`）：
```bash
-scripts/studio_web.py --port 8765
+scripts/studio_web.py
+# 默认端口 0 = 系统自动分配（8765 已被 WorkBuddy Copilot 占用，不要手动指定 8765）；
+# 实际监听地址会打印在启动日志里
# 导入可用 API：POST /api/projects/import-path {"path": "..."}
```
事件时间线
- 2026-07-14 03:17:20created
{"type":"bug","hasLogs":false} - 2026-07-14 03:17:44status
{"from":"received","to":"queued","detail":{"via":"triage"}} - 2026-07-14 03:17:44status
{"from":"queued","to":"fixing"} - 2026-07-14 03:18:41verify
{"ok":true,"steps":[{"name":"verify","ok":true,"required":true}]} - 2026-07-14 03:18:41status
{"from":"fixing","to":"awaiting_judge","detail":{"files":2}} - 2026-07-14 03:18:41status
{"from":"awaiting_judge","to":"judging"} - 2026-07-14 03:19:21judgeError
{"error":"exit 1","attempt":1} - 2026-07-14 03:19:21status
{"from":"judging","to":"awaiting_judge","detail":{"via":"retry"}} - 2026-07-14 03:19:31status
{"from":"awaiting_judge","to":"judging"} - 2026-07-14 03:20:08judgeError
{"error":"exit 1","attempt":2} - 2026-07-14 03:20:08status
{"from":"judging","to":"awaiting_human","detail":{"cardId":"d-20260714-e07054","reasons":["judge 连续失败，无法自动评估"]}} - 2026-07-14 03:25:50humanReview
{"cardId":"d-20260714-e07054","choiceId":"approve","note":"judge exit 1 为瞬时性 API 失败，复现运行 verdict=approve、suggestedTier=low。该批准对应的正是 low 档本应自动合并的路径。"} - 2026-07-14 03:25:50status
{"from":"awaiting_human","to":"approved","detail":{"via":"human"}} - 2026-07-14 03:25:50status
{"from":"approved","to":"merging"} - 2026-07-14 03:25:54merged
{"sha":"dbfbe5dc1c3683891933fa2f802c6a4c7a16a97a"} - 2026-07-14 03:25:54status
{"from":"merging","to":"merged","detail":{"sha":"dbfbe5dc1c3683891933fa2f802c6a4c7a16a97a"}} - 2026-07-14 03:25:56notified
{"mode":"webhook"} - 2026-07-14 03:25:56status
{"from":"merged","to":"awaiting_confirmation"} - 2026-07-14 03:28:05reporterConfirmed
{"note":"已核对 main 上的 README 与 agent-prerequisites：8765 示例已移除，替代示例与默认自动分配说明正确。修复有效。"} - 2026-07-14 03:28:05status
{"from":"awaiting_confirmation","to":"closed","detail":{"via":"reporterConfirmed"}}