# 开发热加载(保存即生效) 目标:在编辑器里改 `src/` 下的源码模块,保存后自动重新打包,浏览器里的脚本自动换成新版本, **不用复制粘贴、不用重装、不用刷新页面**。 ## 结构 `dev/` 只放「在浏览器里跑」的开发工具(HTTP 服务 + 薄加载器 + 真机测试), 构建与检查脚本在 `../scripts/`,运行器配置在 `../config/`。 | 文件 | 作用 | | --- | --- | | `../src/` | 业务脚本源码(拆成多个模块,改这里) | | `../scripts/build.mjs` | 用 esbuild 把 `src/` 打包成单文件 `.user.js`(产物写在仓库根,热加载链路无需改动) | | `../yun-xue-tang-assistant.user.js` | **构建产物**(不要手改,改 `src/` 后 `npm run build`) | | `serve.mjs` | 本地 HTTP 服务,向浏览器提供源码与版本哈希(127.0.0.1:8899) | | `dev-loader.user.js` | Tampermonkey 里的薄加载器,轮询版本、释放旧实例、注入新实例 | | `tests/` | 测试脚本(真机测试 + 终端面板纯函数测试,见下方「真机测试」) | | `../scripts/start-dev.cmd` | 双击启动服务 | | `../scripts/check.mjs` | `npm run check` 的实现:自动遍历 `runner/`、`dev/`、`scripts/`、`config/` 跑 `node --check`,同时检查 `.cmd` 必须是纯 ASCII + CRLF(cmd.exe 逐字节按代码页读批处理,中文和裸 LF 会让行偏移错位);新增模块不用再手改命令 | 原理:加载器每 1 秒请求 `/version`,发现哈希变化就调用旧实例暴露的 `window.__yunXueTangDispose()`(清定时器 / 监听器 / 面板),再把新源码以 `