把这些词当作边界,而不是同义词。
| 术语 | 把它理解为 | 不要把它当成 |
|---|---|---|
| AFS | 按路径寻址的资源与能力文件系统 | 单一物理数据库或云存储桶 |
| Provider | 拥有挂载路径、实现所声明操作的模块 | 每个路径都支持全部操作的证明 |
| AFS UI | 架构视角:相对 AFS 路径与设备表达 UI 工作 | 与 AUP、Web Device 并列的第三套公开 authoring 产品 |
| AUP | 声明式语义 UI tree(节点、事件、绑定、降级) | HTML、CSS 或站点内容模型 |
| Web Device | 读取站点树并渲染静态 HTML 的 AFS provider | 交互式 AUP session 或通用应用运行时 |
| Blocklet | 你编写的 package 与你运行的 instance | 仅仅是一个网站,或仅仅是一个 UI 文件 |
| DID / caller | 运行时附加到请求或 session 的已验证身份上下文 | 碰巧看起来像 DID 的路径字符串 |
| DID Space | 通过 AFS 挂载的、按 DID 分区的持久存储 | 第二套并行文件系统协议 |
| Data Space | 描述 caller 数据上下文与视图的文档术语 | 另一套公开 SDK 或生命周期 API |
| ARC | 承载 AFS、session 与 Blocklet 的运行时与 CLI 外壳 | 与 AFS 同一件事 |
各部分如何连接
- AFS 回答:「资源在哪,其 Provider 支持哪些操作?」
- AFS UI 回答:「展示或编辑该资源时,适用哪类设备与 UI 合同?」
- AUP 回答交互呈现:语义 tree、session、设备能力、降级。
- Web Device 回答站点呈现:页面、内容对象、主题、静态 HTML。
- Blocklet 回答打包:交付什么、如何本地运行、如何把 surface 绑到 AFS。
- 身份与数据空间 回答:「谁在行动,得到哪份数据视图?」
- ARC CLI 是从本机检查并驱动上述层次的操作入口。
阅读顺序
| 如果你是… | 先读 |
|---|---|
| 刚接触 ARC,需要术语 | 本页,然后 ARC 与 AFS |
| 在选择指南归属 | 产品层次 |
| 把 UI 工作接到 AFS 路径 | AFS UI,再进 AUP 或 Web Device |
| 实现资源或 Provider | AFS |
| 交付应用单元 | Blocklets |
| 处理登录、成员关系或用户数据 | Identity & Data Spaces |
| 检查一句话是否构成产品承诺 | 合同与证据 |
| 追查旧产品名 | 产品沿革与边界 |
合同、解释与沿革
- 公开合同 —— 源码、测试与本地运行一致后可以依赖的行为。由专题 board 持有。
- 架构解释 —— 层次如何配合;用于定向,不能替代类型与命令。
- 沿革 —— 旧名称为何仍会出现;绝不是完整功能等价声明。
内部 ARC 材料也会用 AOS 指 ARC 所承载的可移植操作系统语义(session、HTTP 表面、调度)。本公开 board 不把 AOS 当作独立开发者文档产品。需要 session 或 caller 细节时,使用 Identity & Data Spaces 与 AUP 的 session 相关页面。