Permalink to 测试测试

Permalink to 测试运行器测试运行器

Hypit 使用 Node.js 内置的测试运行器（node:test），而不是 Jest、Vitest 或 Mocha。

bash

pnpm test          # 包测试 + boundary 测试

测试文件位于 packages/<name>/test/，扩展名为 .test.ts。它们通过 glob packages/*/test/**/*.test.ts 被发现。

Permalink to 编写测试编写测试

typescript

import assert from "node:assert/strict";
import { describe, test } from "node:test";

import { someFunction } from "@hypit/example";

describe("someFunction", () => {
  test("returns the expected result", () => {
    const result = someFunction(input);
    assert.deepStrictEqual(result, expected);
  });
});

Permalink to 准入规则准入规则

默认测试集只保留三类测试：可观察合同、架构边界，以及可能破坏产物、重复付费调用或让运行环境不安全的失败模式。同一事实只在其归属层测试一次；跨包装配使用一个已提交的完整图夹具，不在每个上层重复搭建半条视频链路。

不要为了让每个包看起来都有覆盖率而写测试，也不要重复比对 Manifest 数组、保留已经删除的预发布参数或数据库形态、把纯文档 UI helper 塞进系统测试。组件注册本身会拒绝 Manifest 与实现漂移。过时行为删除时，其测试也一起删除，不把测试集当作项目历史档案。

Permalink to 测试模式测试模式

Permalink to 纯编译测试纯编译测试

最常见的模式。编译一份 Author Source 或 Run Source，然后对生成的图、导出、Record 或计划步骤做断言。绝不调用外部服务。

typescript

test("compiles the expected exports", async () => {
  const compiler = createCompiler({ root, packageContributions });
  const workspace = await compiler.openFile("fixture.svml");
  const result = await compiler.compileSource(workspace.entry, workspace);
  assert.equal(result.exports.length, 3);
});

Permalink to provider-测试Provider 测试

在可控的伪传输边界验证请求映射、提交歧义、轮询、下载与失败语义。仓库测试不调用付费 Provider，也不以环境变量开启真实 API smoke/canary；一次真实调用不能证明这些失败边界，反而会引入费用、网络和外部状态噪声。

Permalink to 架构边界架构边界

包边界由 package manifest、公开入口和共享合同表达；测试只验证边界上可观察的行为。仓库不再把源码文本正则当作依赖分析或架构审查的替代品。

不得提交客户或品牌 fixture、凭据痕迹、付费产物、工作站绝对路径与一次性交付脚本。本机 ffmpeg、浏览器或 OpenCV 的集成测试可以显式 opt-in；它们不得联网调用付费服务，也不进入默认测试成功的必要条件。

Permalink to 受环境开关控制的测试受环境开关控制的测试

命令	测试内容	前置条件
`pnpm test:whisperx-service`	Python WhisperX 服务	Python 3.13、uv、frozen sync
`pnpm test:image-opencv`	OpenCV 图像变换	服务自带的解释器，位于 `services/image-opencv/.venv`；要用别的解释器就设 `HYPIT_OPENCV_PYTHON`

要运行本地 HyperFrames 浏览器渲染测试，先在当前 shell 环境中设置 HYPIT_BROWSER_TESTS=1，再从仓库根目录执行以下命令。需要可用的 Chrome、ffmpeg 和 ffprobe。

node --import tsx --test packages/provider-hyperframes-local/test/provider.test.ts

Permalink to 测试-fixtures测试 fixtures

测试夹具放在 packages/<name>/test/fixtures/。它们是普通的 .svml、.svs 和 .svrun 文件，用于覆盖特定的编译路径。

examples/ 目录同时充当集成级别的夹具：

examples/interview/、examples/podcast/、examples/ranking-football/ — 包含 Source、Run 和素材的完整视频项目。
examples/minimal-author-package/ — 带有 Surface 预览的完整组件包。