WorkBuddy
9c26d4b7b2
chore(admin-web): 开发端口 3000 → 13520,并禁止端口静默漂移
本机长期并行运行三个项目(videoos / ai-callcenter / 本项目),3000 属最易被
抢用的端口之一。按用户决定改为 13520。
- admin-web/vite.config.ts:server.port 3000 → 13520
- 同处新增 strictPort: true。vite 默认在端口被占用时静默 +1 退到下一个可用端口,
结果是「文档写 13520、实际跑在 13521」且全程不报错 —— 与本项目反复处理的
「声明与兑现失联」同族。加上后端口被占用会直接失败。
- docs/STATUS.md「当前运行状态」同步为 13520。
- ui-tests/ui-document-baseline-contracts.mjs:新增端口一致性守卫。
端口写在两处(vite.config.ts 是权威,STATUS.md 给人照做),只改一处不会让任何
测试变红,却会让照文档操作的人打不开页面。守卫断言的是「两处一致」而非写死
13520 —— 允许改端口,允许的是「一起改」,不是「只改一处」。
两处解析均用「解析失败即失败」写法,避免正则匹配不到时断言退化成与 undefined
比较而失去意义(本项目踩过的守卫静默失效坑)。
用 assert.equal 而非 assert.match:match 失败会把整份 STATUS.md(3000+ 行)
打进报错,噪声会盖掉真正的不一致信息 —— 负向验证时实测确认。
- .gitignore:忽略 admin-web/vite.config.ts.timestamp-*.mjs。
vite 在 dev server 被强杀(未优雅退出)时遗留该配置临时文件,本机已多次出现。
未改动(有意):
- CORS 不受影响。CorsConfig 默认拒绝所有跨域是刻意设计,且注释已写明「管理端走
Vite 代理(同源)」—— dev 端口变化不产生跨域。
- infrastructure/docker-compose.prod.yml 的 127.0.0.1:3000:80 是生产 admin 容器
的发布端口,与开发服务器无关,未动。
- releases/v1.0.0-RC.* 内的 3000 为历史发布快照,属冻结记录,不改写。
验证
- UI 契约门控 14/14 全绿(含新增守卫);vue-tsc --noEmit EXIT=0。
- 负向验证:把 STATUS.md 改回 3000 → 守卫变红并精确报出
「管理后台端口不一致:STATUS.md=3000,vite.config.ts=13520」及行号;还原后复绿。
- 真实启停:dev server 实跑 http://localhost:13520/(HTTP 200),旧端口 3000 无监听。
- strictPort 负向验证:端口被占用时第二实例立即以
「Error: Port 13520 is already in use」退出,未漂移到 13521。
- vite build EXIT=0(19.35s)。
注:vite build 直接执行会失败,栈停在 emptyDir(dist) 且全部位于本机
node-safe-delete-shim(批量删除守卫)内,与本次改动无关;改用全新 outDir 复跑即
成功,据此排除「改动导致构建失败」。该现象此前无记录,已写入技能备查。
2026-09-18 19:36:07 +08:00
..
2026-09-18 16:37:47 +08:00
2026-09-09 22:05:00 +08:00
2026-09-16 14:37:44 +08:00
2026-09-14 11:44:02 +08:00
2026-09-09 22:05:00 +08:00
2026-09-09 22:05:00 +08:00
2026-09-16 14:37:44 +08:00
2026-09-13 22:09:15 +08:00
2026-09-17 23:25:31 +08:00
2026-09-16 14:37:44 +08:00
2026-09-09 22:05:00 +08:00
2026-09-09 22:05:00 +08:00
2026-09-09 22:05:00 +08:00
2026-09-09 22:05:00 +08:00
2026-09-09 22:05:00 +08:00
2026-09-09 22:05:00 +08:00
2026-09-18 16:37:47 +08:00
2026-09-09 22:05:00 +08:00
2026-09-18 16:37:47 +08:00
2026-09-09 22:05:00 +08:00
2026-09-09 22:05:00 +08:00
2026-09-15 22:29:26 +08:00
2026-09-09 22:05:00 +08:00
2026-09-09 22:05:00 +08:00
2026-09-09 22:05:00 +08:00
2026-09-09 22:05:00 +08:00
2026-09-09 22:05:00 +08:00
2026-09-09 22:05:00 +08:00
2026-09-10 10:58:43 +08:00
2026-09-09 22:05:00 +08:00
2026-09-09 22:05:00 +08:00
2026-09-16 14:37:44 +08:00
2026-09-09 22:05:00 +08:00
2026-09-09 22:05:00 +08:00
2026-09-16 14:37:44 +08:00
2026-09-09 22:05:00 +08:00
2026-09-09 22:05:00 +08:00
2026-09-14 10:01:41 +08:00
2026-09-09 22:05:00 +08:00
2026-09-09 22:05:00 +08:00
2026-09-14 10:01:41 +08:00
2026-09-09 22:05:00 +08:00
2026-09-09 22:05:00 +08:00
2026-09-16 12:54:39 +08:00
2026-09-09 22:05:00 +08:00
2026-09-16 15:11:38 +08:00
2026-09-16 15:11:38 +08:00
2026-09-09 22:05:00 +08:00
2026-09-16 16:42:48 +08:00
2026-09-16 16:42:48 +08:00
2026-09-16 21:00:52 +08:00
2026-09-09 22:05:00 +08:00
2026-09-16 21:00:52 +08:00
2026-09-09 22:05:00 +08:00
2026-09-09 22:05:00 +08:00
2026-09-16 21:50:56 +08:00
2026-09-09 22:05:00 +08:00
2026-09-09 22:05:00 +08:00
2026-09-16 23:01:13 +08:00
2026-09-09 22:05:00 +08:00
2026-09-09 22:05:00 +08:00
2026-09-17 00:01:53 +08:00
2026-09-09 22:05:00 +08:00
2026-09-17 01:25:12 +08:00
2026-09-09 22:05:00 +08:00
2026-09-09 22:05:00 +08:00
2026-09-17 14:02:00 +08:00
2026-09-09 22:05:00 +08:00
2026-09-17 15:07:52 +08:00
2026-09-09 22:05:00 +08:00
2026-09-09 22:05:00 +08:00
2026-09-17 16:47:10 +08:00
2026-09-09 22:05:00 +08:00
2026-09-17 20:42:09 +08:00
2026-09-09 22:05:00 +08:00
2026-09-09 22:05:00 +08:00
2026-09-17 21:07:25 +08:00
2026-09-09 22:05:00 +08:00
2026-09-09 22:05:00 +08:00
2026-09-17 22:25:10 +08:00
2026-09-09 22:05:00 +08:00
2026-09-09 22:05:00 +08:00
2026-09-17 23:25:31 +08:00
2026-09-09 22:05:00 +08:00
2026-09-09 22:05:00 +08:00
2026-09-18 10:12:34 +08:00
2026-09-09 22:05:00 +08:00
2026-09-09 22:05:00 +08:00
2026-09-18 11:00:08 +08:00
2026-09-09 22:05:00 +08:00
2026-09-09 22:05:00 +08:00
2026-09-18 11:49:18 +08:00
2026-09-18 13:50:19 +08:00
2026-09-09 22:05:00 +08:00
2026-09-09 22:05:00 +08:00
2026-09-09 22:05:00 +08:00
2026-09-09 22:05:00 +08:00
2026-09-09 22:05:00 +08:00
2026-09-18 19:36:07 +08:00
2026-09-09 22:05:00 +08:00
2026-09-16 14:37:44 +08:00
2026-09-16 14:37:44 +08:00
2026-09-16 12:54:39 +08:00
2026-09-16 14:37:44 +08:00
2026-09-09 22:05:00 +08:00
2026-09-09 22:05:00 +08:00
2026-09-16 14:37:44 +08:00
2026-09-16 14:37:44 +08:00
2026-09-16 14:37:44 +08:00
2026-09-16 14:37:44 +08:00
2026-09-16 14:37:44 +08:00
2026-09-17 22:21:31 +08:00
2026-09-16 14:37:44 +08:00
2026-09-16 14:37:44 +08:00
2026-09-16 14:37:44 +08:00
2026-09-18 16:40:09 +08:00
2026-09-09 22:05:00 +08:00
2026-09-11 09:07:41 +08:00