站点使用说明¶
怎么用这个站点¶
- 首页 是研究目录 —— 列出所有已部署的研究，按时间倒序。
- 进入某个研究：点列表中的项目，进入
research/<仓库代号>/子站。 - 方法论附录：每次研究的元信息（Snapshot hash、产物路径、安全边界）都在
research/<仓库>/appendix_index.md与appendix_method.md。
关于站点版本¶
每次重大研究交付时同时增加一个站点版本号：
| 版本号 | 时间 | 内容 |
|---|---|---|
| 0.1.0 | 2026-08-11 | 首发；含 Pi (earendil-works/pi) 研究 |
每次重新部署都保留历史版本信息在 research/<仓库>/appendix_index.md。
关于内容范围¶
只包含由 Hermes 技术研究员产出的研究。所有结论可追溯到：
- 固定的 git commit
- 固定的 release tag
- 固定的 commit 注释 / 源码行
不包含：未经用户确认的 PR / fork / 用户私有仓库代码。
关于可复用资产¶
每个研究的 reuse.md 是按"复用价值 / 迁移成本"排序的设计清单。读者可以：
- 直接照搬 1 等重用项（低风险）
- 借鉴 2 等重用项的设计思想（部分借鉴）
- 3 等重用项仅做参考
关于 Cloudflare Pages¶
部署目标项目名为 technical-research，公网域 technical-research.pages.dev。
每次构建用 mkdocs build --strict；目录结构稳定：每次只新增 research/<新仓库>/ 子目录，主框架不变。
关于凭据与权限¶
- 凭据（
CF_API_TOKEN等）从/home/ubuntu/.hermes/.env读取；不打印、不进 git、不到产物 - 静态产物目录
/tmp/pi-site/site/严格只含 mkdocs 输出 + 资源，不含受控副本 / token /.env - 任何想要"已执行过 .env 中 token 部署"操作的产物都已展示在首页