@craftline/mind-darwin 1.0.2 → 1.0.3

package/applications/Mind.app/Contents/Info.plist

@@ -17,7 +17,7 @@
 	<key>CFBundlePackageType</key>
 	<string>APPL</string>
 	<key>CFBundleShortVersionString</key>
-	<string>1.0.2</string>
+	<string>1.0.3</string>
 	<key>NSHighResolutionCapable</key>
 	<true/>
 	<key>NSHumanReadableCopyright</key>

package/applications/Mind.app/Contents/MacOS/schematic/skills/bundled/framix-docs/SKILL.md

@@ -0,0 +1,25 @@
+---
+name: framix-docs
+description: Framix CLI 文档，用于移动应用录屏帧分析、启动或页面切换耗时判断、关键帧识别、模型训练数据准备、报告合并和 Framix 命令生成。
+---
+
+# Framix Docs
+
+这个 skill 提供 Framix CLI 的使用文档。`SKILL.md` 是精简入口；详细说明放在 `references/*.md`。
+
+## Routing
+
+| 问题 | 先读什么 |
+| --- | --- |
+| 了解 Framix 能力、适用场景或产物 | [Framix 概览](references/overview.md) |
+| 生成单条 Framix 命令或查询参数 | [Framix 常用命令](references/commands.md) |
+| 处理完整分析、训练、合并流程 | [Framix 典型流程](references/workflows.md) |
+
+## Core Rules
+
+- 先确认输入对象是视频文件、任务 JSON、任务目录、模型目录、报告目录还是资源同步。
+- 优先给出当前任务需要的最小可执行命令。
+- 路径参数必须加引号，避免空格、中文或特殊字符导致命令解析失败。
+- 除授权激活 `framix --apply ...` 外，示例命令必须包含 `--debug`，否则日志可能被动画输出吞掉。
+- 不要编造本地路径、模型路径或报告路径。
+- 说明结果时覆盖输入、处理方式、主要产物和风险。

package/applications/Mind.app/Contents/MacOS/schematic/skills/bundled/framix-docs/references/commands.md

