snapshot-checker 0.1.1

package/README.md

@@ -0,0 +1,283 @@
+# snapshot-checker
+
+按顺序执行 **bat**、**mac**、**shell** 命令的 CLI 工具。支持**命令组**：可为每组命名，用 `--group` 指定执行某一或多个组；不指定时默认执行**当前系统支持的所有命令**（按 `defaultGroupOrder` 顺序）。
+
+## 命令类型
+
+| kind   | 说明 | 默认执行范围 |
+|--------|------|----------------|
+| `bat`  | Windows 下用 `cmd /c` 执行 | 仅 Windows |
+| `mac`  | 面向 macOS 的命令 | 仅 macOS |
+| `shell`| 通用 shell，使用当前系统默认 shell | 全平台 |
+
+## 安装与运行
+
+```bash
+npm install
+npm run build
+npm start -- foo          # 或: node dist/cli.js foo
+```
+
+开发时可直接用 tsx 跑（无需 build）：
+
+```bash
+npm run dev -- run
+# 或
+npm run run:example
+```
+
+## 配置命令与组（commands 目录）
+
+所有命令配置均放在项目根目录的 `commands/` 目录中：
+
+- `commands/*.ts`：场景配置文件，例如 `foo.ts`、`bar.ts`，通过 `snapshot-checker foo` / `snapshot-checker bar` 等命令使用
+
+一个最简单的配置文件形如：
+
+```ts
+export const groups: Groups = {
+  env: [
+    { kind: 'shell', description: '打印当前目录', run: 'pwd' },
+    { kind: 'shell', description: 'Node 版本', run: 'node -v' },
+  ],
+  list: [
+    { kind: 'shell', description: '列出文件', run: 'ls -la' },
+  ],
+};
+
+export const defaultGroupOrder: string[] = ['env', 'list'];
+```
+
+- 不指定 `--group` 时：按 `defaultGroupOrder` 依次执行各组，且**只执行当前系统支持**的命令（shell 全平台；bat 仅 Windows；mac 仅 macOS）。
+- 指定 `--group env list` 时：按给定顺序执行这些组内、且当前系统支持的命令。
+
+每条命令可加 `cwd` 指定工作目录。
+
+### 内置指令（embed）
+
+除平台命令外，还支持内置指令（`kind: 'embed'`），由执行器内部实现，不依赖系统 shell。
+
+#### `sleep <seconds>`
+
+按指定秒数等待，例如：
+
+```ts
+{ kind: 'embed', run: 'sleep 3', description: '等待 3 秒' }
+```
+
+#### `timeout <seconds>`（兼容 `timieout <seconds>`）
+
+最多等待指定秒数，并实时显示剩余时间；在可交互终端下，用户按任意键可立即结束等待。
+
+示例：
+
+```ts
+{
+  kind: 'embed',
+  run: 'timeout 30',
+  description: '最多等待 30 秒，按任意键跳过',
+}
+```
+
+行为说明：
+
+- 使用同一行原地刷新倒计时（`[timeout] 剩余 Ns...`）。
+- 到达超时时间后自动继续后续命令。
+- 若检测到键盘输入则立即结束等待并继续。
+- 在非 TTY 环境（如某些 CI）中会退化为仅按时间等待，不监听按键。
+
+仓库内完整示例见 `commands/timeout_demo.ts`（`npm run dev -- timeout_demo` 或 `node dist/cli.js timeout_demo`）。
+
+### 命令之间传递变量（上下文）
+
+命令执行器内置了一个**简单的上下文对象**，允许前一条命令将自己的输出写入变量，后续命令通过模板占位符引用这些变量。通过 CLI 跑场景时，该上下文在**整个场景执行期间**（含不同 `group`、不同块之间）**同一份共享**，因此可以把变量从 `getUser` 组传到 `greet` 组。仓库内示例见 `commands/context_demo.ts`。
+
+- **写入变量：**在命令上增加 `captureToVar` 元数据
+- **读取变量：**在 `run` / `file` / `args` / `cwd` / `description` 中使用 `{{varName}}` 占位符
+
+示例：
+
+```ts
+// commands/example.ts
+import type { Groups } from '../src/types.js';
+
+export const groups: Groups = {
+  env: [
+    {
+      kind: 'shell',
+      description: '获取当前用户名',
+      run: 'whoami',
+      // 将整段 stdout 写入变量 user
+      // （比如 "alice"），供后续命令使用
+      // @ts-expect-error: 由执行器在运行时识别的扩展字段
+      captureToVar: {
+        name: 'user',
+      },
+    },
+  ],
+  greet: [
+    {
+      kind: 'shell',
+      description: '使用上一条命令得到的用户名',
+      run: 'echo "hello, {{user}}"',
+    },
+  ],
+};
+
+export const defaultGroupOrder = ['env', 'greet'];
+```
+
+#### 仅提取输出的一部分
+
+如果需要从输出中提取一部分（比如只要第一行的数字），可以使用 `pattern` 和 `groupIndex`：
+
+```ts
+{
+  kind: 'shell',
+  description: '获取某个进程 pid',
+  run: 'pidof my-app',
+  // @ts-expect-error: 由执行器在运行时识别的扩展字段
+  captureToVar: {
+    name: 'pid',
+    pattern: '^(\\d+)', // 匹配第一行的数字
+    groupIndex: 1,      // 取第 1 个捕获组
+  },
+},
+{
+  kind: 'shell',
+  description: '用 pid 做点事',
+  run: 'echo "pid is {{pid}}"',
+}
+```
+
+`captureToVar` 字段说明：
+
+- **name**: 变量名（如 `pid`、`user`）
+- **from**: 可选，`"stdout"`（默认）或 `"stderr"`，表示从哪个输出中取值
+- **pattern**: 可选，正则表达式字符串；不传时使用整个输出（去掉首尾空白）
+- **groupIndex**: 可选，指定要取的捕获组索引，默认 `1`
+
+### 多场景配置示例：foo / bar
+
+- 在 `commands/config.ts` 中定义默认场景（供 `run` 使用）
+- 在 `commands/foo.ts` 中定义 `foo` 场景：
+
+```ts
+// commands/foo.ts
+export const groups: Groups = {
+  env: [
+    { kind: 'shell', description: '[foo] 打印当前目录', run: 'pwd' },
+    { kind: 'shell', description: '[foo] 显示 Node 版本', run: 'node -v' },
+  ],
+  list: [{ kind: 'shell', description: '[foo] 列出当前目录', run: 'ls -la' }],
+};
+
+export const defaultGroupOrder: string[] = ['env', 'list'];
+```
+
+- 在 `commands/bar.ts` 中定义 `bar` 场景：
+
+```ts
+// commands/bar.ts
+export const groups: Groups = {
+  env: [
+    { kind: 'shell', description: '[bar] 打印当前目录', run: 'pwd' },
+    { kind: 'shell', description: '[bar] 显示 Node 版本', run: 'node -v' },
+  ],
+  list: [{ kind: 'shell', description: '[bar] 列出当前目录', run: 'ls -la' }],
+  extra: [{ kind: 'shell', description: '[bar] 额外命令示例', run: 'echo extra from bar' }],
+};
+
+export const defaultGroupOrder: string[] = ['env', 'extra', 'list'];
+```
+
+CLI 会自动将 `commands` 目录下除 `config.*` 外的每个文件视为一个**场景命令**，文件名即子命令名：
+
+- `commands/foo.ts` → `snapshot-checker foo`
+- `commands/bar.ts` → `snapshot-checker bar`
+
+## CLI 选项
+
+- `--wait`：所有**前台**命令跑完后，继续等待**后台**命令（`background: true`）自然退出再结束进程；不加则前台全部结束后会**优雅结束**这些后台子进程并立即退出 CLI。
+- `snapshot-checker <scene>` — 使用 `commands/<scene>.ts` 中的配置执行命令，例如：
+  - `snapshot-checker foo` 使用 `commands/foo.ts` 的 `groups` 与 `defaultGroupOrder`
+  - `snapshot-checker bar` 使用 `commands/bar.ts` 的 `groups` 与 `defaultGroupOrder`
+  - `snapshot-checker foo --list` 仅列出 `foo` 场景中的命令，不执行
+  - `snapshot-checker bar --list` 仅列出 `bar` 场景中的命令，不执行
+
+## 简单用例
+
+```bash
+# 使用 foo 场景（commands/foo.ts）执行命令
+node dist/cli.js foo
+
+# 仅查看 foo 场景中的命令（不执行）
+node dist/cli.js foo --list
+
+# 使用 bar 场景（commands/bar.ts）执行命令
+node dist/cli.js bar --group env,extra
+
+# 仅查看 bar 场景中的命令（不执行）
+node dist/cli.js bar --list
+```
+
+## 项目结构
+
+```
+src/
+  cli.ts        # CLI 入口，负责解析参数并调用执行逻辑
+  runCommand.ts # 单条/多条命令执行（无 group 概念）
+  runGroups.ts  # 组规格解析、分块、按组执行（含组间间隔）
+  executor.ts   # 统一导出 runCommand + runGroups
+  types.ts      # 类型定义
+  index.ts      # 库导出（从 commands/config.ts 导出默认 groups）
+
+commands/
+  foo.ts        # foo 场景示例：自定义 groups/defaultGroupOrder
+  bar.ts        # bar 场景示例：自定义 groups/defaultGroupOrder
+
+demos/
+  consumer-app/ # 独立示例：npm install snapshot-checker 后的调用方式
+```
+
+## 发布到 npm
+
+```bash
+npm login
+npm run build   # prepublishOnly 也会在 publish 时执行
+npm publish
+```
+
+若包名 `snapshot-checker` 已被占用，请在 `package.json` 中改为作用域包（如 `@your-org/snapshot-checker`）并相应更新下文导入路径。
+
+## 作为库使用（npm install 之后）
+
+安装：
+
+```bash
+npm install snapshot-checker
+```
+
+在业务项目中调用**运行接口**（入口与源码中 `src/index.ts` 导出一致），并从一个或多个**包内场景模块**生成命令组（发布产物中为 `dist/commands/*.js`，通过 `exports` 暴露）：
+
+```ts
+import { resolveScenario, runScenarioGroups } from 'snapshot-checker';
+import * as contextDemo from 'snapshot-checker/commands/context_demo.js';
+import * as forkall from 'snapshot-checker/commands/forkall.js';
+
+const { groups, defaultGroupOrder } = resolveScenario(forkall, {
+  app: 'com.example.app',
+  eventPath: 'snapshot/hmb_forkall_report_image_failure',
+  mode: 'monitor',
+});
+
+await runScenarioGroups({ groups, defaultGroupOrder, stopOnError: true });
+```
+
+也可在业务项目自建 `commands/*.ts`，仅使用 `snapshot-checker` 的执行 API（`runScenarioGroups`、`getGroupChunks` 等），不引用包内场景。
+
+独立 Node 示例工程（依赖 registry 上的本包）：见 `demos/consumer-app/README.md`。
+
+## License
+
+MIT

