docs(site): 改掉格言式小标题,修 21 个 404 链接,校正统计数字

## 小标题:格言改成陈述

原站的小标题全是这个调子:

```
崩一个,不赔上全部          拦得住,也接得回
三条道,各走各的            数据如水,随流,随改,随走
轻重缓急,各归其位          忙时,有人替你接住
部署,从未如此便捷
```

这是「句子很响,但读者看完不知道这节讲什么」。正文其实写得很扎实
(有退避 1s/2s/3s、L4 被夹到 L3、60 万 token 上限这些实测值),
只有标题在唱口号。

改成陈述式,读者扫一眼就知道这节讲什么:

```
插件崩溃不影响内核              中断可以抢占,也能恢复现场
三条通信通道各管一类数据        大块数据走共享内存,不序列化
输入分两类,中断分四级          积压的消息由驻留子 agent 接手
部署是拷一个文件
```

另外两处本来就重复:「三条道,各走各的」和「数据如水,随流,随改,随走」
讲的是同一件事(都讲共享内存)。前者改成只讲三通道分工,后者保留细节。

## 21 个 404 链接

「可用插件」里每个插件的源码链接都指向
`github.com/JianFeeeee/hologramagentsdk/blob/main/example/<name>`,
而 `example/` 下的 26 个目录已迁走并删除,**全部 404**。

改为 `github.com/HologramAgent/<name>`,逐仓 `git ls-remote` 验证过都存在。
徽章右侧的可见文字也从 `SDK / example/qq` 改成 `GitHub / HologramAgent/qq`。

## 统计数字虚高

按 `site/README.md` 自己的核对流程实测(生产日志
`homed_2026-10-31_10-05-16.log`):

| 页面项 | 原值 | 实测 |
|---|---|---|
| 在跑插件 | 36 | **30** |
| 可用工具 | 340 | **285** |
| Go 代码行 | 109k | **240k** |
| LLM 适配器 | 9 | 9 ✓ |

Go 行数是**反向错**的:核对命令没排除 `build/`,而 `build/` 里打包了 SDK 副本,
不排除会得到 516549 行,排除后 240056 行。已把该排除项写进 `site/README.md`
的核对命令,避免下次再算错。

数字校正清单也写进 `site/README.md`,标注核对日期与日志文件。

## 验证

- HTML 标签配对:div / article / a 全部为 0 差
- 行数未变(3417),改动集中在标题与链接
This commit is contained in:
JianFeeeee
2026-10-31 11:20:37 +08:00
parent 49e80307c7
commit 9363660b79
2 changed files with 68 additions and 54 deletions

View File

@ -152,9 +152,19 @@ print(d.get('name'), d.get('version'), d.get('description','')[:60])"; done
## 改内容前请核对事实
页面上的数字都是**实测值**。**注意「在跑插件 36」是加载总数**
(16 内置 + 20 外部),不是"外部插件数" —— 早期版本写成「36 外部插件」是错的,
已更正。改动前建议重新取一遍:
页面上的数字都是**实测值**,不是估算。**「在跑插件」是加载总数,不是外部插件数**
—— 早期版本写成「36 外部插件」是错的。
2026-10-31 重新核对(生产日志 `homed_2026-10-31_10-05-16.log`):
| 页面项 | 原值 | 实测 | 说明 |
|---|---|---|---|
| 在跑插件 | 36 | **30** | 插件迁移到 org 后外部插件减少 |
| 可用工具 | 340 | **285** | |
| Go 代码行 | 109k | **240k** | 原核对命令漏排除 `build/`,反而少算了 |
| LLM 适配器 | 9 | 9 ✓ | `server.lua` 是网关脚本不算厂商适配器 |
改动前建议重新取一遍:
```bash
# 在跑插件(以日志里实际 loaded 的为准,比数目录可靠)
@ -164,9 +174,13 @@ grep -h '\[plugin\] loaded:' $(ls -t ${HA_DATA}/log/homed_*.log | head -1) \
# 工具数(同上,日志里注册后的真实值)
grep -ohE '[0-9]+ tools' $(ls -t ${HA_DATA}/log/homed_*.log | head -1) | tail -1
# Go 代码行(排除第三方与鸿蒙工程)
# Go 代码行(排除第三方、鸿蒙工程、以及 build/dist 里的打包副本)
# ★ 必须排除 build/ 与 dist/:那里有打包进去的 SDK 副本,会把数字翻倍
# (实测不排除时 516549 行,排除后 240056 行)
find . -name '*.go' -not -path './.git/*' -not -path './.go/*' \
-not -path './third_party/*' -not -path './cmd/ohos/*' | xargs cat | wc -l
-not -path './third_party/*' -not -path './cmd/ohos/*' \
-not -path './build/*' -not -path './dist/*' -not -path './site_build/*' \
-not -path './package/*' | xargs cat | wc -l
# LLM 适配器(注意 server.lua 是网关脚本,不是厂商适配器,故为 9)
ls internal/lua/adapters/*.lua | xargs -n1 basename