@@ -0,0 +1,454 @@
+# Framix 常用命令
+
+## 命令规则
+
+- 除 `framix --apply ...` 外，所有示例命令都加 `--debug`，确保执行时输出日志。
+- 路径参数始终加引号。
+- Windows PowerShell 中 JSON 字符串需要转义双引号。
+
+## 1. 视频分析
+
+分析单个视频：
+
+```bash
+framix --debug --video "/path/to/video.mp4"
+```
+
+分析多个视频：
+
+```bash
+framix --debug --video "/path/to/a.mp4" --video "/path/to/b.mp4"
+```
+
+路径中有空格时必须加引号：
+
+```bash
+framix --debug --video "C:/Users/Alice/Videos/My Sample.mp4"
+```
+
+---
+
+## 2. JSON 任务输入
+
+使用 `--frame` 传入单个 JSON 任务：
+
+```bash
+framix --debug --frame '{"label":"20250814000130","title":"Test","video":["/path/to/a.mp4"]}'
+```
+
+Windows PowerShell 示例：
+
+```powershell
+framix --debug --frame "{`"label`":`"20250814000130`",`"title`":`"Test`",`"video`":[`"C:/Users/Alice/a.mp4`"]}"
+```
+
+---
+
+## 3. 任务目录分析
+
+分析结构化任务目录：
+
+```bash
+framix --debug --stack "/path/to/task-folder"
+```
+
+---
+
+## 4. 快速拆帧
+
+适用于不关心精确时间戳，只想快速生成帧级结果的场景。
+
+```bash
+framix --debug --video "/path/to/video.mp4" --speed
+```
+
+---
+
+## 5. 基础时间戳分析
+
+适用于需要帧时间戳、耗时判断和时序分析的场景。
+
+```bash
+framix --debug --video "/path/to/video.mp4" --basic
+```
+
+---
+
+## 6. 模型辅助分析
+
+适用于关键帧识别、阶段分类、视觉模型判断等场景。
+
+```bash
+framix --debug --video "/path/to/video.mp4" --keras
+```
+
+---
+
+## 7. 远程推理
+
+适用于需要云端 GPU 或远程模型推理的场景。
+
+```bash
+framix --debug --video "/path/to/video.mp4" --infer
+```
+
+也可以单独启用远程推理模式：
+
+```bash
+framix --debug --infer
+```
+
+---
+
+## 8. 训练数据准备
+
+```bash
+framix --debug --train "/path/to/video.mp4"
+```
+
+---
+
+## 9. 构建模型
+
+```bash
+framix --debug --build "/path/to/Model_xxx"
+```
+
+指定模型输入尺寸：
+
+```bash
+framix --debug --shape 200,200 --build "/path/to/Model_xxx"
+```
+
+模型目录要求：
+
+```text
+Model_xxx/
+├── 0/
+├── 1/
+├── 2/
+```
+
+规则：
+
+* 必须包含 `0/`
+* 目录名必须是连续数字
+* 标签范围最多 `0` 到 `5`
+* 图片格式建议为 `.jpg` 或 `.png`
+
+---
+
+## 10. 循环录制分析
+
+用于周期性录制和持续分析。
+
+```bash
+framix --debug --flick
+```
+
+---
+
+## 11. 执行单个脚本
+
+```bash
+framix --debug --carry script.json;ID-X
+```
+
+---
+
+## 12. 执行完整脚本集合
+
+```bash
+framix --debug --fully script.json
+```
+
+---
+
+## 13. 绘制辅助线
+
+用于在截图上绘制横向和竖向辅助线，便于区域分析。
+
+```bash
+framix --debug --paint
+```
+
+---
+
+## 14. 合并无时间戳报告
+
+适用于无严格时间戳对齐的报告合并。
+
+```bash
+framix --debug --union "/path/to/report-folder"
+```
+
+多个目录：
+
+```bash
+framix --debug --union "/path/to/a" --union "/path/to/b"
+```
+
+---
+
+## 15. 合并有时间戳报告
+
+适用于需要按时间戳对齐的报告合并。
+
+```bash
+framix --debug --merge "/path/to/report-folder"
+```
+
+多个目录：
+
+```bash
+framix --debug --merge "/path/to/a" --merge "/path/to/b"
+```
+
+---
+
+## 16. 综合报告合并
+
+使用分组模式合并报告：
+
+```bash
+framix --debug --group --merge "/path/to/a" --merge "/path/to/b"
+```
+
+---
+
+## 17. 配置对话预览
+
+用于打开并校对 Framix 配置。
+
+```bash
+framix --debug --talks
+```
+
+---
+
+## 18. 注入全局运行配置
+
+用于加载报告目录、模型目录和模型选择等全局配置。
+
+```bash
+framix --debug --rings
+```
+
+---
+
+## 19. 授权激活
+
+```bash
+framix --apply ACT-XXXX-XXXX
+```
+
+---
+
+## 20. 批量文本转语音
+
+```bash
+framix --debug --voice 你好 世界 AI科技
+```
+
+---
+
+## 21. 同步资源
+
+首次部署或资源缺失时使用：
+
+```bash
+framix --debug --syncs all
+```
+
+可选值：
+
+```text
+all
+template
+toolkit
+model
+```
+
+---
+
+## 22. 独立录屏控制
+
+适用于多任务并行录制时，独立控制指定设备录屏停止。
+
+```bash
+framix --debug --alone
+```
+
+---
+
+## 23. 高级模型分析参数
+
+### 开启增强分析
+
+```bash
+framix --debug --keras --boost --video "/path/to/video.mp4"
+```
+
+### 开启彩色模型分析
+
+```bash
+framix --debug --keras --boost --color --video "/path/to/video.mp4"
+```
+
+### 开启分组分析
+
+```bash
+framix --debug --keras --boost --color --group --video "/path/to/video.mp4"
+```
+
+### 缩放视频画面
+
+```bash
+framix --debug --keras --boost --color --group --scale 0.5 --video "/path/to/video.mp4"
+```
+
+### 设置开始时间和分析时长
+
+```bash
+framix --debug --keras --boost --color --group --start 0.5 --limit 2 --video "/path/to/video.mp4"
+```
+
+### 设置终止时间
+
+```bash
+framix --debug --keras --boost --color --group --close 3 --video "/path/to/video.mp4"
+```
+
+### 设置帧率和识别阈值
+
+```bash
+framix --debug --keras --boost --color --group --frate 60 --thres 0.97 --video "/path/to/video.mp4"
+```
+
+### 设置偏移和分块参数
+
+```bash
+framix --debug --keras --boost --color --group --shift 3 --block 6 --video "/path/to/video.mp4"
+```
+
+### 设置目标分析区域
+
+```bash
+framix --debug --keras --boost --color --group --crops 0,0.1,1,0.9 --video "/path/to/video.mp4"
+```
+
+### 设置忽略区域
+
+```bash
+framix --debug --keras --boost --color --group --omits 0,0,1,0.2 --omits 0,0.9,1,0.1 --video "/path/to/video.mp4"
+```
+
+---
+
+## 24. 常用组合
+
+### 快速看视频结果
+
+```bash
+framix --debug --video "/path/to/video.mp4" --speed
+```
+
+### 做精确耗时分析
+
+```bash
+framix --debug --video "/path/to/video.mp4" --basic
+```
+
+### 做模型辅助识别
+
+```bash
+framix --debug --video "/path/to/video.mp4" --keras
+```
+
+### 做增强视觉分析
+
+```bash
+framix --debug --keras --boost --color --group --video "/path/to/video.mp4"
+```
+
+### 做指定时间段分析
+
+```bash
+framix --debug --keras --boost --color --group --start 0.5 --limit 2 --video "/path/to/video.mp4"
+```
+
+### 做指定区域分析
+
+```bash
+framix --debug --keras --boost --color --group --crops 0,0.1,1,0.9 --video "/path/to/video.mp4"
+```
+
+### 首次同步资源
+
+```bash
+framix --debug --syncs all
+```
+
+### 已有结果生成合并报告
+
+```bash
+framix --debug --group --merge "/path/to/a" --merge "/path/to/b"
+```
+
+---
+
+## 25. 参数速查
+
+| 参数        | 作用               |
+| --------- | ---------------- |
+| `--frame` | 使用 JSON 载荷注入视频任务 |
+| `--video` | 指定视频文件           |
+| `--stack` | 指定任务目录           |
+| `--train` | 准备训练样本           |
+| `--build` | 构建模型             |
+| `--flick` | 循环录制和分析          |
+| `--carry` | 执行单个脚本任务         |
+| `--fully` | 执行完整脚本集合         |
+| `--paint` | 绘制截图辅助线          |
+| `--union` | 合并无时间戳报告         |
+| `--merge` | 合并有时间戳报告         |
+| `--talks` | 配置对话预览           |
+| `--rings` | 注入全局运行配置         |
+| `--apply` | 授权激活             |
+| `--voice` | 批量文本转语音          |
+| `--syncs` | 同步模板、模型或工具资源     |
+| `--speed` | 快速拆帧             |
+| `--basic` | 时间戳分析            |
+| `--keras` | 模型辅助分析           |
+| `--infer` | 远程推理             |
+| `--alone` | 独立录屏控制           |
+| `--boost` | 启用增强分析           |
+| `--color` | 启用彩色模型/彩色分析      |
+| `--group` | 启用分组分析或分组报告      |
+| `--scale` | 缩放画面             |
+| `--start` | 指定开始时间           |
+| `--limit` | 指定分析时长           |
+| `--close` | 指定终止时间           |
+| `--frate` | 指定帧率             |
+| `--thres` | 指定识别阈值           |
+| `--shift` | 指定偏移参数           |
+| `--block` | 指定分块参数           |
+| `--crops` | 指定目标分析区域         |
+| `--omits` | 指定忽略区域           |
+| `--shape` | 指定模型输入尺寸         |
+
+---
+
+## 26. 路径规则
+
+始终建议给路径加引号：
+
+```bash
+framix --debug --video "/Users/user/Videos/test video.mp4"
+```
+
+不要使用未加引号的路径：
+
+```bash
+framix --debug --video /Users/user/Videos/test video.mp4
+```

package/applications/Mind.app/Contents/MacOS/schematic/skills/bundled/framix-docs/references/overview.md

@@ -0,0 +1,45 @@
+# Framix 概览
+
+## 项目定位
+
+Framix 是用于移动应用性能测试和视频视觉分析的 CLI 工具。
+
+它通过录屏、视频拆帧、视觉识别、模型分析和结构化报告，帮助测试人员和开发人员判断应用在真实用户视角下的性能表现。
+
+## 核心价值
+
+Framix 偏向非侵入式分析，通过用户可见画面判断：
+
+- 启动是否慢
+- 页面切换是否卡顿
+- 功能执行是否超时
+- 视频帧变化是否符合预期
+- 关键操作是否存在性能瓶颈
+
+## 主要分析对象
+
+- APP 启动耗时
+- 页面切换耗时
+- 功能执行耗时
+- 视频帧变化
+- 关键帧区间
+- 多视频对比
+- 模型训练样本
+- 结构化性能报告
+
+## 典型产物
+
+- HTML 报告
+- JSON 数据
+- 视频帧图片
+- 关键帧识别结果
+- 统计曲线
+- 模型训练数据
+- 合并后的分析报告
+
+## 使用建议
+
+- 快速查看帧变化时，优先使用 `--speed`。
+- 需要准确耗时或时间戳时，优先使用 `--basic`。
+- 需要模型辅助识别时，使用 `--keras` 或 `--infer`。
+- 命令示例除 `--apply` 外必须包含 `--debug`，便于输出可见日志。

