@linxin666/dsh-remote-web-ui 0.1.11 → 0.1.13

package/lib/types/mobile/views/App.d.ts

@@ -25,6 +25,8 @@ export interface RenderMessage {
     failed?: boolean;
     toolSummary?: string;
 }
+/** Read the optional workspace target carried from the pairing QR flow. */
+export declare function mobileWorkspaceTarget(search: string): string | undefined;
 /** Map a list row to the surface model; the title comes from projections when present. */
 export declare function toSessionView(item: {
     sessionId: string;
@@ -54,6 +56,6 @@ export declare function errorText(error: unknown): string;
  */
 export declare function staleHostHint(message: string): string | undefined;
 /** Fetch one history page (tail by default) — thin wrapper so views share the call shape. */
-export declare function loadHistory(sessionId: string, beforeSeq?: number): Promise<import("../api.ts").HistoryPage>;
+export declare function loadHistory(sessionId: string, beforeSeq?: number, signal?: AbortSignal): Promise<import("../api.ts").HistoryPage>;
 export { listSessions, listWorkspaces, prompt };
 //# sourceMappingURL=App.d.ts.map

package/lib/types/mobile/views/App.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"App.d.ts","sourceRoot":"","sources":["../../../../src/mobile/views/App.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAA2B,YAAY,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AAazF,yDAAyD;AACzD,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,OAAO,CAAA;CACf;AAED,wDAAwD;AACxD,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,GAAG,WAAW,CAAA;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,0FAA0F;AAC1F,wBAAgB,aAAa,CAAC,IAAI,EAAE;IAClC,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,OAAO,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAA;CACnD,GAAG,WAAW,CAad;AAED,+CAA+C;AAC/C,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CASlD;AAED;;;GAGG;AACH,wBAAgB,GAAG,gCA+ClB;AAED,qEAAqE;AACrE,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAKhD;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAIjE;AAED,6FAA6F;AAC7F,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,4CAEhE;AAED,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,EAAE,CAAA"}
+{"version":3,"file":"App.d.ts","sourceRoot":"","sources":["../../../../src/mobile/views/App.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAA2B,YAAY,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AAazF,yDAAyD;AACzD,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,OAAO,CAAA;CACf;AAED,wDAAwD;AACxD,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,GAAG,WAAW,CAAA;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,2EAA2E;AAC3E,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGxE;AAED,0FAA0F;AAC1F,wBAAgB,aAAa,CAAC,IAAI,EAAE;IAClC,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,OAAO,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAA;CACnD,GAAG,WAAW,CAad;AAED,+CAA+C;AAC/C,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CASlD;AAED;;;GAGG;AACH,wBAAgB,GAAG,gCA4DlB;AAED,qEAAqE;AACrE,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAKhD;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAIjE;AAED,6FAA6F;AAC7F,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,4CAEtF;AAED,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,EAAE,CAAA"}

package/lib/types/mobile/views/App.js

@@ -12,6 +12,11 @@ import { RpcCallError, RpcTransportError } from "../rpc.js";
 import { ChatView } from "./ChatView.js";
 import { SessionListView } from "./SessionListView.js";
 import { WorkspaceView as WorkspaceRoster } from "./WorkspaceView.js";
+/** Read the optional workspace target carried from the pairing QR flow. */
+export function mobileWorkspaceTarget(search) {
+    const value = new URLSearchParams(search).get('workspace');
+    return value === null || value === '' ? undefined : value;
+}
 /** Map a list row to the surface model; the title comes from projections when present. */
 export function toSessionView(item) {
     const titleValue = item.projections?.values?.title;
@@ -46,6 +51,7 @@ export function formatTime(epochMs) {
  */
 export function App() {
     const [route, setRoute] = useState({ kind: 'workspaces' });
+    const [initialWorkspaceId, setInitialWorkspaceId] = useState(() => mobileWorkspaceTarget(window.location.search));
     const muxRef = useRef(undefined);
     // The mux stream lives for the page lifetime: session events keep the
     // open chat live, and reconnect is automatic.
@@ -73,8 +79,17 @@ export function App() {
     const openChat = useCallback((session, workspace) => {
         setRoute({ kind: 'chat', session, workspace });
     }, []);
+    const openWorkspace = useCallback((workspace) => {
+        if (initialWorkspaceId !== undefined) {
+            const url = new URL(window.location.href);
+            url.searchParams.delete('workspace');
+            window.history.replaceState(null, '', `${url.pathname}${url.search}${url.hash}`);
+            setInitialWorkspaceId(undefined);
+        }
+        setRoute({ kind: 'sessions', workspace });
+    }, [initialWorkspaceId]);
     return (_jsx("div", { className: "mobile", children: route.kind === 'workspaces'
-            ? _jsx(WorkspaceRoster, { onPick: (workspace) => { setRoute({ kind: 'sessions', workspace }); } })
+            ? _jsx(WorkspaceRoster, { initialWorkspaceId: initialWorkspaceId, onPick: openWorkspace })
             : route.kind === 'sessions'
                 ? (_jsx(SessionListView, { workspace: route.workspace, onBack: back, onPick: (session) => { openChat(session, route.workspace); } }))
                 : _jsx(ChatView, { session: route.session, mux: muxRef.current, onBack: back }) }));
@@ -102,7 +117,7 @@ export function staleHostHint(message) {
         : undefined;
 }
 /** Fetch one history page (tail by default) — thin wrapper so views share the call shape. */
-export function loadHistory(sessionId, beforeSeq) {
-    return fetchHistory(sessionId, beforeSeq);
+export function loadHistory(sessionId, beforeSeq, signal) {
+    return fetchHistory(sessionId, beforeSeq, undefined, signal);
 }
 export { listSessions, listWorkspaces, prompt };

package/lib/types/mobile/views/ChatView.d.ts

@@ -19,6 +19,12 @@ export interface ChatViewProps {
     mux?: MuxClient | undefined;
     onBack(): void;
 }
+/**
+ * Hard cap on live events buffered while the initial history tail page is in
+ * flight. Beyond this the oldest buffered event is dropped and a follow-up
+ * history tail re-pull closes the seam.
+ */
+export declare const MAX_TAIL_BUFFER_EVENTS = 500;
 /** One switchable permission preset (the `permissions` projection shape). */
 export interface PermissionOption {
     value: string;

package/lib/types/mobile/views/ChatView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChatView.d.ts","sourceRoot":"","sources":["../../../../src/mobile/views/ChatView.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,WAAW,CAAA;AAIjE,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAGrC,+BAA+B;AAC/B,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,WAAW,CAAA;IACpB,6EAA6E;IAC7E,GAAG,CAAC,EAAE,SAAS,GAAG,SAAS,CAAA;IAC3B,MAAM,IAAI,IAAI,CAAA;CACf;AAYD,6EAA6E;AAC7E,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,iFAAiF;AACjF,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,gBAAgB,EAAE,CAAA;IAC3B,YAAY,EAAE,MAAM,CAAA;CACrB;AAqCD;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,aAAa,+BA2N/D"}
+{"version":3,"file":"ChatView.d.ts","sourceRoot":"","sources":["../../../../src/mobile/views/ChatView.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,WAAW,CAAA;AAIjE,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAGrC,+BAA+B;AAC/B,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,WAAW,CAAA;IACpB,6EAA6E;IAC7E,GAAG,CAAC,EAAE,SAAS,GAAG,SAAS,CAAA;IAC3B,MAAM,IAAI,IAAI,CAAA;CACf;AAED;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,MAAM,CAAA;AAYzC,6EAA6E;AAC7E,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,iFAAiF;AACjF,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,gBAAgB,EAAE,CAAA;IAC3B,YAAY,EAAE,MAAM,CAAA;CACrB;AAqCD;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,aAAa,+BAkT/D"}

package/lib/types/mobile/views/ChatView.js

@@ -14,9 +14,15 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useCallback, useEffect, useRef, useState } from 'react';
 import { loadHistory, prompt } from "./App.js";
 import { errorText, formatTime, staleHostHint } from "./App.js";
-import { models, selectModel, sendCommand } from "../api.js";
+import { fetchMobilePreferences, models, selectModel, sendCommand } from "../api.js";
 import { foldEvents } from "../messages.js";
 import { ThemeToggle } from "../theme-toggle.js";
+/**
+ * Hard cap on live events buffered while the initial history tail page is in
+ * flight. Beyond this the oldest buffered event is dropped and a follow-up
+ * history tail re-pull closes the seam.
+ */
+export const MAX_TAIL_BUFFER_EVENTS = 500;
 /** Extract the raw event from one history entry (the fold consumes events only). */
 function eventOf(entry) {
     return entry.event;
@@ -77,22 +83,63 @@ export function ChatView({ session, mux, onBack }) {
     const [sending, setSending] = useState(false);
     const scrollRef = useRef(undefined);
     const pendingRef = useRef(false);
+    /**
+     * True while the initial tail page is in flight. Live events arriving in
+     * that window go to {@link liveBufferRef} instead of the message list: the
+     * tail load replaces the list wholesale, so a directly folded event would
+     * flash once, be discarded by the snapshot, and then be skipped forever by
+     * the seq watermark.
+     */
+    const tailLoadingRef = useRef(true);
+    /** Live session events buffered while the initial tail page loads. */
+    const liveBufferRef = useRef([]);
+    /** True once the live buffer hit its cap (oldest events were dropped). */
+    const liveBufferOverflowRef = useRef(false);
     /** The session's permission select (absent = capability not composed). */
     const [permissions, setPermissions] = useState(undefined);
     /** The current model selection for the toolbar chip (best-effort label). */
     const [currentModel, setCurrentModel] = useState(undefined);
     /** Which bottom sheet is open. */
     const [sheet, setSheet] = useState(null);
+    /**
+     * Composer preference from the plugin's host settings (default true keeps
+     * the legacy Enter-to-send behavior until the preference loads).
+     */
+    const [mobileEnterToSend, setMobileEnterToSend] = useState(true);
+    // Read-only mobile display preferences ride the plugin's local
+    // `/m/api` method; a failure keeps the default (Enter sends).
+    useEffect(() => {
+        let cancelled = false;
+        void fetchMobilePreferences().then((preferences) => {
+            if (!cancelled)
+                setMobileEnterToSend(preferences.mobileEnterToSend !== false);
+        }, () => { });
+        return () => { cancelled = true; };
+    }, []);
     // Tail page on open (content loads only when the session is opened).
     useEffect(() => {
         let cancelled = false;
+        const controller = new AbortController();
+        // A stuck history load must not keep the chat empty (or the live buffer
+        // growing) forever: abort it and surface the transport error.
+        const timeout = setTimeout(() => {
+            controller.abort(new DOMException('history load timed out', 'TimeoutError'));
+        }, 15_000);
+        tailLoadingRef.current = true;
+        liveBufferRef.current = [];
+        liveBufferOverflowRef.current = false;
         setLoading(true);
         setError(undefined);
         setMessages([]);
-        void loadHistory(session.sessionId).then((page) => {
+        void loadHistory(session.sessionId, undefined, controller.signal).then((page) => {
             if (cancelled)
                 return;
-            setMessages(foldEvents(page.events.map(eventOf)));
+            // Buffered live events re-fold on top of the snapshot; the watermark
+            // drops any the snapshot already includes, so nothing is lost or doubled.
+            const buffered = liveBufferRef.current;
+            liveBufferRef.current = [];
+            tailLoadingRef.current = false;
+            setMessages(foldEvents(buffered, foldEvents(page.events.map(eventOf))));
             setHasOlder(page.hasMore);
             setLoading(false);
             // The history-tail projection baseline seeds the permission picker.
@@ -100,9 +147,31 @@ export function ChatView({ session, mux, onBack }) {
             // plugin (augmentation), so the base SDK map is indexed loosely.
             const projections = page.projections?.values;
             setPermissions(parsePermissionSelect(projections?.['permissions']));
+            // The buffer overflowed while waiting (oldest events were dropped), so
+            // re-pull the freshest history page to close the gap on top of what is
+            // already rendered. Best-effort: a failure here only logs, it must not
+            // replace the loaded state with an error.
+            if (liveBufferOverflowRef.current) {
+                void loadHistory(session.sessionId, undefined, controller.signal).then((fresh) => {
+                    if (cancelled)
+                        return;
+                    setMessages(previous => foldEvents(fresh.events.map(eventOf), previous));
+                    liveBufferOverflowRef.current = false;
+                }, (reason) => {
+                    if (cancelled)
+                        return;
+                    console.warn('history tail re-pull after live buffer overflow failed', reason);
+                });
+            }
         }, (reason) => {
             if (cancelled)
                 return;
+            // Load failed: flush the buffer so the live stream still renders.
+            const buffered = liveBufferRef.current;
+            liveBufferRef.current = [];
+            tailLoadingRef.current = false;
+            if (buffered.length > 0)
+                setMessages(foldEvents(buffered));
             setError(errorText(reason));
             setLoading(false);
         });
@@ -112,7 +181,11 @@ export function ChatView({ session, mux, onBack }) {
             if (!cancelled)
                 setCurrentModel(directory.current);
         }, () => { });
-        return () => { cancelled = true; };
+        return () => {
+            cancelled = true;
+            clearTimeout(timeout);
+            controller.abort();
+        };
     }, [session.sessionId]);
     // Live frames: fold session events for this session in as they arrive.
     useEffect(() => {
@@ -122,7 +195,22 @@ export function ChatView({ session, mux, onBack }) {
             if (frame.type === 'session/event') {
                 if (frame.sessionId !== session.sessionId)
                     return;
-                setMessages(previous => foldEvents([frame.event], previous));
+                const event = frame.event;
+                if (tailLoadingRef.current) {
+                    if (liveBufferRef.current.length >= MAX_TAIL_BUFFER_EVENTS) {
+                        // Bound the tail-load window: drop the oldest buffered event and
+                        // remember that a follow-up history re-pull is needed. Warn once
+                        // per load, not for every subsequent overflow.
+                        liveBufferRef.current.shift();
+                        if (!liveBufferOverflowRef.current) {
+                            console.warn(`history tail is slow: live buffer reached ${MAX_TAIL_BUFFER_EVENTS} events; oldest buffered events will be re-fetched`);
+                            liveBufferOverflowRef.current = true;
+                        }
+                    }
+                    liveBufferRef.current.push(event);
+                    return;
+                }
+                setMessages(previous => foldEvents([event], previous));
                 return;
             }
             // Live projection pushes keep the permission picker current.
@@ -204,8 +292,8 @@ export function ChatView({ session, mux, onBack }) {
         ? undefined
         : permissions.options.find(option => option.value === permissions.currentValue)?.name
             ?? displayName(permissions.currentValue);
-    return (_jsxs("div", { className: "chat", children: [_jsxs("header", { className: "mobile-header", children: [_jsx("button", { type: "button", className: "mobile-back", "aria-label": "\u8FD4\u56DE", onClick: onBack, children: "\u2039" }), _jsx("h1", { className: "mobile-title mobile-titleInline", children: session.title }), _jsx(ThemeToggle, {})] }), error !== undefined && _jsx("p", { className: "mobile-error mobile-pad", children: error }), _jsxs("div", { className: "chat-scroll", ref: ref => { scrollRef.current = ref ?? undefined; }, children: [hasOlder && (_jsx("button", { type: "button", className: "chat-load-older", disabled: loading, onClick: () => { void loadOlder(); }, children: loading ? '加载中…' : '加载更早的消息' })), messages.map(message => _jsx(MessageRow, { message: message }, message.id)), loading && messages.length === 0 && _jsx("p", { className: "chat-typing", children: "\u52A0\u8F7D\u4E2D\u2026" }), !loading && messages.length === 0 && _jsx("p", { className: "chat-typing", children: "\u8FD8\u6CA1\u6709\u6D88\u606F\uFF0C\u53D1\u4E00\u53E5\u8BDD\u5F00\u59CB\u5427" })] }), _jsxs("div", { className: "chat-tools", children: [_jsxs("button", { type: "button", className: "chat-chip", onClick: () => { setSheet('model'); }, "aria-haspopup": "dialog", children: [_jsx("span", { className: "chat-chip-label", children: "\u6A21\u578B" }), _jsx("span", { className: "chat-chip-value", children: modelLabel }), _jsx("span", { className: "chat-chip-chevron", "aria-hidden": true, children: "\u203A" })] }), permissionLabel !== undefined && (_jsxs("button", { type: "button", className: "chat-chip", onClick: () => { setSheet('permission'); }, "aria-haspopup": "dialog", children: [_jsx("span", { className: "chat-chip-label", children: "\u6743\u9650" }), _jsx("span", { className: "chat-chip-value", children: permissionLabel }), _jsx("span", { className: "chat-chip-chevron", "aria-hidden": true, children: "\u203A" })] }))] }), _jsxs("div", { className: "chat-inputbar", children: [_jsx("textarea", { className: "chat-input", rows: 1, value: input, placeholder: "\u8F93\u5165\u6D88\u606F\uFF0CEnter \u53D1\u9001\u2026", enterKeyHint: "send", onChange: (event) => { setInput(event.target.value); }, onKeyDown: (event) => {
-                            if (event.key === 'Enter' && !event.shiftKey) {
+    return (_jsxs("div", { className: "chat", children: [_jsxs("header", { className: "mobile-header", children: [_jsx("button", { type: "button", className: "mobile-back", "aria-label": "\u8FD4\u56DE", onClick: onBack, children: "\u2039" }), _jsx("h1", { className: "mobile-title mobile-titleInline", children: session.title }), _jsx(ThemeToggle, {})] }), error !== undefined && _jsx("p", { className: "mobile-error mobile-pad", children: error }), _jsxs("div", { className: "chat-scroll", ref: ref => { scrollRef.current = ref ?? undefined; }, children: [hasOlder && (_jsx("button", { type: "button", className: "chat-load-older", disabled: loading, onClick: () => { void loadOlder(); }, children: loading ? '加载中…' : '加载更早的消息' })), messages.map(message => _jsx(MessageRow, { message: message }, message.id)), loading && messages.length === 0 && _jsx("p", { className: "chat-typing", children: "\u52A0\u8F7D\u4E2D\u2026" }), !loading && messages.length === 0 && _jsx("p", { className: "chat-typing", children: "\u8FD8\u6CA1\u6709\u6D88\u606F\uFF0C\u53D1\u4E00\u53E5\u8BDD\u5F00\u59CB\u5427" })] }), _jsxs("div", { className: "chat-tools", children: [_jsxs("button", { type: "button", className: "chat-chip", onClick: () => { setSheet('model'); }, "aria-haspopup": "dialog", children: [_jsx("span", { className: "chat-chip-label", children: "\u6A21\u578B" }), _jsx("span", { className: "chat-chip-value", children: modelLabel }), _jsx("span", { className: "chat-chip-chevron", "aria-hidden": true, children: "\u203A" })] }), permissionLabel !== undefined && (_jsxs("button", { type: "button", className: "chat-chip", onClick: () => { setSheet('permission'); }, "aria-haspopup": "dialog", children: [_jsx("span", { className: "chat-chip-label", children: "\u6743\u9650" }), _jsx("span", { className: "chat-chip-value", children: permissionLabel }), _jsx("span", { className: "chat-chip-chevron", "aria-hidden": true, children: "\u203A" })] }))] }), _jsxs("div", { className: "chat-inputbar", children: [_jsx("textarea", { className: "chat-input", rows: 1, value: input, placeholder: mobileEnterToSend ? '输入消息，Enter 发送…' : '输入消息，Enter 换行，点按钮发送…', enterKeyHint: mobileEnterToSend ? 'send' : 'enter', onChange: (event) => { setInput(event.target.value); }, onKeyDown: (event) => {
+                            if (mobileEnterToSend && event.key === 'Enter' && !event.shiftKey) {
                                 event.preventDefault();
                                 void send();
                             }

package/lib/types/mobile/views/ChatView.test.js

@@ -3,10 +3,11 @@ import { jsx as _jsx } from "react/jsx-runtime";
 /** ChatView: collapsible message folds, toolbar chips, and the bottom sheets. */
 import { afterAll, afterEach, beforeAll, beforeEach, describe, expect, it, vi } from 'vitest';
 import { act, cleanup, fireEvent, render, screen, waitFor } from '@testing-library/react';
-import { ChatView } from "./ChatView.js";
+import { ChatView, MAX_TAIL_BUFFER_EVENTS } from "./ChatView.js";
 // The api module is fully mocked; App.tsx's history wrapper is overridden to
 // feed fixed history pages, its pure helpers (errorText / formatTime) stay real.
 vi.mock('../api.ts', () => ({
+    fetchMobilePreferences: vi.fn(),
     models: vi.fn(),
     selectModel: vi.fn(),
     sendCommand: vi.fn(),
@@ -19,8 +20,8 @@ vi.mock('./App.tsx', async (importOriginal) => {
         prompt: vi.fn(async () => { }),
     };
 });
-import { models, selectModel, sendCommand } from "../api.js";
-import { loadHistory } from "./App.js";
+import { fetchMobilePreferences, models, selectModel, sendCommand } from "../api.js";
+import { loadHistory, prompt } from "./App.js";
 const session = {
     sessionId: 's-1',
     title: '测试会话',
@@ -58,11 +59,15 @@ function turnEvents() {
         }, 5),
     ];
 }
+const fetchMobilePreferencesMock = vi.mocked(fetchMobilePreferences);
 const modelsMock = vi.mocked(models);
 const selectModelMock = vi.mocked(selectModel);
 const sendCommandMock = vi.mocked(sendCommand);
 const loadHistoryMock = vi.mocked(loadHistory);
+const promptMock = vi.mocked(prompt);
 beforeEach(() => {
+    fetchMobilePreferencesMock.mockResolvedValue({ mobileEnterToSend: true });
+    promptMock.mockResolvedValue(undefined);
     modelsMock.mockResolvedValue({
         current: { provider: 'fx', model: 'fx-1' },
         routable: true,
@@ -84,6 +89,7 @@ beforeEach(() => {
 afterEach(() => {
     cleanup();
     vi.clearAllMocks();
+    vi.restoreAllMocks();
 });
 describe('ChatView message folds', () => {
     it('hides reasoning behind a collapsed disclosure and expands on tap', async () => {
@@ -165,6 +171,102 @@ describe('ChatView message folds', () => {
         });
     });
 });
+describe('ChatView initial-load race', () => {
+    /** Minimal mux stand-in: captures the ChatView's frame listener for hand-off. */
+    class FakeMux {
+        listeners = new Set();
+        onFrame(listener) {
+            this.listeners.add(listener);
+            return () => { this.listeners.delete(listener); };
+        }
+        emit(frame) {
+            for (const listener of this.listeners)
+                listener(frame);
+        }
+    }
+    it('keeps live events that arrive while the tail page is still loading', async () => {
+        let resolveHistory = () => { };
+        loadHistoryMock.mockReturnValue(new Promise((resolve) => { resolveHistory = resolve; }));
+        const mux = new FakeMux();
+        render(_jsx(ChatView, { session: session, mux: mux, onBack: () => { } }));
+        // A live turn starts before the snapshot resolves: chunk, tool call, final.
+        await act(async () => {
+            mux.emit({ type: 'session/event', sessionId: 's-1', event: makeEntry('assistant/chunk', { turn: 1, step: 0, chunk: { type: 'text-delta', text: '正在' } }, 6).event });
+            mux.emit({ type: 'session/event', sessionId: 's-1', event: makeEntry('tool/call', { turn: 1, step: 0, callId: 'c9', name: 'bash', arguments: '{"cmd":"ls"}' }, 7).event });
+            mux.emit({ type: 'session/event', sessionId: 's-1', event: makeEntry('assistant/message', { turn: 1, step: 0, message: { id: 'a-9', role: 'assistant', content: [{ type: 'text', text: '实时新消息' }] } }, 8).event });
+        });
+        // The snapshot predates those events; resolving it must not drop them.
+        await act(async () => { resolveHistory(historyPage(turnEvents())); });
+        expect(await screen.findByText('实时新消息')).toBeTruthy();
+        // The history turn's tool disclosure plus the live one both render.
+        expect((await screen.findAllByRole('button', { name: /工具/ })).length).toBe(2);
+    });
+    it('caps the tail-load live buffer and re-pulls the history tail after an overflow', async () => {
+        const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => { });
+        let resolveHistory = () => { };
+        loadHistoryMock
+            .mockReturnValueOnce(new Promise((resolve) => { resolveHistory = resolve; }))
+            // The overflow follow-up load resolves a page newer than the buffered burst.
+            .mockResolvedValueOnce(historyPage([
+            makeEntry('assistant/message', {
+                id: 'a-refetch',
+                role: 'assistant',
+                content: [{ type: 'text', text: '补拉恢复' }],
+            }, 700),
+        ]));
+        const mux = new FakeMux();
+        render(_jsx(ChatView, { session: session, mux: mux, onBack: () => { } }));
+        // 501 live final messages arrive before the snapshot resolves: the first one
+        // is dropped by the 500-event cap, the remaining 500 stay buffered.
+        await act(async () => {
+            for (let index = 0; index <= MAX_TAIL_BUFFER_EVENTS; index++) {
+                mux.emit({
+                    type: 'session/event',
+                    sessionId: 's-1',
+                    event: makeEntry('assistant/message', {
+                        id: `a-burst-${index}`,
+                        role: 'assistant',
+                        content: [{ type: 'text', text: `突发消息 ${index}` }],
+                    }, 100 + index).event,
+                });
+            }
+        });
+        // The overflow is logged exactly once, and the cap mentions the limit.
+        expect(warnSpy).toHaveBeenCalledTimes(1);
+        expect(String(warnSpy.mock.calls[0]?.[0])).toContain(String(MAX_TAIL_BUFFER_EVENTS));
+        await act(async () => { resolveHistory(historyPage(turnEvents())); });
+        // The capped buffer keeps the render bounded: the dropped oldest burst
+        // message is gone, while the newest buffered one survives the snapshot fold.
+        expect(await screen.findByText('突发消息 500')).toBeTruthy();
+        expect(screen.queryByText('突发消息 0')).toBeNull();
+        // The overflow triggered exactly one follow-up tail load, still carrying the
+        // same abort signal as the initial load.
+        await waitFor(() => { expect(loadHistoryMock).toHaveBeenCalledTimes(2); });
+        expect(loadHistoryMock.mock.calls[1]?.[0]).toBe('s-1');
+        expect(loadHistoryMock.mock.calls[1]?.[1]).toBeUndefined();
+        expect(loadHistoryMock.mock.calls[1]?.[2]).toBeInstanceOf(AbortSignal);
+        expect(loadHistoryMock.mock.calls[1]?.[2]).toBe(loadHistoryMock.mock.calls[0]?.[2]);
+        // The re-pulled page folds into the already-rendered messages.
+        expect(await screen.findByText('补拉恢复')).toBeTruthy();
+    });
+    it('passes an AbortSignal to loadHistory and aborts it on unmount', async () => {
+        let capturedSignal;
+        loadHistoryMock.mockImplementation((_sessionId, _beforeSeq, signal) => {
+            capturedSignal = signal;
+            return Promise.resolve(historyPage(turnEvents()));
+        });
+        const view = render(_jsx(ChatView, { session: session, onBack: () => { } }));
+        expect(await screen.findByText('已完成修改')).toBeTruthy();
+        expect(loadHistoryMock).toHaveBeenCalledTimes(1);
+        expect(loadHistoryMock.mock.calls[0]?.[0]).toBe('s-1');
+        expect(loadHistoryMock.mock.calls[0]?.[1]).toBeUndefined();
+        expect(loadHistoryMock.mock.calls[0]?.[2]).toBeInstanceOf(AbortSignal);
+        expect(capturedSignal).toBeInstanceOf(AbortSignal);
+        expect(capturedSignal?.aborted).toBe(false);
+        view.unmount();
+        expect(capturedSignal?.aborted).toBe(true);
+    });
+});
 describe('ChatView model sheet', () => {
     it('labels the toolbar chip with the current model and selects a new one', async () => {
         loadHistoryMock.mockResolvedValue(historyPage(turnEvents()));
@@ -213,6 +315,62 @@ describe('ChatView model sheet', () => {
         expect(await screen.findByText(/重启 dsh web/)).toBeTruthy();
     });
 });
+describe('ChatView composer', () => {
+    const inputBox = () => screen.getByRole('textbox');
+    /** Dispatch one keydown through the React tree and return the real event. */
+    const pressEnter = (input, shiftKey = false) => {
+        const event = new KeyboardEvent('keydown', { key: 'Enter', bubbles: true, cancelable: true, shiftKey });
+        input.dispatchEvent(event);
+        return event;
+    };
+    it('sends on Enter by default and keeps Shift+Enter inserting a newline', async () => {
+        loadHistoryMock.mockResolvedValue(historyPage(turnEvents()));
+        render(_jsx(ChatView, { session: session, onBack: () => { } }));
+        await screen.findByText('已完成修改');
+        const input = inputBox();
+        expect(input.getAttribute('enterKeyHint')).toBe('send');
+        expect(input.getAttribute('placeholder')).toContain('Enter 发送');
+        fireEvent.change(input, { target: { value: '第一行' } });
+        const enter = pressEnter(input);
+        expect(enter.defaultPrevented).toBe(true);
+        await waitFor(() => {
+            expect(promptMock).toHaveBeenCalledWith('s-1', '第一行');
+        });
+        // Shift+Enter stays a newline gesture and never sends.
+        promptMock.mockClear();
+        const shifted = pressEnter(input, true);
+        expect(shifted.defaultPrevented).toBe(false);
+        expect(promptMock).not.toHaveBeenCalled();
+    });
+    it('inserts a newline on Enter and sends only from the button when the preference is false', async () => {
+        fetchMobilePreferencesMock.mockResolvedValue({ mobileEnterToSend: false });
+        loadHistoryMock.mockResolvedValue(historyPage(turnEvents()));
+        render(_jsx(ChatView, { session: session, onBack: () => { } }));
+        await screen.findByText('已完成修改');
+        const input = inputBox();
+        await waitFor(() => { expect(input.getAttribute('enterKeyHint')).toBe('enter'); });
+        expect(input.getAttribute('placeholder')).not.toContain('Enter 发送');
+        // The handler no longer prevents Enter, so the browser's default inserts
+        // a newline (emulated here through the controlled value) and no send fires.
+        fireEvent.change(input, { target: { value: '第一行' } });
+        const enter = pressEnter(input);
+        expect(enter.defaultPrevented).toBe(false);
+        fireEvent.change(input, { target: { value: '第一行\n' } });
+        expect(input.value).toBe('第一行\n');
+        expect(promptMock).not.toHaveBeenCalled();
+        // The send button still sends the full multi-line draft.
+        fireEvent.change(input, { target: { value: '第一行\n第二行' } });
+        fireEvent.click(screen.getByRole('button', { name: '发送' }));
+        await waitFor(() => {
+            expect(promptMock).toHaveBeenCalledWith('s-1', '第一行\n第二行');
+        });
+        // Shift+Enter keeps inserting a newline in either mode.
+        promptMock.mockClear();
+        const shifted = pressEnter(input, true);
+        expect(shifted.defaultPrevented).toBe(false);
+        expect(promptMock).not.toHaveBeenCalled();
+    });
+});
 describe('ChatView scrolling', () => {
     // Controllable scrollHeight + a write log for the chat-scroll element. The
     // accessors live on Element.prototype, so patching them here lets every

package/lib/types/mobile/views/WorkspaceView.d.ts

@@ -7,6 +7,8 @@
 import type { WorkspaceView as WorkspaceRow } from '@deepseek-ai/dsh-host-apiproxy/api/workspace';
 /** Props for the workspace roster. */
 export interface WorkspaceViewProps {
+    /** Workspace carried by the pairing link; opened after the roster loads. */
+    initialWorkspaceId?: string;
     /** Open one workspace's session list. */
     onPick(workspace: WorkspaceRow): void;
 }
@@ -15,5 +17,5 @@ export interface WorkspaceViewProps {
  * @param props - the pick action.
  * @returns the roster.
  */
-export declare function WorkspaceView({ onPick }: WorkspaceViewProps): import("react").JSX.Element;
+export declare function WorkspaceView({ initialWorkspaceId, onPick }: WorkspaceViewProps): import("react").JSX.Element;
 //# sourceMappingURL=WorkspaceView.d.ts.map

package/lib/types/mobile/views/WorkspaceView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WorkspaceView.d.ts","sourceRoot":"","sources":["../../../../src/mobile/views/WorkspaceView.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,aAAa,IAAI,YAAY,EAAE,MAAM,8CAA8C,CAAA;AAKjG,sCAAsC;AACtC,MAAM,WAAW,kBAAkB;IACjC,yCAAyC;IACzC,MAAM,CAAC,SAAS,EAAE,YAAY,GAAG,IAAI,CAAA;CACtC;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,EAAE,MAAM,EAAE,EAAE,kBAAkB,+BAmF3D"}
+{"version":3,"file":"WorkspaceView.d.ts","sourceRoot":"","sources":["../../../../src/mobile/views/WorkspaceView.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,aAAa,IAAI,YAAY,EAAE,MAAM,8CAA8C,CAAA;AAKjG,sCAAsC;AACtC,MAAM,WAAW,kBAAkB;IACjC,4EAA4E;IAC5E,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,yCAAyC;IACzC,MAAM,CAAC,SAAS,EAAE,YAAY,GAAG,IAAI,CAAA;CACtC;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,EAAE,kBAAkB,EAAE,MAAM,EAAE,EAAE,kBAAkB,+BA0F/E"}

package/lib/types/mobile/views/WorkspaceView.js

@@ -14,7 +14,7 @@ import { ThemeToggle } from "../theme-toggle.js";
  * @param props - the pick action.
  * @returns the roster.
  */
-export function WorkspaceView({ onPick }) {
+export function WorkspaceView({ initialWorkspaceId, onPick }) {
     const [items, setItems] = useState(undefined);
     const [error, setError] = useState(undefined);
     useEffect(() => {
@@ -22,6 +22,13 @@ export function WorkspaceView({ onPick }) {
         void listWorkspaces().then((rows) => {
             if (cancelled)
                 return;
+            const target = initialWorkspaceId === undefined
+                ? undefined
+                : rows.find(workspace => workspace.workspaceId === initialWorkspaceId);
+            if (target !== undefined) {
+                onPick(target);
+                return;
+            }
             setItems(rows);
         }, (reason) => {
             if (cancelled)
@@ -29,7 +36,7 @@ export function WorkspaceView({ onPick }) {
             setError(errorText(reason));
         });
         return () => { cancelled = true; };
-    }, []);
+    }, [initialWorkspaceId, onPick]);
     if (error !== undefined) {
         return (_jsxs("div", { className: "mobile", children: [_jsxs("header", { className: "mobile-header", children: [_jsx("h1", { className: "mobile-title", children: "\u5DE5\u4F5C\u533A" }), _jsx(ThemeToggle, {})] }), _jsxs("div", { className: "mobile-empty", children: [_jsxs("p", { className: "mobile-error", children: ["\u52A0\u8F7D\u5931\u8D25\uFF1A", error] }), _jsx("button", { type: "button", className: "mobile-button", onClick: () => { setError(undefined); setItems(undefined); }, children: "\u91CD\u8BD5" })] })] }));
     }

package/lib/types/mobile/views/WorkspaceView.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=WorkspaceView.test.d.ts.map

package/lib/types/mobile/views/WorkspaceView.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkspaceView.test.d.ts","sourceRoot":"","sources":["../../../../src/mobile/views/WorkspaceView.test.tsx"],"names":[],"mappings":""}

package/lib/types/mobile/views/WorkspaceView.test.js

@@ -0,0 +1,56 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+// @vitest-environment jsdom
+/** Mobile workspace landing: roster rendering and QR deep-link selection. */
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import { cleanup, render, screen, waitFor } from '@testing-library/react';
+import { mobileWorkspaceTarget } from "./App.js";
+import { WorkspaceView } from "./WorkspaceView.js";
+vi.mock('../api.ts', () => ({
+    listWorkspaces: vi.fn(),
+}));
+import { listWorkspaces } from "../api.js";
+const listWorkspacesMock = vi.mocked(listWorkspaces);
+const workspaces = [
+    {
+        workspaceId: 'ws-1',
+        path: '/tmp/first',
+        title: 'First',
+        sessionIds: [],
+        createdAt: '2026-01-01T00:00:00.000Z',
+        updatedAt: '2026-01-01T00:00:00.000Z',
+    },
+    {
+        workspaceId: 'ws-2',
+        path: '/tmp/second',
+        title: 'Second',
+        sessionIds: [],
+        createdAt: '2026-01-01T00:00:00.000Z',
+        updatedAt: '2026-01-01T00:00:00.000Z',
+    },
+];
+afterEach(() => {
+    cleanup();
+    vi.clearAllMocks();
+});
+describe('mobile workspace deep link', () => {
+    it('reads a non-empty workspace target from the query', () => {
+        expect(mobileWorkspaceTarget('?workspace=ws-2')).toBe('ws-2');
+        expect(mobileWorkspaceTarget('?workspace=')).toBeUndefined();
+        expect(mobileWorkspaceTarget('')).toBeUndefined();
+    });
+    it('opens the targeted workspace as soon as the roster loads', async () => {
+        listWorkspacesMock.mockResolvedValue(workspaces);
+        const onPick = vi.fn();
+        render(_jsx(WorkspaceView, { initialWorkspaceId: "ws-2", onPick: onPick }));
+        await waitFor(() => expect(onPick).toHaveBeenCalledWith(workspaces[1]));
+        expect(onPick).toHaveBeenCalledTimes(1);
+    });
+    it('falls back to the roster when the target no longer exists', async () => {
+        listWorkspacesMock.mockResolvedValue(workspaces);
+        const onPick = vi.fn();
+        render(_jsx(WorkspaceView, { initialWorkspaceId: "missing", onPick: onPick }));
+        expect(await screen.findByText('First')).toBeTruthy();
+        expect(await screen.findByText('Second')).toBeTruthy();
+        expect(onPick).not.toHaveBeenCalled();
+    });
+});

package/lib/types/mobile-api.d.ts

@@ -27,6 +27,8 @@ export interface MobileApiDeps {
     service: PairingService;
     /** The host ApiProxy service (injected by the plugin). */
     apiProxy: ApiProxy;
+    /** The resolved mobile composer preference (live per request). */
+    mobileEnterToSend: () => boolean;
 }
 /** Mobile API route paths. */
 export declare const MOBILE_API_PATHS: {

package/lib/types/mobile-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mobile-api.d.ts","sourceRoot":"","sources":["../../src/mobile-api.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAA;AAC/D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAA;AAG9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAuClD,iCAAiC;AACjC,MAAM,WAAW,aAAa;IAC5B,uDAAuD;IACvD,OAAO,EAAE,cAAc,CAAA;IACvB,0DAA0D;IAC1D,QAAQ,EAAE,QAAQ,CAAA;CACnB;AAED,8BAA8B;AAC9B,eAAO,MAAM,gBAAgB;;CAEnB,CAAA;AAOV;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,aAAa,GAAG,QAAQ,EAAE,CAkHnE"}
+{"version":3,"file":"mobile-api.d.ts","sourceRoot":"","sources":["../../src/mobile-api.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAA;AAC/D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAA;AAG9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AA8ClD,iCAAiC;AACjC,MAAM,WAAW,aAAa;IAC5B,uDAAuD;IACvD,OAAO,EAAE,cAAc,CAAA;IACvB,0DAA0D;IAC1D,QAAQ,EAAE,QAAQ,CAAA;IAClB,kEAAkE;IAClE,iBAAiB,EAAE,MAAM,OAAO,CAAA;CACjC;AAED,8BAA8B;AAC9B,eAAO,MAAM,gBAAgB;;CAEnB,CAAA;AAOV;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,aAAa,GAAG,QAAQ,EAAE,CA2HnE"}