# @condorinst/mobile-bridge 中文文档

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

版本：0\.27\.0
npm 元数据更新时间：2026-11-04T10:34:46.185Z
中文译文更新时间：2026-11-11T01:13:12.561Z
软件包许可：SEE LICENSE IN LICENSE

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

原始 npm 页面：https://www.npmjs.com/package/%40condorinst/mobile-bridge
原文对照：https://npmcn.com/package/%40condorinst/mobile-bridge/?lang=original
项目主页：https://bitbucket.org/condorinstprogdev/mobile-bridge
源码仓库：https://bitbucket.org/condorinstprogdev/mobile-bridge

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

- 包体积（解压后）：2.2 MB，40 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=18
- 运行依赖：3 个
- 首次发布：2026-06-23T18:27:07.305Z
- 最新版本发布：2026-11-04T10:34:45.979Z
- 近 30 天下载量：2321（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：35（近 12 个月 35 个）

## 中文简介

TypeScript SDK为Condor白标签移动应用的JSQNative桥.

## 安装

```sh
npm install @condorinst/mobile-bridge
```

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

## README

# @condorinst/移动桥

给 **Condor Canvas 应用程序的故乡**: 自成一体的网页 程序在登录后显示在沙盒内。 页面对 app——设备列表,活光读取,历史,权限,语言,a 手机上的缓存,用于重启后必须幸存的东西 `BridgeClient`,以及 该软件包的CLI构建,检查,测试并发布.

## 建立家园——个人或大赦国际代理人

开始于 **[`AGENTS.md`](https://npmcn.com/package/%40condorinst/mobile-bridge/AGENTS.md)**规则 复制的靴子序列 浏览器控制器,验证回路,以及哪个文档拥有每个主题. 这个 给两个观众写过一次.

所有在Npm油管内的船只,所以之后 `npm install` 在磁盘上 `node_modules/@condorinst/mobile-bridge/`,无网络可读。 过 网络,每个文档在被绑定的,未经认证的URL上都是纯文本; `llms.txt` 是索引和 `llms-full.txt` 在一个文件中包含每个文档 :

```
https://cdn.jsdelivr.net/npm/@condorinst/mobile-bridge@0.27.0/llms.txt
https://cdn.jsdelivr.net/npm/@condorinst/mobile-bridge@0.27.0/llms-full.txt
```

机器可读合同——钥匙、命令、限制、能力矩阵——是 `contract/bridge-contract.json`,可导入为 `@condorinst/mobile-bridge/contract`。 。 。 .

> 获取器的注释: Bitbucket 寄存器的登陆页面是 JavaScript 应用程序并返回无可读文本。 使用上面的 jsDelivr URL,或 键盘 `raw/` 文件 URL.

## 安装

```bash
npm install @condorinst/mobile-bridge@^0.27.0
```

包裹上装了预置的 `dist/` (ESM + CJS + 类型声明);无构建 需要我们的工具链 在你身边.

## 国家行动倡议

| 命令 | 对 | 记录在 |
| --- | --- | --- |
| `npx condor-mobile-bridge dev -i dist/index.html` | 在一个类似应用程序的浏览器控制带中,在电话或平板框架中运行您的页面(`--device`(中文(简体) ) | `docs/device-testing.md` |
| `npx condor-mobile-bridge build -i dist/index.html -o dist/bundle.zip` | 将您的构件插入到其中 `index.html` 把它拉起来 | `docs/device-testing.md` |
| `npx condor-mobile-bridge validate -i dist/bundle.zip --strict` | 应用被封锁的 API 应用程序的门和指针 | `docs/device-testing.md` |
| `npx condor-mobile-bridge canvas publish | list | revoke` | 发布您的捆绑到您的公司( 交互式登录) | `docs/device-testing.md` |

## 版本策略( 样本)

-   **帕齐** (单位:千美元)`0.23.x`: bugfix 没有 API 更改.
-   **毛里塔尼亚** (单位:千美元)`0.x.0`:新的可观测密钥,新的命令,后相兼容的API.
    
    > 期间 `0.x`,小起落可能带有断裂变化(样本处理) (b) 未成年者(1.0岁前)作为破门而入)。 键 `^0.27.0` 保持安全补丁.
    
-   **大师** (单位:千美元)`x.0.0`: 不相容的变相( 键重命名, 有效载荷形状) 更改,公共API更改). `1.0.0` 标出生产稳定合同.

本地一方声明 `nativeVersion` 输入 `handshake`; 客户端 声明 `clientVersion`。此释放确实 **没有** 执行硬铸件 验证 - 本地方接受任何 `clientVersion`。真正的验证意愿 一旦有 2+ 版本在田.

## 贝壳侧 (孔多尔)

`BridgeShell`遗产 `Bridge` 单通、模拟模式和 dev 面板为 对于Condor的应用程序外壳, 而不是客户包: [`docs/shell-integration.md`](https://npmcn.com/package/%40condorinst/mobile-bridge/docs/shell-integration.md)。 。 。 .

## 地方发展(SDK贡献者)

```bash
npm install          # installs deps + runs prepare (build)
npm run typecheck    # tsc --noEmit
npm run lint         # biome check
npm run format       # biome format --write
npm run test         # vitest run
npm run build        # tsup (ESM + CJS + types in dist/)
```

## 许可证

专有——孔道文书. 见 [自由主义](https://npmcn.com/package/%40condorinst/mobile-bridge/LICENSE)。 。 。 .

## 常见问题

### @condorinst/mobile-bridge 是什么？

TypeScript SDK为Condor白标签移动应用的JSQNative桥\.

### 如何安装 @condorinst/mobile-bridge？

在项目目录运行 npm install @condorinst/mobile-bridge，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 condor-mobile-bridge，可以用 npx condor-mobile-bridge 直接运行。

### @condorinst/mobile-bridge 支持 TypeScript 吗？

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

### @condorinst/mobile-bridge 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

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

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

### @condorinst/mobile-bridge 可以商用吗？

@condorinst/mobile-bridge 使用 SEE LICENSE IN LICENSE 许可。许可条款写在包内的独立文件中，请阅读该文件确认可否商用。以上为概括，不构成法律意见，请以许可原文为准。

### @condorinst/mobile-bridge 的下载量有多少？

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

### @condorinst/mobile-bridge 还在维护吗？

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