@ afps- spec/ 类型
AFPS 0.1合同的TypeScript绑定.
这个包是语言不可知论的 Canonical TS 投影
AFPS 规格(见 afps-spec/spec.md) (中文(简体) ).
它只宣布类型——没有运行时间行为——所以任何AFPS符合
TypeScript 工具、 运行时间或跑取工具可以依赖它共享
词汇与特定执行不相配合.
里面有什么东西
- 备注 (单位:千美元)
DependencyRef, (中文(简体) ), SkillRef, (中文(简体) ), McpServerRef, (中文(简体) ), IntegrationRef, (中文(简体) ), JSONSchema)——与Zod计划平行于: @afps-spec/schema。 。 。 .
- 工具协议 (单位:千美元)
Tool, (中文(简体) ), ToolContext, (中文(简体) ), ToolResult)——每个AFPS工具执行的形状MUSST满足.
- 电线信封 (单位:千美元)
RunEvent——从工具流向汇的开放事件形状.
怎么样
运行时- 内部接口( Bundle 加载器 API, 解析器接口,
switch 接口, 聚合运行状态) 运行于运行时包
——例如:. @your-org/afps-runtime他们
描述特定的 TypeScript 运行时电线本身如何向上
内部,而不是整个生态系统共享的合同.
关于 @afps-spec/types 的常见问题
@afps-spec/types 是什么？
用于AFPS 0.1合同的TypeScript装订——工具协议,表列参考,和RunEvent接线信封.
如何安装 @afps-spec/types？
在项目目录运行 npm install @afps-spec/types，或使用 pnpm add / yarn add / bun add。
@afps-spec/types 支持 TypeScript 吗？
该包的 package.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/afps-spec__types 是否存在。
@afps-spec/types 支持 ESM 还是 CommonJS？
以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module，更早的版本需要改用动态 import()。
@afps-spec/types 可以商用吗？
@afps-spec/types 使用 Apache-2.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。
@afps-spec/types 的下载量有多少？
根据 npm 官方下载统计，@afps-spec/types 在 2026/10/05 – 2026/11/03 这 30 天内被下载 3,708 次，日均约 124 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。
@afps-spec/types 还在维护吗？
最新版本 0.1.0 发布于 2026/05/27（5 个月前）；至今共发布 3 个版本，其中过去 12 个月发布了 3 个；首次发布于 2026/04/24。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。