内容
# elstar
**从终端或让AI代理为您完成Xcode无法完成的一切。**
elstar是一个用于iOS模拟器开发的编译二进制文件：驱动正在运行的应用程序，检查其UI和网络流量，无需重建即可热加载Swift代码，并在运行过程中评估代码 — 从您的shell、CI或通过MCP的AI代理。
无需嵌入SDK。无需代理证书。无需必须保持打开的GUI应用程序。适用于您可以在模拟器上启动的任何应用程序。
> 此仓库托管 **发布版本、问题跟踪器和公共文档**。网站：[elstar.dev](https://elstar.dev)
## 安装
```bash
brew install elstar-dev/elstar/elstar
```
或无需Homebrew：
```bash
curl -fsSL https://elstar.dev/install.sh | bash
```
需要macOS 15+和Xcode。首次使用时启动7天试用期 — `elstar license activate <key>` 以解锁。
## 快速入门
```bash
elstar state # 应用信息 + 屏幕尺寸 + 元素 + 截图，一次JSON调用
elstar tap "Sign In" --wait # 通过辅助功能标签点击，等待其出现
elstar hot Sources/HomeView.swift # 将SwiftUI/UIKit文件热加载到正在运行的应用中
elstar net # 前台应用的实时HTTPS流量 — 无代理，无证书
elstar eval 'UIApplication.shared.windows.count' # 在实时进程中运行代码
```
## 适用于AI代理
```bash
elstar mcp install # 将MCP服务器注册到您的代理
elstar skills install # 捆绑技能：ios-setup, ios-test, ios-audit, ios-debug, ios-perf
elstar hook install # Claude Code钩子：热加载编辑时，崩溃检测，a11y审计
```
每个命令都支持 `--json` 带有结构化错误，`elements --compact` 用于token高效输出，`state` 用于为代理循环设计的单次快照。
## 功能
- **热加载** — SwiftUI视图，UIKit视图控制器，纯Swift类，XIB和资产在运行的应用中注入，约一秒钟。无需重建，无需重启，无需SDK。
- **网络** — 捕获并解密前台应用的HTTPS流量，零设置；为测试模拟端点。
- **运行时** — 在实时进程中评估Swift/ObjC表达式，转储类和ivar，附加持久调试REPL。
- **UI自动化** — 通过模拟器HID的本地点击/滑动/拖拽/类型；从记录的交互生成XCUITest代码。
- **检查** — 可访问性树，视图层次结构，按角色/标签查询元素，截图。
- **性能** — 启动时间，卡顿，仪表，泄漏 — 从CLI检测，可在CI中使用。
- **模拟器控制** — 启动，安装，启动，推送通知，权限，隐私状态，应用数据。
完整命令参考：`elstar --help` 或 [elstar.dev](https://elstar.dev)。
## 反馈问题
欢迎在 [Issues](../../issues) 中提交错误报告和功能请求。对于崩溃或行为异常，请附加 `elstar diagnose --out bug.txt` 的输出 — 它收集版本，设备状态和最近的日志（无源代码或机密）。
## 许可
具有7天免费试用期的商业软件。一个许可证涵盖一名开发人员在两台机器上使用。有关定价，请参见 [elstar.dev](https://elstar.dev)。
