deepseek-harness/packages/test-support/tool-testkit/README.zh.md

description, kind

description	kind
在仓库测试和基准测试中定义测试工具，并调用工具流水线或选定的执行器。	package-library

@deepseek-ai/dsh-tool-testkit

English | 中文

概述

使用本包定义生成内容的测试工具，并在不运行 Agent 回合的情况下测试工具执行。测试和基准测试将这些辅助函数作为开发依赖导入。调用方负责 Cordis context、插件组合和资源清理。

目录

• 使用本包
• 理解实现
• 进一步探索
• 模型体验
• 已知限制与后续工作
• 开发备注

---

使用本包

将 @deepseek-ai/dsh-tool-testkit 加入消费包的 devDependencies。测试只需要渲染内容而不需要领域结果值时，可以定义以下 fixture：

import { defineContentToolFixture } from '@deepseek-ai/dsh-tool-testkit'

const tool = defineContentToolFixture({
  name: 'echo',
  description: 'Return a test message.',
  parameters: {},
  execute: async () => [{ type: 'text', text: 'hello' }],
})

通过调用方的工具注册表注册返回的定义。使用 executeToolFixture 执行已解析的调用，或使用 executeModelToolFixture 将一次 JSON 编码的调用交给选定的执行器。后者要求调用方挂载该执行器，并在参数无法编码为 JSON 或执行器响应缺少结果时拒绝。调用字段见 src/index.ts。

---

理解实现

实现细节——点击展开

src/index.ts 将内容块适配为工具的规范 JSON 值，并将执行委托给生产流水线或注册表。它不创建 context，也不持有插件注册。

---

进一步探索

• 工具包——工具定义、注册表和执行策略。
• 测试策略——为生产行为选择验证方式。
• test-support 分组地图——同组测试工具。

---

模型体验

无，这些测试辅助函数不组装或发送模型请求。

KV Cache 影响

无；本包自身不发送 provider 请求。

已知限制与后续工作

• 内容数组值仅用于测试 fixture；产品工具声明领域自己的输出 schema。
• 直接执行流水线不包含模型批次调度。两种执行辅助函数都不记录根 Session 日志；验证会话记录时应运行 Agent 回合。
• 插件组合和 context 释放仍由调用方负责。

开发备注

维护者工作上下文——点击展开

无。