# @goliapkg/smix 中文文档

规范地址：https://npmcn.com/package/%40goliapkg/smix/

版本：25\.1\.0
npm 元数据更新时间：2026-11-10T17:51:23.963Z
中文译文更新时间：2026-11-16T18:52:25.103Z
软件包许可：Apache-2\.0 OR MIT

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

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

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

- 包体积（解压后）：230 kB，81 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=20
- 运行依赖：0 个
- 首次发布：2026-06-29T19:58:45.480Z
- 最新版本发布：2026-11-10T17:51:23.630Z
- 近 30 天下载量：3385（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：90（近 12 个月 90 个）

## 中文简介

Playwright-shape iOS模拟器 / Android仿真器 UI自动化SDK用于回放原生+博览会 + Detox-兼容TypeScript测试跑取.

## 安装

```sh
npm install @goliapkg/smix
```

也可以使用：`pnpm add @goliapkg/smix`、`yarn add @goliapkg/smix`、`bun add @goliapkg/smix`

## README

# @goliapkg/ smix (英语)

类型脚本类型和主机侧构件 [组合](https://github.com/goliajp/smix) - AI-原生UI自动化,用于 iOS模拟器和Android模拟器.

**现场驾驶贯穿了美洲狮外加.** 这个包裹也一样 输入 API 表面为 Swift / Kotlin / Rust SDK ; `Smix.launchApp`, (中文(简体) ), `App.tap`, (中文(简体) ), `App.fill`,其余通过呼叫驱动设备 `@goliapkg/smix-node`。 。 。 . `Smix.launchApp` 装入每个平台的添加 自动( 通过) `loadNodeDriver`);加通由每三层所建 在 CI 中预建矩阵,其 npm 发布在后面的版本中——您 也可以注入一个 `NodeDriver` 明确用于测试或海关运输. 三块地还抛出 `SmixNotImplementedError` 在运输途中: `App.screenshot` 财务报告和审定财务报表 `App.openUrl` 需要一条跑道 `App.launchFresh` 需要主机侧状态清除 。 驱动一个设备没有 今天的加词,请使用 [`smix` 国 际](https://crates.io/crates/smix-cli) 或者说 斯威夫特 克特林 斯德 SDK.

## 今天有什么用吗

-   **选择器 DSL** —— 完整的选择语言, 编码到精确 JSON铁丝网塑造出Rust核解.
-   **届会周期** —— 说 `Session.open` 编号 : `stillValid` 编号 : `relaunchApp` 编号 : `renewActivation` 编号 : `close` 对阵一个正在运行的混音跑者,超过HTTP.
-   **`ExpectationFailure`** ——解析并制作Smix的AI可读 失败 JSON.
-   **`A11yNode`** ——打入的可访问性-树木模型 `flatten` 编号 : `findById` 编号 : `rectCenter` 帮助工作 `smix tree --json` 输出.

## 安装

```bash
bun add -D @goliapkg/smix
# OR
npm install -D @goliapkg/smix
```

仅测试目标: 保留在内 `devDependencies`,从来没有捆绑成一个 生产 RN / Expo app.

## 选择器

```typescript
import { Selector, literal, regex } from '@goliapkg/smix'

Selector.id('btn-login')
Selector.text(literal('Sign In'))
Selector.text(regex('^Sub', 'i'))
Selector.label('Settings')
Selector.role('button', literal('Submit'))
Selector.localizedText({ en: 'Submit', ja: '送信' })

// Fluent modifier chaining (returns a new Selector)
Selector.id('btn').below(Selector.text(literal('Address'))).nth(0)
Selector.role('button').near(Selector.text(literal('Confirm')))
```

线接JSON(未标记 + 平面- 字节与 Rust 相同) `smix-selector`:

```json
{"id": "btn-login", "below": {"text": "Address"}, "nth": 0}
```

## 届会周期

```typescript
import { HttpSimRuntime, Session } from '@goliapkg/smix'

const runtime = new HttpSimRuntime('http://127.0.0.1:22087')
const session = await Session.open(runtime, 'com.example.app')
await session.relaunchApp()
await session.close()
```

`HttpSimRuntime` 还揭露 `resolver` 编号 : `labelsResolver`,哪个 解决选择者通过跑者 提供电话的树JSON `/select/resolve` 路线.

## 期望 失败

```typescript
import { ExpectationFailure } from '@goliapkg/smix'

try {
  // a driving call, once the native transport lands
} catch (e) {
  if (e instanceof ExpectationFailure) {
    e.code            // 'ELEMENT_NOT_FOUND' | 'AMBIGUOUS' | 'TIMEOUT' | ...
    e.visibleElements // A11yNode[] — context for AI diagnosis
    e.suggestions     // string[]
    e.toJson()        // single-line JSON for agent consumption
  }
}
```

## 许可证

Apache-2.0 或 MIT(双重,由您选择).

## 常见问题

### @goliapkg/smix 是什么？

Playwright-shape iOS模拟器 / Android仿真器 UI自动化SDK用于回放原生\+博览会 \+ Detox-兼容TypeScript测试跑取\.

### 如何安装 @goliapkg/smix？

在项目目录运行 npm install @goliapkg/smix，或使用 pnpm add / yarn add / bun add。

### @goliapkg/smix 支持 TypeScript 吗？

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

### @goliapkg/smix 支持 ESM 还是 CommonJS？

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

### @goliapkg/smix 需要什么版本的 Node\.js？

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

### @goliapkg/smix 可以商用吗？

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

### @goliapkg/smix 的下载量有多少？

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

### @goliapkg/smix 还在维护吗？

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

