diff --git a/scripts/start-local.ps1 b/scripts/start-local.ps1
index 46df185b2..a61f19286 100644
--- a/scripts/start-local.ps1
+++ b/scripts/start-local.ps1
@@ -78,7 +78,9 @@ function Test-ListeningPort([int]$Port) {
     }
 }
 
-foreach ($port in @(3000, 8080)) {
+# 本项目本地开发端口为前端 7380 / 后端 7381（见 AGENTS.md「本项目附加约定」）。
+# 上游默认的 3000 / 8080 在同机上被其它工程占用，不能作为探测目标。
+foreach ($port in @(7380, 7381)) {
     if (Test-ListeningPort $port) {
         throw "端口 $port 已被占用，请先关闭占用进程后重试。"
     }