docs(cli): clarify optional simulator selector prefix

Author: linhay

README.md

@@ -377,6 +377,7 @@ triton app prefs dump --device booted --bundle-id com.example.app --json
 Destructive commands require `--confirm` by default, and `runtime delete` supports `--dry-run` first so agents can inspect the selected runtimes before deleting anything.
 
 `app go <url>` is the short iOS deep-link smoke entry: it opens the URL, waits for embedded runtime readiness, returns an app/route/AX snapshot summary, and defaults to JSON output. Use `--device <selector>` only when the current/default target is ambiguous.
+For iOS simulator selectors, `sim:` is optional. `--device 60667794-96F8-40E6-8664-85538EC4663E` and `--device sim:60667794-96F8-40E6-8664-85538EC4663E` both resolve to the same simulator; keep `sim:` only when you want explicit platform disambiguation.
 `app open-url` is the lower-level host action and only proves the URL was submitted to Simulator. Continue with `triton wait`, `triton find`, `triton assert`, `triton webview current-url`, `triton route assert-current-url`, or `triton app prefs get` to verify the business state.
 
 Xcode project discovery and `xcodebuild` execution are also exposed through Triton CLI. Use this path before falling back to XcodeBuildMCP or raw `xcodebuild` so the agent sees stable JSON/JSONL contracts:

docs-linhay/dev/ai-cli-readable-control.md

@@ -77,6 +77,7 @@ TritonKit 首期不需要 Web 端。AI agent 的读取与控制入口收敛到 C
 - `triton app info --device <selector> --bundle-id <id> --format json`：读取单个已安装 App 元数据；当 `simctl appinfo` 对缺失 bundle 只回显 `CFBundleIdentifier` 时，归一为 `app_info_not_available`。
 - `triton app install --device <selector> --app <path.app> --format json`、`triton app uninstall --device <selector> --bundle-id <id> --confirm --format json`、`triton app launch --device <selector> --bundle-id <id> --format json`、`triton app terminate --device <selector> --bundle-id <id> --format json`：App 生命周期首批入口，返回 host action envelope；`uninstall` 必须显式 `--confirm`，业务就绪仍需继续用 `status/wait/find/assert/prefs` 验证。
 - `triton app go <url> [--device <selector>]`：iOS deep-link smoke 的短入口；默认提交 URL、等待 embedded runtime ready、返回 app/route/AX snapshot summary，并默认 JSON 输出。若当前/default target 唯一，可省略 `--device`。
+- iOS simulator 的 `--device` selector 支持裸 UDID、`sim:<udid>`、`booted`、`current` 与 alias；`sim:` 只是平台消歧前缀，不是必填。
 - `triton app open-url <url> --device <selector> --format json`：低层 host action，只证明 deep link 或 URL 已提交到 simulator；业务完成需继续用 `wait/find/assert`、preferences、route 或 `app go` 验证。
 - `triton app container --device <selector> --bundle-id <id> --kind data --format json`：读取 simulator App container path。
 - `triton app prefs get <key> --device <selector> --bundle-id <id> --format json`、`triton app prefs dump --device <selector> --bundle-id <id> --format json`：读取 App preferences plist，避免 agent 解析 `plutil -p` 人读文本。

docs-linhay/spaces/20260527-command-surface-optimization/plans/checkpoints/20260602-round-180-short-app-go-deeplink-entry.md

@@ -10,6 +10,7 @@
 - 新增短入口：`triton app go <url>`。
 - `app go` 默认执行 iOS `open-url + wait-ready + snapshot`，并保持 JSON 为默认输出。
 - `app go` 的 target 选择顺序：显式 `--device/--simulator`、当前 target、唯一 ready iOS target。
+- iOS simulator selector 支持裸 UDID 与 `sim:<udid>`；`sim:` 只是平台消歧前缀，不是必填。
 - `triton plan open-url` 和 capability `nextAction` 首选 `triton app go <url>`，不再推荐长 `open-url --wait-ready --snapshot --json`。
 - `--json` 可省略：schema 默认 `--format=json` 被纳入机器可读门禁，不再强制对默认 JSON 命令追加显式 `--json`。
 
@@ -26,6 +27,12 @@ triton app go "dxy-jobmd://nativejump/test/talentMoreFilter"
 triton app go "dxy-jobmd://nativejump/test/talentMoreFilter" --device sim:60667794-96F8-40E6-8664-85538EC4663E
 ```
 
+也可以省略 `sim:`：
+
+```bash
+triton app go "dxy-jobmd://nativejump/test/talentMoreFilter" --device 60667794-96F8-40E6-8664-85538EC4663E
+```
+
 ## 验证
 
 - `swift build --package-path CLI --product triton` 通过。