StarryOS 应用运行
cargo xtask starry app 管理 apps/starry/ 目录下发现的可运行应用。压力测试、K230、visual 等重型用例已从 test-suit/starryos/ 迁移到 apps/starry/，通过 app 子命令显式运行，避免污染常规测试套件。
1. 子命令
app 下的三个子命令分别负责发现、QEMU 运行和板端运行。
cargo xtask starry app <subcommand> [options]
当前命令面如下。
| 子命令 | 说明 |
|---|---|
app list | 列出 apps/starry/ 下发现的可运行应用 |
app qemu | 构建并在 QEMU 中运行 apps/starry/ 下的应用 |
app board | 在远程板卡上运行应用 |
2. 应用发现
discover_apps(workspace_root) 扫描 apps/starry/ 目录，递归收集所有应用 case。每个应用目录通过文件特征自动推断类型（infer_app_kind）：
| 类型 | 触发条件 | 配置文件 |
|---|---|---|
| QEMU | 含 qemu-*.toml，无 init.sh + board-*.toml | qemu-{arch}.toml、可选 build-*.toml、prebuild.sh |
| Board | 含 init.sh + board-*.toml，无 qemu-*.toml | init.sh、board-*.toml、build-*.toml |
| QEMU（fallback） | 仅含 prebuild.sh | prebuild.sh |
一个应用目录不能同时含 qemu-* 和 board-* 配置（infer_app_kind 会报错要求拆分）。
2.1 应用忽略
apps/.ignore 文件（每行一个应用名，# 开头为注释）可排除特定应用。匹配规则支持裸名（my-app）、starry/my-app、apps/starry/my-app 三种前缀形式。
2.2 能力要求
每个应用可在 requires 文件中声明所需能力（每行一个）。app qemu 和 app board 通过 --cap <CAP> 声明当前可用的能力，缺失所需能力的应用会被过滤。例如一个需要 OrangePi-5-Plus 板卡的应用声明 board:OrangePi-5-Plus，只有运行时传入 --cap board:OrangePi-5-Plus 才会被选中。
3. App List
app list 只读取应用目录和能力声明，不触发构建或运行。
cargo xtask starry app list [--kind qemu|board]
列出 apps/starry/ 下发现的应用。--kind qemu|board 按类型过滤。输出包含应用名、类型、所需能力。
4. App QEMU
app qemu 选择一个或多个 QEMU 应用，并复用测试资产管线准备 rootfs 内容。
cargo xtask starry app qemu [options]
常用参数如下。
| 参数 | 说明 |
|---|---|
--all | 运行所有匹配（经能力过滤后的）QEMU 应用 |
-t/--test-case <CASE> | 选择 apps/starry/<CASE> 单个应用 |
--cap <CAP>（可重复） | 声明可用能力，如 --cap board:OrangePi-5-Plus |
--arch <ARCH> | 覆盖架构 |
--qemu-config <PATH> | 覆盖 QEMU 配置 |
--debug | debug 构建 |
--all 与 -t 互斥。每个选中的应用使用其目录内的 qemu-{arch}.toml 和 build-*.toml 配置，复用 StarryOS 测试的资产准备流程（rootfs 注入、ELF 依赖同步、Grouped runner 生成）。
5. App Board
app board 选择单个板端应用，并通过 ostool-server 完成部署和运行。
cargo xtask starry app board -t <CASE> [options]
常用参数如下。
| 参数 | 说明 |
|---|---|
-t/--test-case <CASE>（必需） | 选择 apps/starry/<CASE> 板端应用 |
--board-config <PATH> | 板卡配置路径 |
-b/--board-type <TYPE> | 板卡类型 |
--server <HOST> --port <PORT> | ostool-server 地址 |
--debug | debug 构建 |
--linux-stage | 先把应用资产同步到板卡 Linux rootfs，再重启进入 StarryOS |
每个板端应用目录包含 init.sh 启动脚本（定义板卡上执行的命令）以及自动发现的 board-*.toml 和 build-*.toml 配置文件，无需手动指定所有配置路径。
6. 用法示例
以下示例覆盖应用发现、QEMU 应用运行和板端应用运行。
# 列出所有应用
cargo xtask starry app list
# 只看 QEMU 应用
cargo xtask starry app list --kind qemu
# 运行所有匹配的 QEMU 应用（带能力过滤）
cargo xtask starry app qemu --all --cap board:OrangePi-5-Plus
# 运行单个应用
cargo xtask starry app qemu -t dual-net
# 在 x86_64 QEMU 来宾中自编译 StarryOS
cargo xtask starry app qemu -t selfhost/selfhost-full-kernel --arch x86_64
# 板端应用
cargo xtask starry app board -t my-board-app -b OrangePi-5-Plus
自编译应用需要独立的持久化 rootfs、KVM 和较长运行时间，完整环境与验证边界见 StarryOS 自编译。