package/dist/commands/context_demo.d.ts

@@ -0,0 +1,18 @@
+import { type Groups } from '../src/types.js';
+/**
+ * 示例场景：演示如何在命令之间传递变量（含跨不同 group）。
+ *
+ * 使用方式（开发态）：
+ *   npm run dev -- context_demo
+ *
+ * 使用方式（构建后）：
+ *   node dist/cli.js context_demo
+ *
+ * 作为 npm 包被外部项目引用时：
+ *   import { resolveScenario, runScenarioGroups } from 'snapshot-checker';
+ *   import * as contextDemo from 'snapshot-checker/commands/context_demo.js';
+ * 完整示例见 demos/consumer-app（需先发布包并 npm install snapshot-checker）。
+ */
+export declare const groups: Groups;
+export declare const defaultGroupOrder: string[];
+//# sourceMappingURL=context_demo.d.ts.map

package/dist/commands/context_demo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context_demo.d.ts","sourceRoot":"","sources":["../../commands/context_demo.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4D,KAAK,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAYxG;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,MAAM,EAAE,MA0CpB,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,MAAM,EAAqD,CAAC"}

package/dist/commands/context_demo.js

@@ -0,0 +1,68 @@
+import { CommandKind, getCurrentPlatformKind } from '../src/types.js';
+/** 与当前 OS 一致，避免示例在非 macOS 上被整组跳过 */
+const kind = getCurrentPlatformKind();
+async function foo(ctx) {
+    const user = ctx.user ?? 'unknown';
+    const message = `foo says hi to ${user}`;
+    ctx.fromFoo = message;
+    console.log(message);
+}
+/**
+ * 示例场景：演示如何在命令之间传递变量（含跨不同 group）。
+ *
+ * 使用方式（开发态）：
+ *   npm run dev -- context_demo
+ *
+ * 使用方式（构建后）：
+ *   node dist/cli.js context_demo
+ *
+ * 作为 npm 包被外部项目引用时：
+ *   import { resolveScenario, runScenarioGroups } from 'snapshot-checker';
+ *   import * as contextDemo from 'snapshot-checker/commands/context_demo.js';
+ * 完整示例见 demos/consumer-app（需先发布包并 npm install snapshot-checker）。
+ */
+export const groups = {
+    getUser: [
+        {
+            kind,
+            description: '获取当前用户名，并写入变量 user',
+            run: 'whoami',
+            captureToVar: {
+                name: 'user',
+            },
+        },
+    ],
+    greet: [
+        {
+            kind,
+            description: '使用上一条命令得到的用户名',
+            run: 'echo "hello, {{user}}"',
+        },
+    ],
+    builtinFn: [
+        {
+            kind: CommandKind.BuiltinFunction,
+            description: '执行内置函数 foo，并写入变量 fromFoo',
+            func: foo,
+        },
+        {
+            kind,
+            description: '读取 foo 写入的变量',
+            run: 'echo "{{fromFoo}}"',
+        },
+    ],
+    builtinFail: [
+        {
+            kind: CommandKind.BuiltinFunction,
+            description: '演示：返回 false 表示失败（可配合 --stop-on-error）',
+            func: () => false,
+        },
+        {
+            kind,
+            description: '这条命令在 --stop-on-error 下不会执行',
+            run: 'echo "should not run when stop-on-error is enabled"',
+        },
+    ],
+};
+export const defaultGroupOrder = ['getUser', 'greet', 'builtinFn', 'builtinFail'];
+//# sourceMappingURL=context_demo.js.map

