跳到主要内容

AFS

Provider 目录

用分层准入,只把有证据的 provider 写成公开集成——而不是把仓库 package 列表整表公开。

本页定义讨论 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-jsonproviders/core/json面向作者的紧凑「树当 FS」基线Conformance:pnpm --filter @aigne/afs-json test -- test/conformance.test.ts → 在 ARC 44fbd616f372 pass, 6 skip, 0 fail。源码实现 list/read/write/delete/search/stat/explain(可写时 capabilities 含 rename)本地文件支撑的 JSON/YAML;不是远程多租户存储;search 仅限该树;不是完整产品验收记录
本地文件系统 providerproviders/basic/fs,URI fs://常见本地目录挂载beta.28 本地验收:在已挂载工程树上 ls/stat/read/searchread …/.meta/.capabilities 显示 provider: "fs" 及 write/search/exec/batch;在另一预挂载可写 fs:// 上完成可丢弃 write/read/deleteMount 随实例而变;mount add 成功 ≠ 立即可用(见 Runtime boundaries);search 是该 mount 的文件系统搜索,不是全局 FTS

在样例 daemon 上观察到(不等于 catalog 准入)

下列出现在一台核验主机的 mount list / 根列表。仅说明环境 mount。本页因此把它们升格为受支持的公开产品:

  • web-device://(Web Device 站点宿主——合同在 Web Device board
  • vault://、agent code-agent:// mount、消息类 mount、hub URI 等

不要把某台主机的 mount list 抄进营销或 onboarding 当作「受支持 provider」。

准入规则(重申)

不要因为后端名字耳熟或 package 存在就推广。未来的 catalog 行必须写明版本边界、支持的操作、访问/数据边界、维护者、文档位置,以及所用的精确本地验收证据。

在更多行满足该规则之前,本目录有意保持精简。