# @agentshouse/app-bridge 中文文档

规范地址：https://npmcn.com/package/%40agentshouse/app-bridge/

版本：0\.1\.0-c1e5c86e4cadd
npm 元数据更新时间：2026-11-07T20:08:51.089Z
中文译文更新时间：2026-11-05T20:09:38.806Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：336 kB，115 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=24
- 运行依赖：0 个
- 首次发布：2026-09-19T10:10:44.299Z
- 最新版本发布：2026-11-07T20:08:50.913Z
- 近 30 天下载量：42858（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：338（近 12 个月 338 个）

## 中文简介

代理类型. house App Bridge House hands Every App:导航,标签标题和图标,仪式,安装,通知,状态,App发布代码,App和站点截图读取,App消息和Chat,有一个访问器和一页内 te

## 安装

```sh
npm install @agentshouse/app-bridge
```

也可以使用：`pnpm add @agentshouse/app-bridge`、`yarn add @agentshouse/app-bridge`、`bun add @agentshouse/app-bridge`

## README

# @ agentshouse/ app- bridge

代理商的类型.house App Bridge,一个访问器和一个页面内测试主机. 房子在它服务的每个App中建桥对象并将其交给页面 在App自己的脚本运行之前; `houseBridge()` 返回对象,所以是一个 App 连桥码都没有 它带着这些家庭:航海, 仪式、安装、通知、电报、状态、App 发布代码、外部呼叫、 App 消息、 App 和 Site 截图读取 说吧. [医生/家庭](https://npmcn.com/package/%40agentshouse/app-bridge/docs/families.md) 描述每个和测试主机.

桥上没有证书 也没有Runtime家庭。 房屋建造 mD运行时客户端进入了桥边的页面,并服务于Chat,所以 app 导入、构造和捆绑均不: `bridge.runtime` 解决客户端.

房子的App建设指南是它的指南 `apps/` 页面,其中 `guide/open` 打开.

## 使用

```js
import { houseBridge } from '@agentshouse/app-bridge';

const bridge = houseBridge();
const md = await bridge.runtime;

bridge.onAddress((address) => render(address));
bridge.onStatus((status) => showSync(status.sync));
bridge.setTab({ title: 'Atlas (3)' });

open('/rooms/atlas');
function open(address) {
  bridge.push(address);
}

async function manageSecurity(securityPath) {
  try {
    await bridge.ceremony(securityPath);
  } catch (refusal) {
    if (refusal.name === 'HouseCeremonyRefused') report(refusal.path);
  }
}
```

`bridge.runtime` 决定: `MdRuntimeClient` 联 合 国 `@agentshouse/mdruntime/client`, (中文(简体) ), 其README描述了其成员. 内容 `call(method, params)` 是一个远程程序呼叫 以本院名义行事,例如 `call('rooms/members/list', { room_ref })`数字 : `HouseMethods` 每个名字都有豪斯自己的输入, `HouseParams<Name>`并回答, `HouseResult<Name>`。 。 。 .

## 没有房子的测试

```js
import { houseBridge } from '@agentshouse/app-bridge';
import { createHouseBridgeTestHost } from '@agentshouse/app-bridge/test-host';

const host = createHouseBridgeTestHost({ address: '/rooms/atlas' });
const bridge = houseBridge();

bridge.push('/rooms/atlas/members');
host.open('/rooms/atlas');
```

## 常见问题

### @agentshouse/app-bridge 是什么？

代理类型\. house App Bridge House hands Every App:导航,标签标题和图标,仪式,安装,通知,状态,App发布代码,App和站点截图读取,App消息和Chat,有一个访问器和一页内 te

### 如何安装 @agentshouse/app-bridge？

在项目目录运行 npm install @agentshouse/app-bridge，或使用 pnpm add / yarn add / bun add。

### @agentshouse/app-bridge 支持 TypeScript 吗？

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

### @agentshouse/app-bridge 支持 ESM 还是 CommonJS？

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

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

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

### @agentshouse/app-bridge 可以商用吗？

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

### @agentshouse/app-bridge 的下载量有多少？

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

### @agentshouse/app-bridge 还在维护吗？

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