# @agentshouse/kit 中文文档

规范地址：https://npmcn.com/package/%40agentshouse/kit/

版本：0\.2\.1-c8a6a7fe83281
npm 元数据更新时间：2026-11-07T12:18:39.800Z
中文译文更新时间：2026-11-05T22:44:32.087Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：343 kB，56 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：24\.22\.1
- 运行依赖：7 个
- peer 依赖：@agentclientprotocol/codex-acp 2\.5\.0，@agentclientprotocol/claude-agent-acp 0\.100\.0
- 首次发布：2026-09-27T09:57:17.963Z
- 最新版本发布：2026-11-07T12:18:39.423Z
- 近 30 天下载量：19515（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：203（近 12 个月 203 个）

## 中文简介

Kit 连接环境与代理商. house.

## 安装

```sh
npm install @agentshouse/kit
```

也可以使用：`pnpm add @agentshouse/kit`、`yarn add @agentshouse/kit`、`bun add @agentshouse/kit`

## README

# 阿标

Kit 连接环境、 Linux 计算机或服务器到 [探员们,豪斯](https://agents.house/)它运行 您的代理谈话通过您选择的代理 CLIs 并给每个代理 `house` 命令.

## 安装

运行 `sh -c 'kit=$(curl -fsSL "$0") || { echo "Kit could not be downloaded; run this command again." >&2; exit 1; }; eval "$kit"' agents.house/kit`, (中文(简体) ), 或者说 `& { try { $kit = irm agents.house/kit.ps1 } catch { throw 'Kit could not be downloaded; run this command again.' }; & ([scriptblock]::Create($kit)) @args }` 在 Windows 上,没有运行任何失败的下载,并再次更新; 选项随之而来 `agents.house/kit`。 。 。 . 在 macOS 和 Linux 上, 它将 Kit 本地安装在自己的账户下, 没有管理员密码, 作为运行的服务 当你被登录. `kit` 财务报告和审定财务报表 `house` 然后在您的登录外壳 `PATH`,您的工作空间是 `~/AgentsHouse` 除非你们 通过 `--workspace <path>`。每次运行时, Kit 都会将 Kit 释放出您的大楼服务, 它运行的节点 js 和代理适配器, 在运行的节点和代理适配器旁边的目录中, 然后启动它; 较早的则停留到下一次发布。 Kit也自我更新:当你的大楼再次发行时,Kit将它放在同样的位置上,一旦没有转弯,它的服务即告结束,或者容器的重启政策,启动它. 当House拒绝运行太老或太新颖的Kit时,Kit立刻将你的大楼的放出,结束任何运行的转弯,结束的方式也一样;虽然它不能,却保持离线,印出为什么与重新安装它的命令,并定期再次尝试.

添加 `--container` 将 Kit 运行在一个 Docker 容器中, 而您的工作空间安装在 `/agents/house`;然后,你的代理人只接触 工作空间。 该容器的图像没有 Kit 发布和 Node.js : 每跑一次都放在 Kit 家里 `kit` 文件夹,再次创建的容器保存该文件夹。 在视窗上, 阿杰的家是多克的音量 `house-kit-home` 而容器是一个选择。 附录a `kit` 或者说 `house` 命令在容器中运行. 在连接的计算机上运行另一个选项的命令 以新的环境取代环境 其代理结束 以不同的方式运行 `HOUSE_KIT_HOME` 从运行中的 Kit 进程要求您在它取代这个进程之前确认, 然后按原样离开 Kit .

在您的 Linux 服务器上运行 Linux 命令 `--linux` 以本地方式安装 Kit, 工作空间位于 `/agents/house` 和失踪 `ca-certificates`, (中文(简体) ), `curl` 或者说 `git` 通过相接装置; `kit` 财务报告和审定财务报表 `house` 在服务器上 `PATH`。 。 。 .

Kit为苹果硅上macOS 27所建,AMd64上Ubuntu 26.04 LTS和AMd64上Windows 11所所建. 在另一个发行、发行或架构上,命令打印出一条警告行,例如 `Warning: macOS 26.7.1 is outdated; update to macOS 27.`并安装。 它只拒绝 amd64 和 arm64 以外的架构, 本地安装在 macOS 上超过 13.5 , 本地安装在 Linux 没有 glibc 2. 28 或 更新, 其中 `--container` 仍然运行克特。 在没有系统的Linux上,它安装和连接了 Kit,但开始不动:运行 `kit resident` 命令它在您自己的服务管理器下打印,当它以失败结束时重新启动它. `--container` 在Ubuntu和Debian上安装多克引擎;另一个Linux首先需要工作多克引擎.

Kit 通过您登录 shell 找到的链接运行每个代理 CLI , 并通过 CLI 自己找到并安装一个缺失的 安装器。 当它开始后, Kit 运行每个 CLI 自身的更新命令, 例如 `claude update`,旁边 您的对话 : 运行中的对话保留其版本, 而下一个则运行新版本 。 年龄大于 虽然Kit的对话可能失败:Kit告诉House的版本 最古老的发布及其更新命令. Kit 也给环境局的每个探员 以代理技能 `@agentshouse/skills`,在每个 Kit 发行版本安装。 添加 `--no-skills` 命令他们离开;再运行一次,没有旗帜带他们回来.

## 图标

`kit login` 在此计算机上打开或打印您在浏览器中确认的链接 并保持环境证书 `$HOUSE_KIT_HOME` 当它被设定, 否则在 `~/.house-kit`,或在 `house-kit-<uid>` 在临时目录下,当您的家只读时. `--environment <id>` 重新连接您已有的环境 ; `--rooms <ref>[,<ref>...]` 给它 只有那些房间和 `--no-private` 每个房间 除了你的私人房间; `--code <code>` 立即连接而无链接. 登录也会连接自己的代理商: 在代理商谈话之外, `house <tool>` 电话 房子,像你一样 `git` 复制并推进您的 Apps `<house>/app/` 和你一样,每个都穿透了这个套装 家为 `$HOUSE_KIT_HOME` 名称,直到您取消连接. `house help` 列出工具。 代码会议开始于 登录独行 `house` 在沙盒外指挥. `kit logout` 断开此选项 电脑,停止 Kit 进程,结束你自己的代理连接,所以 `house` 财务报告和审定财务报表 `git` 没有 更长时间的扮演你在这里; 稍后 `kit login` 重新连接同一环境,或连接 这台电脑是新的 当豪斯不再持有它.

`kit resident` 保持环境的连接,并在环境连接时复制您选择的每个房间的文本 工作空间中的 Git 仓库 `local-copies`,并保留一个房间的复制件 原样,不再刷新,一旦 房间可能不再复制到这里. `house fetch` 做同样和记录 豪斯的变动 在每份副本 `refs/house/received`; 重置其上, 承诺并运行 `house push --owner` 在副本中,通过安装命令 集装箱。 一个特工运行两者,没有 `--owner`。 。 。 . `house upload` 财务报告和审定财务报表 `house download` 将一个房间的其他文件直接移动到磁盘和豪斯商店之间,一个被破损的上传内容会自行恢复.

Kit 在代理读取之前将每个音频文件您的消息转换成代理链接, 并保存一个无法从开始变成文本的信息 。 在复制时,演讲引擎和模型在环境证书旁使用大约425 MB;关闭后删除它们.

当您在 Web 向导的页面上按下 Run 时, Kit 用 `bash` 在电脑上的终端中,像你一样,在家中和目录中,它运行代理的CLIs,与您的登录 shell's `PATH`;页面显示终端并取出您的打字,并关闭页面,或Kit失去与House的连接,结束脚本及其子进程. Kit不保存脚本指纹 也不输入 您保存的脚本从一个 Web 向导运行时的功能, 从同一家、 目录和 `PATH`,当您的私人房间或代理机的触发器运行时,没有终端,标准输入上什么都没有,当您按下Run现在的页面时,可以在终端中输入。 Kit 将运行的输入写为 JSON , 仅您可以读取的文件, 其路径在其中 `HOUSE_INPUT`,并在运行结束后删除;在运行的时间限制或失去与House的连接时结束脚本及其子进程,并发送House所打印的脚本的结尾,直到运行的输出限制,没有任何一行持有您输入的行.

## 许可证

麻省理工学院.

## 常见问题

### @agentshouse/kit 是什么？

Kit 连接环境与代理商\. house\.

### 如何安装 @agentshouse/kit？

在项目目录运行 npm install @agentshouse/kit，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 kit、house，可以用 npx kit 直接运行。

### @agentshouse/kit 支持 TypeScript 吗？

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

### @agentshouse/kit 支持 ESM 还是 CommonJS？

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

### @agentshouse/kit 需要什么版本的 Node\.js？

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

### @agentshouse/kit 可以商用吗？

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

### @agentshouse/kit 的下载量有多少？

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

### @agentshouse/kit 还在维护吗？

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

