## 摘要 - 后端端口改为按运行环境解析：正式版仍为 36163，开发环境改用 36164，`AUTO_MAS_HTTP_PORT` 可覆盖；前端 Electron 拉起后端时注入同一端口，保证两侧始终对齐。 - 开发环境切换到独立的 Electron `userData` 目录（`frontend-dev`）。此前打包版 asar 内的 `name` 同为 `frontend`，两版共用同一个 Chromium profile 与 `requestSingleInstanceLock` 锁键，后启动的一方在窗口创建前就静默退出，端口冲突甚至来不及暴露。 - 渲染进程的后端端点收敛到 `src/utils/backendEndpoint.ts` 单一出口，清掉 `src/main.ts`、`services/websocket/connection.ts`、`utils/browserDevElectronAPI.ts`、`utils/sentry.ts` 里的硬编码地址；`mirrorService` 在开发环境不再采用云端 `mirror.json` 下发的端点，避免 ETag 刷新把开发版指回正式版后端。 - Vite dev server 加 `strictPort`，把「端口被占用时静默换端口、Electron 仍加载另一实例页面」改成显式失败；停止全部任务的全局快捷键在开发环境错开为 `Ctrl+Shift+Alt+N`，避免两版互抢这个系统级独占资源。正式版行为逐字不变：端口、`userData`、单实例锁、端点、快捷键均与改动前一致，`instance` 相关分支只在开发环境生效。 ## 验证已执行：`yarn lint`（0 error，1 个既有 `vue/no-v-html` warning）、`yarn typecheck`、`yarn build:main`、`yarn test`（18 文件 126 用例通过）、`vite build`（确认注入端口随 `AUTO_MAS_HTTP_PORT` 变化）。后端 `resolve_http_port` 的 7 条分支（生产/开发/环境变量覆盖/非法值回退）逐条实测通过。端口解析用例放在新增的 `tests/test_main_port.py`（4 passed, 3 subtests passed）。之所以单独成文件：`tests/test_main.py` 因 `app.services` 的既有循环导入（`app/services/__init__` → `app/core/ws` → `task_manager` → `app/task/MAA` → `UpdateMAA` → `from app.services import System`）无法被 pytest/unittest 收集，放进去的用例不会被执行。该循环导入与本 PR 无关，留待单独修复。实机验证（Windows 11，均为管理员权限启动）：**已安装的 v5.4.0 正式版（未修改）与本分支源码开发环境同时运行成功**。 | 项 | 正式版 v5.4.0 | 开发版（本分支） | | --- | --- | --- | | 后端端口 | 36163 | 36164 | | 前端实连 | `API基础URL: http://127.0.0.1:36163` | `API基础URL: http://127.0.0.1:36164` | | userData | `%APPDATA%rontend` | `%APPDATA%rontend-dev` | 两个 Electron 应用进程同时存在、窗口都正常显示，两边前端各连各的后端无串台。注意这一组的正式版是**未打本 PR 的已发布版本**，说明端口与单实例锁的冲突由开发侧单方面解决，用户无需升级即可生效。关于跨版本进程清理：已发布版本（v5.4.0）中确实存在全机范围的 `taskkill /f /im python.exe` 与 `*main.py*` 清理代码，但实测它位于「强制清理」与异常兜底分支，正常关窗不会走到——该安装目录的全部历史日志中 `开始强制清理所有相关进程` / `所有相关进程已清理` / `清理进程时出错` / `备用清理方法` 四个标志均为 0 次，六次正常退出都停在 `窗口关闭，执行最终清理`。本次实测关闭正式版后，开发环境后端仍然存活。故这是条件触发的风险而非必然行为；相关匹配范围已在当前 dev 上收窄到 appRoot。 ## 说明 - 开发环境端口分流复用既有的 `.env` 机制。为避免依赖这个未纳入版本库的文件，`yarn backend` 脚本显式传了 `AUTO_MAS_HTTP_PORT=36164`；否则新克隆（无 `.env`）下后端会绑 36163、而 `wait-on` 死等 36164，`wait-on` 默认无超时会静默永久挂起。 - 开发者已有的 `%APPDATA%\frontend` 数据（主题偏好、`app-config` 等）在切到 `frontend-dev` 后相当于重置一次，是一次性影响；正式版路径不变。 - 开发环境快捷键改为 `Ctrl+Shift+Alt+N` 属于产品取舍，如果更希望保留同一组合键、只把注册失败提示出来，我按你的意见调整。 - 此前 `res/version.json`(v5.5.0-beta.2) 与 `frontend/package.json`、`app/core/config.py`(v5.5.0-beta.1) 版本号不一致，版本一致性 CI 对所有 PR 都是红的。该遗漏已由 `d023c373` 直接在 dev 上补齐（提升到 beta.2 的三次提交都只动了 `res/version.json`），本分支已 rebase 到该提交之上。 Closes #438 Closes #448

希望区分生产环境和开发环境的前后端端口，可以同时启动 #438

Description

Activity

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions