# @agent-inspect/adapter-sdk 中文文档

规范地址：https://npmcn.com/package/%40agent-inspect/adapter-sdk/

版本：6\.31\.35
npm 元数据更新时间：2026-11-04T20:01:31.937Z
中文译文更新时间：2026-11-06T13:12:23.105Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40agent-inspect/adapter-sdk
原文对照：https://npmcn.com/package/%40agent-inspect/adapter-sdk/?lang=original
项目主页：https://github.com/rajudandigam/agent-inspect/tree/main/packages/adapter-sdk
源码仓库：https://github.com/rajudandigam/agent-inspect

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

- 包体积（解压后）：145 kB，9 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：1 个
- 首次发布：2026-06-29T04:53:15.481Z
- 最新版本发布：2026-11-04T20:01:31.529Z
- 近 30 天下载量：3157（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：117（近 12 个月 117 个）

## 中文简介

配有符合要求和隐私帮助者的适应者编写工具包

## 安装

```sh
npm install @agent-inspect/adapter-sdk
```

也可以使用：`pnpm add @agent-inspect/adapter-sdk`、`yarn add @agent-inspect/adapter-sdk`、`bun add @agent-inspect/adapter-sdk`

## README

# @ agent-incept/ adapter- sdk

作者第三方 Agent Inspect 框架适配器并配有符合性辅助器.

**支助级别:** 贝塔——见 [支助](https://github.com/rajudandigam/agent-inspect/blob/main/docs/SUPPORT-LEVELS.md)。网络行为 : [网络-银行](https://github.com/rajudandigam/agent-inspect/blob/main/docs/NETWORK-BEHAVIOR.md)。 。 。 .

## 何时使用

-   建立社区或内部适配器包
-   验证只限元数据的获取和隐私合同

## 不使用时

-   应用程序跟踪(使用) `agent-inspect` 或现有适配器)

## 安装

```bash
npm install @agent-inspect/adapter-sdk agent-inspect
```

## 示例

```ts
import { createAdapterRegistration, runAdapterConformance } from "@agent-inspect/adapter-sdk";

export const registration = createAdapterRegistration({
  id: "my-framework",
  // ...
});
```

## 最小第三方适配器示例

见 [`examples/adapter-sdk/minimal-source-adapter`](https://npmcn.com/package/examples/adapter-sdk/minimal-source-adapter) 用于注册适配器元数据的无依赖假框架源, 抓取本地元数据唯一的跟踪,并运行 `runAdapterConformance`。 。 。 .

## 自定义渲染器示例

见 [`examples/adapter-sdk/custom-renderer`](https://npmcn.com/package/examples/adapter-sdk/custom-renderer) 独立 `TraceRenderer` 使一个只包含元数据的减记摘要 从一棵坚固的树上 `renderWithSafety`。 。 。 .

## 自定义变换示例

见 [`examples/adapter-sdk/custom-transform`](https://npmcn.com/package/examples/adapter-sdk/custom-transform) 独立 `TraceTransform` 使特定供应商事件形状正常化 并警告未完成的投入.

## 隐私

-   SDK 助手执行本地第一模式; 适配器不能默认上传
-   使用适配器 SDK 隐私核对表来记录捕获,持久性, 在公布或提议登记前进行编辑和出口审查 列入.

## API 密码

| 导出 | 目的 |
| --- | --- |
| `createAdapterRegistration` | 注册适配元数据 |
| `runAdapterConformance` | 合格测试跑者 |

## 文档

-   [适配器](https://github.com/rajudandigam/agent-inspect/blob/main/docs/ADAPTER-CONFORMANCE.md)
-   [SDK 隐私清单](https://github.com/rajudandigam/agent-inspect/blob/main/docs/ADAPTER-SDK-PRIVACY.md)
-   [适配器](https://github.com/rajudandigam/agent-inspect/blob/main/docs/ADAPTERS.md)
-   [延期提交模板](https://github.com/rajudandigam/agent-inspect/blob/main/docs/community/EXTENSION-SUBMISSION-TEMPLATE.md)

## 软件包作者核对表

1.  仅使用元数据默认值
2.  文档对等依赖性
3.  适配器代码路径中没有网络
4.  添加符合性测试
5.  运行隐私检查表并在共享前审查出口的文物
6.  在提议列入登记册之前使用延期提交模板

## 版本

部分固定代理监取放行. 参见当前版本的npm徽章/包表.

## 许可证

麻省理工学院

## 常见问题

### @agent-inspect/adapter-sdk 是什么？

配有符合要求和隐私帮助者的适应者编写工具包

### 如何安装 @agent-inspect/adapter-sdk？

在项目目录运行 npm install @agent-inspect/adapter-sdk，或使用 pnpm add / yarn add / bun add。

### @agent-inspect/adapter-sdk 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @agent-inspect/adapter-sdk 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @agent-inspect/adapter-sdk 可以商用吗？

@agent-inspect/adapter-sdk 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @agent-inspect/adapter-sdk 的下载量有多少？

根据 npm 官方下载统计，@agent-inspect/adapter-sdk 在 2026/10/05 – 2026/11/03 这 30 天内被下载 3,157 次，日均约 105 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @agent-inspect/adapter-sdk 还在维护吗？

最新版本 6\.31\.35 发布于 2026/11/05（3 天前）；至今共发布 117 个版本，其中过去 12 个月发布了 117 个；首次发布于 2026/06/29。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。