fix: 避免统一本地端口冲突 (#38)

config/local-services.yml

@@ -10,4 +10,4 @@ admin:
 
 admin_ui:
   host: 127.0.0.1
-  port: 9527
+  port: 9528

docs/04-local-development-and-verification.md

@@ -2,8 +2,8 @@
 generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件)
 wiki_page: Local-Development-and-Verification
 wiki_url: https://git.ilapage.cn/OPC/chorus/wiki/Local-Development-and-Verification.-
-wiki_revision: 1116f18111a84af4a49eba47a749b02563c0ed3a
-synchronized_at: 2026-08-24T01:16:32Z
+wiki_revision: f960470de0bd38a3d894ecec03c9b387afc55f14
+synchronized_at: 2026-08-24T01:23:28Z
 <!-- gitea-wiki-mirror:end -->
 
 # 本地开发与验证
@@ -364,7 +364,7 @@ admin:
   settings_file: ../admin/config/settings.yml
 admin_ui:
   host: 127.0.0.1
-  port: 9527
+  port: 9528
 ```
 
 相对路径以 `local-services.yml` 所在目录为基准。配置严格拒绝未知字段、非 loopback Host、无效/重复端口、缺失文件或错误扩展名。`chorus-local-config` 读取 Admin settings 时只投影 `settings.application.host/port`，不会输出其他配置内容。Admin Host/Port 不在统一配置重复保存，避免两个事实源漂移。
@@ -379,6 +379,6 @@ scripts\stop-all.bat
 
 也可把另一份不含凭据的统一配置作为第一个参数，例如 `scripts\start-all.bat "D:\tools\chorus-services.yml"`。`start-all` 的顺序为 Portal → Admin API → Admin UI；Admin 被编译到 `%LOCALAPPDATA%\Chorus\all\bin`，Admin UI 复用已安装的锁定依赖。缺少 `admin-ui/node_modules` 时脚本停止并提示人工执行锁文件安装，不自动联网安装。
 
-状态和日志位于 `%LOCALAPPDATA%\Chorus\all`，Portal 继续使用 `%LOCALAPPDATA%\Chorus\dev`。`status-all` 区分 `managed running`、`stopped` 与 `unmanaged listener`。`stop-all` 只停止 PID 与可执行路径同时匹配的受管进程，不停止端口上的旧进程；若 9527 已由之前手工启动的 Admin UI 占用，先在原终端按 Ctrl+C 停止它，再执行 `start-all`。统一脚本不执行 migration、AutoMigrate、seed、账号创建或密码重置。
+状态和日志位于 `%LOCALAPPDATA%\Chorus\all`，Portal 继续使用 `%LOCALAPPDATA%\Chorus\dev`。`status-all` 区分 `managed running`、`stopped` 与 `unmanaged listener`。`stop-all` 只停止 PID 与可执行路径同时匹配的受管进程，不停止端口上的旧进程；若配置端口已被其他项目或手工进程占用，脚本会拒绝接管；修改统一配置选择空闲端口，或由该进程的所有者自行停止。默认使用 9528，避免与本机已有 9527 服务冲突。统一脚本不执行 migration、AutoMigrate、seed、账号创建或密码重置。
 
 生产仍不得运行 Vue 开发服务器。Admin UI 构建为静态文件，由反向代理与 Portal/Admin API 组合为单一外部 Host。