修正验证脚本的数量说法(是三个不是两个),改成指向文件头的用法说明, 以后加脚本不再过时。删掉指向仓库外 docs/adr 的引用:克隆者拿到的是 断链,工作区内有 AGENTS.md 指路。开发一节只留命令和「访问 5173 不是 7580」这个坑。
单页应用的兜底原本对任何找不到的路径都回 index.html,包括带扩展名的资源。 资源文件是带哈希的,每次打包换名字,浏览器缓存了旧 index.html 时会去请求一个已经 不存在的 .js,然后拿到一份 HTML,报出「MIME 类型不对」——一句完全指不到病根的错误。 现在带扩展名的路径找不到就回 404,index.html 也不再允许缓存。 另外 dev:all 一条命令同时起后端(--hot)和前端(Vite),省掉记两个终端和两个端口。
之前跑起来要记一串命令和路径,现在 bun run start 一条就够。 另外补了 dev:kernel 和 dev:reset,本地那套「写坏配置看它怎么救」的流程不用再手敲二进制路径。