# @afps-spec/types 中文文档

规范地址：https://npmcn.com/package/%40afps-spec/types/

版本：0\.1\.0
npm 元数据更新时间：2026-05-27T02:12:09.554Z
中文译文更新时间：2026-11-06T09:03:30.831Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40afps-spec/types
原文对照：https://npmcn.com/package/%40afps-spec/types/?lang=original
项目主页：https://github.com/afps-spec/afps-spec#readme
源码仓库：https://github.com/afps-spec/afps-spec

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：18.8 kB，4 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2026-04-24T03:34:20.122Z
- 最新版本发布：2026-05-27T02:12:09.393Z
- 近 30 天下载量：3708（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：3（近 12 个月 3 个）

## 中文简介

用于AFPS 0.1合同的TypeScript装订——工具协议,表列参考,和RunEvent接线信封.

## 安装

```sh
npm install @afps-spec/types
```

也可以使用：`pnpm add @afps-spec/types`、`yarn add @afps-spec/types`、`bun add @afps-spec/types`

## README

# @ afps- spec/ 类型

AFPS 0.1合同的TypeScript绑定.

这个包是语言不可知论的 Canonical TS 投影 AFPS 规格(见 [`afps-spec/spec.md`](https://github.com/afps-spec/afps-spec/blob/main/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 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 和提交记录判断。