@harness-engineering/cli

中文文档
14.1.0发布于 2026/11/17MITTypeScriptES Module构建来源已验证近 30 天下载 1万

用于Harness工程的CLI工具包

中文使用文档
文档目录13 节
  1. 安装
  2. 图标
  3. harness init
  4. harness validate
  5. harness check-deps
  6. harness check-docs
  7. harness cleanup
  8. harness fix-drift
  9. harness add
  10. harness agent
  11. 全球选项
  12. 配置
  13. 退出代码

@harness-engineering/cli (英语)

Harness工程工具包的CLI.

安装

npm install -g @harness-engineering/cli

图标

harness init

启动一个新的牵引工程项目.

harness init
harness init --name my-project

harness validate

运行所有验证检查 .

harness validate
harness validate --json
harness validate --verbose

harness check-deps

验证依赖层并检测循环依赖.

harness check-deps

harness check-docs

检查文件覆盖面.

harness check-docs
harness check-docs --min-coverage 90

harness cleanup

侦测 en问题.

harness cleanup
harness cleanup --type drift
harness cleanup --type dead-code

harness fix-drift

自动修补等效问题.

harness fix-drift           # Dry run
harness fix-drift --no-dry-run  # Apply fixes

harness add

在项目中添加组件 .

harness add layer services
harness add module user
harness add doc architecture

harness agent

代理指挥.

harness agent run review
harness agent review

全球选项

  • --config <path> - 配置文件的路径
  • --json - 输出为JSON
  • --verbose - 微波输出
  • --quiet - 最小输出

配置

创建 harness.config.json 在您的工程根中 :

{
  "version": 1,
  "name": "my-project",
  "layers": [
    { "name": "types", "pattern": "src/types/**", "allowedDependencies": [] },
    { "name": "domain", "pattern": "src/domain/**", "allowedDependencies": ["types"] }
  ],
  "agentsMapPath": "./AGENTS.md",
  "docsDir": "./docs"
}

退出代码

  • 0 - 成功吗
  • 1 - 验证失败
  • 2 - 错误

版本与发布记录

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

版本发布日期距今
14.1.0latest2026/11/17今天
14.0.02026/11/125 天前
13.0.02026/10/2027 天前
12.10.12026/09/241 个月前
12.10.02026/09/181 个月前
12.9.02026/09/172 个月前

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

@harness-engineering/cli 是什么?

用于Harness工程的CLI工具包

如何安装 @harness-engineering/cli?

在项目目录运行 npm install @harness-engineering/cli,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 harness、harness-mcp,可以用 npx harness 直接运行。

@harness-engineering/cli 支持 TypeScript 吗?

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

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

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

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

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

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

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

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

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