dsh-ios-webview-app-control 0.2.1 → 0.2.2

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # 更新记录
 
+## 0.2.2 — 2026-11-03
+
+- 修复设置页环境面板在准备结束后仍挂着“步骤/字节数/进度条”的问题：只有准备进行中（busy）才输出并渲染过程信息，就绪、失败、取消后的公开状态不再保留 step/progress。
+- 修复从插件列表启用后准备面板一直停留、要切换页面才消失的问题：环境达到 ready 时激活引导自动收起；失败、取消、未准备状态仍保留面板供操作。
+
 ## 0.2.1 — 2026-10-31
 
 - README 按 npm 包页面的阅读顺序重组，补上 npm 安装方式和可直接跑的 CLI 示例，并把验证快照与安装要求的表述分开。

package/lib/client.js

@@ -108,6 +108,7 @@ window.__ModuleLoader__.load({
         const [revision, setRevision] = React.useState(0);
         const live = React.useRef(null);
         const confirmedButton = React.useRef(null);
+        const dismissed = React.useRef(false);
         const panelId = React.useId();
         React.useEffect(() => {
           const control = new AbortController();
@@ -135,6 +136,14 @@ window.__ModuleLoader__.load({
           };
         }, [revision]);
         React.useEffect(() => { if (confirmCleanup) confirmedButton.current?.focus(); }, [confirmCleanup]);
+        // Activation guidance exists to get the environment ready, so it closes
+        // itself once preparation settles in a state that needs no action.
+        const settledReady = snapshot !== null && snapshot.phase === 'ready' && snapshot.busy !== true;
+        React.useEffect(() => {
+          if (!props.activation || !settledReady || dismissed.current) return;
+          dismissed.current = true;
+          if (typeof props.onDismiss === 'function') props.onDismiss();
+        }, [props.activation, settledReady, props.onDismiss]);
         async function run(action) {
           const control = live.current;
           if (!control || control.signal.aborted || (working && !(action === 'cancel' && working === 'prepare'))) return;
@@ -158,7 +167,10 @@ window.__ModuleLoader__.load({
           return h('div', { className: 'iosenv-row', key: label }, h('dt', null, label), h('dd', { className: mono ? 'iosenv-mono' : undefined }, value || t('missing')));
         }
         const busy = snapshot?.busy === true;
-        const progress = snapshot?.progress;
+        // Step and byte counts describe an in-flight preparation only; once it
+        // settles they must not read like a stalled download.
+        const progress = busy ? snapshot?.progress : null;
+        const step = busy ? snapshot?.step : null;
         const total = progress?.totalBytes;
         const progressText = progress ? t(total === undefined ? 'bytesUnknown' : 'bytes', { completed: progress.completedBytes, total }) : null;
         const phase = snapshot?.phase;
@@ -175,7 +187,7 @@ window.__ModuleLoader__.load({
           h('p', { className: 'iosenv-muted' }, t('intro')),
           h('div', { className: 'iosenv-state', role: 'status', 'aria-live': 'polite' },
             h('div', { className: 'iosenv-statehead' }, h('span', null, t('phase')), h('strong', { className: 'iosenv-phase' }, snapshot ? t(`phase.${phase}`) : t('loading'))),
-            snapshot?.step ? h('p', { className: 'iosenv-muted' }, `${t('step')}: ${snapshot.step}`) : null,
+            step ? h('p', { className: 'iosenv-muted' }, `${t('step')}: ${step}`) : null,
             progressText ? h('p', null, progressText) : null,
             progress ? h('progress', { className: 'iosenv-progress', 'aria-label': t('progress'), ...(total > 0 ? { max: total, value: Math.min(progress.completedBytes, total) } : {}) }) : null,
             phase === 'ready' ? h('p', { className: 'iosenv-muted' }, t('readyHint')) : null),

package/lib/runtime/environment-manager.mjs

@@ -141,7 +141,15 @@ export class EnvironmentManager {
   }
   status() {
     const state=clone(this.snapshot);
-    state.step=state.step||state.stage||state.phase;
+    // Step and byte counters describe an in-flight preparation only. Once it
+    // settles they read like a stalled download, so a public status drops them.
+    if(BUSY_PHASES.has(state.phase)){
+      state.step=state.step||state.stage||state.phase;
+      state.progress=state.bytes.total>0?{completedBytes:state.bytes.downloaded,totalBytes:state.bytes.total}:null;
+    }else{
+      state.step='';
+      state.progress=null;
+    }
     if(!state.python?.path||!state.python?.version||!['host','private'].includes(state.python?.source))state.python=null;
     if(typeof state.pymobiledevice3!=='string')delete state.pymobiledevice3;
     return state;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-ios-webview-app-control",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Business-free DSH tools for inspectable iOS WebView/hybrid apps only.",
   "type": "module",
   "license": "MIT",