package/dist/commands/context_demo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context_demo.js","sourceRoot":"","sources":["../../commands/context_demo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,sBAAsB,EAAoC,MAAM,iBAAiB,CAAC;AAExG,oCAAoC;AACpC,MAAM,IAAI,GAAG,sBAAsB,EAAE,CAAC;AAEtC,KAAK,UAAU,GAAG,CAAC,GAAmB;IACpC,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,IAAI,SAAS,CAAC;IACnC,MAAM,OAAO,GAAG,kBAAkB,IAAI,EAAE,CAAC;IACzC,GAAG,CAAC,OAAO,GAAG,OAAO,CAAC;IACtB,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AACvB,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,MAAM,GAAW;IAC5B,OAAO,EAAE;QACP;YACE,IAAI;YACJ,WAAW,EAAE,oBAAoB;YACjC,GAAG,EAAE,QAAQ;YACb,YAAY,EAAE;gBACZ,IAAI,EAAE,MAAM;aACb;SACF;KACF;IACD,KAAK,EAAE;QACL;YACE,IAAI;YACJ,WAAW,EAAE,eAAe;YAC5B,GAAG,EAAE,wBAAwB;SAC9B;KACF;IACD,SAAS,EAAE;QACT;YACE,IAAI,EAAE,WAAW,CAAC,eAAe;YACjC,WAAW,EAAE,0BAA0B;YACvC,IAAI,EAAE,GAAG;SACV;QACD;YACE,IAAI;YACJ,WAAW,EAAE,cAAc;YAC3B,GAAG,EAAE,oBAAoB;SAC1B;KACF;IACD,WAAW,EAAE;QACX;YACE,IAAI,EAAE,WAAW,CAAC,eAAe;YACjC,WAAW,EAAE,uCAAuC;YACpD,IAAI,EAAE,GAAG,EAAE,CAAC,KAAK;SAClB;QACD;YACE,IAAI;YACJ,WAAW,EAAE,6BAA6B;YAC1C,GAAG,EAAE,qDAAqD;SAC3D;KACF;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAa,CAAC,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,aAAa,CAAC,CAAC"}

