Skip to content

fix: 增加本地启动前置检查 - #97

Merged
cnYui merged 2 commits into
mainfrom
codex/dev-startup-prereqs
Jun 3, 2026
Merged

cnYui merged 2 commits into
mainfrom
codex/dev-startup-prereqs

Conversation

@cnYui

@cnYui cnYui commented Jun 3, 2026

Copy link
Copy Markdown
Owner

背景

本地首次启动时容易把“准备开发环境”和“启动应用”混在一起。缺少 server/.venv、后端核心包、Electron 依赖或 renderer 构建产物时,旧入口会较晚失败,后端还可能回退系统 Python,容易误用 Conda 或系统环境。

改动

  • 新增 scripts/dev-prereqs.mjs,集中封装本地启动前置检查。
  • npm run server 启动前检查 server/.venv 和后端核心包,不再默认回退系统 Python。
  • npm start / npm run start:electron 启动前检查 Electron 依赖和 renderer dist/index.html
  • 新增 npm run doctor 只检查本地开发前置条件,不安装依赖。
  • 新增 scripts/dev-prereqs.test.mjs 覆盖缺 venv、半安装 venv、缺 Electron 和缺 renderer dist 的提示行为。
  • 更新 README、AGENTS 和 .gitignore

验证

  • node --test scripts/dev-prereqs.test.mjs:5/5 通过
  • node --check scripts/dev-prereqs.mjs; node --check scripts/start-server-dev.mjs; node --check scripts/start-electron-dev.mjs; node --check scripts/check-dev-prereqs.mjs:通过
  • npm run doctor:当前半安装 venv 下按设计失败,明确提示缺 fastapi, funasr, transformers,没有继续安装

风险

  • 当前改动不会解决首次安装后端依赖慢的问题,只把失败边界和提示前移。
  • 后续如果要优化首次准备耗时,需要单独拆分后端依赖或增加专门的 bootstrap 脚本。

@cnYui
cnYui merged commit 720b3a9 into main Jun 3, 2026
1 check passed
@cnYui
cnYui deleted the codex/dev-startup-prereqs branch June 3, 2026 07:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant