@harmonyos-arkts/d2h 0.1.6 → 0.1.8

package/dist/src/install-opencode.js

@@ -2,6 +2,7 @@ import fs from 'node:fs';
 import path from 'node:path';
 import os from 'node:os';
 import crypto from 'node:crypto';
+import { updateMetricsPlugin } from './metrics-plugin.js';
 function stat(file) {
     try {
         return fs.lstatSync(file);
@@ -68,7 +69,7 @@ function resolvedLocation(directory) {
     const parent = path.dirname(directory);
     return parent === directory ? directory : path.join(resolvedLocation(parent), path.basename(directory));
 }
-export function installOpenCode({ sourceDir, configDir, agent = 'opencode', link = false, force = false, dryRun = false, log = console.log }) {
+export function installOpenCode({ sourceDir, configDir, agent = 'opencode', link = false, force = false, dryRun = false, remote = false, log = console.log }) {
     if (!['opencode', 'deveco'].includes(agent))
         throw new Error(`unsupported agent: ${agent}`);
     const application = agent === 'deveco' ? 'DevEco Code' : 'OpenCode';
@@ -80,6 +81,13 @@ export function installOpenCode({ sourceDir, configDir, agent = 'opencode', link
         contains(sourceRoot, configRoot) || contains(configRoot, sourceRoot)) {
         throw new Error(`refusing unsafe OpenCode config directory: ${configDir}`);
     }
+    const configFile = path.join(configRoot, 'opencode.json');
+    const existingConfig = stat(configFile);
+    if (existingConfig?.isSymbolicLink())
+        throw new Error(`refusing linked OpenCode config file: ${configFile}`);
+    const config = existingConfig ? JSON.parse(fs.readFileSync(configFile, 'utf8')) : {};
+    updateMetricsPlugin(config, remote);
+    const configText = JSON.stringify(config, null, 2) + '\n';
     const entries = [];
     for (const kind of ['skills', 'agents']) {
         const source = path.join(sourceRoot, kind);
@@ -157,6 +165,17 @@ export function installOpenCode({ sourceDir, configDir, agent = 'opencode', link
     const skills = entries.filter(entry => entry.kind === 'skills').length;
     const agents = entries.filter(entry => entry.kind === 'agents').length;
     if (!dryRun) {
+        if (!existingConfig || fs.readFileSync(configFile, 'utf8') !== configText) {
+            const temporaryConfig = `${configFile}.d2h-${process.pid}.tmp`;
+            try {
+                fs.writeFileSync(temporaryConfig, configText);
+                fs.renameSync(temporaryConfig, configFile);
+            }
+            finally {
+                if (fs.existsSync(temporaryConfig))
+                    fs.rmSync(temporaryConfig);
+            }
+        }
         const receipt = path.join(configRoot, '.d2h-installation.json');
         const temporary = path.join(configRoot, `.d2h-installation-${process.pid}.tmp`);
         const packageFile = path.join(sourceRoot, 'package.json');

package/dist/src/install-vscode.js

@@ -2,6 +2,7 @@ import fs from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
 import crypto from 'node:crypto';
+import { updateMetricsPlugin } from './metrics-plugin.js';
 const extensionPrefix = 'huaweideveloperserviceplatform.harmonyosdevassistantforvscode-';
 const modeLabel = '安卓转鸿蒙';
 function digest(file) {
@@ -72,7 +73,7 @@ export function updateD2HModeLabel(source) {
         : original.slice(0, -1) + `,d2h:${JSON.stringify(modeLabel)}}`;
     return source.slice(0, matches[0].index) + next + source.slice(matches[0].index + original.length);
 }
-function updateConfig(source) {
+function updateConfig(source, remote) {
     const value = JSON.parse(source);
     value.agent ??= {};
     value.agent.d2h = { ...value.agent.d2h, description: modeLabel,
@@ -84,6 +85,8 @@ function updateConfig(source) {
         throw new Error('opencode plugin list must be an array');
     if (!value.plugin.includes('./plugin/d2h'))
         value.plugin.push('./plugin/d2h');
+    if (remote !== undefined)
+        updateMetricsPlugin(value, remote);
     return JSON.stringify(value, null, 2) + '\n';
 }
 function copyWithBackup(source, destination, backupRoot, root) {
@@ -111,7 +114,7 @@ function copyWithBackup(source, destination, backupRoot, root) {
     }
     return true;
 }
-export function installVSCode({ sourceDir, extensionDir, bundleCacheRoot, dryRun = false, log = console.log }) {
+export function installVSCode({ sourceDir, extensionDir, bundleCacheRoot, remote = false, dryRun = false, log = console.log }) {
     const sourceRoot = fs.realpathSync(sourceDir);
     const root = validatedRoot(locateVSCodeExtension(extensionDir));
     const bundle = activeBundle(root, bundleCacheRoot);
@@ -120,7 +123,7 @@ export function installVSCode({ sourceDir, extensionDir, bundleCacheRoot, dryRun
     const bundleConfigFile = path.join(bundle, 'opencode.json');
     const distFiles = ['dist/extension.js', 'dist/webview/main.js'];
     const patches = [
-        { file: configFile, content: updateConfig(fs.readFileSync(configFile, 'utf8')) },
+        { file: configFile, content: updateConfig(fs.readFileSync(configFile, 'utf8'), remote) },
         ...distFiles.map(name => ({ file: path.join(root, name), content: updateD2HModeLabel(fs.readFileSync(path.join(root, name), 'utf8')) })),
     ];
     const copies = [

package/dist/src/metrics-plugin.js

@@ -0,0 +1,20 @@
+export const liteMetricsPlugin = 'opencode-metrics-plugin-lite';
+export const remoteMetricsPlugin = 'opencode-metrics-plugin';
+export function updateMetricsPlugin(config, remote = false) {
+    const plugins = config.plugin ?? [];
+    if (!Array.isArray(plugins))
+        throw new Error('opencode plugin list must be an array');
+    const selected = remote ? remoteMetricsPlugin : liteMetricsPlugin;
+    const isMetrics = (entry) => {
+        const name = Array.isArray(entry) ? entry[0] : entry;
+        return name === liteMetricsPlugin || name === remoteMetricsPlugin;
+    };
+    const existing = plugins.findIndex(isMetrics);
+    const filtered = plugins.filter((entry, index) => !isMetrics(entry) || index === existing);
+    const selectedEntry = [selected, { agents: ['d2h'] }];
+    if (existing < 0)
+        filtered.push(selectedEntry);
+    else
+        filtered[filtered.findIndex(isMetrics)] = selectedEntry;
+    config.plugin = filtered;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@harmonyos-arkts/d2h",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "Install Android-to-HarmonyOS migration agents and skills into OpenCode or DevEco Code",
   "type": "module",
   "bin": {
@@ -11,6 +11,7 @@
     "dist/src/",
     "skills/",
     "agents/",
+    "AGENTS.md",
     "schemas/",
     "opencode/",
     ".claude-plugin/",

package/scripts/check-environment.mjs

@@ -7,7 +7,6 @@ import { fileURLToPath, pathToFileURL } from 'node:url';
 import { parseArgs } from 'node:util';
 
 const DEFAULT_REQUIREMENTS = fileURLToPath(new URL('../skills/managing-d2h-toolchain/environment-requirements.json', import.meta.url));
-const D2H_VERSION = JSON.parse(fs.readFileSync(new URL('../package.json', import.meta.url), 'utf8')).version;
 const VERSION_TOOLS = ['node', 'python', 'git', 'npm', 'java', 'python-json5', 'appgraph', 'droid2hmos', 'hvigor', 'ohpm', 'devecocli'];
 
 function versionParts(value) {
@@ -220,7 +219,7 @@ export async function collect(options, { runner = probe, env = process.env, plat
     }
   }
   for (const name of ['appgraph', 'droid2hmos']) {
-    await tool(name, name, ['--version'], `运行 npx --yes @harmonyos-arkts/d2h@${D2H_VERSION} install 安装兼容工具组合；本地 npm link 需由开发者显式管理。`);
+    await tool(name, name, ['--version'], '运行 managing-d2h-toolchain Skill 中的 node scripts/manage-toolchain.mjs install 安装精确版本；本地 npm link 需由开发者显式管理。');
   }
   const deveco = directoryFinder([env.DEVECO_STUDIO_HOME, env.DEVECO_HOME,
     platform === 'darwin' ? '/Applications/DevEco-Studio.app/Contents' : null,

package/skills/d2h-hypium-forge/SKILL.md

@@ -177,12 +177,69 @@ first_launch** 分组排序执行（破坏性递增，bm clean 类强制排尾
 完整 `ensure_login`，组内后续幂等复用。组首执行时 `FORGE_GROUP_FIRST=1`。
 results.json 每条附 `group` 字段可分组统计。**禁把 reset_data=True 用在 logged_in 组**。
 
-### 5. 裸跑执行 + 四簇分析 + HTML 报告
+### 5. 裸跑执行 + 四簇分析 + HTML 报告（重跑阶梯 = 硬规范）
+
+**执行命令阶梯（--all 仅限首轮与门禁升级，修复轮禁无脑全量；违反会被 runner 硬阻断）**：
+> TD-LADDER v3 防护（已内置于 run_direct.py）：**所有"显式全量"（`--all` / `--acceptance` / 变相全量的 `--filter`）统一受管**，
+> 不再给 `--acceptance` 开后门。五条规则（任一命中即 exit 2 阻断并输出指引）：
+> ① **R1** 上轮 results.json 存在 FAIL/SKIP → 必须先修（`--case`/`--retry-failed`），禁止全量；
+> ② **R2** 源码 `srcHash` 与上次全量相同 → 重复全量无新结论（仅拦 `--all`）；
+> ③ **R2b** 上次已是**同源验收**（`lastMode=acceptance` 且 srcHash 未变）→ 拒绝重复验收；
+> ④ **R3** 本修复周期显式全量已达上限（默认 2，`FORGE_FULL_BUDGET` 可调）→ 归零条件是"跑出全绿"；
+> ⑤ **L1** `--filter` 覆盖 >50% 用例 = 变相全量，按全量纳管；**L2** 连续两轮失败签名一致且源码未变 → 拒绝重跑（先 probe 定案）。
+> 免检：`--retry-failed` 因源码变更**自动升级**的全量（非显式，不占预算）；`--force-all` 为显式逃生门。
+> droid2hmos CLI 的 `test harmony --runner python --all` 同步受 R1 防护（`--force-all` 放行）。
+> 实证（Grit）：修复期 15 次全量 212min，其中 **`--acceptance` 被当日常全量跑 13 次 157min（占测试时间 65%）**；
+> `--filter TC0` 当"小全量"跑 7 次；同族失败连卡 5 轮。v3 的 R1 覆盖 / R3 计次 / L1 / R2b / L2 即由此固化。
+> 合法全量收敛为：首轮（无历史）+ 终局验收（全绿后一次）+ 逃生门。
 ```bash
-python3 $F/run_direct.py --all --dir testcases --device <sn>   # 自动采集 end/fail 截图
+# 首轮全量（唯一常规使用 --all 的场景）
+python3 $F/run_direct.py --all --dir testcases --device <sn>
+
+# 修复轮阶梯（Grit 实证：15 次全量 212min，其中 5 轮卡同一 bug 空转 71min）
+python3 $F/run_direct.py --case <失败用例> --dir testcases --device <sn>      # ① 修测试脚本后单条验证（1-4min）
+python3 $F/run_direct.py --retry-failed --dir testcases --device <sn>         # ② 修产品代码后增量重跑（srcHash 门禁自动升级全量）
+python3 $F/run_direct.py --filter TC3 --dir testcases --device <sn>           # ③ 同族用例子集回归（如 TC30/31/35）
+
 python3 $F/analyze_results.py --results results.json --runtime-pages runtime_pages.json
 python3 $F/forge_report.py    # 产出 test-report.html（Allure 风格：概况/用例卡片/关键截图内嵌）
 ```
+铁律：修 1 个用例 ≠ 重跑 24 个。run_direct 汇总后 FAIL>0 会直接打印下一步命令——照抄执行。
+
+**范围回归（touched，产品代码变更后的默认门禁策略）**：
+`--retry-failed` 检测到产品代码变更时不再一律全量——按 `results.meta.json` 的**逐文件指纹**
+diff 出改动集，若全部是 ids.json 可定位的 UI 文件，则只重跑 `FAIL/SKIP + 引用这些文件的用例`
+（用例源码中的 id 字面量 → ids.json 文件映射）。改动含共享逻辑（viewmodel/repository）或
+范围超 60% → 自动退化全量。禁手动 `--all` 替代；`--regression-scope full` 仅用于里程碑。
+
+**热启动（组内软复用）**：组内非首条用例 `FORGE_WARM_LAUNCH=1`，`launch()` 探测 HOME_ANCHOR
+已在位即跳过 stop/start/bootstrap（省 8-12s/例）；组首条与 first_launch 组保持冷启；
+`--case` 单条验证默认热启动（`--cold` 强制冷启）。断言冷启行为的用例写 `launch(d, force=True)`。
+单用例挂死由看门狗截断（`--case-timeout 240` 默认，超时记 FAIL 继续下一条）。
+瞬态失败（watchdog/连接类）轮末自动复测一次（`--flake-retry 1` 默认，断言类失败不
+自动复测防掩盖真缺陷）。**零进展检测**：失败签名集与上轮完全一致时 runner 直接亮牌
+警告——停止重跑转 probe 定案（Grit 实证：同族失败连卡 5 轮全量空转 71min）。
+调试迭代期可 `FORGE_WAIT_SCALE=0.5` 把断言超时减半加速失败复现；正式回归保持 1。
+
+**最终质量门（不可跳过）**：所有优化（范围回归/热启动/flake 复测）只加速迭代期；
+**交付/收尾前必须执行一次验收全量**：`run_direct.py --acceptance`（强制 --all + 全程截图 +
+`.acceptance` 标记永久保护，最近 2 次留存），FAIL=0 或全部 FAIL 已登记缺陷并经 probe 定案。
+范围回归的 PASS 保留记录不作为最终结论——它只是迭代加速器，最终覆盖度以这次验收全量为准。
+
+**截图与 reports/ 留存（防体积失控——Grit 实证 5266 张/666MB）**：
+- 迭代期 `--shots fail`（默认）：PASS 用例只留 `<case>_end.jpeg`，过程帧/分步图仅 FAIL 用例保留；
+  连续相同帧自动去重（静止页 8 帧→1 帧）。
+- **中间运行目录即用即弃**（`--keep-reports` 默认 0）：每轮结束只保留本轮供当轮取证，
+  下一轮自动回收上一轮中间目录；需要跨轮对照时 `--keep-reports 3`。
+- **验收全程留存**：`--acceptance`（最终质量门专用）强制全量+全程截图，目录写 `.acceptance`
+  标记，prune 独立保护**最近 2 次**验收目录，永久作为交付证据。
+**取证一条命令（probe.py，禁手写 UiDriver 内联脚本——Grit 实证 69 次手写探针多花一半时间在代码生成上）**：
+```bash
+python3 $F/probe.py texts|ids|find <id>|tree --grep x     # 单次 dumpLayout 本地解析取证
+python3 $F/probe.py click <id|text>                        # uinput 坐标点击（Toggle 等 touch 失效场景可靠）
+python3 $F/probe.py shot / hilog JSAPP 400 / db-pull <pkg> / db-sql <db> '<sql>'
+```
+
 失败四簇：DEVICE（环境，重跑）/ DESIGN-ERROR（脚本定位/步骤错误，修脚本 ≤2 轮）/
 NAV-CONTEXT-LOSS（页面上下文丢失，hilog 定案）/ ASSERT-FAIL（**优先怀疑产品缺陷，保留 FAIL**）。
 

package/skills/d2h-hypium-forge/scripts/_common_template.py

@@ -11,10 +11,23 @@
   UI 登录——组首一次完整 setup，组内后续直接复用（省重复登录/注册）。
   组首条执行时环境变量 FORGE_GROUP_FIRST=1（可选做完整冷启验证）。
 """
+import os as _os
 import time
 from hypium import *
 from hypium.model import MatchPattern, UiParam
 
+try:
+    WAIT_SCALE = float(_os.environ.get('FORGE_WAIT_SCALE', '1') or 1)
+except ValueError:
+    WAIT_SCALE = 1.0
+
+
+def _w(sec):
+    """等待时长缩放（env FORGE_WAIT_SCALE，默认 1 不变）：调试迭代期设 0.5
+    可把失败路径的超时烧穿时间减半（Grit 实证 FAIL 用例 17-36s 多为等待超时）；
+    正式回归/出报告必须保持 1，防止慢设备真问题被截短掩盖。"""
+    return max(0.5, sec * WAIT_SCALE)
+
 PACKAGE = "me.hackerchick.raisetoanswer"
 ABILITY = "EntryAbility"
 ENTRY_PAGE = "pages/Index"
@@ -37,6 +50,21 @@ def _page_texts(d):
     except Exception:
         return []
 
+
+def _visible_clickables(d):
+    """一次拉全 Text+Button 可见文案集合（弹窗消化轮询的单 RPC 扫描，
+    替代逐文案 find_component 的 12+ RPC/轮——冷启消化从 ~3s/轮 降到 ~0.6s/轮）。"""
+    out = []
+    try:
+        for by in (BY.type("Text"), BY.type("Button")):
+            for c in (d.find_all_components(by) or []):
+                t = c.getText() or ""
+                if t:
+                    out.append(t)
+    except Exception:
+        pass
+    return out
+
 def bootstrap(d, gates=None, home_tab="", anchor_key="", total=60, log=print):
     """冷启到可用基座。流程：轮询消化全部弹窗关卡（一轮多点，直到无特征）→
     tab 归位（点目标 tab + 验证锚）→ 主页锚可见返回 True。
@@ -55,19 +83,18 @@ def bootstrap(d, gates=None, home_tab="", anchor_key="", total=60, log=print):
                     return True
             except Exception:
                 pass
-        # 2) 消化所有弹窗关卡：一轮内逐个点
+        # 2) 消化所有弹窗关卡：一轮拉全可见文案（单 RPC 扫描），本地匹配命中再点击
         hit_any = False
+        vis = set(_visible_clickables(d))
         for t in all_texts:
-            if t == (home_tab or ""):
+            if t == (home_tab or "") or t not in vis:
                 continue
             try:
-                # 全类型探测（按钮常为 Button 非 Text——TD-008 实证：Text-only 扫描漏掉隐私页同意按钮）
-                if d.find_component(BY.text(t)) is not None:
-                    d.touch(BY.text(t))
-                    dismissed.append(t)
-                    hit_any = True
-                    time.sleep(1.2)
-                    break  # 点一个后重新扫（弹窗可能叠加/消失后露下一个）
+                d.touch(BY.text(t))
+                dismissed.append(t)
+                hit_any = True
+                time.sleep(1.2)
+                break  # 点一个后重新扫（弹窗可能叠加/消失后露下一个）
             except Exception:
                 pass
         if hit_any:
@@ -125,10 +152,21 @@ def ensure_home_tab(d, tab_text, timeout=10):
 HOME_TAB = ""  # 应用级：主功能 tab 文案（如 "玩安卓"）；空串跳过归位
 
 
-def launch(d, want="", reset_data=False):
+def launch(d, want="", reset_data=False, force=False):
     """v3-①②（EXEC-034）：want=启动参数（'k=v;k2=v2' → hdc aa start --ps 透传，启动参数门控应用免人工补丁）；
-    reset_data=True → bm clean -n 清应用数据（用例级状态重置，防跨用例泄漏）。"""
+    reset_data=True → bm clean -n 清应用数据（用例级状态重置，防跨用例泄漏）；
+    force=True → 强制冷启（断言冷启行为的用例用）。
+    热启动（run_direct 组内非首条置 FORGE_WARM_LAUNCH=1）：HOME_ANCHOR 已在位即软复用
+    当前会话跳过 stop/start/bootstrap（省冷启 8-12s/例）；锚不可见自动回退完整冷启。"""
     import os as _os, subprocess as _sp
+    if not want and not reset_data and not force and _os.environ.get("FORGE_WARM_LAUNCH") == "1":
+        anchor = globals().get("HOME_ANCHOR", "")
+        if anchor:
+            try:
+                if d.find_component(BY.key(anchor)) is not None:
+                    return  # 基座已就位：软复用（上一用例恰好停在本页）
+            except Exception:
+                pass
     d.stop_app(PACKAGE)
     time.sleep(0.8)
     if reset_data:
@@ -180,18 +218,22 @@ def launch(d, want="", reset_data=False):
     ok = bootstrap(d, home_tab=HOME_TAB, anchor_key=HOME_ANCHOR)
     if not ok:
         raise AssertionError("L0 bootstrap failed（弹窗/tab 未消化，见日志快照）")
-    time.sleep(2.5)
+    time.sleep(1.5)  # bootstrap 锚已验证就位，1.5s 落座余量（原 2.5s）
     _dismiss_first_run(d)
 
 
 def _dismiss_first_run(d):
-    """首启弹窗一键处置（权限/隐私协议）"""
+    """首启弹窗一键处置（权限/隐私协议）——单 RPC 拉全文案本地匹配"""
+    vis = set(_visible_clickables(d))
     for txt in ["同意并继续", "允许", "我知道了", "暂不", "以后再说", "同意"]:
+        if txt not in vis:
+            continue
         try:
             c = d.find_component(BY.text(txt))
             if c:
                 c.click()
                 time.sleep(0.8)
+                vis = set(_visible_clickables(d))  # 点掉一层后重扫（可能叠弹窗）
         except Exception:
             pass
 
@@ -234,7 +276,7 @@ def click_tab(d, label):
                 return
         except Exception:
             pass
-        _t.sleep(0.5)
+        _t.sleep(0.25)
     idx = TAB_LABELS.index(label) if label in TAB_LABELS else 2
     w, h = d.get_display_size()
     d.touch((int(w * (idx + 0.5) / len(TAB_LABELS)), int(h * 0.945)))
@@ -253,7 +295,7 @@ def click_text(d, txt, wait=6):
             return
     except Exception:
         pass
-    deadline = _t.time() + wait
+    deadline = _t.time() + _w(wait)
     while _t.time() < deadline:
         try:
             c = d.find_component(BY.text(txt, MatchPattern.CONTAINS))
@@ -263,14 +305,14 @@ def click_text(d, txt, wait=6):
                 return
         except Exception:
             pass
-        _t.sleep(0.5)
+        _t.sleep(0.25)
     raise AssertionError("text not clickable: " + txt)
 
 
 def click_type_first(d, ctype, wait=6):
     """点击指定类型的第一个组件（lineN:Type 引用的兜底点击）"""
     import time as _t
-    deadline = _t.time() + wait
+    deadline = _t.time() + _w(wait)
     while _t.time() < deadline:
         try:
             comps = d.find_all_components(BY.type(ctype))
@@ -281,7 +323,7 @@ def click_type_first(d, ctype, wait=6):
                 return
         except Exception:
             pass
-        _t.sleep(0.5)
+        _t.sleep(0.25)
     raise AssertionError("type not clickable: " + ctype)
 
 
@@ -299,7 +341,7 @@ def id_input(d, cid, text, wait=6):
 
 def _find(d, cid, wait=6):
     import time as _t
-    deadline = _t.time() + wait
+    deadline = _t.time() + _w(wait)
     while _t.time() < deadline:
         try:
             c = d.find_component(BY.key(cid))
@@ -313,14 +355,14 @@ def _find(d, cid, wait=6):
                 return c
         except Exception:
             pass
-        _t.sleep(0.5)
+        _t.sleep(0.25)
     raise AssertionError("component not found: " + cid)
 
 
 def smart_click(d, cid, txt=None, wait=6):
     """key 优先点击；失败且有 txt 时文本点击（mine 类 HAR 模块 ID 丢失边界）"""
     import time as _t
-    deadline = _t.time() + wait
+    deadline = _t.time() + _w(wait)
     while _t.time() < deadline:
         try:
             c = d.find_component(BY.key(cid))
@@ -330,7 +372,7 @@ def smart_click(d, cid, txt=None, wait=6):
                 return
         except Exception:
             pass
-        _t.sleep(0.5)
+        _t.sleep(0.25)
     if txt and txt.startswith("line"):
         import re as _re
         m = _re.match(r"line\d+:(\w+)", txt)
@@ -365,7 +407,7 @@ def scroll_text_exist(d, txt, wait=6):
 def smart_check(d, cid, txt=None, wait=6):
     """key 优先断言；失败且有 txt 时降级文本断言（部分 HAR 模块 .id 运行时丢弃的边界）"""
     import time as _t
-    deadline = _t.time() + wait
+    deadline = _t.time() + _w(wait)
     while _t.time() < deadline:
         try:
             c = d.find_component(BY.key(cid))
@@ -373,7 +415,7 @@ def smart_check(d, cid, txt=None, wait=6):
                 return True
         except Exception:
             pass
-        _t.sleep(0.5)
+        _t.sleep(0.25)
     if txt and txt.startswith("line"):
         import re as _re
         m = _re.match(r"line\d+:(\w+)", txt)
@@ -389,7 +431,7 @@ def text_equals(d, txt, wait=6):
     """精确文本断言（EQUALS）——CONTAINS 会被前缀污染（如 ❄️Gallery 含 Gallery），
     恢复/状态标记类断言必须用本原语。存在且精确相等返回 True，否则抛。"""
     import time as _t
-    deadline = _t.time() + wait
+    deadline = _t.time() + _w(wait)
     while _t.time() < deadline:
         try:
             c = d.find_component(BY.text(txt))
@@ -397,7 +439,7 @@ def text_equals(d, txt, wait=6):
                 return True
         except Exception:
             pass
-        _t.sleep(0.5)
+        _t.sleep(0.25)
     raise AssertionError("text (exact) not found: " + txt)
 
 
@@ -418,8 +460,11 @@ def text_absent(d, txt, wait=3):
 
 def step_shot(d, label="step"):
     """分步截图：一个动作/断言一张页面图（run_direct 设 FORGE_SHOT_DIR/FORGE_CASE 时启用）。
-    文件名 <case>_<序号>_<label>.jpeg，供 test-report.html 按步回放页面。"""
+    文件名 <case>_<序号>_<label>.jpeg，供 test-report.html 按步回放页面。
+    FORGE_SHOT_MODE=off 时跳过；fail 模式下 PASS 用例的过程图由 run_direct 统一清理。"""
     import os as _os
+    if _os.environ.get("FORGE_SHOT_MODE") == "off":
+        return
     base = _os.environ.get("FORGE_SHOT_DIR")
     case = _os.environ.get("FORGE_CASE", "case")
     if not base:
@@ -438,7 +483,7 @@ step_shot.n = {}
 def wait_for(d, by, timeout=10, interval=0.5):
     """轮询等待控件出现（首屏锚点等待用）；返回组件或 None，不抛异常"""
     import time as _t
-    end = _t.time() + timeout
+    end = _t.time() + _w(timeout)
     while _t.time() < end:
         try:
             c = d.find_component(by)
@@ -455,7 +500,7 @@ def text_exist(d, txt, wait=6):
     契约：存在返回 True；不存在【抛 AssertionError】——永不返回 False。
     run_direct/analyze_results 依赖异常文本做 FAIL 判定与失败聚类，勿改为静默返回。"""
     import time as _t
-    deadline = _t.time() + wait
+    deadline = _t.time() + _w(wait)
     while _t.time() < deadline:
         try:
             c = d.find_component(BY.text(txt, MatchPattern.CONTAINS))
@@ -463,14 +508,14 @@ def text_exist(d, txt, wait=6):
                 return True
         except Exception:
             pass
-        _t.sleep(0.5)
+        _t.sleep(0.25)
     raise AssertionError("text not found: " + txt)
 
 
 def text_value_equals(d, cid, expected, wait=6):
     """值断言（EXEC-040 实证+反证）：getText() 精确等于期望——锚定 key 控件动态内容。"""
     import time as _t
-    deadline = _t.time() + wait
+    deadline = _t.time() + _w(wait)
     while _t.time() < deadline:
         try:
             c = d.find_component(BY.key(cid))
@@ -478,7 +523,7 @@ def text_value_equals(d, cid, expected, wait=6):
                 return True
         except Exception:
             pass
-        _t.sleep(0.5)
+        _t.sleep(0.25)
     got = None
     try:
         c = d.find_component(BY.key(cid))
@@ -491,7 +536,7 @@ def text_value_equals(d, cid, expected, wait=6):
 def text_value_contains(d, cid, part, wait=6):
     """值包含断言：getText() 包含子串（动态文案前缀不定时用）。"""
     import time as _t
-    deadline = _t.time() + wait
+    deadline = _t.time() + _w(wait)
     while _t.time() < deadline:
         try:
             c = d.find_component(BY.key(cid))
@@ -499,14 +544,14 @@ def text_value_contains(d, cid, part, wait=6):
                 return True
         except Exception:
             pass
-        _t.sleep(0.5)
+        _t.sleep(0.25)
     raise AssertionError(f"text value not containing {part!r} (key={cid})")
 
 
 def count_equals(d, target, expected, wait=6):
     """计数断言（EXEC-040 实证）：key 或 CONTAINS 文本匹配的组件数==期望。"""
     import time as _t, re as _re
-    deadline = _t.time() + wait
+    deadline = _t.time() + _w(wait)
     last = -1
     while _t.time() < deadline:
         try:
@@ -519,14 +564,14 @@ def count_equals(d, target, expected, wait=6):
                 return True
         except Exception:
             pass
-        _t.sleep(0.5)
+        _t.sleep(0.25)
     raise AssertionError(f"count mismatch: expect {expected} got {last} (target={target})")
 
 
 def is_below(d, cid, ref_cid, wait=6):
     """几何断言（EXEC-040 实证）：cid 的 top >= ref_cid 的 bottom（垂直次序）。"""
     import time as _t
-    deadline = _t.time() + wait
+    deadline = _t.time() + _w(wait)
     while _t.time() < deadline:
         try:
             a = d.find_component(BY.key(cid)); b = d.find_component(BY.key(ref_cid))
@@ -534,7 +579,7 @@ def is_below(d, cid, ref_cid, wait=6):
                 return True
         except Exception:
             pass
-        _t.sleep(0.5)
+        _t.sleep(0.25)
     raise AssertionError(f"geometry: {cid} not below {ref_cid}")
 
 
@@ -542,7 +587,7 @@ def toast_exist(d, txt, wait=4, poll=0.5):
     """Toast 断言（v3.1）：轮询 hilog 捕获 Toast 文本。需 FORGE_HDC/FORGE_DEVICE。"""
     import os as _os, subprocess as _sp, time as _tt
     hdc = _os.environ.get("FORGE_HDC", "hdc"); dev = _os.environ.get("FORGE_DEVICE", "127.0.0.1:5555")
-    deadline = _tt.time() + wait
+    deadline = _tt.time() + _w(wait)
     while _tt.time() < deadline:
         try:
             r = _sp.run([hdc, "-t", dev, "shell", "hilog", "-x"],
@@ -599,7 +644,7 @@ def hilog_tail(tag=None, n=400):
 def toast_text_seen(d, txt, timeout=6):
     """Toast 文本断言（dump 版）。无 ID 例外：Toast 为瞬时浮层无稳定 ID，且 hypium find_component
     实测看不到 Toast 子窗口，故以 uitest dumpLayout 原文轮询（首轮实测教训 Round-1）。"""
-    deadline = time.time() + timeout
+    deadline = time.time() + _w(timeout)
     while time.time() < deadline:
         raw = _dump_layout()
         if txt in raw:

package/skills/d2h-hypium-forge/scripts/analyze_results.py

@@ -127,8 +127,17 @@ def main():
         '',
         '- DEVICE：环境问题，重跑即可，不计用例失败',
         '- DESIGN-ERROR：回 cases.json 修正 target（引用 runtime_pages 中真实存在的文本）',
-        '- NAV-CONTEXT-LOSS：先 hdc hilog 查目标入口点击是否有路由事件——无事件即 EXEC-011 门禁，改判 BLOCKED-GATE；有事件则查 Tab 切换/back 链（EXEC-012）',
-        '- ASSERT-FAIL：看截图核状态，属数据/时序断言失败',
+        '- NAV-CONTEXT-LOSS：先 `probe.py hilog JSAPP 800` 查目标入口点击是否有路由事件——无事件即 EXEC-011 门禁，改判 BLOCKED-GATE；有事件则 `probe.py tree --grep <入口文案>` 查 Tab 切换/back 链（EXEC-012）',
+        '- ASSERT-FAIL：看截图核状态，属数据/时序断言失败；定案用 `probe.py db-pull <pkg>` + `probe.py db-sql <db> "<sql>"` 对照业务落库（Grit 实证有效）',
+        '',
+        '## 下一步命令（照抄执行，禁直接 --all）',
+        '',
+        '```bash',
+        '# DEVICE → 环境恢复后: run_direct.py --retry-failed',
+        '# DESIGN-ERROR → probe.py find <id> / ids 核对（ids.json vs 运行时）',
+        '# 修复验证 → run_direct.py --case <失败用例>（调试期可 FORGE_WAIT_SCALE=0.5 加速失败复现）',
+        '# 修产品码后 → run_direct.py --retry-failed（范围回归自动收窄）',
+        '```',
     ]
 
     report = '\n'.join(lines)