package/dist/commands/forkall.d.ts

@@ -0,0 +1,54 @@
+import type { Groups } from '../src/types.js';
+/**
+ * forkall 场景的基础占位配置。
+ * 实际要执行的命令会在 applyOptions 中，根据 CLI 传入的参数（eventPath/app 等）动态生成。
+ *
+ * 作为 npm 包被外部项目引用时：
+ *   import * as forkall from 'snapshot-checker/commands/forkall.js';
+ *   resolveScenario(forkall, { app, eventPath, ... })
+ * 完整示例见 demos/consumer-app。
+ */
+export declare const groups: Groups;
+export declare const defaultGroupOrder: string[];
+export declare const options: ({
+    flags: string;
+    description: string;
+    defaultValue?: undefined;
+} | {
+    flags: string;
+    description: string;
+    defaultValue: string;
+})[];
+interface ForkallOptions {
+    eventPath?: string;
+    app?: string;
+    systemSymbolFilePath?: string;
+    logKey?: string;
+    duration?: string;
+    defaultTimeout?: string;
+    bufferSize?: string;
+    mode?: string;
+}
+/**
+ * 将 CLI 解析出来的参数应用到 forkall 场景，动态生成各阶段命令。
+ *
+ * 关键映射关系：
+ * - eventPath            -> dump_stack.bat 中的 event_path
+ * - app                  -> dump_stack.bat 中的 app
+ * - systemSymbolFilePath -> dump_stack.bat 中的 system_symbol_file_path
+ * - logKey               -> dump_stack.bat 中的 log_key（默认 pid）
+ * - duration             -> dump_stack.bat 中的 duration（默认 70）
+ * - defaultTimeout       -> dump_stack.bat 中的 default_timeout（默认 90）
+ * - bufferSize           -> dump_stack.bat 中的 buffer_size（默认 512000）
+ * - mode                 -> dump_stack.bat 中根据参数跳转到 REBOOT 或 MONITOR 的条件分支
+ */
+export declare function applyOptions(ctx: {
+    groups: Groups;
+    defaultGroupOrder: string[];
+    options: ForkallOptions;
+}): {
+    groups: Groups;
+    defaultGroupOrder: string[];
+};
+export {};
+//# sourceMappingURL=forkall.d.ts.map

