系统 ID
public-snapshot-layer
public-snapshot-layer
Public Snapshot Layer
从 public-data/ 发布经过净化、预生成的 JSON 快照（站点、状态、架构、文章、路线图、队列、拓扑、流量摘要）的层级。
状态
active
架构层级
- L3 公共数据
输入
- 精选的 public-data JSON
- content/ 中的 markdown（文章、研究、开发日志、路线图）
- 匿名流量摘要
输出
- public-data/ 与 web/public-data/ 中带版本和哈希的公共快照
公共接口
- public-data/*.json（静态提供）
安全边界
快照在发布前经过净化。禁止的数据（秘密、私有记忆、内部日志、用户数据）按契约和边界测试排除。该层对公众只读。
数据方向
核心 → 净化快照 → 公开。绝不反向。
是什么
通过净化快照为公众提供 AENET 建设的只读、确定性视图——绝无实时查询。
为什么
公开侧绝不能对核心进行实时查询。快照层预生成净化 JSON，使公众无需任何实时连接即可读取事实。
如何
核心 → 净化快照 → 公开。绝不反向。
- 发布站点、状态、架构、变更日志快照
- 从 content/ 生成文章、开发日志、路线图和流量摘要快照
- 为每个快照附加 version、generatedAt 与 contentHash
- 将快照复制到 web/public-data/ 供静态主机使用
- 强制模式契约
示例
构建流水线验证并将净化快照复制到 public-data/ 与 web/public-data/，带版本与哈希，页面与 API 读取同一来源。
输入
- 精选的 public-data JSON
- content/ 中的 markdown（文章、研究、开发日志、路线图）
- 匿名流量摘要
输出
- public-data/ 与 web/public-data/ 中带版本和哈希的公共快照
依赖
aenet-cloud-public生命周期
- 内容精选
- build-public-index 生成
- 信封 + 哈希
- 静态发布
使用场景
- UI 从快照 JSON 渲染页面
- Public API 提供基于快照的数据
- 爬虫与开发者直接读取 public-data
限制
- 无实时数据——快照是预生成的
- 仅限契约允许的净化数据集
- 流量摘要仅聚合
相关研究
- The AENET Public Entrance — What this public entrance is, what the public may observe, and where the one-way boundary sits.
人们常问的问题
这些问题由本页内容解答。
- 什么是公共快照层？
- AENET 发布哪些快照？
- 公共快照如何生成与哈希？
- 公众能否查询核心实时数据？
证据
仅已验证状态——本页内容均非预测。
- scripts/build-public-index.js
- public-data/*.json
- contracts/aenet-public-snapshot.contract.json
- docs/PUBLIC_DATA_BOUNDARY.md