linkshell-cli 0.10.49 → 0.10.51

package/dist/host/src/index.d.ts

@@ -1,5 +1,6 @@
 export { defaultHome, startHost, hostPaths, isHostRunning, type HostOptions, type HostPaths, type RunningHost } from "./host.js";
 export { connectHost, type HostClient } from "./rpc/client.js";
+export { localWebSocket, windowsPipe } from "./local-transport.js";
 export { SessionHub, type Subscriber } from "./hub.js";
 export { HostStore } from "./store.js";
 export { CodexDriver } from "./drivers/codex/driver.js";

package/dist/host/src/index.js

@@ -1,5 +1,6 @@
 export { defaultHome, startHost, hostPaths, isHostRunning } from "./host.js";
 export { connectHost } from "./rpc/client.js";
+export { localWebSocket, windowsPipe } from "./local-transport.js";
 export { SessionHub } from "./hub.js";
 export { HostStore } from "./store.js";
 export { CodexDriver } from "./drivers/codex/driver.js";

package/dist/host/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../host/src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAsD,MAAM,WAAW,CAAC;AACjI,OAAO,EAAE,WAAW,EAAmB,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAmB,MAAM,UAAU,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAGxD,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EAAE,SAAS,EAAqB,MAAM,yBAAyB,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEnE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../host/src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAsD,MAAM,WAAW,CAAC;AACjI,OAAO,EAAE,WAAW,EAAmB,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,UAAU,EAAmB,MAAM,UAAU,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAGxD,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EAAE,SAAS,EAAqB,MAAM,yBAAyB,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEnE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}

package/dist/host/src/local-transport.d.ts

@@ -2,4 +2,6 @@ import WebSocket from "ws";
 export declare const isNamedPipe: (path: string) => boolean;
 /** Stable across callers, separate for each state directory, without the Unix path limit. */
 export declare function windowsPipe(home: string, name: string): string;
-export declare function localWebSocket(target: string, timeout?: number): WebSocket;
+export declare function localWebSocket(target: string, timeout?: number, limits?: {
+    maxPayload?: number;
+}): WebSocket;

package/dist/host/src/local-transport.js

@@ -9,14 +9,19 @@ export function windowsPipe(home, name) {
     const tag = createHash("sha256").update(key).digest("hex").slice(0, 24);
     return `\\\\.\\pipe\\linkshell-${tag}-${name}`;
 }