package/dist/commands/forkall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forkall.d.ts","sourceRoot":"","sources":["../../commands/forkall.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE9C;;;;;;;;GAQG;AACH,eAAO,MAAM,MAAM,EAAE,MAAW,CAAC;AAEjC,eAAO,MAAM,iBAAiB,EAAE,MAAM,EAAiD,CAAC;AAExF,eAAO,MAAM,OAAO;;;;;;;;IAqBnB,CAAC;AAEF,UAAU,cAAc;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,OAAO,EAAE,cAAc,CAAC;CACzB,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,MAAM,EAAE,CAAA;CAAE,CAmKlD"}

package/dist/commands/forkall.js

@@ -0,0 +1,192 @@
+import { CommandKind } from '../src/types.js';
+/**
+ * forkall 场景的基础占位配置。
+ * 实际要执行的命令会在 applyOptions 中，根据 CLI 传入的参数（eventPath/app 等）动态生成。
+ *
+ * 作为 npm 包被外部项目引用时：
+ *   import * as forkall from 'snapshot-checker/commands/forkall.js';
+ *   resolveScenario(forkall, { app, eventPath, ... })
+ * 完整示例见 demos/consumer-app。
+ */
+export const groups = {};
+export const defaultGroupOrder = ['reboot', 'monitor', 'collect', 'analysis'];
+export const options = [
+    { flags: '--event-path <path>', description: '事件路径' },
+    { flags: '--app <app>', description: '应用名' },
+    { flags: '--system-symbol-file-path <path>', description: '系统符号文件路径' },
+    { flags: '--log-key <key>', description: '日志过滤关键字（默认 pid）', defaultValue: 'pid' },
+    { flags: '--duration <seconds>', description: '采样持续时间（秒，默认 70）', defaultValue: '70' },
+    {
+        flags: '--default-timeout <seconds>',
+        description: '默认等待时间（秒，默认 90）',
+        defaultValue: '90',
+    },
+    {
+        flags: '--buffer-size <bytes>',
+        description: '缓冲区大小（字节，默认 512000）',
+        defaultValue: '512000',
+    },
+    {
+        flags: '--mode <mode>',
+        description: '执行模式：monitor 或 reboot-monitor',
+        defaultValue: 'monitor',
+    },
+];
+/**
+ * 将 CLI 解析出来的参数应用到 forkall 场景，动态生成各阶段命令。
+ *
+ * 关键映射关系：
+ * - eventPath            -> dump_stack.bat 中的 event_path
+ * - app                  -> dump_stack.bat 中的 app
+ * - systemSymbolFilePath -> dump_stack.bat 中的 system_symbol_file_path
+ * - logKey               -> dump_stack.bat 中的 log_key（默认 pid）
+ * - duration             -> dump_stack.bat 中的 duration（默认 70）
+ * - defaultTimeout       -> dump_stack.bat 中的 default_timeout（默认 90）
+ * - bufferSize           -> dump_stack.bat 中的 buffer_size（默认 512000）
+ * - mode                 -> dump_stack.bat 中根据参数跳转到 REBOOT 或 MONITOR 的条件分支
+ */
+export function applyOptions(ctx) {
+    const { eventPath = '', app = '', systemSymbolFilePath = '', logKey = 'pid', duration = '70', defaultTimeout = '90', bufferSize = '512000', mode = 'monitor', } = ctx.options ?? {};
+    const eventName = eventPath ? eventPath.replace(/\//g, ':') : '';
+    const checkStateCommand = "hdc shell hidumper -s 1901 -a '-p libforkall_plugin.z.so --list'";
+    const rebootGroup = mode === 'reboot-monitor'
+        ? [
+            {
+                kind: CommandKind.Windows,
+                run: 'hdc shell "test  ! -f /system/etc/hiview/hitrace_utils.json.bk && mv /system/etc/hiview/hitrace_utils.json /system/etc/hiview/hitrace_utils.json.bk"',
+            },
+            {
+                kind: CommandKind.Windows,
+                run: 'hdc shell "test  ! -f /bin/hiperf && mv /bin/hiperf /bin/hiperf.bk"',
+            },
+            {
+                kind: CommandKind.Windows,
+                description: '上传hitrace配置文件',
+                run: 'hdc file send .\config\hitrace\hitrace_utils_snapshot.json /system/etc/hiview/hitrace_utils.json',
+            },
+            {
+                kind: CommandKind.Windows,
+                description: '配置自定义trace事件',
+                run: String.raw `hdc shell "sed -i 's|<TARGET_EVENT>|${eventPath}'|g /system/etc/hiview/hitrace_utils.json"`,
+            },
+            {
+                kind: CommandKind.Windows,
+                description: '配置hiperf权限',
+                run: 'hdc shell "chmod 755 /bin/hiperf && chcon u:object_r:hiperf_exec:s0 /bin/hiperf"',
+            },
+            {
+                kind: CommandKind.Windows,
+                description: '重启设备',
+                run: 'hdc shell reboot',
+            },
+            {
+                kind: CommandKind.Embed,
+                description: '等待设备重启',
+                run: `sleep ${defaultTimeout}`,
+            },
+        ]
+        : [];
+    const monitorGroup = [
+        {
+            kind: CommandKind.Windows,
+            description: '[forkall] 强制停止应用',
+            run: app ? `hdc shell aa force-stop ${app}` : 'echo "[forkall] app 未指定，跳过 force-stop"',
+        },
+        {
+            kind: CommandKind.Windows,
+            description: '[forkall] 检查当前可用事件列表',
+            run: checkStateCommand,
+        },
+        {
+            kind: CommandKind.Windows,
+            description: '[forkall] 启动 perf/hitrace 监控',
+            run: [
+                'hdc shell "',
+                `echo [SnapshotChecker]: Setting Target && `,
+                `hitrace custom_event --overwrite -b ${bufferSize} -t ${duration} -o /data/local/tmp/snapshot_hitrace.txt && `,
+                eventName
+                    ? `hiperf record -e ${eventName} --period 1 -s fp --clockid bootime --cpu-limit 100 -o /data/local/tmp/perf.data -a --exclude-hiperf -d ${duration} && `
+                    : '',
+                `echo [SnapshotChecker]: Monitor start, Target: (app=${app}) && `,
+                `sleep 5 && `,
+                app
+                    ? `hidumper -s 1901 -a '-p libforkall_plugin.z.so --create 100 ${app}' && `
+                    : '',
+                `${checkStateCommand} && `,
+                `wait && `,
+                `echo [SnapshotChecker]: Monitor end, App Pid is: \`pidof ${app}\`, Please Check... && `,
+                `hiperf dump -i /data/local/tmp/perf.data -o /data/local/tmp/snapshot_perf.data.txt"`,
+            ]
+                .filter(Boolean)
+                .join(''),
+        },
+    ];
+    const collectGroup = [
+        {
+            kind: CommandKind.Windows,
+            description: '[forkall] 清理旧日志',
+            run: 'rm ./output/snapshot_log.txt || true',
+        },
+        {
+            kind: CommandKind.Windows,
+            description: '[forkall] 收集日志到本地',
+            run: [
+                'start "" /b cmd /c "hdc shell ',
+                `"hilog -t kmsg ^| grep '${logKey}'" >> ./output/snapshot_log.txt`,
+            ].join(''),
+        },
+        {
+            kind: CommandKind.Windows,
+            description: '[forkall] 再次检查事件列表',
+            run: checkStateCommand,
+        },
+        {
+            kind: CommandKind.Windows,
+            description: '[forkall] 拉取 perf / hitrace / log 文件',
+            run: [
+                'hdc file recv /data/local/tmp/snapshot_perf.data.txt ./output/ && ',
+                'hdc file recv /data/local/tmp/snapshot_hitrace.txt ./output/ && ',
+                'hdc file recv /data/local/tmp/snapshot_log.txt ./output/',
+            ].join(''),
+        },
+        {
+            kind: CommandKind.Windows,
+            description: '[forkall] 关闭 hdc 进程',
+            run: 'taskkill /IM hdc.exe /F || true',
+        },
+    ];
+    const analysisGroup = [
+        {
+            kind: CommandKind.Windows,
+            description: '[forkall] 分析 perf 数据',
+            run: [
+                'cd ./output && ',
+                (systemSymbolFilePath
+                    ? `python ../tools/host/checker/parser_system_stack.py snapshot_perf.data.txt snapshot_perf_data_parsed.data.txt -S "${systemSymbolFilePath}" && `
+                    : ''),
+                'python ../tools/host/checker/hiperf_txt_filter.py -to_backtrace_stack ',
+                '--input_file ',
+                systemSymbolFilePath
+                    ? 'snapshot_perf_data_parsed.data.txt '
+                    : 'snapshot_perf.data.txt ',
+                '--output_file dump_stack.txt ',
+                '--output_csv dump_stack.xlsx ',
+                '--output_json dump_stack.json',
+            ].join(''),
+        },
+    ];
+    const resultGroups = {
+        reboot: rebootGroup,
+        monitor: monitorGroup,
+        collect: collectGroup,
+        analysis: analysisGroup,
+    };
+    const order = mode === 'reboot-monitor'
+        ? ['reboot', 'monitor', 'collect', 'analysis']
+        : ['monitor', 'collect', 'analysis'];
+    return {
+        groups: resultGroups,
+        defaultGroupOrder: order,
+    };
+}
+//# sourceMappingURL=forkall.js.map

package/dist/commands/forkall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forkall.js","sourceRoot":"","sources":["../../commands/forkall.ts"],"names":[],"mappings":"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"}

package/dist/commands/mac-example.d.ts

@@ -0,0 +1,23 @@
+import type { Groups } from '../src/types.js';
+/**
+ * Mac 示例场景：仅在 macOS 下执行，接收 --app 参数，参数不为空时打印 app。
+ */
+export declare const groups: Groups;
+export declare const defaultGroupOrder: string[];
+export declare const options: {
+    flags: string;
+    description: string;
+}[];
+interface MacExampleOptions {
+    app?: string;
+}
+export declare function applyOptions(ctx: {
+    groups: Groups;
+    defaultGroupOrder: string[];
+    options: MacExampleOptions;
+}): {
+    groups: Groups;
+    defaultGroupOrder: string[];
+};
+export {};
+//# sourceMappingURL=mac-example.d.ts.map

package/dist/commands/mac-example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mac-example.d.ts","sourceRoot":"","sources":["../../commands/mac-example.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE9C;;GAEG;AACH,eAAO,MAAM,MAAM,EAAE,MAQpB,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,MAAM,EAAoB,CAAC;AAE3D,eAAO,MAAM,OAAO;;;GAEnB,CAAC;AAEF,UAAU,iBAAiB;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,OAAO,EAAE,iBAAiB,CAAC;CAC5B,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,MAAM,EAAE,CAAA;CAAE,CAuBlD"}