fix:完善项目目录

2026-07-29 22:28:42 +08:00
parent 344920fd5d
commit 43c530e915
4 changed files with 177 additions and 0 deletions
@@ -0,0 +1,24 @@
+---
+description: 杜康好客官网项目总览与改动边界
+alwaysApply: true
+---
+
+# 项目总览
+
+杜康好客品牌官网 / 发布会展项单页：「你请客，我买单」。无路由、无后端、无 UI 库。
+
+## 改哪里
+
+- 逻辑与文案：`src/App.tsx`
+- 视觉与布局：`src/App.css`
+- 根排版 / scroll-snap：`src/index.css`
+- 站点图：`public/assets/`（路径 `/assets/...`）
+- 更完整说明见根目录 `AGENTS.md`
+
+## 必须遵守
+
+- 保持技术栈精简；非必要不新增依赖、路由或状态库
+- 章节 `id` 须与 `sections`、`navItems`、DOM、展控 dots/panel 同步
+- `public/assets/pdf-ref/` 仅设计参考，勿挂进生产 UI
+- 保留合规文案（理性饮酒、无收益承诺、细则以政策为准、ICP）
+- 布局或章节改动后，同时验证普通浏览与 `?mode=stage`
@@ -0,0 +1,25 @@
+---
+description: 发布会展控模式（stage）行为与样式约定
+globs: src/App.tsx,src/App.css
+alwaysApply: false
+---
+
+# 展控模式
+
+## 入口与状态
+
+- URL：`?mode=stage` 或 `?mode=stage#sectionId`
+- DOM：`body.stage-mode`、`.site.is-stage`
+- 翻页依赖 `sections` 数组顺序与 `id`；改章节数或 id 时同步 stage 逻辑
+
+## 行为
+
+- 键盘：←/→、↑/↓、Space、PageUp/PageDown、Home/End
+- UI：圆点、可折叠面板、进度、可选自动播放
+- 展控下隐藏普通顶栏导航 / CTA 的行为勿随意破坏
+
+## 样式
+
+- 大量 `.is-stage …` 覆盖负责更密排版与展项布局
+- 普通模式改完后，必须用 `?mode=stage` 再验一遍各 LP
+- 本地自测：`http://localhost:5173/?mode=stage#hero`
@@ -0,0 +1,27 @@
+---
+description: 双主题视觉与 LP 章节结构约定
+globs: src/App.tsx,src/App.css,src/index.css
+alwaysApply: false
+---
+
+# UI 与章节
+
+## 双主题
+
+- `hero`～`system`：`.poetic-section`（宣纸/国风：`--paper`、`--ink`、`--red`、`--gold`）
+- `tech`～`contact`：`.tech-section`（深色科技：`--tech`、`--tech-card`、`--tech-line`）
+- 新增章节必须选对主题族；勿混用两套配色令牌
+
+## 改章节
+
+1. 更新 `sections` 常量（id / label / title / summary）
+2. 更新 `navItems`（hero 通常不进顶栏）
+3. 增加带正确 `id` 的 `<section className="page-section …">`
+4. 同步展控 UI（dots、panel、进度）
+
+## 视觉原则
+
+- 首屏品牌优先；章节多为 full-bleed 背景，保持 scroll-snap
+- 动效沿用 `fadeRise`、`reveal-*`、`.is-entered`、`--slide-i`，勿堆叠无关徽章/卡片装饰
+- 静态资源用 `/assets/...`；勿引用 `pdf-ref/`
+- 响应式断点已有约 `1100px`、`760px`，优先扩展现有规则