package/applications/Mind.app/Contents/MacOS/schematic/skills/bundled/framix-docs/references/workflows.md

@@ -0,0 +1,144 @@
+# Framix 典型流程
+
+## 1. 首次环境准备
+
+适用于新机器、新环境或资源缺失场景。
+
+```bash
+framix --debug --syncs all
+```
+
+目的：
+
+- 同步模板
+- 同步模型
+- 同步运行所需工具资源
+- 确保本地环境可执行
+
+## 2. 快速分析一个视频
+
+适用于快速预览视频帧变化，不要求精确耗时。
+
+```bash
+framix --debug --video "/path/to/video.mp4" --speed
+```
+
+输出关注：
+
+- 是否成功拆帧
+- 是否生成报告
+- 是否存在明显异常帧
+
+## 3. 分析 APP 操作耗时
+
+适用于启动耗时、页面切换耗时、功能执行耗时分析。
+
+```bash
+framix --debug --video "/path/to/video.mp4" --basic
+```
+
+输出关注：
+
+- 起始帧
+- 结束帧
+- 时间戳
+- 耗时区间
+- 是否超出预期
+
+## 4. 使用模型辅助识别关键帧
+
+适用于需要自动识别关键阶段、关键动作或视觉变化的场景。
+
+```bash
+framix --debug --video "/path/to/video.mp4" --keras
+```
+
+输出关注：
+
+- 模型识别结果
+- 关键帧区间
+- 分类置信度
+- 报告是否完整
+
+## 5. 使用远程推理
+
+适用于本地算力不足或需要云端模型的场景。
+
+```bash
+framix --debug --video "/path/to/video.mp4" --infer
+```
+
+注意：
+
+- 远程服务不可用时可能降级为本地推理
+- 需要关注网络、接口和返回结果
+
+## 6. 批量任务输入
+
+适用于脚本化、CI 或批量视频任务。
+
+```bash
+framix --debug --frame '{"label":"20250814000130","title":"Test","video":["/path/to/a.mp4","/path/to/b.mp4"]}'
+```
+
+要求：
+
+- JSON 根节点必须是对象
+- `label` 必须是任务标识
+- `title` 必须是任务标题
+- `video` 必须是视频路径数组
+
+## 7. 训练样本准备
+
+```bash
+framix --debug --train "/path/to/video.mp4"
+```
+
+之后需要整理模型目录：
+
+```text
+Model_xxx/
+├── 0/
+├── 1/
+├── 2/
+```
+
+## 8. 构建模型
+
+```bash
+framix --debug --build "/path/to/Model_xxx"
+```
+
+注意：
+
+- 目录必须从 `0/` 开始
+- 编号必须连续
+- 最多支持 6 类，即 `0` 到 `5`
+
+## 9. 报告合并
+
+无严格时间戳时：
+
+```bash
+framix --debug --union "/path/to/report-folder"
+```
+
+需要按时间戳对齐时：
+
+```bash
+framix --debug --merge "/path/to/report-folder"
+```
+
+## 10. 回答用户时的推荐格式
+
+优先给命令：
+
+```bash
+framix --debug --video "/path/to/video.mp4" --basic
+```
+
+然后简要说明：
+
+```text
+这个命令会对视频进行带时间戳的帧级分析，适合判断启动、页面切换或功能执行耗时。执行后重点查看生成的报告和关键帧区间。
+```

