# @agent-inspect/vitest 中文文档

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

版本：6\.31\.35
npm 元数据更新时间：2026-11-04T20:00:38.609Z
中文译文更新时间：2026-11-06T12:07:19.680Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：155 kB，9 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：1 个
- peer 依赖：vitest ^2\.1\.0 \|\| ^3\.2\.6
- 首次发布：2026-06-28T04:39:05.116Z
- 最新版本发布：2026-11-04T20:00:38.200Z
- 近 30 天下载量：3275（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：122（近 12 个月 122 个）

## 中文简介

毒物记录员和实验 Trace Contracts配对员

## 安装

```sh
npm install @agent-inspect/vitest
```

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

## README

# @ agent-incept/ vitest (英语)

本地代理检测故障文物的毒物记者,加 **实验** 追踪合同匹配者.

**支助级别:** · 实验(匹配)——见 [支助](https://github.com/rajudandigam/agent-inspect/blob/main/docs/SUPPORT-LEVELS.md)。 。 。 .

## 何时使用

-   运行仪器代理的虚拟套房
-   关于失败的公关文物而不改变断言库
-   实验轨迹断言 `toPassTraceContract` 编号 : `toHaveRequiredTool`

## 不使用时

-   评分( 使用 `@agent-inspect/jest`(中文(简体) )
-   没有代理检查痕迹的测试

## 安装

```bash
npm install agent-inspect @agent-inspect/vitest vitest
```

**端点 :** `vitest@^2.1.0 || ^3.2.6` (Vites 2仍供消费者使用;单雷波测试跑者使用Vitest → 3.2.6)

## 记者的例子

```ts
// vitest.config.ts
import { defineConfig } from "vitest/config";
import agentInspectReporter from "@agent-inspect/vitest";

export default defineConfig({
  test: {
    reporters: ["default", agentInspectReporter({ traceDir: ".agent-inspect" })],
  },
});
```

## 实验匹配器

```ts
import { expect } from "vitest";
import { agentInspectVitestMatchers } from "@agent-inspect/vitest";

expect.extend(agentInspectVitestMatchers);

expect(read).toPassTraceContract(contract);
expect(read).toHaveRequiredTool("lookup_orders");
```

没有 `expectTrace(...).toSatisfyTraceContract` 帮助者——使用上面的匹配者.

## 隐私

-   仅在失败时写入本地跟踪( 默认情况下)
-   没有默认上传到代理检查

## API 密码

-   默认导出: Vitest 报告厂
-   `agentInspectVitestMatchers` - 实验

## 国 际

失败后 : `npx agent-inspect report <run-id>`

## 限制

-   匹配者为 **实验** 并可能在未成年人中演变
-   当匹配者不足时,优先使用深 CI 门的CLI / Trace Contact API

## 文档

-   [CI 文物](https://github.com/rajudandigam/agent-inspect/blob/main/docs/CI-ARTIFACTS.md)
-   [TRACE-COTRACTS.md (美国)](https://github.com/rajudandigam/agent-inspect/blob/main/docs/TRACE-CONTRACTS.md)
-   [TRACE-FACTS.md (美国)](https://github.com/rajudandigam/agent-inspect/blob/main/docs/TRACE-FACTS.md)

## 解决问题

-   **没有文物 :** 确保跟踪在测试和记者时被写入 `traceDir` 匹配
-   **保留了原始错误 :** 记者不会吞下 Vitest 失败

## 版本

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

## 许可证

麻省理工学院

## 常见问题

### @agent-inspect/vitest 是什么？

毒物记录员和实验 Trace Contracts配对员

### 如何安装 @agent-inspect/vitest？

在项目目录运行 npm install @agent-inspect/vitest，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：vitest（^2\.1\.0 \|\| ^3\.2\.6）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @agent-inspect/vitest 支持 TypeScript 吗？

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

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

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

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

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

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

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

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

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