# @by-association-only/harness 中文文档

规范地址：https://npmcn.com/package/%40by-association-only/harness/

版本：0\.7\.3
npm 元数据更新时间：2026-11-06T13:06:55.037Z
中文译文更新时间：2026-11-08T21:04:28.411Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40by-association-only/harness
原文对照：https://npmcn.com/package/%40by-association-only/harness/?lang=original
项目主页：https://github.com/baoagency/harness#readme
源码仓库：https://github.com/baoagency/harness

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

- 包体积（解压后）：534 kB，111 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=24\.15\.0
- 运行依赖：17 个
- peer 依赖：effect ~4\.0\.2，vite-plus ^1\.1\.0
- 首次发布：2026-10-12T20:16:54.543Z
- 最新版本发布：2026-11-06T13:06:54.847Z
- 近 30 天下载量：3727（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：24（近 12 个月 24 个）

## 中文简介

毒剂从unisian-next:规则书,栅栏,钩子,道具和校验,用于任何Vite+ repo.

## 安装

```sh
npm install @by-association-only/harness
```

也可以使用：`pnpm add @by-association-only/harness`、`yarn add @by-association-only/harness`、`bun add @by-association-only/harness`

## README

# @by-sociation- only/harness (由社会团体所组成)

代理从BAO的unisian-next,用于任何Vite+ repo:用于编码代理的规则书,在代理们的快捷方式上失败的Lint和prose lint,git和Claude代码钩,代理们无法跳过,而浏览器驱动器因此代理证明了其用户所看到的改变.

## 设置回购

Repo 需要 pnpm 和 Vite+ (`vite-plus` (单位:千美元) `vite.config.ts`) (中文(简体) ).

```sh
pnpm add -DE @by-association-only/harness
pnpm exec harness init
```

然后打开Claude代码的回放运行 `/harness-setup`。技能读取回放并填充 `AGENTS.md` 只有repo可以回答,和你在一起,直到 `pnpm check` 财务报告和审定财务报表 `pnpm test` 通过.

包裹出事后, `pnpm exec harness rulebook --update` 将其文本带入 `AGENTS.md`医生和最新技能 它只重写文本之间 `<!-- harness:begin -->` 财务报告和审定财务报表 `<!-- harness:end -->` 标记,所以repo自己的文本保持不变.

Init 也设置重播 [终极](https://github.com/HazAT/ultimate) 内 `.ultimate/`; 其编号 `README.md` 上面写着每个文件做什么 一个在0.7.0前跑入的回扣 `.ultimate/` 来自 `harness rulebook --update`时,除 `.ultimate/automations/ci-watch/`,该秒 `harness init` 复制件, 跳过所有 repo 已有的文件 .

`pnpm exec harness init github --yes` 在默认分支上再添加出期标签,合并-仅承诺合并和分支保护. 无 `--yes` 它打印了电话,没有运行.

## 你得到的东西

| 命令 | 它会做什么 |
| --- | --- |
| `harness init` | 复制规则书、文件、技能、接线钩和CI 输入重播,并将克洛德代码接线钩从包中运行;从不覆盖 |
| `harness rulebook --check` | 当Repo中一组带状文字与已安装的软件包不同时失败; `--update` 重写区块和外面的任何东西 |
| `harness green-tree run <script>` | 运行 `<script>:steps`,当它已经传到这棵树上时跳过它 |
| `harness worktree <branch>` | 为经纪人做个工作树; `--done <branch>` 清理一个合并的 |
| `harness second-opinion "<q>"` | 在代理问你之前 问一个新来的只读的代理 |
| `harness ci-watch` | 打印默认分支上运行的每个失败动作的 FIRE 线条; Ultimate 的 `.ultimate/automations/ci-watch` 运行它 |
| `harness sighting <message file>` | 拒绝实施 `Sighting: <slug>` 拖车 `git log` 已经持有,直到其分阶段规则或工具; `commit-msg` 运行它 |
| `harness verify <command>` | 在真实浏览器中驱动产品并写入证据 |
| `harness vendor-agent-sources` | 克隆人压住上游源头 所以特工们读了,而不是他们的记忆 |
| `harness pins --check` | 失败的时间 `docs/pins.md` 和已安装的版本不一致 |
| `harness peers` | 列出公开重置至少两道预放线的针头 `docs/pins.md`在repo的名册上标出缺失的 |
| `prose-lint` | AI - slop propers 代理的失败者在文件、技能和承诺中写作 |

从 Lint 插件加载 `@by-association-only/harness/lint`; 扩展 `harnessLint` 输入 `vite.config.ts`。 。 。 .

## 常见问题

### @by-association-only/harness 是什么？

毒剂从unisian-next:规则书,栅栏,钩子,道具和校验,用于任何Vite\+ repo\.

### 如何安装 @by-association-only/harness？

在项目目录运行 npm install @by-association-only/harness，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：effect（~4\.0\.2）、vite-plus（^1\.1\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。它还提供命令行工具 harness、prose-lint，可以用 npx harness 直接运行。

### @by-association-only/harness 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/by-association-only\_\_harness 是否存在。

### @by-association-only/harness 支持 ESM 还是 CommonJS？

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

### @by-association-only/harness 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=24\.15\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @by-association-only/harness 可以商用吗？

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

### @by-association-only/harness 的下载量有多少？

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

### @by-association-only/harness 还在维护吗？

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