@harness-engineering/types

中文文档
0.37.0发布于 2026/11/17MITTypeScriptESM + CJS构建来源已验证近 30 天下载 9489

Harness 工程的脚本类型和接口

中文使用文档
文档目录12 节
  1. 安装
  2. 使用量
  3. API 密码
  4. Result<T, E>
  5. Ok<T>(value: T)
  6. Err<E>(error: E)
  7. isOk<T, E>(result: Result<T, E>)
  8. isErr<T, E>(result: Result<T, E>)
  9. UsageRecord
  10. ModelPricing
  11. DailyUsage 编号 : SessionUsage
  12. 许可证

@harness-engineering/类型

用于牵引-工程包的共享类型脚本.

安装

npm install @harness-engineering/types
# or
pnpm add @harness-engineering/types

使用量

import { Result, Ok, Err, isOk, isErr } from '@harness-engineering/types';

// Create successful result
const success: Result<number, never> = Ok(42);

// Create error result
const failure: Result<never, string> = Err('Something went wrong');

// Type-safe error handling
function divide(a: number, b: number): Result<number, string> {
  if (b === 0) {
    return Err('Division by zero');
  }
  return Ok(a / b);
}

const result = divide(10, 2);
if (isOk(result)) {
  console.log(result.value); // 5
} else {
  console.error(result.error);
}

API 密码

Result<T, E>

在所有牵引装置-工程API中使用的类型安全错误处理.

type Result<T, E = Error> = { ok: true; value: T } | { ok: false; error: E };

Ok<T>(value: T)

创建成功的结果.

Err<E>(error: E)

创建失败的结果.

isOk<T, E>(result: Result<T, E>)

类型守护以检查结果是否好 .

isErr<T, E>(result: Result<T, E>)

类型守护以检查结果是否为 Err .

UsageRecord

成本跟踪的扩展符号使用条目 。 编曲 TokenUsage 带有会话元数据,缓存符号计数,模型标识符,以及以整数微美元计的成本.

import type { UsageRecord } from '@harness-engineering/types';

ModelPricing

每100万令牌按美元计的模型定价率。 包括输入、输出和可选缓存读取/写率.

import type { ModelPricing } from '@harness-engineering/types';

DailyUsage 编号 : SessionUsage

每日趋势和每会分类的汇总使用率。 用于 harness usage CLI命令.

许可证

麻省理工学院

版本与发布记录

@harness-engineering/types 共发布 46 个版本,首次发布于 2026/03/17;过去 12 个月发布了 46 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.37.0latest2026/11/17今天
0.36.02026/11/125 天前
0.35.02026/10/2027 天前
0.34.02026/09/092 个月前
0.33.02026/09/082 个月前
0.32.02026/09/052 个月前

关于 @harness-engineering/types 的常见问题

@harness-engineering/types 是什么?

Harness 工程的脚本类型和接口

如何安装 @harness-engineering/types?

在项目目录运行 npm install @harness-engineering/types,或使用 pnpm add / yarn add / bun add。

@harness-engineering/types 支持 TypeScript 吗?

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

@harness-engineering/types 支持 ESM 还是 CommonJS?

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

@harness-engineering/types 可以商用吗?

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

@harness-engineering/types 的下载量有多少?

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

@harness-engineering/types 还在维护吗?

最新版本 0.37.0 发布于 2026/11/17(今天);至今共发布 46 个版本,其中过去 12 个月发布了 46 个;首次发布于 2026/03/17。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。