-export function localWebSocket(target, timeout = 10_000) {
-    const options = { perMessageDeflate: false, handshakeTimeout: timeout };
+export function localWebSocket(target, timeout = 10_000, limits = {}) {
+    const options = { perMessageDeflate: false, handshakeTimeout: timeout, ...limits };
     // URL parsers treat Windows backslashes and drive letters as URL syntax. Connect directly.
-    if (isNamedPipe(target))
-        return new WebSocket("ws://localhost/", {
-            ...options,
-            createConnection: () => connect(target),
-        });
-    return new WebSocket(/^wss?:\/\//.test(target) ? target : `ws+unix://${target}:/`, options);
+    const socket = isNamedPipe(target) ? new WebSocket("ws://localhost/", {
+        ...options,
+        createConnection: () => connect(target),
+    }) : new WebSocket(/^wss?:\/\//.test(target) ? target : `ws+unix://${target}:/`, options);
+    // Node's HTTP request timeout does not reliably fire on Windows pipe handshakes.
+    const deadline = setTimeout(() => socket.terminate(), timeout);
+    deadline.unref();
+    socket.once("open", () => clearTimeout(deadline));
+    socket.once("close", () => clearTimeout(deadline));
+    socket.once("error", () => clearTimeout(deadline));
+    return socket;
 }
 //# sourceMappingURL=local-transport.js.map

package/dist/host/src/local-transport.js.map

@@ -1 +1 @@
-{"version":3,"file":"local-transport.js","sourceRoot":"","sources":["../../../../host/src/local-transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAClC,OAAO,SAAS,MAAM,IAAI,CAAC;AAE3B,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,IAAY,EAAW,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;AAEvF,6FAA6F;AAC7F,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,IAAY;IACpD,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IACrE,MAAM,GAAG,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACxE,OAAO,0BAA0B,GAAG,IAAI,IAAI,EAAE,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAc,EAAE,OAAO,GAAG,MAAM;IAC7D,MAAM,OAAO,GAAG,EAAE,iBAAiB,EAAE,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC;IACxE,2FAA2F;IAC3F,IAAI,WAAW,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,SAAS,CAAC,iBAAiB,EAAE;YAC/D,GAAG,OAAO;YACV,gBAAgB,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;SACxC,CAAC,CAAC;IACH,OAAO,IAAI,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,MAAM,IAAI,EAAE,OAAO,CAAC,CAAC;AAC9F,CAAC"}
+{"version":3,"file":"local-transport.js","sourceRoot":"","sources":["../../../../host/src/local-transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAClC,OAAO,SAAS,MAAM,IAAI,CAAC;AAE3B,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,IAAY,EAAW,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;AAEvF,6FAA6F;AAC7F,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,IAAY;IACpD,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IACrE,MAAM,GAAG,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACxE,OAAO,0BAA0B,GAAG,IAAI,IAAI,EAAE,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAc,EAAE,OAAO,GAAG,MAAM,EAAE,SAAkC,EAAE;IACnG,MAAM,OAAO,GAAG,EAAE,iBAAiB,EAAE,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,GAAG,MAAM,EAAE,CAAC;IACnF,2FAA2F;IAC3F,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC,iBAAiB,EAAE;QACpE,GAAG,OAAO;QACV,gBAAgB,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;KACxC,CAAC,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,MAAM,IAAI,EAAE,OAAO,CAAC,CAAC;IAC1F,iFAAiF;IACjF,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,OAAO,CAAC,CAAC;IAC/D,QAAQ,CAAC,KAAK,EAAE,CAAC;IACjB,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC;IAClD,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC;IACnD,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC;IACnD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/host/src/screen-loading.d.ts

@@ -0,0 +1,3 @@
+export declare const SCREEN_LOADING_STYLE: string;
+export declare const SCREEN_LOADING_HTML: string;
+export declare const SCREEN_LOADING_SCRIPT: string;

package/dist/host/src/screen-loading.js

@@ -0,0 +1,93 @@
+// Shared by the browser viewer and the phone's WebView, including native video reception.
+export const SCREEN_LOADING_STYLE = String.raw `
+  #note { position: absolute; inset: 0; display: flex; align-items: center; justify-content: center;
+    padding: max(28px, env(safe-area-inset-top)) 24px max(88px, env(safe-area-inset-bottom));
+    color: #f4f4f7; text-align: center; pointer-events: none; background: rgba(8,9,14,.94); }
+  .screen-loading-card { width: min(100%, 340px); }
+  .screen-loading-art { position: relative; width: 104px; height: 84px; margin: 0 auto 28px; color: #a5a9ef; }
+  .screen-loading-art::before { content: ''; position: absolute; inset: -32px; border-radius: 50%;
+    background: radial-gradient(ellipse, rgba(129,140,248,.16), transparent 68%); animation: screen-breathe 2.8s ease-in-out infinite; }
+  .screen-loading-monitor { position: absolute; inset: 6px 4px 17px; border: 1px solid rgba(165,169,239,.5); border-radius: 10px;
+    background: rgba(129,140,248,.05); overflow: hidden; }
+  .screen-loading-monitor::before { content: ''; position: absolute; top: 12px; left: 12px; width: 23px; height: 4px;
+    border-radius: 2px; background: rgba(165,169,239,.4); box-shadow: 0 11px 0 rgba(165,169,239,.12), 0 22px 0 rgba(165,169,239,.12); }
+  .screen-loading-monitor::after { content: ''; position: absolute; top: 0; bottom: 0; left: -45%; width: 45%;
+    background: linear-gradient(90deg, transparent, rgba(165,169,239,.16), transparent); animation: screen-scan 2.4s ease-in-out infinite; }
+  .screen-loading-stand { position: absolute; bottom: 8px; left: 50%; width: 26px; height: 10px; transform: translateX(-50%);
+    border-bottom: 1px solid rgba(165,169,239,.5); }
+  .screen-loading-stand::before { content: ''; position: absolute; left: 50%; height: 9px; border-left: 1px solid rgba(165,169,239,.5); }
+  #screen-loading-title { margin: 0; font-size: calc(18px * var(--text-scale, 1)); font-weight: 600; letter-spacing: -.3px; }
+  #screen-loading-detail { margin: 10px 0 0; color: rgba(255,255,255,.52); font-size: calc(13px * var(--text-scale, 1)); line-height: 1.7; overflow-wrap: anywhere; }
+  .screen-loading-steps { display: flex; align-items: center; justify-content: center; gap: 10px; margin-top: 24px;
+    color: rgba(255,255,255,.3); font-size: calc(11px * var(--text-scale, 1)); }
+  .screen-loading-steps i { width: 24px; height: 1px; background: rgba(255,255,255,.12); }
+  .screen-loading-steps .current { color: #bbbffb; }
+  .screen-loading-steps .complete { color: rgba(255,255,255,.68); }
+  #note[data-state="error"] .screen-loading-steps { display: none; }
+  #screen-loading-retry { pointer-events: auto; margin-top: 22px; min-height: 44px; padding: 0 20px; border-radius: 10px;
+    border: 1px solid rgba(255,255,255,.18); background: rgba(255,255,255,.07); color: #eeeef4; font: inherit; font-size: 13px; cursor: pointer; }
+  #screen-loading-retry:hover { background: rgba(255,255,255,.13); }
+  #screen-loading-retry:focus-visible { outline: 2px solid #a5a9ef; outline-offset: 4px; }
+  #note[data-state="error"] .screen-loading-art::before, #note[data-state="error"] .screen-loading-monitor::after,
+  #note[data-state="blocked"] .screen-loading-art::before, #note[data-state="blocked"] .screen-loading-monitor::after,
+  #note[data-state="paused"] .screen-loading-art::before, #note[data-state="paused"] .screen-loading-monitor::after { animation: none; opacity: .3; }
+  @keyframes screen-scan { to { transform: translateX(340%); } }
+  @keyframes screen-breathe { 50% { opacity: .4; transform: scale(.92); } }
+  @media (prefers-reduced-motion: reduce) { .screen-loading-art::before, .screen-loading-monitor::after { animation: none; } }
+  @media (max-height: 420px) { #note { padding: 16px 72px; } .screen-loading-art { height: 64px; margin-bottom: 12px; }
+    .screen-loading-steps { margin-top: 14px; } #screen-loading-retry { margin-top: 12px; } }
+`;
+export const SCREEN_LOADING_HTML = String.raw `
+<div id="note" data-state="connecting">
+  <div class="screen-loading-card">
+    <div class="screen-loading-art" aria-hidden="true"><div class="screen-loading-monitor"></div><div class="screen-loading-stand"></div></div>
+    <div role="status" aria-live="polite" aria-atomic="true">
+      <h2 id="screen-loading-title">正在连接电脑</h2>
+      <p id="screen-loading-detail">正在建立屏幕连接，画面会自动显示。</p>
+    </div>
+    <div class="screen-loading-steps" aria-hidden="true"><span id="screen-step-connect" class="current">连接电脑</span><i></i><span id="screen-step-picture">接收画面</span><i></i><span>显示桌面</span></div>
+    <button id="screen-loading-retry" class="gone" type="button">重新连接</button>
+  </div>
+</div>`;
+export const SCREEN_LOADING_SCRIPT = String.raw `
+function createScreenLoading(root, retry, report) {
+  const title = root.querySelector('#screen-loading-title');
+  const detail = root.querySelector('#screen-loading-detail');
+  const button = root.querySelector('#screen-loading-retry');
+  const connectStep = root.querySelector('#screen-step-connect');
+  const pictureStep = root.querySelector('#screen-step-picture');
+  let phase = '', timer = 0, slow = false, disposed = false;
+  const pending = () => phase === 'connecting' || phase === 'receiving' || phase === 'recovering' || phase === 'adjusting';
+  const description = () => slow ? '这次连接耗时较长。可以继续等待，或重新连接。' :
+    phase === 'receiving' ? '电脑已响应，画面准备好后会自动显示。' :
+    phase === 'adjusting' ? '正在应用屏幕设置，请稍候。' :
+    phase === 'recovering' ? '正在尝试恢复画面，请稍候。' : '正在建立屏幕连接，画面会自动显示。';
+  function set(next, message) {
+    if (disposed || (phase === next && !message)) return;
+    const wasPending = pending();
+    phase = next;
+    root.dataset.state = phase;
+    root.classList.toggle('gone', phase === 'ready');
+    if (!pending()) { clearTimeout(timer); timer = 0; slow = false; }
+    else if (!wasPending) {
+      timer = setTimeout(() => {
+        if (!pending() || disposed) return;
+        slow = true;
+        detail.textContent = description();
+        button.classList.remove('gone');
+      }, 12000);
+    }
+    title.textContent = phase === 'connecting' ? '正在连接电脑' : phase === 'receiving' ? '正在接收画面' :
+      phase === 'recovering' ? '正在恢复画面' : phase === 'adjusting' ? '正在调整屏幕' : phase === 'paused' ? '屏幕已暂停' : phase === 'blocked' ? '画面已就绪，轻点开始' : phase === 'error' ? '暂时无法显示屏幕' : '画面已连接';
+    detail.textContent = message || (pending() ? description() : phase === 'paused' ? '返回屏幕后会自动继续。' : '');
+    button.classList.toggle('gone', phase !== 'error' && !slow);
+    connectStep.className = phase === 'connecting' ? 'current' : 'complete';
+    pictureStep.className = phase === 'receiving' || phase === 'recovering' ? 'current' : '';
+    report(phase);
+  }
+  button.addEventListener('click', (event) => { event.stopPropagation(); retry(); });
+  set('connecting');
+  return { set, get phase() { return phase; }, dispose() { disposed = true; clearTimeout(timer); } };
+}
+`;
+//# sourceMappingURL=screen-loading.js.map

package/dist/host/src/screen-loading.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screen-loading.js","sourceRoot":"","sources":["../../../../host/src/screen-loading.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqC7C,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;OAWtC,CAAC;AAER,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwC9C,CAAC"}

package/dist/host/src/screen-viewer.js

@@ -17,6 +17,7 @@
 // device can reach each other, it is a video track from the app, with the hands and the pointer on
 // data channels beside it; the page draws the pointer, which that picture does not have in it.
 // Otherwise it is H.264 down the page's socket, decoded here onto a canvas, as it always was.
+import { SCREEN_LOADING_HTML, SCREEN_LOADING_SCRIPT, SCREEN_LOADING_STYLE } from "./screen-loading.js";
 const icon = (body) => `<svg viewBox="0 0 24 24" width="22" height="22" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round">${body}</svg>`;
 const ICONS = {
     view: icon('<path d="M2.5 12s3.5-6.5 9.5-6.5 9.5 6.5 9.5 6.5-3.5 6.5-9.5 6.5S2.5 12 2.5 12Z"/><circle cx="12" cy="12" r="2.8"/>'),
@@ -52,8 +53,6 @@ const STYLE = String.raw `
   #pointer.pressed { background: rgba(255,255,255,0.4); }
   #pointer.own { border: 0; border-radius: 0; box-shadow: none; background: transparent center / 100% 100% no-repeat; }
   #stage.own { cursor: none; }
-  #note { position: absolute; inset: 0; display: flex; align-items: center; justify-content: center; padding: 32px;
-    color: rgba(255,255,255,0.72); text-align: center; pointer-events: none; }
   .glass { background: rgba(38,38,42,0.74); -webkit-backdrop-filter: blur(22px) saturate(1.6); backdrop-filter: blur(22px) saturate(1.6);
     border: 0.5px solid rgba(255,255,255,0.16); box-shadow: 0 8px 28px rgba(0,0,0,0.38); }
   #control-shell { position: absolute; pointer-events: none; z-index: 1; will-change: width, height, transform, border-radius, opacity; }
@@ -597,8 +596,22 @@ const mods = new Set();
 
 // ---- The picture ----------------------------------------------------------
 
-let sessionError = "";
-const say = (text) => { text = sessionError || text; note.textContent = text; note.classList.toggle("gone", !text); };
+let sessionError = "", sessionPhase = "", hasPicture = false;
+const loading = createScreenLoading(note, () => {
+  if (app && chrome.canRetryScreen) tellApp({ type: "screenRetry" });
+  else if (typeof window.__linkshellReload === "function") window.__linkshellReload({});
+  else location.reload();
+}, (phase) => window.__linkshellScreenState?.(phase));
+addEventListener("pagehide", () => loading.dispose(), { once: true });
+const say = (text) => {
+  if (!text) hasPicture = true;
+  if (sessionError) loading.set("error", sessionError);
+  else if (text) loading.set("error", text);
+  else if (sessionPhase) loading.set(sessionPhase);
+  else loading.set("ready");
+};
+// Transport updates must not hide a configuration failure or a paused retained session.
+const showProgress = (phase) => { if (!sessionError && !sessionPhase) loading.set(phase); };
 const round = (value, digits) => (value == null || !isFinite(value) ? null : +value.toFixed(digits === undefined ? 1 : digits));
 const hex = (n) => n.toString(16).padStart(2, "0");
 function sps(unit) {
@@ -694,11 +707,13 @@ const session = createScreenSession({ active: true, display: Number(query.get("d
   changed: (state) => {
     width = state.width;
     const previousError = sessionError;
+    const previousPhase = sessionPhase;
     sessionError = state.error;
+    sessionPhase = state.paused ? "paused" : !state.inputReady ? "adjusting" : "";
     if (sessionError) say(sessionError);
-    else if (state.paused) say("屏幕已暂停");
-    else if (!state.inputReady) say("正在调整屏幕…");
-    else if (previousError || note.textContent === "屏幕已暂停" || note.textContent === "正在调整屏幕…") say("");
+    else if (sessionPhase) loading.set(sessionPhase);
+    // Configuration acknowledgement enables input; only received media proves the first picture exists.
+    else if (previousError || previousPhase) loading.set(hasPicture ? "ready" : "receiving");
     if (state.inputReady && mode !== "view") askControl();
     refreshWidths();
     refresh();
@@ -725,7 +740,7 @@ function waitForCapabilities() {
     if (!session.known()) session.receive({ t: "capabilities", version: 1, configure: false, pause: false, retainMs: 0 });
   }, 10000);
 }
-ws.onopen = () => { session.open(); waitForCapabilities(); if (mode !== "view") askControl(); };
+ws.onopen = () => { if (loading.phase === "connecting") showProgress("receiving"); session.open(); waitForCapabilities(); if (mode !== "view") askControl(); };
 // Out of sight, a page answers late (its timers slow to one a second) and shows nothing: the host sends no
 // picture down the socket meanwhile, and starts again at a keyframe.
 document.addEventListener("visibilitychange", () => session.visibility(document.hidden));
@@ -803,7 +818,7 @@ ws.onclose = () => {
   drop();
   if (requestRelay()) return;
   tellApp({ type: "screenClosed" });
-  if (blocked || note.classList.contains("gone") || note.textContent.startsWith("正在")) say("屏幕连接已断开");
+  if (loading.phase !== "error") say("屏幕连接已断开，请确认电脑在线后重新连接。");
   blocked = false;
 };
 
@@ -936,15 +951,17 @@ function watch(mine) {
   const state = mine.pc.connectionState || mine.pc.iceConnectionState;
   if (state === "failed" || mine.pc.iceConnectionState === "failed") return giveUp(mine.up ? "the connection failed" : "no path between the two (ICE failed)");
   if (state === "disconnected") {
+    showProgress("recovering");
     // A path that drops for a moment comes back by itself; one gone for longer is given up.
     if (mine.up && !mine.away) mine.away = setTimeout(() => away(mine, performance.now()), 4000);
   } else if (state === "connected" || state === "completed") {
+    if (loading.phase !== "ready") showProgress("receiving");
     clearTimeout(mine.away);
     mine.away = 0;
     if (mine.up) return;
     mine.up = true;
     clearTimeout(patience);
-    if (!live) patience = setTimeout(frameless, 4000);
+    if (loading.phase !== "ready") patience = setTimeout(frameless, 4000);
   }
 }
 
@@ -973,6 +990,7 @@ function frameless() {
 function giveUp(reason) {
   if (gaveUp) return;
   gaveUp = true;
+  showProgress("recovering");
   const pc = rtc && rtc.pc;
   const told = (detail) => {
     drop();
@@ -989,7 +1007,7 @@ function requestRelay() {
   if (!relayRequested) {
     relayRequested = true;
     tellApp({ type: "screenFallback" });
-    say("正在连接电脑屏幕…");
+    showProgress("recovering");
   }
   return true;
 }
@@ -1010,7 +1028,7 @@ function fallBack() {
   gaveUp = true;
   drop();
   if (requestRelay()) return;
-  if (blocked) say("正在连接电脑屏幕…");
+  showProgress("recovering");
   blocked = false;
   if (!windowsHost && !("VideoDecoder" in window)) return unseeable();
   if (tried) hint(live ? "直连断开了：已改用兼容方式传画面，延迟会高一些" : "没能和电脑直连：已改用兼容方式传画面，延迟会高一些", 5000);
@@ -1024,12 +1042,12 @@ function play() {
   started.then(() => {
     if (!blocked) return;
     blocked = false;
-    say(live ? "" : "正在连接电脑屏幕…");
+    showProgress("receiving");
   }, (error) => {
     // A new stream replacing the one being started rejects the first call too; that is not a refusal.
     if (error.name === "AbortError" || !rtc) return;
     blocked = true;
-    say("轻点屏幕，开始显示画面");
+    if (!sessionError && !sessionPhase) loading.set("blocked", "浏览器需要你的确认，轻点屏幕即可开始观看。");
   });
 }
 // What a browser takes as someone's say-so to start a video.
@@ -1041,19 +1059,34 @@ function sized() {
   // While this page presents the frames itself, the size that counts is the frame's own: the
   // <video> is kept running as the fallback but is not what is on screen.
   if (presenter) {
-    clearTimeout(patience);
+    if (presenter.shown) clearTimeout(patience);
     if (!live) show(true);
     return;
   }
   content.w = video.videoWidth;
   content.h = video.videoHeight;
-  if (!blocked) say("");
   if (live) return layout();
-  clearTimeout(patience);
   show(true);
 }
 video.addEventListener("resize", sized);
 video.addEventListener("loadedmetadata", sized);
+// Metadata and a connected socket do not mean a frame is visible yet.
+function videoShown() {
+  if (!rtc || blocked || video.readyState < 2 || presenter) return;
+  clearTimeout(patience);
+  sized();
+  say("");
+}
+if ("requestVideoFrameCallback" in video) {
+  const nextFrame = () => {
+    if (loading.phase !== "ready") videoShown();
+    video.requestVideoFrameCallback(nextFrame);
+  };
+  video.requestVideoFrameCallback(nextFrame);
+} else {
+  video.addEventListener("playing", videoShown);
+  video.addEventListener("timeupdate", videoShown);
+}
 
 // ---- Presenting the track's frames this page's own way --------------------
 
@@ -1129,6 +1162,7 @@ async function presentTrack(track) {
       draws.end();
       device.queue.submit([pass.finish()]);
       mine.shown += 1;
+      say("");
       if (mine.w !== frame.displayWidth || mine.h !== frame.displayHeight) {
         mine.w = frame.displayWidth;
         mine.h = frame.displayHeight;
@@ -1138,7 +1172,6 @@ async function presentTrack(track) {
         // the <video> beside it was allowed to start playing.
         clearTimeout(patience);
         blocked = false;
-        say("");
         if (!live) show(true);
         else layout();
       }
@@ -3108,7 +3141,7 @@ if (nativePicture) {
       session.reconnect();
       waitForCapabilities();
       Object.assign(control, { asked: false, known: false, trusted: false });
-      say("正在连接电脑屏幕…");
+      showProgress("connecting");
       if (mode !== "view") askControl();
     },
   };
@@ -3126,16 +3159,16 @@ if (nativePicture) {
 }
 tellApp({ type: "ready", mode });
 `;
-const SCRIPT = `(() => {${VIEWER_LOGIC}${BODY}})();`;
+const SCRIPT = `(() => {${VIEWER_LOGIC}${SCREEN_LOADING_SCRIPT}${BODY}})();`;
 export function viewerPage(platform = "darwin") {
     return `<!doctype html>
 <html><head><meta charset="utf-8">
 <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1, user-scalable=no, viewport-fit=cover">
 <title>屏幕</title>
-<style>${STYLE}</style></head>
+<style>${STYLE}${SCREEN_LOADING_STYLE}</style></head>
 <body data-platform="${platform === "win32" ? "win32" : "darwin"}">
 <div id="stage"><div id="picture"><canvas id="screen"></canvas><canvas id="gpu" class="gone"></canvas><video id="video" class="gone" autoplay playsinline muted></video><div id="pointer"></div></div></div>
-<div id="note">正在连接电脑屏幕…</div>
+${SCREEN_LOADING_HTML}
 <div id="toast" class="glass"></div>
 <div id="menu" class="glass gone">
   <div class="choice" role="button" aria-label="只看，不操作电脑" data-mode="view"><i></i><div><b>只看</b><span>不操作电脑</span></div></div>

package/dist/host/src/screen-viewer.js.map

@@ -1 +1 @@
-{"version":3,"file":"screen-viewer.js","sourceRoot":"","sources":["../../../../host/src/screen-viewer.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,2EAA2E;AAC3E,6EAA6E;AAC7E,mEAAmE;AACnE,EAAE;AACF,4DAA4D;AAC5D,yEAAyE;AACzE,2CAA2C;AAC3C,6EAA6E;AAC7E,+EAA+E;AAC/E,2CAA2C;AAC3C,qGAAqG;AACrG,+EAA+E;AAC/E,6FAA6F;AAC7F,EAAE;AACF,oGAAoG;AACpG,mGAAmG;AACnG,+FAA+F;AAC/F,8FAA8F;AAE9F,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,EAAE,CAC5B,uJAAuJ,IAAI,QAAQ,CAAC;AAEtK,MAAM,KAAK,GAAG;IACZ,IAAI,EAAE,IAAI,CAAC,qHAAqH,CAAC;IACjI,QAAQ,EAAE,IAAI,CAAC,6DAA6D,CAAC;IAC7E,KAAK,EAAE,IAAI,CAAC,oGAAoG,CAAC;IACjH,QAAQ,EAAE,IAAI,CAAC,iJAAiJ,CAAC;IACjK,GAAG,EAAE,IAAI,CAAC,0EAA0E,CAAC;IACrF,MAAM,EAAE,IAAI,CAAC,oDAAoD,CAAC;IAClE,MAAM,EAAE,IAAI,CAAC,oDAAoD,CAAC;IAClE,IAAI,EAAE,IAAI,CAAC,4BAA4B,CAAC;IACxC,KAAK,EAAE,IAAI,CAAC,qDAAqD,CAAC;IAClE,OAAO,EAAE,IAAI,CAAC,sEAAsE,CAAC;IACrF,IAAI,EAAE,IAAI,CAAC,iEAAiE,CAAC;IAC7E,KAAK,EAAE,IAAI,CAAC,4CAA4C,CAAC;CAC1D,CAAC;AAEF,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoHvB,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0YrC,CAAC;AAEF,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAihFtB,CAAC;AAEF,MAAM,MAAM,GAAG,WAAW,YAAY,GAAG,IAAI,OAAO,CAAC;AAErD,MAAM,UAAU,UAAU,CAAC,WAA4B,QAAQ;IAC7D,OAAO;;;;SAIA,KAAK;uBACS,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ;;;;;;;;;;iHAUiD,KAAK,CAAC,KAAK;;;;;;;;;;;;;;;kEAe1D,KAAK,CAAC,QAAQ;iEACf,KAAK,CAAC,KAAK;+DACb,KAAK,CAAC,GAAG;gEACR,KAAK,CAAC,IAAI;;;;;;;;;;;;;;;4CAe9B,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,aAAa,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ;;4CAEtF,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,aAAa,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;;;;;;;;;;;;;;;;;;;;;;;oCAuBnG,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG;oCAClC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG;;;;;;;;;;6CAUzB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;UACxD,MAAM;eACD,CAAC;AAChB,CAAC"}
+{"version":3,"file":"screen-viewer.js","sourceRoot":"","sources":["../../../../host/src/screen-viewer.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,2EAA2E;AAC3E,6EAA6E;AAC7E,mEAAmE;AACnE,EAAE;AACF,4DAA4D;AAC5D,yEAAyE;AACzE,2CAA2C;AAC3C,6EAA6E;AAC7E,+EAA+E;AAC/E,2CAA2C;AAC3C,qGAAqG;AACrG,+EAA+E;AAC/E,6FAA6F;AAC7F,EAAE;AACF,oGAAoG;AACpG,mGAAmG;AACnG,+FAA+F;AAC/F,8FAA8F;AAE9F,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAEvG,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,EAAE,CAC5B,uJAAuJ,IAAI,QAAQ,CAAC;AAEtK,MAAM,KAAK,GAAG;IACZ,IAAI,EAAE,IAAI,CAAC,qHAAqH,CAAC;IACjI,QAAQ,EAAE,IAAI,CAAC,6DAA6D,CAAC;IAC7E,KAAK,EAAE,IAAI,CAAC,oGAAoG,CAAC;IACjH,QAAQ,EAAE,IAAI,CAAC,iJAAiJ,CAAC;IACjK,GAAG,EAAE,IAAI,CAAC,0EAA0E,CAAC;IACrF,MAAM,EAAE,IAAI,CAAC,oDAAoD,CAAC;IAClE,MAAM,EAAE,IAAI,CAAC,oDAAoD,CAAC;IAClE,IAAI,EAAE,IAAI,CAAC,4BAA4B,CAAC;IACxC,KAAK,EAAE,IAAI,CAAC,qDAAqD,CAAC;IAClE,OAAO,EAAE,IAAI,CAAC,sEAAsE,CAAC;IACrF,IAAI,EAAE,IAAI,CAAC,iEAAiE,CAAC;IAC7E,KAAK,EAAE,IAAI,CAAC,4CAA4C,CAAC;CAC1D,CAAC;AAEF,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkHvB,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0YrC,CAAC;AAEF,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmjFtB,CAAC;AAEF,MAAM,MAAM,GAAG,WAAW,YAAY,GAAG,qBAAqB,GAAG,IAAI,OAAO,CAAC;AAE7E,MAAM,UAAU,UAAU,CAAC,WAA4B,QAAQ;IAC7D,OAAO;;;;SAIA,KAAK,GAAG,oBAAoB;uBACd,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ;;EAE9D,mBAAmB;;;;;;;;iHAQ4F,KAAK,CAAC,KAAK;;;;;;;;;;;;;;;kEAe1D,KAAK,CAAC,QAAQ;iEACf,KAAK,CAAC,KAAK;+DACb,KAAK,CAAC,GAAG;gEACR,KAAK,CAAC,IAAI;;;;;;;;;;;;;;;4CAe9B,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,aAAa,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ;;4CAEtF,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,aAAa,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;;;;;;;;;;;;;;;;;;;;;;;oCAuBnG,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG;oCAClC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG;;;;;;;;;;6CAUzB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;UACxD,MAAM;eACD,CAAC;AAChB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "linkshell-cli",
-  "version": "0.10.49",
+  "version": "0.10.51",
   "description": "Follow, steer and approve the coding agents on your computer (Claude Code, Codex, Gemini, Copilot and more) from your phone",
   "type": "module",
   "main": "dist/cli/src/index.js",
@@ -34,9 +34,9 @@
     "node-pty": "^1.1.0",
     "qrcode-terminal": "^0.12.0",
     "ws": "^8.21.0",
-    "@linkshell/gateway": "0.6.26",
-    "@linkshell/host": "0.4.47",
-    "@linkshell/wire": "0.2.17"
+    "@linkshell/gateway": "0.6.28",
+    "@linkshell/wire": "0.2.17",
+    "@linkshell/host": "0.4.49"
   },
   "devDependencies": {
     "@types/ws": "^8.5.14",

package/src/commands/desktop-workspace.ts

@@ -6,6 +6,7 @@ import { homedir } from "node:os";
 import type { Readable } from "node:stream";
 import type { Socket } from "node:net";
 import WebSocket, { WebSocketServer } from "ws";
+import { localWebSocket } from "@linkshell/host/local-transport";
 import { isMethodName, machineInfoSchema, rpcMessageSchema, type MachineEntry } from "@linkshell/wire";
 import { getValidToken, loadAuth } from "../auth.js";
 import { runLogin } from "./login.js";
@@ -85,7 +86,7 @@ async function loadAssets(directory: string): Promise<Map<string, Buffer>> {
 async function localComputer(target: string, upstreams: Set<WebSocket>): Promise<LocalComputer | undefined> {
   // Query the existing socket directly: discovering this computer never starts a host.
   return new Promise((resolve) => {
-    const client = new WebSocket(`ws+unix://${target}:/`, { perMessageDeflate: false, handshakeTimeout: 1_500, maxPayload: MAX_PROXY_BYTES });
+    const client = localWebSocket(target, 1_500, { maxPayload: MAX_PROXY_BYTES });
     upstreams.add(client);
     const finish = (computer?: LocalComputer) => {
       clearTimeout(timeout);
@@ -107,7 +108,7 @@ async function localComputer(target: string, upstreams: Set<WebSocket>): Promise
           key: "desktop:local", gateway: "desktop:local",
           machine: {
             id: info.machineId, name: info.hostname.replace(/\.local$/, ""), platform: info.platform,
-            // Local transport uses a protected Unix socket, not a relay identity or tunnel.
+            // Local transport uses the host's Unix socket or Windows named pipe.
             signKey: "", boxKey: "", online: true, via: "paired",
           },
         });
@@ -127,9 +128,7 @@ async function account(signal: AbortSignal) {
 }
 
 function proxyHost(client: WebSocket, target: string, upstreams: Set<WebSocket>): void {
-  const host = new WebSocket(`ws+unix://${target}:/`, {
-    perMessageDeflate: false, handshakeTimeout: 3_000, maxPayload: MAX_PROXY_BYTES,
-  });
+  const host = localWebSocket(target, 3_000, { maxPayload: MAX_PROXY_BYTES });
   upstreams.add(host);
   let pending: string[] = [];
   let pendingBytes = 0;
@@ -271,7 +270,7 @@ export async function startDesktopWorkspace(options: { assets: string; home?: st
     }
     if (!["GET", "HEAD"].includes(request.method ?? "")) throw new HttpError(405, "不支持此请求方法");
     const assetPath = path === "/" ? "/index.html" : path;
-    const content = path === "/config.js" ? Buffer.from(`window.__LINKSHELL_CONFIG__ = ${JSON.stringify({ desktop: true, deployment: "official", previewOrigin })};\n`) : assets.get(assetPath);
+    const content = path === "/config.js" ? Buffer.from(`window.__LINKSHELL_CONFIG__ = ${JSON.stringify({ desktop: true, desktopPlatform: process.platform, deployment: "official", previewOrigin })};\n`) : assets.get(assetPath);
     if (!content) throw new HttpError(404, "未找到资源");
     response.writeHead(200, {
       "content-type": MIME[extname(assetPath)] ?? "application/octet-stream", "content-length": content.byteLength,