# @cotal-ai/herdr 中文文档

规范地址：https://npmcn.com/package/%40cotal-ai/herdr/

版本：0\.157\.2
npm 元数据更新时间：2026-11-10T21:02:25.535Z
中文译文更新时间：2026-11-10T20:39:57.973Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40cotal-ai/herdr
原文对照：https://npmcn.com/package/%40cotal-ai/herdr/?lang=original
源码仓库：https://github.com/Cotal-AI/Cotal

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

- 包体积（解压后）：99 kB，15 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：@cotal-ai/core \*
- 首次发布：2026-08-13T23:16:15.901Z
- 最新版本发布：2026-11-10T21:02:25.193Z
- 近 30 天下载量：57845（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：379（近 12 个月 379 个）

## 中文简介

Cotal Herdr 集成:一个Herdr runtime提供商,用于将毒剂产入一个专门的Herdr会场的窗格.

## 安装

```sh
npm install @cotal-ai/herdr
```

也可以使用：`pnpm add @cotal-ai/herdr`、`yarn add @cotal-ai/herdr`、`bun add @cotal-ai/herdr`

## README

# 翻译:

这个 [贺德](https://herdr.dev/) 集成: 在 herdr CLI 上的一个瘦驱动程序( 启动一个窗格运行) 命令, 发送密钥, 关闭它) 外加自动注册 `herdr` `Runtime` 供养. 导入中 将提供者与核心登记在一起 `Registry`所以经理可以把毒剂 产入赫德面板 不取决于此包.

**等级 :** `extensions/`. 同行依赖 [`@cotal-ai/core`](https://npmcn.com/package/packages/core); 自动注册 导入.

要求草药0.8.0或以后(`brew install herdr`,或见 [医生 dev](https://herdr.dev/).0.7.x (中文(简体) ) 已曝光 `agent start --cwd -- <argv>` 财务报告和审定财务报表 `agent send`,其中0.8.0被删除,以及两者 行没有可用的子集. `available()` 而不是仅仅证明 二进制运行,所以一个年长的草药报告运行时间是没有的,而不是宣传它已经准备好了 然后让每一个产卵都失败.

## 它会做什么

这个 `herdr` `Runtime` 给每个特工一个名为Herdr的专有会议, `cotal-<space>`,带有自己的服务器和套接字。 它从不使用您默认的Herdr 会话,所以没有 地表操作可以触摸不相干地表. 会话服务器在第一个产卵上开始无头 并且拥有面板,所以当经理的终端消失时,代理员会不停地跑 `herdr session attach cotal-<space>`。 。 。 .

默认情况下, 每个代理都获得自己的工作空间和名标签; 设置 `COTAL_HERDR_LAYOUT=split` 在管理器上将代理折叠成一个共享标签(未知值会响亮出故障)。 优雅的 停止类型 `/exit` 然后关闭窗帘; 硬站立即关闭.

## 产卵的原理

herdr 0.8.0没有"创建一个运行此命令的窗帘"原始. `agent start` 附上a _公认的代理类型_ 到现有的窗帘, `pane split` 需要一个窗帘来分割, 和一个新鲜的 无头服务器根本没有工作空间、标签或窗格。 所以,一个产卵是:

1.  `workspace create --cwd <cwd> --label <name> --no-focus`:一个呼叫产生一个工作空间,一个标签, 并有根花纹,有工作目录。 也给一个特效 无后续移动的布局.
2.  `tab rename <tab_id> <name>`数字 : `--label` 名称 _工作空间_,和标签条,这就是什么 操作员读取,否则会显示一个空数.
3.  `pane run <pane_id> "exec <command>"`平地 `pane run` 窗帘的外壳在之后活着 命令出口,所以窗格会活过代理,而且一个出口永远无法证明. `exec` 替换外壳,当代理退出时,草药会关闭窗帘.
4.  票价 `pane process-info` 直到进程实际出现, 范围. `pane run` 类型为 a 贝壳,所以一个成功的呼叫 证明键盘被送出,而不是任何开始 过程从未出现 半建的工作空间被撕毁 和产卵抛出.

生命周期是赫德全球独一无二的 `terminal_id`; 工作空间范围公众 `pane_id` (当一个窗帘被移动时,它会改变)在每一个窗帘扫描的呼叫之前重新解开,关闭 整个届会的面板清单。 退出将等待清点清单和因提供者出错而关闭的民调: a 失败的库存投放, 而不是报告错误的退出 .

## 秘诀

连接器 env( 身份、 证书、 控制符) 仅使用所有者(`0600`) 发射台脚本 a 非公开 `0700` 目录。 herdr 只看到可执行节点和脚本路径以及脚本 装入后立即删除自己的目录.

**不要"简化"这个给草原人 `--env KEY=VALUE`。 。 。 .** 两者都有 `workspace create` 财务报告和审定财务报表 `tab create`它把值直接放入窗帘回滚, 地点 `herdr pane read` 返回逐字记录。 发射装置的存在正是为了避免这种情况.

## 不是草药代理的侧边栏

外生的特工会 **没有** 在赫尔德的代理人侧边栏上出现 这是0.8.0的财产 而不是驱动程序可以修正的东西: 草药将其代理注册保留在一套固定的确认的 类型(`pi`, (中文(简体) ), `claude`, (中文(简体) ), `codex`, (中文(简体) ), `gemini`, (中文(简体) ), `cursor`,...)附着在现有的窗帘上,通过 `agent start --kind`一种Cotal剂 运行一个任意的发射器, 所以它从来不是其中的一种, 财务报告和审定财务报表 `agent get`编号 :`agent list` 无法看见它。 代理通过标签和 (单位:千美元) `cotal` 窗格上的元数据符号(可见于 `pane get` 和面条UI.

## 使用量

```bash
cotal ext add @cotal-ai/herdr
cotal supervise --runtime herdr
```

库组成根可以直接导入:

```ts
import "@cotal-ai/herdr"; // self-registers; no other setup needed
```

## 测试

`pnpm smoke:herdr` 在孤立的命名会话中运行套件与真正的草药服务器。 它跳过 当草药不在或太老时发出响亮的通知 CI安装了草药,以便永远跳过 默然立入为通.

## 与 `@cotal-ai/tmux`

相同的形状( 内观, 无 PTY 流线; 共享的每个空间会话), 但窗体生活在 Herdr 语句,其服务器也以本地方式跟踪到 pane 状态,运行时间基于 pane 而不是 窗口。 通过 POSIX 检测到服务器启动失败 `ps` 何处存在;没有它 (窗户,一个无 ps- 容器) 死亡永远不会被假定, 同样的故障在边缘表面 启动窗口, 使用服务器自己的 stderr .

见 [文档/建筑图.mdx](https://npmcn.com/package/docs/architecture.mdx) (单位:千美元)_经理监督_)和 [根 AGENTS.md 数据](https://npmcn.com/package/AGENTS.md) 等级规则.

## 常见问题

### @cotal-ai/herdr 是什么？

Cotal Herdr 集成:一个Herdr runtime提供商,用于将毒剂产入一个专门的Herdr会场的窗格\.

### 如何安装 @cotal-ai/herdr？

在项目目录运行 npm install @cotal-ai/herdr，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@cotal-ai/core（\*）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @cotal-ai/herdr 支持 TypeScript 吗？

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

### @cotal-ai/herdr 支持 ESM 还是 CommonJS？

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

### @cotal-ai/herdr 可以商用吗？

@cotal-ai/herdr 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @cotal-ai/herdr 的下载量有多少？

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

### @cotal-ai/herdr 还在维护吗？

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