@cotal-ai/herdr

中文文档
0.157.2发布于 2026/11/11Apache-2.0TypeScriptES Module零依赖构建来源已验证近 30 天下载 5.8万

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

中文使用文档
文档目录7 节
  1. 它会做什么
  2. 产卵的原理
  3. 秘诀
  4. 不是草药代理的侧边栏
  5. 使用量
  6. 测试
  7. 与 @cotal-ai/tmux

翻译:

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

等级 : extensions/. 同行依赖 @cotal-ai/core; 自动注册 导入.

要求草药0.8.0或以后(brew install 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.

使用量

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

库组成根可以直接导入:

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 (单位:千美元)经理监督)和 根 AGENTS.md 数据 等级规则.

版本与发布记录

@cotal-ai/herdr 共发布 379 个版本,首次发布于 2026/08/14;过去 12 个月发布了 379 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.157.2latest2026/11/11今天
0.157.12026/11/11今天
0.157.02026/11/11今天
0.156.02026/11/11今天
0.155.22026/11/10今天
0.155.12026/11/10今天

其他发布通道:hack → 0.28.0-hack-20260823234508。

关于 @cotal-ai/herdr 的常见问题

@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 和提交记录判断。