From 1e6d0838be1f7c6984f38ebcd64b026677e7e622 Mon Sep 17 00:00:00 2001 From: lhl Date: Sat, 12 Sep 2026 22:53:24 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20AGENTS/README=20HMR=20=E8=AF=B4?= =?UTF-8?q?=E6=98=8E=E6=94=B9=E4=B8=BA=20Vite=20=E6=8F=92=E4=BB=B6?= =?UTF-8?q?=E5=AE=9E=E6=97=B6=E8=BD=AC=E6=8D=A2=20+=20AI=20=E4=BD=BF?= =?UTF-8?q?=E7=94=A8=E6=97=A5=E5=BF=97?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- AGENTS.md | 3 +-- README.md | 2 +- _AI_USAGE_LOG.md | 2 ++ 3 files changed, 4 insertions(+), 3 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index f5e17fd..d051fcb 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -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` 为准。 ## 开发范式 diff --git a/README.md b/README.md index a3dd529..9364a37 100644 --- a/README.md +++ b/README.md @@ -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、自然语言指令（`生成概要设计书` / `用中文生成` / diff --git a/_AI_USAGE_LOG.md b/_AI_USAGE_LOG.md index eb03117..bf12b47 100644 --- a/_AI_USAGE_LOG.md +++ b/_AI_USAGE_LOG.md @@ -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 |