package/applications/Mind.app/Contents/MacOS/schematic/skills/bundled/memrix-docs/SKILL.md

@@ -0,0 +1,26 @@
+---
+name: memrix-docs
+description: Memrix CLI 文档，用于 Android 应用内存和 I/O 采样、Perfetto 帧率流畅度分析、性能评分、HTML 报告生成、设备选择和 Memrix 命令生成。
+---
+
+# Memrix Docs
+
+这个 skill 提供 Memrix CLI 的使用文档。`SKILL.md` 是精简入口；详细说明放在 `references/*.md`。
+
+## Routing
+
+| 问题 | 先读什么 |
+| --- | --- |
+| 了解 Memrix 能力、适用场景或产物 | [Memrix 概览](references/overview.md) |
+| 生成单条 Memrix 命令或查询参数 | [Memrix 常用命令](references/commands.md) |
+| 处理采集、报告、评分或排障流程 | [Memrix 典型流程](references/workflows.md) |
+
+## Core Rules
+
+- 先确认测试目标是应用包名、设备序列号、Perfetto trace 文件、输出目录还是已有报告目录。
+- 需要测试 Android 应用时，必须提供 `--focus <包名>`。
+- 多设备场景必须补充 `--imply <设备序列号>`。
+- 需要自动生成报告时，优先追加 `--atlas`。
+- 需要按规则评分时，追加 `--align`。
+- 除授权激活 `memrix --apply ...` 外，Memrix 示例命令必须包含 `--debug`，否则日志可能被动画输出吞掉。
+- 不要编造包名、设备序列号或本地路径。

package/applications/Mind.app/Contents/MacOS/schematic/skills/bundled/memrix-docs/references/commands.md

@@ -0,0 +1,170 @@
+# Memrix 常用命令
+
+## 命令规则
+
+- 除 `memrix --apply ...` 外，所有 Memrix 示例命令都加 `--debug`，确保执行时输出日志。
+- Android 应用采集必须提供 `--focus <包名>`。
+- 多设备场景必须提供 `--imply <设备序列号>`。
+- `adb devices` 不是 Memrix 命令，不需要追加 `--debug`。
+
+## 内存与 I/O 联合采样
+
+用于采集目标应用的内存波动和 I/O 行为。
+
+```bash
+memrix --debug --storm --focus <com.example.application>
+```
+
+指定设备：
+
+```bash
+memrix --debug --storm --focus <com.example.application> --imply <device.serial>
+```
+
+指定输出目录：
+
+```bash
+memrix --debug --storm --focus <com.example.application> --scene <output_dir>
+```
+
+设置报告标题：
+
+```bash
+memrix --debug --storm --focus <com.example.application> --title <report_name>
+```
+
+开启详细调试日志：
+
+```bash
+memrix --debug --storm --focus <com.example.application> --watch
+```
+
+## 帧率与流畅度分析
+
+用于分析 Perfetto trace 文件中的帧率、卡顿和交互流畅度。
+
+```bash
+memrix --debug --sleek --focus <trace_file.perfetto>
+```
+
+## 生成报告
+
+用于根据已有测试输出目录生成结构化 HTML 报告。
+
+```bash
+memrix --debug --forge <output_dir>
+```
+
+生成报告并区分前后台阶段：
+
+```bash
+memrix --debug --forge <output_dir> --layer
+```
+
+## 采集后自动生成报告
+
+用于采集完成后自动生成图表报告。
+
+```bash
+memrix --debug --storm --focus <com.example.application> --atlas
+```
+
+## 启用评分标准
+
+用于按 YAML 配置对内存、流畅度、I/O 等指标进行多维度评分。
+
+```bash
+memrix --debug --storm --focus <com.example.application> --align
+```
+
+通常可以和自动报告一起使用：
+
+```bash
+memrix --debug --storm --focus <com.example.application> --align --atlas
+```
+
+## 指定设备
+
+当连接多台设备时使用。
+
+```bash
+memrix --debug --storm --focus <com.example.application> --imply <device.serial>
+```
+
+设备序列号可通过以下命令查看：
+
+```bash
+adb devices
+```
+
+## 指定任务目录
+
+用于指定输出目录或任务挂载目录。
+
+```bash
+memrix --debug --storm --focus <com.example.application> --scene <file.name>
+```
+
+## 设置报告标题
+
+```bash
+memrix --debug --storm --focus <com.example.application> --title <name>
+```
+
+## 授权激活
+
+`--apply` 是例外，不加 `--debug`：
+
+```bash
+memrix --apply ACT-XXXX-XXXX
+```
+
+## 常用组合
+
+### 持续监控应用内存
+
+```bash
+memrix --debug --storm --focus <com.example.application>
+```
+
+### 指定设备采集
+
+```bash
+memrix --debug --storm --focus <com.example.application> --imply <device.serial>
+```
+
+### 采集并自动生成报告
+
+```bash
+memrix --debug --storm --focus <com.example.application> --atlas
+```
+
+### 采集、评分并生成报告
+
+```bash
+memrix --debug --storm --focus <com.example.application> --align --atlas
+```
+
+### 生成已有目录报告
+
+```bash
+memrix --debug --forge <file.name>
+```
+
+## 参数说明
+
+| 参数 | 作用 |
+| --- | --- |
+| `--debug` | 输出执行日志 |
+| `--storm` | 内存波动和 I/O 行为联合采样 |
+| `--sleek` | 帧率稳定性和交互流畅度分析 |
+| `--forge` | 生成结构化报告 |
+| `--align` | 启用多维度评分标准 |
+| `--apply` | 授权激活 |
+| `--focus` | 指定应用包名或 trace 文件 |
+| `--imply` | 指定 ADB 设备序列号 |
+| `--scene` | 指定输出目录或任务目录 |
+| `--title` | 设置报告标题 |
+| `--atlas` | 任务完成后自动生成报告 |
+| `--layer` | 报告中区分前台和后台阶段 |
+| `--watch` | 输出详细调试信息 |

