# @adhd/agent-base-types 中文文档

规范地址：https://npmcn.com/package/%40adhd/agent-base-types/

版本：2\.3\.13
npm 元数据更新时间：2026-10-21T17:42:33.487Z
中文译文更新时间：2026-11-08T00:02:56.143Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：91.8 kB，14 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2026-07-12T20:26:02.908Z
- 最新版本发布：2026-10-21T17:42:33.228Z
- 近 30 天下载量：1965（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：22（近 12 个月 22 个）

## 中文简介

@adhd/代理生态系统的共享类型脚本类型和计划

## 安装

```sh
npm install @adhd/agent-base-types
```

也可以使用：`pnpm add @adhd/agent-base-types`、`yarn add @adhd/agent-base-types`、`bun add @adhd/agent-base-types`

## README

# @adhd/代理基型

为 @adhd/ agent- \* 家族共享类型脚本类型定义和计划 。 提供代理,任务,会话,消息,用法以及验证策略的接口.

**状态 :** 共用类型(已发运 v 2.0.0)  
**软件包 :** `npm install @adhd/agent-base-types`  
**消费者:** 所有代理软件包

## 它会做什么

-   **核心类型** - 代理、任务、会话、消息、任务事件接口
-   **托肯会计** ——与提供者中性字段的 TokenUsage 接口(2.0.2+)
-   **反应模式** —— 说 `PostModelResponsePayload.responseModel` 提供商说发送了电话(未报告)
-   **验证计划** ——代理配置的Zod schemas,任务输入,消息验证
-   **执行模式** ——状态语句,停止理由正常化,出错类型
-   **MCP合同** - 16个多边CP工具的工具输入/输出计划

## 使用量

```typescript
import {
  Agent,
  Task,
  TokenUsage,
  agentCreateSchema,
} from '@adhd/agent-base-types';

const agentConfig = agentCreateSchema.parse({
  name: 'my-agent',
  config: { provider: 'anthropic', model: 'claude-opus-4-1' },
});
```

## 关键文件

-   `src/domain.ts` ——核心接口定义(代理,任务,会话,消息,托克内乌斯克)
-   `src/validation/` 所有投入的Zod计划
-   `src/index.ts` ——公共出口

## R10 微量符号类型( 添加, 所有可选)

-   **虎克事件** (单位:千美元)`HookEventMap` 内 `src/hooks.ts`: `task:startup` (单位:千美元)`TaskStartupPayload`: per- server MCP 连接 ms, 工具准备 ms, 队列等待, 会话 ms, 工具计数), `dispatch:completed` (单位:千美元)`DispatchCompletedPayload`: 类型、 同步/ 背景模式、 任务代号、 父屏蔽 ms) 和 `background:delivered` (单位:千美元)`BackgroundDeliveredPayload`; 仅输入,尚未发射). `HookEvent` 实值 `keyof HookEventMap`,因此这些被 `HookRegistry` 没有进一步登记.
-   **有效载荷字段 :** `PreToolCallPayload` 收益 `concurrencyClass`, (中文(简体) ), `turnIndex`, (中文(简体) ), `groupIndex`, (中文(简体) ), `queuedMs`· ; `PostToolCallPayload` 收益 `errorClass`, (中文(简体) ), `resultBytes`, (中文(简体) ), `noteAppended`; 数据 `post:model_response` 有效载荷收益 `thinkingConfig`, (中文(简体) ), `thinkingBlocks`, (中文(简体) ), `toolResultBytesIn`, (中文(简体) ), `turnIndex` (已携带) `ttfbMs`) (中文(简体) ).
-   **`ToolDefinition.annotations`** (单位:千美元)`IToolAnnotations`数字 : `readOnlyHint`, (中文(简体) ), `destructiveHint`, (中文(简体) ), `idempotentHint`:引擎-内部元数据. 绝对不能串行到提供者的电线请求上 也不能串行到犬科工具散列上.
-   **`IAnthropicThinking`** (单位:千美元)`{ type: 'adaptive'; display?: 'summarized' | 'omitted' } | { type: 'disabled' }`在人类的 `ProviderConfig` 财务报告和审定财务报表 `PartialBinding` 作为 `thinking`。默认未设定;由管弦乐手验证 `providerConfigSchema`。 。 。 .

## 2.0.2 变动

-   **TokenUsage 扩展** - 添加 `uncachedInputTokens`, (中文(简体) ), `cacheReadTokens`, (中文(简体) ), `cacheCreationTokens`, (中文(简体) ), `reasoningTokens` 字段(提供者中性会计)
-   已添加 `peakContextTokens` 到任务跟踪( u)

## 建筑

-   6个包装剂框架家族的一部分
-   取决于: `zod`
-   取决于: 所有其他@adhd/ agent- \* 软件包

见 `/entrypoint/agent-mcp/docs/architecture-and-security.md` 用于全代理运行时架构.

## 常见问题

### @adhd/agent-base-types 是什么？

@adhd/代理生态系统的共享类型脚本类型和计划

### 如何安装 @adhd/agent-base-types？

在项目目录运行 npm install @adhd/agent-base-types，或使用 pnpm add / yarn add / bun add。

### @adhd/agent-base-types 支持 TypeScript 吗？

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

### @adhd/agent-base-types 支持 ESM 还是 CommonJS？

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

### @adhd/agent-base-types 可以商用吗？

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

### @adhd/agent-base-types 的下载量有多少？

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

### @adhd/agent-base-types 还在维护吗？

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