本页指针的版本边界：ARC 源码布局截至 44fbd616f，CLI arc 2.0.0-beta.28。packages/ 与 providers/ 下路径指向 ARC 仓库（站点作者的只读参考），不是本站点 blocklet 内的文件。
术语
| 术语 | 含义 |
|---|---|
| AFS | ARC 中路径可寻址的文件系统抽象 |
| Path | 实例命名空间中的虚拟地址（如 /modules/project/README.md） |
| Mount | 路径前缀到 provider URI/实例的绑定 |
Provider / AFSModule | 为所拥有路径实现操作的模块 |
| Capability / operations declaration | Provider 声称支持的操作（及 features） |
list | 枚举子项；选项可能 best-effort |
search | Provider 定义的自由文本检索 |
query | 可选的严格类型化集合查询，位于 /.actions/query |
exec | 在可执行路径上调用 action |
explain | 解释概念或路径解析 |
| Access mode | readonly / create / append / readwrite |
| Visibility | full / meta |
| Conformance | 经 @aigne/afs-testing 的共享 provider 测试 |
| Instance | 带有自己 mount 与数据的具体运行时 |
核心类型与操作（源码指针）
| 主题 | ARC 中位置 |
|---|---|
AFSModule、AFSRoot、条目/结果类型 | packages/core/src/type.ts |
| 调度 / 路由 | packages/core/src/afs.ts |
OperationsDeclaration、能力助手 | packages/core/src/capabilities/types.ts |
| Collection query 类型 + 严格校验 | packages/core/src/capabilities/collection-query.ts |
| 错误类与码 | packages/core/src/error.ts |
| Base provider + 装饰器 | packages/core/src/provider/ |
| JSON 参考 provider | providers/core/json/ |
| FS provider | providers/basic/fs/ |
| Conformance runner | packages/testing/（runProviderTests） |
| 编写指南 | docs/guides/provider-authoring.md |
| Collection query 指南 | docs/guides/collection-query.md |
CLI 命令组
| 命令 | 作用 |
|---|---|
arc afs ls | List |
arc afs read | Read |
arc afs write | Write |
arc afs delete | Delete |
arc afs stat | Stat |
arc afs search | Search |
arc afs exec | Exec action |
arc afs explain | Explain |
arc afs mount … | Mount 管理 |
完整旗标参考：arc afs。
Board 地图
| 页面 | 回答的问题 |
|---|---|
| Overview | 抽象与非承诺 |
| Get started | 第一道命令面 |
| Local inspection | 实测巡检 |
| Core contract | 操作、能力、错误 |
| Search and query | list vs query vs search |
| Providers | Provider 角色 |
| Author a provider | 实现起点 |
| Provider catalog | 分层公开列表 |
| Runtime boundaries | Mount、状态、本地 vs 发布 |
| Recipes | 可重复任务 |
相关 board
- AUP — 声明式 UI 模型
- Web Device — 基于 AFS 路径的静态站点 provider
- arc-cli — 命令手册
错误码（速查）
见 Core contract 表格。按 AFS_NOT_FOUND、AFS_UNSUPPORTED、AFS_VALIDATION_ERROR、AFS_CONFLICT、AFS_READONLY、AFS_AUTH_REQUIRED 等码分支。