干净独立工作目录

这是从原目录整理出的独立副本，后续开发、启动和构建请在本目录执行。

启动应用

start-local.bat

或：

npm.cmd run start:local

默认会同时启动本地认证服务、Vite 和 Electron。

npm.cmd run auth:local

管理后台是从遗失代码中恢复的原版纯静态页面，源码位于 admin-panel/；服务端代码位于 server/local-auth/。当前为了本地测试，认证服务会顺带托管 admin-panel/，之后可以把 admin-panel/ 单独部署到任意静态站点。

独立部署后台时，默认请求同域 /api。如果后台和认证服务不在同一个域名，可以通过 api 参数指定认证服务地址：

https://admin.example.com/?api=https://auth.example.com

本地测试也可以这样写：

http://127.0.0.1:3302/admin/?api=http://127.0.0.1:3302

npm.cmd run start:check

客户端安装包不包含本地认证服务和管理后台，只会连接你指定的认证服务地址。

npm.cmd run build:client:win -- --auth-url=https://auth.example.com

本地测试可以先只打包目录，速度更快：

npm.cmd run build:client:win -- --auth-url=http://127.0.0.1:3302 --dir

说明：

--auth-url 可以带或不带 /api，脚本会自动规范化。
打包时会把该地址注入客户端默认配置。
运行时仍可通过环境变量 AUTH_SERVER_URL 覆盖认证服务地址。
打包配置已排除 server/、admin-panel/、scripts/local-auth-server.cjs 和 local-auth-data/。

进入 http://127.0.0.1:3302/admin/ 后，在“系统配置”里填写：

aliyun_bailian_api_key：QwenTTS / DashScope API Key
aliyun_bailian_base_url：默认 https://dashscope.aliyuncs.com/compatible-mode/v1
其他 OSS、RunningHub、火山引擎、云美颜配置也可以在这里维护

这些配置会通过 /api/system/config/public 提供给本地应用作为兜底配置。

clean 目录就是后续入库的项目根目录；外层 aIzhinengti 只作为临时整理和参考目录。

源码放在 src/、electron/、server/、admin-panel/。
打包相关资源统一放在 packaging/。
大型本地依赖放在 packaging/vendor/，例如 Python runtime、FFmpeg、Playwright、模型、字体、BGM；这些内容默认不入库。
构建输出、运行数据和历史整理残留分别由 .gitignore 和 archive/ 隔离。

更完整说明见 docs/PROJECT_LAYOUT.md 和 packaging/README.md。