mirror of
https://gitcode.com/JianFeeeee/HomeAgent.git
synced 2026-10-04 00:03:59 +00:00
fab27a1194
## 深浅双主题 跟随系统偏好，导航栏按钮可手动切换（存 localStorage）。首绘前在 <head> 里 定好 data-theme，无闪白（实测 reload 首绘即正确背景色）。 语义色全部令牌化，:root[data-theme="light"] 只覆盖取值；品牌三色两主题共用 （对应三层记忆，换主题不该换语义）。 ## 动效层（1 → 11 个 keyframes） 极光漂移 + 细网格背景、粒子网络（近邻连线，密度按面积自适应、上限 72）、 三色滚动进度条、标题渐变流动、分块上错落入场、卡片聚光 + 3D 微倾、 三层记忆色条自上而下灌注、架构图流光带 + 节点脉冲、数字滚动到位、 分节标题下划线展开。 三条硬约束（都吃过亏）： 1. **内容默认可读** —— 初始隐藏只在 .js-fx 下生效，而 .js-fx 仅当 JS 真跑起来才加。 实测 JS 禁用时 30/30 元素可见（旧版把 opacity:0 写默认样式里 → 26/30 永久不可见）。 2. **尊重 prefers-reduced-motion** —— 不启粒子、不画进度条、元素直接可见。 3. **装饰不得产生滚动条** —— canvas 改用 documentElement.clientWidth （window.innerWidth 含滚动条，实测多出 15px 撑出横向滚动），body 加 overflow-x: clip 兜底。 ## 移除立绘（用户要求） 删掉 HTML/CSS/JS/资源/令牌全部痕迹，Hero 改单栏。README 记下为什么最终不放图： 原图是不透明 WebP（mode=RGB 实测），白底与角色白裙子同色，flood-fill 会渗进轮廓 让约 42% 身体透明 —— 这类素材要么出透明图，要么就别放。 ## 顺带修掉 3 个真 bug（都是主题化后暴露/复核出来的） 1. **代码块换行全丢** —— .code 缺 white-space: pre，实测整段命令挤成一行。 （这个 bug 在我这次改动之前就存在） 2. **浅色下导航看不清** —— header 背景硬编码 rgba(11,16,32,.78)，改用 --nav-bg。 3. **浅色下立绘处有灰块** —— .mascot::after 硬编码深色，改用 --mascot-fade （该规则已随立绘一并删除）。 另把 .badge / .btn-ghost:hover / 按钮光泽里 3 处 rgba(255,255,255,…) 令牌化为 --hover / --sheen，否则浅色下是白压白。 ## 验证（共享 Chromium 实跑） 深/浅首屏 + 记忆段 + 架构段截图逐张看过；console 错误 0；坏图 0； JS 禁用 30/30 可见；reduce 全可见且粒子/进度条已停；主题切换 → 刷新后保持； 390/768/1440 三档横向溢出均为 0；CSS 花括号平衡、8 个 keyframes 无孤儿。
121 lines
4.9 KiB
Markdown
121 lines
4.9 KiB
Markdown
# 官网（静态站）
|
||
|
||
单文件、零构建、零依赖的落地页。与仓库 WebUI 的做法一致（原生 HTML/CSS/JS，无打包步骤）。
|
||
|
||
## 文件
|
||
|
||
```
|
||
site/
|
||
├── index.html 单文件站点（内联 CSS/JS）
|
||
└── assets/
|
||
└── logo.svg logo（来自 assets/branding/logo-h-he.svg）
|
||
```
|
||
|
||
资源是**复制**而非引用上级目录，因此 `site/` 可整体拷走独立部署。
|
||
|
||
## 本地预览
|
||
|
||
```bash
|
||
cd site && python3 -m http.server 8799
|
||
# 打开 http://127.0.0.1:8799/
|
||
```
|
||
|
||
## 部署
|
||
|
||
纯静态，任意 web 服务器指向 `site/` 即可：
|
||
|
||
```nginx
|
||
server {
|
||
listen 80;
|
||
server_name your.domain;
|
||
root /path/to/TrueAgent/site;
|
||
index index.html;
|
||
location / { try_files $uri $uri/ =404; }
|
||
}
|
||
```
|
||
|
||
## 设计说明
|
||
|
||
- **配色取自品牌指南**：蓝 `#3b82f6` / 青 `#06b6d4` / 金 `#f59e0b`，
|
||
正好对应三层记忆 Context / Document / Graph，因此三层记忆那节直接用了这三色做色条。
|
||
- **不放置立绘**。曾试过放看板娘，但原图是白底 + 蓝紫渐变外框的方形图，
|
||
与页面几乎无法自然衔接（详见下文「为什么最终没有图」）。
|
||
- **淡入动画是渐进增强**：内容默认可见，仅当 JS 真的跑起来才加 `.js-reveal` 接管。
|
||
早期版本把 `opacity:0` 写在默认样式里，结果 JS 未执行时整页永久空白
|
||
（实测 30 个元素里 26 个停在不可见）——现在禁用 JS 也完整可读。
|
||
- 尊重 `prefers-reduced-motion`；架构图的 `<pre>` 在窄屏横向滚动，避免整页撑宽。
|
||
|
||
## 深浅双主题
|
||
|
||
跟随系统偏好；导航栏右上角的按钮可手动切换，选择存入 `localStorage`（键 `ha-theme`）。
|
||
|
||
实现要点：
|
||
|
||
- 在 `<head>` 里**首绘前**就定好 `data-theme`，避免先渲染深色再跳浅色的闪白。
|
||
- 语义色全部走 CSS 变量（`--bg` / `--text` / `--border` / `--code-bg` / `--hover` …），
|
||
`:root[data-theme="light"]` 只覆盖取值，不重复选择器。
|
||
- 品牌三色（蓝/青/金）两主题共用，因为它对应三层记忆，换主题不该换语义。
|
||
|
||
## 动效层
|
||
|
||
| 效果 | 位置 |
|
||
|---|---|
|
||
| 四团极光漂移 + 细网格 | 背景（`position: fixed`, `z-index: -2`） |
|
||
| 粒子网络（近邻连线） | `#fx` canvas，密度按视口面积自适应，上限 72 |
|
||
| 三色滚动进度条 | 顶部 |
|
||
| 标题渐变流动 | `h1 .grad` |
|
||
| 分块上浮入场（错落延迟） | 各 section |
|
||
| 卡片聚光 + 3D 微倾 | `.card` / `.stat`（仅精确指针） |
|
||
| 色条自上而下「灌注」 | 三层记忆 |
|
||
| 数据流光带下行 + 节点脉冲 | 架构图 |
|
||
| 数字滚动到位 | 统计卡 |
|
||
| 文字下划线展开 | 分节标题 |
|
||
|
||
**三条硬约束**（都吃过亏）：
|
||
|
||
1. **内容默认可读**：初始隐藏只在 `.js-fx` 下生效，而 `.js-fx` 只有 JS 真跑起来才加。
|
||
JS 被禁用或报错时，页面是完整可读的 —— 早期版本把 `opacity:0` 写在默认样式里，
|
||
实测 30 个元素里 26 个永久不可见。
|
||
2. **尊重 `prefers-reduced-motion`**：此时不加 `.js-fx`、不启粒子、不画进度条，
|
||
所有元素直接可见。
|
||
3. **装饰不得产生滚动条**：canvas 按 `documentElement.clientWidth` 定尺寸
|
||
（用 `window.innerWidth` 会含滚动条宽度，实测多出 15px 撑出横向滚动）；
|
||
`body` 再加 `overflow-x: clip` 兜底。
|
||
|
||
所有 listener 走 `requestAnimationFrame` 节流；标签页隐藏时暂停粒子。
|
||
|
||
## 为什么最终没有图
|
||
|
||
试过放看板娘立绘，失败，最后决定不放。过程留在这里，免得下次重复踩：
|
||
|
||
原图 `mascot-xiaozhai.webp` 是**不透明** WebP（无 alpha），白底 + 蓝紫渐变外框。
|
||
直接用 = 深色页面上一个刺眼的白色方块；抠图又不可行：
|
||
|
||
```bash
|
||
python3 -c "
|
||
from PIL import Image
|
||
im = Image.open('assets/branding/mascot-xiaozhai.webp')
|
||
print(im.mode) # RGB —— 没有 alpha 通道
|
||
"
|
||
```
|
||
|
||
背景连通域分析显示**白底与角色的白裙子、白围裙同色**，flood-fill 会顺着轮廓
|
||
渗进去，让约 42% 的身体变成透明（发丝高光先死）。曾退而求其次做成
|
||
「圆角卡面 + 发光边框 + 底部渐隐」，视觉上能接受，但本质上是在方形图上盖装饰，
|
||
而非让图融入页面。
|
||
|
||
结论：**这类素材要么重新出一张带透明通道的图，要么就不放**。
|
||
现在 Hero 是单栏文字，版面反而更稳。
|
||
|
||
## 改内容前请核对事实
|
||
|
||
页面上的数字（外部插件数、工具数、代码行数、适配器数）都是**实测值**，
|
||
不是估的。改动前建议重新取一遍：
|
||
|
||
```bash
|
||
ls /home/newqqagent/plugins/ | grep -v hmap | wc -l # 外部插件
|
||
grep -oE '[0-9]+ tools' $(ls -t /home/newqqagent/log/*.log | head -1) | tail -1
|
||
ls internal/lua/adapters/*.lua | wc -l # LLM 适配器
|
||
find . -name '*.go' -not -path './.git/*' -not -path './.go/*' -not -path './third_party/*' | xargs wc -l | tail -1
|
||
```
|