package/applications/Mind.app/Contents/MacOS/schematic/skills/bundled/memrix-docs/references/overview.md

@@ -0,0 +1,49 @@
+# Memrix 概览
+
+## 项目定位
+
+Memrix 是用于移动应用性能测试和资源分析的 CLI 工具。
+
+它通过 ADB、Perfetto、内存采样、I/O 采样、帧率分析和结构化报告，帮助测试人员判断应用是否存在内存异常、性能瓶颈、卡顿和资源使用不稳定等问题。
+
+## 核心价值
+
+Memrix 主要解决以下问题：
+
+- 内存使用是否持续上涨
+- 是否存在疑似内存泄漏
+- I/O 行为是否异常
+- 页面或交互是否存在卡顿
+- 帧率是否稳定
+- 测试结果是否可以自动报告化
+- 是否满足准出标准
+
+## 主要分析对象
+
+- Android 应用包名
+- ADB 设备
+- Perfetto trace 文件
+- 内存采样数据
+- I/O 行为数据
+- 帧率和 Jank 指标
+- 测试输出目录
+- HTML 报告
+
+## 典型产物
+
+- HTML 性能报告
+- 内存趋势图
+- I/O 行为图表
+- 帧率稳定性分析
+- 流畅度评分
+- 多维度准出判断
+- 测试日志和中间数据
+
+## 使用建议
+
+- 测试应用内存和 I/O 时，优先使用 `--storm`。
+- 分析流畅度和掉帧时，优先使用 `--sleek`。
+- 生成报告时，使用 `--forge` 或追加 `--atlas`。
+- 按标准评分时，追加 `--align`。
+- 连接多台设备时，必须使用 `--imply` 指定设备。
+- Memrix 命令示例除 `--apply` 外必须包含 `--debug`，便于输出可见日志。

package/applications/Mind.app/Contents/MacOS/schematic/skills/bundled/memrix-docs/references/workflows.md

