mirror of
https://gitcode.com/JianFeeeee/HomeAgent.git
synced 2026-09-23 02:18:06 +00:00
923d5d595f
用户要求写一个官网介绍页面。做成纯静态单文件，与仓库 WebUI 的既有做法一致 （原生 HTML/CSS/JS，无打包步骤）。 ## 内容（每一条都对着源码/运行实例核实过） - Hero：一句话定位（常驻型个人 Agent 框架）+ 看板娘立绘 - 四个设计决定：内核零 IO / 插件独立进程 / 输入有级别 / 忙时有人顶班 - 三层记忆：Context → Document → Graph，含媒体一等节点、描述即语义记忆、统一多模态空间 - 架构：一条消息进来之后的完整路径图 + 核心组件表 - 数字（**实测值，非估算**）：36 外部插件 / 340 工具 / 110k Go 行 / 10 LLM 适配器 - 上手命令、插件徽章墙、6 条 FAQ、页脚（文档/深入/项目/状态） ## 两个设计决定，都有理由 1. **配色取自品牌指南**：蓝/青/金正好对应三层记忆，故三层记忆那节直接用三色做色条。 2. **立绘按「有意的圆角卡面」呈现，不抠图**：原图是白底 + 蓝紫渐变外框， 而白底与角色的白裙子同色 —— 连通域分析显示 flood-fill 会让 42% 的身体变透明 （围裙、发丝高光被吃掉）。改为圆角 + 发光边框 + 底部渐隐，方形图与深色页自然衔接。 ## 修掉一个真实的可访问性缺陷 初版把 `opacity:0` 写在**默认样式**里、由 IntersectionObserver 加 `.in` 揭示。 实测：30 个 .reveal 元素里 26 个停在不可见 —— **JS 被禁用或报错时整页永久空白**。 改为渐进增强：内容默认可见，仅当 JS 真跑起来才加 `.js-reveal` 接管动画。 复测两种场景均 30/30 可见（正常滚动 + 禁用 JS）。 ## 验证（用共享 Chromium 实跑，不只是看代码） - 控制台错误 0；两张图均加载（logo 400x400、立绘 1024x1024） - 移动端 390px：无横向溢出，导航折叠，立绘置顶 - FAQ 手风琴展开正常（open=true） - a11y：图片 alt 齐全、单一 h1、lang=zh-CN、无空文本链接 - 标签配对全 OK；34.6 KB；**无任何外部依赖**（无 CDN/字体/JS 库）
官网（静态站）
单文件、零构建、零依赖的落地页。与仓库 WebUI 的做法一致（原生 HTML/CSS/JS，无打包步骤）。
文件
site/
├── index.html 单文件站点（内联 CSS/JS）
└── assets/
├── logo.svg logo（来自 assets/branding/logo-h-he.svg）
└── mascot.webp 看板娘立绘（来自 assets/branding/mascot-xiaozhai.webp）
资源是复制而非引用上级目录，因此 site/ 可整体拷走独立部署。
本地预览
cd site && python3 -m http.server 8799
# 打开 http://127.0.0.1:8799/
部署
纯静态，任意 web 服务器指向 site/ 即可：
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，因此三层记忆那节直接用了这三色做色条。 - 立绘按「有意的圆角卡面」呈现，不做抠图：原图是白底 + 蓝紫渐变外框， 抠图会连带毁掉白裙子与发丝高光（实测背景连通域分析：白底与裙子同色， flood-fill 会让 42% 的身体变成透明）。改为圆角 + 发光边框 + 底部渐隐， 让方形图与深色页面自然衔接。
- 淡入动画是渐进增强：内容默认可见，仅当 JS 真的跑起来才加
.js-reveal接管。 早期版本把opacity:0写在默认样式里，结果 JS 未执行时整页永久空白 （实测 30 个元素里 26 个停在不可见）——现在禁用 JS 也完整可读。 - 尊重
prefers-reduced-motion；架构图的<pre>在窄屏横向滚动，避免整页撑宽。
改内容前请核对事实
页面上的数字（外部插件数、工具数、代码行数、适配器数）都是实测值， 不是估的。改动前建议重新取一遍：
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