docs: AGENTS/README HMR 说明改为 Vite 插件实时转换 + AI 使用日志

2026-09-12 22:53:24 +08:00
parent 82c435a9b2
commit 1e6d0838be
3 changed files with 4 additions and 3 deletions
@@ -84,8 +84,7 @@ npm run dev        # 打开 http://127.0.0.1:5173/
 ```

 - 开发访问 `http://127.0.0.1:5173/`；改 `frontend/src/*.ts`、`frontend/src/chat.css` 即时热更新。
- `npm run dev` 先由 `scripts/gen-dev-html.mjs` 从 `src/genesis/server/static/chat.html` 生成开发入口
-  `frontend/index.html`（不入库，勿手改）。
+- 开发入口由 Vite 插件在请求时**实时读取**规范页 `src/genesis/server/static/chat.html`（无中间文件）；改 `chat.html` 会整页刷新。
 - 发布/交付仍以 `npm run verify` 产出并入库 `chat.js`/`chat.css` 为准。

 ## 开发范式
@@ -153,7 +153,7 @@ npm test               # 纯逻辑单测（node --test，Node >= 23.6）

 ### 前端热更新（开发时）

-开两个终端：终端 1 `python scripts/serve.py --fake`（后端 API），终端 2 `cd frontend && npm run dev`（Vite dev server），浏览器打开 `http://127.0.0.1:5173/`——改 `frontend/src/*.ts` / `chat.css` 保存即热更新；`/api`、`/static` 自动代理到 `:8000`。开发入口 `frontend/index.html` 由脚本自动生成，勿手改。
+开两个终端：终端 1 `python scripts/serve.py --fake`（后端 API），终端 2 `cd frontend && npm run dev`（Vite dev server），浏览器打开 `http://127.0.0.1:5173/`——改 `frontend/src/*.ts` / `chat.css` 保存即热更新；`/api`、`/static` 自动代理到 `:8000`。开发入口由 Vite 插件实时读取规范页 `src/genesis/server/static/chat.html`，改它即整页刷新。

 - 访问 `http://127.0.0.1:8000/` 进入聊天页面；API 文档 `http://127.0.0.1:8000/docs`
 - 聊天页面支持：📎 上传要件定义/模板/规则/既有系统 zip、自然语言指令（`生成概要设计书` / `用中文生成` /
@@ -165,3 +165,5 @@
 | 2026-09-12 18:59 | 架构设计 | 前端热更新：新增 Vite dev server(HMR,代理 /api+/static 到 :8000)+vite.config.ts+gen-dev-html.mjs(由 chat.html 生成 dev 入口,不入库)；chat.css 迁入 frontend/src 由 main.ts 引入；esbuild 改 outdir 产出 chat.js/chat.css | frontend/vite.config.ts; frontend/scripts/gen-dev-html.mjs; frontend/src/chat.css; frontend/src/main.ts; frontend/esbuild.config.mjs; frontend/package.json; frontend/tsconfig.json; frontend/src/vite-env.d.ts; .gitignore; src/genesis/server/static/chat.css | deepseek-chat |
 | 2026-09-12 18:59 | 架构设计 | AGENTS.md 增服务启动(前后端同一服务)与前端热更新说明；README 增 HMR 开发说明 | AGENTS.md; README.md | deepseek-chat |
 | 2026-09-12 22:14 | 反馈迭代 | 修复侧边栏双滚动条与输入区被卷走：新增 .side-scroll 统一滚动容器(项目+其他会话共用); body/#main overflow:hidden + height:100vh、#chat min-height:0、#composer flex-shrink:0 锁定底部 | src/genesis/server/static/chat.html; frontend/src/chat.css; src/genesis/server/static/chat.css | deepseek-chat |
+| 2026-09-12 22:53 | 反馈迭代 | 根治 HTML/资源版本错配：app.py 改为每请求现读 chat.html+现算 mtime 版本(去启动缓存)；chat.css 布局双保险(.side-section flex:0 0 auto + #sidebar overflow-y:auto)；Vite 插件请求时实时转换规范 chat.html(删 gen-dev-html.mjs/index.html/predev)；新增 2 测试 | src/genesis/server/app.py; frontend/src/chat.css; src/genesis/server/static/chat.css; frontend/vite.config.ts; frontend/package.json; .gitignore; tests/test_server_api.py | deepseek-chat |
+| 2026-09-12 22:53 | 架构设计 | 文档同步：AGENTS/README 的 HMR 说明改为 Vite 插件实时转换(无中间产物) | AGENTS.md; README.md | deepseek-chat |