@@ -0,0 +1,197 @@
+# Memrix 典型流程
+
+## 1. 测试前确认设备
+
+适用于 Android 设备测试前确认连接状态。
+
+```bash
+adb devices
+```
+
+确认设备在线后，再执行 Memrix 采集命令。
+
+如果只有一台设备，可以不传 `--imply`。
+
+如果有多台设备，建议指定设备序列号：
+
+```bash
+memrix --debug --storm --focus <com.example.application> --imply <device.serial>
+```
+
+## 2. 采集应用内存和 I/O
+
+适用于判断应用是否存在内存上涨、波动异常或 I/O 异常。
+
+```bash
+memrix --debug --storm --focus <com.example.application>
+```
+
+关注结果：
+
+- 内存是否持续上涨
+- 是否存在明显波动
+- I/O 是否异常频繁
+- 采样过程是否稳定
+- 是否生成中间数据
+
+## 3. 采集并自动生成报告
+
+适用于一次性完成采集和报告输出。
+
+```bash
+memrix --debug --storm --focus <com.example.application> --atlas
+```
+
+关注结果：
+
+- 是否生成 HTML 报告
+- 报告中是否包含趋势图
+- 是否包含异常提示
+- 是否方便归档和共享
+
+## 4. 启用评分机制
+
+适用于需要准出判断、风险标注或统一测试标准的场景。
+
+```bash
+memrix --debug --storm --focus <com.example.application> --align --atlas
+```
+
+关注结果：
+
+- 是否加载评分配置
+- 是否输出评分结果
+- 是否标注风险项
+- 是否满足准出标准
+
+## 5. 指定输出目录和报告标题
+
+适用于批量测试或需要归档的场景。
+
+```bash
+memrix --debug --storm --focus <com.example.application> --scene <output_dir> --title <report_name> --atlas
+```
+
+说明：
+
+- `--scene` 控制输出目录
+- `--title` 控制报告标题
+- `--atlas` 控制采集结束后自动生成报告
+
+## 6. 多设备测试
+
+适用于同时连接多台 Android 设备的场景。
+
+```bash
+memrix --debug --storm --focus <com.example.application> --imply <device.serial> --scene <output_dir>
+```
+
+注意：
+
+- 多设备场景必须确认设备序列号
+- 不要让工具自动猜测目标设备
+- 输出目录建议按设备或任务命名
+
+## 7. 分析帧率和流畅度
+
+适用于已有 Perfetto trace 文件，或需要分析滑动、拖拽、掉帧等问题。
+
+```bash
+memrix --debug --sleek --focus <trace_file.perfetto>
+```
+
+关注结果：
+
+- FPS 是否稳定
+- 是否存在 Jank
+- 是否存在明显掉帧段
+- 是否能定位异常交互区间
+
+## 8. 根据已有目录生成报告
+
+适用于采集已经完成，只需要补充生成报告的场景。
+
+```bash
+memrix --debug --forge <output_dir>
+```
+
+如果需要区分前台和后台阶段：
+
+```bash
+memrix --debug --forge <output_dir> --layer
+```
+
+## 9. 调试异常采集
+
+适用于采集失败、设备无响应、数据缺失或命令行为异常。
+
+```bash
+memrix --debug --storm --focus <com.example.application> --watch
+```
+
+关注内容：
+
+- ADB 是否连接正常
+- 目标包名是否正确
+- 是否有权限或设备状态异常
+- 采样过程是否中断
+
+## 10. 授权激活
+
+首次部署或授权过期时使用。
+
+```bash
+memrix --apply ACT-XXXX-XXXX
+```
+
+注意：
+
+- 激活码通常为一次性授权码
+- 授权会绑定设备指纹
+- 激活成功后会在本地生成授权文件
+
+## 11. 回答用户时的推荐格式
+
+先给命令：
+
+```bash
+memrix --debug --storm --focus <com.example.application> --align --atlas
+```
+
+再简要说明：
+
+```text
+这个命令会对目标应用进行内存和 I/O 采样，并启用评分标准，任务结束后自动生成结构化报告。适合做性能准出、内存异常排查和测试结果归档。
+```
+
+## 12. 常见判断
+
+用户说“看内存有没有涨”：
+
+```bash
+memrix --debug --storm --focus <com.example.application>
+```
+
+用户说“顺便出报告”：
+
+```bash
+memrix --debug --storm --focus <com.example.application> --atlas
+```
+
+用户说“要按标准判断是否通过”：
+
+```bash
+memrix --debug --storm --focus <com.example.application> --align --atlas
+```
+
+用户说“有多台设备”：
+
+```bash
+memrix --debug --storm --focus <com.example.application> --imply <device.serial>
+```
+
+用户说“已有结果，只要报告”：
+
+```bash
+memrix --debug --forge <output_dir>
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@craftline/mind-darwin",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "Mind macOS runtime package.",
   "os": [
     "darwin"