按你实际依赖的东西来命名层次:
| 名称 | 角色 | 何时会碰到它 |
|---|---|---|
| AFS | 按路径组织的资源与能力抽象 | 你对路径做 list、read、write、search、exec 或 mount |
| ARC | 围绕 AFS 的运行时产品外壳 | 你启动服务、运行 Blocklet、打开 session,或用 CLI 操作实例 |
AFS 不关心 HTTP 如何到达,也不关心由哪个进程承载。ARC 负责:启动宿主、挂载 Provider、应用身份与 session 上下文,并暴露运维工具。
AFS 拥有什么
AFS 以 @aigne/afs 核心与 Provider 基类实现。Provider 声明名称、访问模式,以及它实现的操作。你在 CLI 与 Provider 合同中会看到的操作族包括:
| 操作族 | 用途 |
|---|---|
list / read / write / delete | 目录与条目访问 |
stat | 不取全文时的元数据 |
search | Provider 定义的路径内内容搜索 |
exec | 以可执行路径暴露的动作 |
explain | 面向人或 agent 的路径/概念说明 |
mount | 在路径上挂载 Provider |
路径是接口边界,不是「所有数据都在同一存储里」的证据。把某操作写进应用合同前,先查 Provider 声明的能力。完整操作语义见 AFS 核心合同。
ARC 拥有什么
ARC 是让 AFS 成为产品的宿主:
- 加载并挂载 Provider(例如 Web Device、DID Space、UI 设备模块)
- 运行 Blocklet package 与 instance
- 构建交互与站点表面使用的 session / caller 视图
- 暴露
arcCLI 分组(afs、blocklet、service、dsl、space、did等)
本 board 核验的已安装 CLI:arc 2.0.0-beta.28。命令参考:ARC CLI。
从正确的名字开始
| 任务 | 从何开始 | 原因 |
|---|---|---|
| 实现或调试路径操作 | AFS | 行为由 Provider 与操作合同决定 |
| 编写 Provider 包 | AFS | 挂载与能力规则在此 |
| 运行或打包应用 | ARC 上的 Blocklet | 生命周期是 package/instance,不是裸路径 |
| 渲染静态站点 | 经 ARC 的 Web Device(AFS provider) | 站点 layout 属于 Web Device |
| 驱动交互式 AUP 应用 | ARC UI 运行时上的 AUP session | Session 与设备握手是运行时事务 |
| 检查调用者是谁 | Identity board | Caller 与 DID Space 不是 AFS 操作名 |
本页不作的断言
- 不发布稳定的第三方「任意 UI 设备插件」扩展 API。
- 不把每个历史 Blocklet Server 或 DID 产品名等同于当前 ARC 模块。
- 不把实验性远端部署或 Instance DID 生命周期写成现在时合同;那些属于能再次核验的专题 board。