From 8cbc11e21ed8387fdc155e9fd0d72fec50142745 Mon Sep 17 00:00:00 2001
From: tongtongstudio <tongtongstudio@outlook.com>
Date: Sat, 10 Oct 2026 09:31:32 +0800
Subject: [PATCH] =?UTF-8?q?fix(scripts):=20=E6=9C=AC=E5=9C=B0=E5=90=AF?=
 =?UTF-8?q?=E5=8A=A8=20-=20=E7=AB=AF=E5=8F=A3=E5=8D=A0=E7=94=A8=E6=8E=A2?=
 =?UTF-8?q?=E6=B5=8B=E6=94=B9=E7=94=A8=207380/7381?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 scripts/start-local.ps1 | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

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 已被占用，请先关闭占用进程后重试。"
     }