本页定义讨论 provider 时的分层。它有意不是 providers/ 下每个 package 的生成列表。
近期 ARC 树清单观察到约 77 个 provider package(实现数量,不是支持承诺)。在达到证据门槛之前,其中大多数不得进入公开 catalog。
分层
| 层级 | 归属 | 公开表述前需要的证据 |
|---|---|---|
| 核心运行时合同 | 每位作者都必须理解的共享路径、操作、能力与错误合同 | 当前源码 + 合同测试。本 board 写这些合同;不把单个 provider 写成「核心产品」 |
| 参考 / 可选(已文档化) | 可作为起点或可选模块向开发者介绍的具名集成 | 完整的 编写验收记录:合同、访问边界、conformance 结果、隔离本地验收、兼容性、支持归属 |
| 仅源码清单 | ARC 源码中可见的 package,含实验、测试向或不完整工作 | 仅 package 存在。源码笔记与公开 catalog 分开 |
| 不公开列出 | 内部、废弃、未验证后端;或其 search/认证叙事会误导的内容 | — |
有证据条目(本 board 修订)
下表不是完整产品矩阵。每行引用本修订使用的证据(arc 2.0.0-beta.28 和/或 ARC 44fbd616f)。未出现表示「此处尚未准入」,不是「源码里不存在」。
核心/参考证据(不是完整产品准入)
下表是带证据的核心合同或参考基线。不等于已具备 编写验收记录 的全部字段(维护者、生命周期、隔离 demo、公开支持面)作为产品支持承诺。当作起点,不要当作「已准入产品」矩阵。
| 名称 | 角色 | 证据 | 边界 |
|---|---|---|---|
JSON / YAML provider(@aigne/afs-json,providers/core/json) | 面向作者的紧凑「树当 FS」基线 | Conformance:pnpm --filter @aigne/afs-json test -- test/conformance.test.ts → 在 ARC 44fbd616f 上 372 pass, 6 skip, 0 fail。源码实现 list/read/write/delete/search/stat/explain(可写时 capabilities 含 rename) | 本地文件支撑的 JSON/YAML;不是远程多租户存储;search 仅限该树;不是完整产品验收记录 |
本地文件系统 provider(providers/basic/fs,URI fs://) | 常见本地目录挂载 | beta.28 本地验收:在已挂载工程树上 ls/stat/read/search;read …/.meta/.capabilities 显示 provider: "fs" 及 write/search/exec/batch;在另一预挂载可写 fs:// 上完成可丢弃 write/read/delete | Mount 随实例而变;mount add 成功 ≠ 立即可用(见 Runtime boundaries);search 是该 mount 的文件系统搜索,不是全局 FTS |
在样例 daemon 上观察到(不等于 catalog 准入)
下列出现在一台核验主机的 mount list / 根列表。仅说明环境 mount。本页不因此把它们升格为受支持的公开产品:
web-device://(Web Device 站点宿主——合同在 Web Device board)vault://、agentcode-agent://mount、消息类 mount、hub URI 等
不要把某台主机的 mount list 抄进营销或 onboarding 当作「受支持 provider」。
准入规则(重申)
不要因为后端名字耳熟或 package 存在就推广。未来的 catalog 行必须写明版本边界、支持的操作、访问/数据边界、维护者、文档位置,以及所用的精确本地验收证据。
在更多行满足该规则之前,本目录有意保持精简。