@jingyi0605/codingns4dsh 0.1.2 → 0.1.7-rc.3

package/data/build/dist/client/index.d.ts

@@ -7,13 +7,18 @@
  */
 import type { Context } from '@deepseek-ai/cordis';
 import './provider-icon-assets.js';
+export { PeerHostSessionController } from './peer-host-session-controller.js';
 export { ensureCryptoRandomUUID } from './lan-access.js';
 export type { CryptoRandomUUIDInstallResult, LanAccessCrypto, LanAccessGlobal, } from './lan-access.js';
-export { CLIENT_FEATURES, settingsModules, startBrowserRelayConnection, gitManagementFeature } from './features/index.js';
+export { CLIENT_FEATURES, settingsModules, startBrowserRelayConnection, gitManagementFeature, fileManagementFeature } from './features/index.js';
 export { chooseDshDevice, createHttpDshH5ControlApi, startDshH5Bootstrap, startDshH5BrowserBootstrap } from './dsh-h5-bootstrap.js';
 export type { DshH5BootstrapOptions, DshH5BootstrapResult, DshH5BrowserBootstrapOptions, DshH5BrowserBootstrapResult, DshH5BrowserControlApi, } from './dsh-h5-bootstrap.js';
 export { RemoteDshWebContext } from './remote-web-context.js';
 export type { RemoteDshWebBoot, RemoteDshWebContextOptions } from './remote-web-context.js';
+export { createPeerHostScopedClient, createPeerHostWebSocketFactory } from './peer-host-scoped-client.js';
+export type { PeerHostClientMessageType, PeerHostEventStreamOptions, PeerHostEventSubscription, PeerHostProxyResponse, PeerHostScopedClient } from './peer-host-scoped-client.js';
+export { startPeerHostNativeNavigation, startPeerHostNativeSession, probePeerHostNativeNavigation, probePeerHostNativeSession, PEER_HOST_NAVIGATION_ATTRIBUTE, PEER_HOST_SESSION_ATTRIBUTE, PEER_HOST_STATUS_ATTRIBUTE, } from './peer-host-native-session-ui.js';
+export type { PeerHostNativeUiState, PeerHostNativeNavigationController, PeerHostNativeSessionController, } from './peer-host-native-session-ui.js';
 export type { CodingNsClientFeatureModule, CodingNsClientServices, CodingNsRpcClient, CodingNsRpcResult, FeaturePanelProps, } from './features/index.js';
 export { CodingNsSettingsSection } from './settings-section.js';
 export { startWorkspaceSessionArchiveDom, WORKSPACE_SESSION_ARCHIVE_ATTRIBUTE, WORKSPACE_SESSION_ARCHIVE_MODAL_ATTRIBUTE, } from './workspace-session-archive-dom.js';

package/data/build/dist/client/index.js

@@ -6,17 +6,23 @@ import { CLIENT_FEATURES } from './features/index.js';
 import { ensureCryptoRandomUUID } from './lan-access.js';
 import { CodingNsSettingsSection } from './settings-section.js';
 import { callCodingNsRpc, createCodingNsSettingsBridge } from './settings-bridge.js';
-import { debugInfo } from '../shared/debug.js';
+import { debugInfo, debugWarn } from '../shared/debug.js';
 import { createConfigFormSettingsStore } from '../dsh-capabilities/client/config-forms-adapter.js';
 import { CodingNsWebTerminals, registerCodingNsTerminalUi } from './terminal/index.js';
 import { startCodingNsAccountBar } from './account-bar.js';
 import { assertInjectedDshVersion } from './dsh-runtime-version.js';
 import { createDshCapabilityRegistry } from '../dsh-capabilities/index.js';
 import { TYPERT_REMOTE } from '../typert.remote-client.js';
+import { createPeerHostScopedClient } from './peer-host-scoped-client.js';
+import { HostRouter } from './host-router.js';
+import { PeerHostSessionController } from './peer-host-session-controller.js';
+export { PeerHostSessionController } from './peer-host-session-controller.js';
 export { ensureCryptoRandomUUID } from './lan-access.js';
-export { CLIENT_FEATURES, settingsModules, startBrowserRelayConnection, gitManagementFeature } from './features/index.js';
+export { CLIENT_FEATURES, settingsModules, startBrowserRelayConnection, gitManagementFeature, fileManagementFeature } from './features/index.js';
 export { chooseDshDevice, createHttpDshH5ControlApi, startDshH5Bootstrap, startDshH5BrowserBootstrap } from './dsh-h5-bootstrap.js';
 export { RemoteDshWebContext } from './remote-web-context.js';
+export { createPeerHostScopedClient, createPeerHostWebSocketFactory } from './peer-host-scoped-client.js';
+export { startPeerHostNativeNavigation, startPeerHostNativeSession, probePeerHostNativeNavigation, probePeerHostNativeSession, PEER_HOST_NAVIGATION_ATTRIBUTE, PEER_HOST_SESSION_ATTRIBUTE, PEER_HOST_STATUS_ATTRIBUTE, } from './peer-host-native-session-ui.js';
 export { CodingNsSettingsSection } from './settings-section.js';
 export { startWorkspaceSessionArchiveDom, WORKSPACE_SESSION_ARCHIVE_ATTRIBUTE, WORKSPACE_SESSION_ARCHIVE_MODAL_ATTRIBUTE, } from './workspace-session-archive-dom.js';
 export { startWorkspaceSessionVisibilityDom, WORKSPACE_SESSION_HIDDEN_ATTRIBUTE, WORKSPACE_SESSION_HIDDEN_MENU_ATTRIBUTE, WORKSPACE_SESSION_HIDDEN_LIST_ATTRIBUTE, } from './workspace-session-visibility-dom.js';
@@ -68,10 +74,15 @@ export function apply(ctx) {
         debugInfo('codingns4dsh: client terminal UI registration begin');
         const disposeTerminalUi = registerCodingNsTerminalUi(settingsCtx, webTerminals, settings);
         debugInfo('codingns4dsh: client terminal UI registration ready');
+        const hostRouter = new HostRouter();
+        const peerHost = createPeerHostScopedClient(connection.rpc);
         const services = {
             dshVersion,
             settings,
             rpc: connection.rpc,
+            peerHost,
+            hostRouter,
+            peerHostSession: new PeerHostSessionController(hostRouter, peerHost),
             remote: settingsCtx.remote,
             terminalRemote,
             slots: settingsCtx.slots,
@@ -125,6 +136,7 @@ export function apply(ctx) {
             return async () => {
                 unsubscribe();
                 await registry.reconcile([]);
+                await services.hostRouter.clear();
                 disposeTerminalUi();
                 await disposeAccountBar.dispose();
                 await disposeTerminalRemote();
@@ -172,15 +184,23 @@ function createClientSettingsStore(ctx, rpc) {
     }
     const forms = ctx.get('configForms');
     const form = findConfigForm(forms);
-    debugInfo('codingns4dsh: client settings source=configForms', { hasConfigForms: forms !== undefined, hasForm: form !== undefined });
-    return createConfigFormSettingsStore({ get: () => form }, CODINGNS_SETTINGS_NAMESPACE, form === undefined
-        ? undefined
-        : {
-            // DSH 0.1.7 的 ConfigForm 会把 Host 后台索引更新也纳入 revision。
-            // Codingns4DSH 的路径操作是原子的，交给 Host RPC 无条件合并，避免
-            // 模块开关因为 cliSessions 的后台心跳而永久冲突。
-            writeUnfenced: async (ops) => callCodingNsRpc(rpc, 'settings/set', { ops }),
+    if (form === undefined) {
+        // DSH 只向回环页面或声明了 Host 所有权的页面下发持久设置命名空间；局域网和
+        // 中继页面会降级为 memory 模式，ConfigForm 因此缺失。设置页不能停在这里：
+        // 插件设置本来就由自己的 Host RPC 承载，退回 RPC 边界后这些页面依然可读写，
+        // 也不再需要宿主启动页去改页面级 Transport 全局（那会覆盖 Desktop Transport）。
+        debugWarn('codingns4dsh: client config form unavailable; falling back to Host settings RPC', {
+            hasConfigForms: forms !== undefined,
         });
+        return createCodingNsSettingsBridge(undefined, rpc);
+    }
+    debugInfo('codingns4dsh: client settings source=configForms', { hasConfigForms: forms !== undefined, hasForm: true });
+    return createConfigFormSettingsStore({ get: () => form }, CODINGNS_SETTINGS_NAMESPACE, {
+        // DSH 0.1.7 的 ConfigForm 会把 Host 后台索引更新也纳入 revision。
+        // Codingns4DSH 的路径操作是原子的，交给 Host RPC 无条件合并，避免
+        // 模块开关因为 cliSessions 的后台心跳而永久冲突。
+        writeUnfenced: async (ops) => callCodingNsRpc(rpc, 'settings/set', { ops }),
+    });
 }
 function findConfigForm(forms) {
     if (forms === undefined)

package/data/build/dist/client/locale.js

@@ -1,4 +1,4 @@
-import { useSyncExternalStore } from 'react';
+import { useMemo, useSyncExternalStore } from 'react';
 /** Codingns4DSH 自有词典命名空间。词典缺少的语言由 DSH 自动回退到英文。 */
 export const CODINGNS_LOCALE_NS = 'codingns';
 const en = {
@@ -23,9 +23,18 @@ const en = {
     'feature.cliAdapters.label': 'External Agent integration',
     'feature.cliAdapters.description': 'View installed external Agents, versions, command paths, available models, and enable them independently.',
     'feature.workspaceSession.label': 'Workspace session enhancement',
-    'feature.workspaceSession.description': 'Show Agent logos, archived-session entries, workspace hiding controls, subscription or usage information, and local quick sessions.',
+    'feature.workspaceSession.description': 'Show Agent logos, archived-session entries, workspace hiding controls, subscription or usage information, local quick sessions, and an optional remembered conversation/right-sidebar width ratio.',
     'feature.terminal.label': 'Terminal enhancements',
     'feature.terminal.description': 'Configure the default shell and terminal appearance. Enabling or disabling requires a DSH restart.',
+    'feature.fileManagement.label': 'File management enhancements',
+    'feature.fileManagement.description': 'Add file and folder operation menus to the DSH file sidebar and edit common text files in place.',
+    'fileManagement.menuEnhancement': 'File and folder operation menu',
+    'fileManagement.menuEnhancementDescription': 'Show the right-click operation menu for files and folders in the DSH sidebar.',
+    'fileManagement.fileEditor': 'File viewer editor',
+    'fileManagement.fileEditorDescription': 'Show the icon button for editing supported text files with syntax highlighting and line numbers.',
+    'fileManagement.sessionChangedFiles': 'Show current session changed files',
+    'fileManagement.sessionChangedFilesDescription': 'Show the files changed in the current session and their Git Diff.',
+    'fileManagement.saved': 'File management settings saved.',
     'terminal.title': 'Terminal',
     'terminal.new': 'New terminal',
     'terminal.description': 'Run commands in the session workspace',
@@ -202,6 +211,8 @@ const en = {
     'workspace.subscriptionUsageDescription': 'Detect and display provider subscription balances and upstream usage in the conversation footer.',
     'workspace.showQuickPhrases': 'Show quick sessions',
     'workspace.quickPhrasesDescription': 'Keep reusable session instructions locally in Codingns4DSH and show the quick sessions button inside the composer.',
+    'workspace.rememberConversationRightbarRatio': 'Remember conversation and right sidebar width ratio',
+    'workspace.rememberConversationRightbarRatioDescription': 'Restore the right sidebar proportion after refreshing this browser; the ratio is stored locally.',
     'workspace.quickPhrasesTitle': 'Quick sessions',
     'workspace.quickPhrasesHint': 'Click an item in the composer to fill the current draft.',
     'workspace.quickPhrasesEmpty': 'No quick sessions yet.',
@@ -241,9 +252,18 @@ const zh = {
     'feature.cliAdapters.label': '外部Agent集成',
     'feature.cliAdapters.description': '查看外部 Agent 的安装状态、版本、命令路径和可用模型，并单独启用或停用。',
     'feature.workspaceSession.label': '工作区会话增强',
-    'feature.workspaceSession.description': '在原生工作区会话行显示 Agent Logo、归档会话入口、工作区隐藏功能和订阅/用量信息，并提供本地快捷会话。',
+    'feature.workspaceSession.description': '在原生工作区会话行显示 Agent Logo、归档会话入口、工作区隐藏功能和订阅/用量信息，提供本地快捷会话，并可记忆对话窗口与右侧栏宽度比例。',
     'feature.terminal.label': '终端增强',
     'feature.terminal.description': '配置持久终端的默认 shell 与插件终端外观。启用和禁用均需重启 DSH。',
+    'feature.fileManagement.label': '文件管理增强',
+    'feature.fileManagement.description': '为 DSH 文件侧栏增加文件和文件夹操作菜单，并支持直接编辑常用文本文件。',
+    'fileManagement.menuEnhancement': '文件管理菜单增强',
+    'fileManagement.menuEnhancementDescription': '在 DSH 文件侧栏为文件和目录显示右键操作菜单。',
+    'fileManagement.fileEditor': '文件查看器编辑功能',
+    'fileManagement.fileEditorDescription': '为支持的文本文件显示编辑图标按钮，并保留语法高亮和行号。',
+    'fileManagement.sessionChangedFiles': '显示当前会话修改的文件',
+    'fileManagement.sessionChangedFilesDescription': '在当前会话顶部显示已修改文件，并支持查看 Git Diff 和暂存。',
+    'fileManagement.saved': '文件管理设置已保存。',
     'terminal.title': '终端',
     'terminal.new': '新建终端',
     'terminal.description': '在会话工作区运行命令',
@@ -346,7 +366,7 @@ const zh = {
     'relay.dshVersion': 'DSH 版本：{value}',
     'relay.computerName': '计算机名：{value}',
     'relay.host': 'Host：{value}',
-    'relay.devicesSummary': '当前设备 {current}，其他活动设备 {count} 台',
+    'relay.devicesSummary': '当前设备 {current}，活动设备 {count} 台',
     'relay.deviceStatus': '设备状态：{value}',
     'relay.dshDevices': 'Codingns4DSH 设备',
     'relay.selectDevice': '选择 DSH Host',
@@ -420,6 +440,8 @@ const zh = {
     'workspace.subscriptionUsageDescription': '在对话底部检测并显示 Agent 订阅余额和上游用量。',
     'workspace.showQuickPhrases': '显示快捷会话',
     'workspace.quickPhrasesDescription': '在 Codingns4DSH 内本地保存可复用的会话指令，并将快捷会话按钮显示在输入工具区。',
+    'workspace.rememberConversationRightbarRatio': '记忆对话窗口与右侧栏的宽度比例',
+    'workspace.rememberConversationRightbarRatioDescription': '刷新后恢复右侧栏比例；比例仅保存在当前浏览器中。',
     'workspace.quickPhrasesTitle': '快捷会话',
     'workspace.quickPhrasesHint': '点击条目即可填入当前对话框。',
     'workspace.quickPhrasesEmpty': '还没有快捷会话。',
@@ -443,11 +465,18 @@ export function registerCodingNsLocale(ctx) {
 }
 /** 订阅 DSH 语言修订，并返回当前 Codingns4DSH 命名空间翻译函数。 */
 export function useCodingNsTranslator(locale) {
-    const getRevision = () => locale.getSnapshot().revision;
-    const subscribe = (listener) => locale.subscribe(listener);
-    useSyncExternalStore(subscribe, getRevision, getRevision);
+    // useSyncExternalStore 要求 subscribe/getSnapshot 保持稳定引用：内联闭包会让
+    // React 在每次渲染后追加一次一致性检查，并在引用变化时强制重新渲染。
+    const store = useMemo(() => localeSnapshotHandle(locale), [locale]);
+    useSyncExternalStore(store.subscribe, store.getRevision, store.getRevision);
     return locale.bind(CODINGNS_LOCALE_NS);
 }
+function localeSnapshotHandle(locale) {
+    return {
+        subscribe: (listener) => locale.subscribe(listener),
+        getRevision: () => locale.getSnapshot().revision,
+    };
+}
 /** 非 React 注册回调使用的翻译函数。 */
 export function codingNsTranslator(locale) {
     return locale.bind(CODINGNS_LOCALE_NS);

package/data/build/dist/client/peer-host-connection-button.d.ts

@@ -0,0 +1,13 @@
+export declare const PEER_HOST_BUTTON_ATTRIBUTE = "data-codingns-peer-host-button";
+export declare const PEER_HOST_OPEN_EVENT = "codingns4dsh:peer-host-open";
+export interface PeerHostConnectionButtonController {
+    dispose(): void;
+}
+export interface PeerHostConnectionButtonOptions {
+    readonly document?: Document;
+    readonly onOpen?: () => void;
+}
+/** 在现有账户入口旁提供 PeerHost 管理按钮；模块停用时完整移除 DOM。 */
+export declare function startPeerHostConnectionButton(options?: PeerHostConnectionButtonOptions): PeerHostConnectionButtonController;
+export declare function createPeerHostButton(dom: Pick<Document, 'createElement'>): HTMLButtonElement;
+//# sourceMappingURL=peer-host-connection-button.d.ts.map

package/data/build/dist/client/peer-host-connection-button.js

@@ -0,0 +1,69 @@
+export const PEER_HOST_BUTTON_ATTRIBUTE = 'data-codingns-peer-host-button';
+export const PEER_HOST_OPEN_EVENT = 'codingns4dsh:peer-host-open';
+/** 在现有账户入口旁提供 PeerHost 管理按钮；模块停用时完整移除 DOM。 */
+export function startPeerHostConnectionButton(options = {}) {
+    const dom = options.document ?? (typeof document === 'undefined' ? undefined : document);
+    if (dom === undefined)
+        return { dispose() { } };
+    let disposed = false;
+    let observer;
+    const scan = () => {
+        if (disposed)
+            return;
+        const settings = dom.querySelector('button[aria-label="设置"]');
+        const account = dom.querySelector('button[data-codingns-account-button]');
+        const anchor = account ?? settings;
+        const parent = anchor?.parentElement;
+        if (parent === null || parent === undefined)
+            return;
+        let button = parent.querySelector(`button[${PEER_HOST_BUTTON_ATTRIBUTE}]`);
+        if (button === null) {
+            button = createPeerHostButton(dom);
+            button.addEventListener('click', (event) => {
+                event.preventDefault();
+                event.stopPropagation();
+                options.onOpen?.();
+                dom.defaultView?.dispatchEvent(new Event(PEER_HOST_OPEN_EVENT));
+            });
+            parent.insertBefore(button, anchor?.nextSibling ?? null);
+        }
+    };
+    observer = typeof MutationObserver === 'undefined' ? undefined : new MutationObserver(scan);
+    observer?.observe(dom.documentElement, { childList: true, subtree: true });
+    scan();
+    return {
+        dispose() {
+            if (disposed)
+                return;
+            disposed = true;
+            observer?.disconnect();
+            dom.querySelectorAll(`button[${PEER_HOST_BUTTON_ATTRIBUTE}]`).forEach((node) => node.remove());
+        },
+    };
+}
+export function createPeerHostButton(dom) {
+    const button = dom.createElement('button');
+    button.type = 'button';
+    button.setAttribute(PEER_HOST_BUTTON_ATTRIBUTE, '');
+    button.setAttribute('aria-label', '管理其他 DSH Host');
+    button.title = '管理其他 DSH Host';
+    button.textContent = 'Host';
+    Object.assign(button.style, {
+        minWidth: '30px',
+        height: '30px',
+        padding: '0 6px',
+        border: '1px solid var(--dsw-alias-border-l2, rgba(255,255,255,.16))',
+        borderRadius: '6px',
+        background: 'var(--dsw-alias-button-elevated-fill, #545557)',
+        color: 'var(--dsw-alias-label-primary, #fff)',
+        cursor: 'pointer',
+        boxSizing: 'border-box',
+        display: 'inline-flex',
+        alignItems: 'center',
+        justifyContent: 'center',
+        fontSize: '11px',
+        fontWeight: '600',
+    });
+    return button;
+}
+//# sourceMappingURL=peer-host-connection-button.js.map

package/data/build/dist/client/peer-host-management-api.d.ts

@@ -0,0 +1,40 @@
+import type { AggregateHostResult, PeerHostClientRecord, PeerHostDiagnosticSnapshot, PeerHostRoute, PeerHostWebSocketEndpoint } from '../shared/contracts/peer-host.js';
+import type { CodingNsRpcClient } from './features/types.js';
+export interface PeerHostCreateRequest {
+    readonly displayName: string;
+    readonly route: PeerHostRoute;
+}
+export interface PeerHostUpdateRequest {
+    readonly peerHostId: string;
+    readonly displayName?: string;
+    readonly route?: PeerHostRoute;
+}
+export interface PeerHostLoginRequest {
+    readonly peerHostId: string;
+    readonly username: string;
+    readonly password: string;
+}
+export interface PeerHostManagementApi {
+    list(): Promise<readonly PeerHostClientRecord[]>;
+    create(input: PeerHostCreateRequest): Promise<PeerHostClientRecord>;
+    update(input: PeerHostUpdateRequest): Promise<PeerHostClientRecord>;
+    remove(peerHostId: string): Promise<void>;
+    check(peerHostId: string): Promise<PeerHostClientRecord>;
+    reconnect(peerHostId: string): Promise<PeerHostClientRecord>;
+    login(input: PeerHostLoginRequest): Promise<{
+        readonly peerHostId: string;
+        readonly status: string;
+        readonly expiresAt: number | null;
+    }>;
+    logout(peerHostId: string): Promise<{
+        readonly peerHostId: string;
+        readonly status: string;
+        readonly expiresAt: number | null;
+    }>;
+    webSocketEndpoint(): Promise<PeerHostWebSocketEndpoint | null>;
+    aggregate(): Promise<readonly AggregateHostResult[]>;
+    diagnostics(): Promise<readonly PeerHostDiagnosticSnapshot[]>;
+}
+/** PeerHost 管理 RPC 封装；客户端不接受目标凭据字段。 */
+export declare function createPeerHostManagementApi(rpc: CodingNsRpcClient): PeerHostManagementApi;
+//# sourceMappingURL=peer-host-management-api.d.ts.map

package/data/build/dist/client/peer-host-management-api.js

@@ -0,0 +1,33 @@
+import { CODINGNS_RPC_CHANNEL } from '../shared/contracts/transport.js';
+/** PeerHost 管理 RPC 封装；客户端不接受目标凭据字段。 */
+export function createPeerHostManagementApi(rpc) {
+    const call = async (endpoint, payload) => {
+        let result;
+        try {
+            result = await rpc.call(CODINGNS_RPC_CHANNEL, endpoint, payload);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            if (!/HTTP (?:404|405)\b/u.test(message))
+                throw error;
+            result = await rpc.call('/api', `codingns/${endpoint}`, payload);
+        }
+        if (!result.ok)
+            throw new Error(result.error.message);
+        return result.value;
+    };
+    return {
+        list: () => call('peerHost/list', {}),
+        create: (input) => call('peerHost/create', input),
+        update: (input) => call('peerHost/update', input),
+        remove: (peerHostId) => call('peerHost/remove', { peerHostId }).then(() => undefined),
+        check: (peerHostId) => call('peerHost/check', { peerHostId }),
+        reconnect: (peerHostId) => call('peerHost/reconnect', { peerHostId }),
+        login: (input) => call('peerHost/login', input),
+        logout: (peerHostId) => call('peerHost/logout', { peerHostId }),
+        webSocketEndpoint: () => call('peerHost/wsEndpoint', {}),
+        aggregate: () => call('peerHost/aggregate', {}),
+        diagnostics: () => call('peerHost/diagnostics', {}),
+    };
+}
+//# sourceMappingURL=peer-host-management-api.js.map

package/data/build/dist/client/peer-host-management-panel.d.ts

@@ -0,0 +1,13 @@
+import type { CodingNsRpcClient } from './features/types.js';
+import { type PeerHostManagementApi } from './peer-host-management-api.js';
+export interface PeerHostManagementPanelController {
+    dispose(): void;
+}
+export interface PeerHostManagementPanelOptions {
+    readonly document?: Document;
+    readonly rpc: CodingNsRpcClient;
+    readonly api?: PeerHostManagementApi;
+}
+/** PeerHost 管理面板；只渲染脱敏记录和稳定状态。 */
+export declare function startPeerHostManagementPanel(options: PeerHostManagementPanelOptions): PeerHostManagementPanelController;
+//# sourceMappingURL=peer-host-management-panel.d.ts.map

package/data/build/dist/client/peer-host-management-panel.js

@@ -0,0 +1,181 @@
+import { PEER_HOST_OPEN_EVENT } from './peer-host-connection-button.js';
+import { createPeerHostManagementApi } from './peer-host-management-api.js';
+/** PeerHost 管理面板；只渲染脱敏记录和稳定状态。 */
+export function startPeerHostManagementPanel(options) {
+    const dom = options.document ?? (typeof document === 'undefined' ? undefined : document);
+    if (dom === undefined)
+        return { dispose() { } };
+    const api = options.api ?? createPeerHostManagementApi(options.rpc);
+    let disposed = false;
+    let overlay = null;
+    const open = () => {
+        if (disposed)
+            return;
+        if (overlay === null)
+            overlay = createOverlay(dom, api, () => { overlay = null; });
+        void refreshList(overlay, api);
+    };
+    dom.defaultView?.addEventListener(PEER_HOST_OPEN_EVENT, open);
+    return {
+        dispose() {
+            if (disposed)
+                return;
+            disposed = true;
+            dom.defaultView?.removeEventListener(PEER_HOST_OPEN_EVENT, open);
+            overlay?.remove();
+            overlay = null;
+        },
+    };
+}
+function createOverlay(dom, api, onClose) {
+    const overlay = dom.createElement('div');
+    overlay.setAttribute('data-codingns-peer-host-panel', '');
+    overlay.setAttribute('role', 'dialog');
+    overlay.setAttribute('aria-label', '管理其他 DSH Host');
+    Object.assign(overlay.style, { position: 'fixed', right: '16px', bottom: '56px', zIndex: '9999', width: 'min(520px, calc(100vw - 32px))', maxHeight: 'min(720px, calc(100vh - 80px))', overflow: 'auto', padding: '16px', border: '1px solid var(--dsw-alias-border-l2, #555)', borderRadius: '8px', background: 'var(--dsw-alias-bg-primary, #202124)', color: 'var(--dsw-alias-label-primary, #fff)', boxShadow: '0 12px 32px rgba(0,0,0,.28)' });
+    const header = dom.createElement('header');
+    const title = dom.createElement('strong');
+    title.textContent = '管理其他 DSH Host';
+    const close = dom.createElement('button');
+    close.type = 'button';
+    close.textContent = '关闭';
+    close.addEventListener('click', () => { overlay.remove(); onClose(); });
+    Object.assign(close.style, { float: 'right' });
+    header.append(title, close);
+    const message = dom.createElement('div');
+    message.setAttribute('role', 'status');
+    message.setAttribute('data-codingns-peer-host-message', '');
+    const list = dom.createElement('div');
+    list.setAttribute('data-codingns-peer-host-list', '');
+    const form = createAddForm(dom, api, list, message);
+    overlay.append(header, message, form, list);
+    dom.body.append(overlay);
+    return overlay;
+}
+function createAddForm(dom, api, list, message) {
+    const form = dom.createElement('form');
+    const name = input(dom, '名称', 'text');
+    const routeKind = dom.createElement('select');
+    routeKind.required = true;
+    for (const option of [['lan', '局域网'], ['relay', '中转']]) {
+        const item = dom.createElement('option');
+        item.value = option[0];
+        item.textContent = option[1];
+        routeKind.append(item);
+    }
+    const routeKindLabel = dom.createElement('label');
+    routeKindLabel.textContent = '路由类型';
+    routeKindLabel.append(routeKind);
+    const url = input(dom, '局域网地址', 'url');
+    const deviceId = input(dom, '中转设备标识', 'text');
+    const relayEntryId = input(dom, '中转绑定标识', 'text');
+    const transportVersion = input(dom, '中转协议版本', 'text');
+    const routeFields = dom.createElement('div');
+    routeFields.append(url.wrapper, deviceId.wrapper, relayEntryId.wrapper, transportVersion.wrapper);
+    const updateRouteFields = () => {
+        const relay = routeKind.value === 'relay';
+        url.wrapper.hidden = relay;
+        deviceId.wrapper.hidden = !relay;
+        relayEntryId.wrapper.hidden = !relay;
+        transportVersion.wrapper.hidden = !relay;
+        url.input.required = !relay;
+        deviceId.input.required = relay;
+        relayEntryId.input.required = relay;
+        transportVersion.input.required = relay;
+    };
+    routeKind.addEventListener('change', updateRouteFields);
+    updateRouteFields();
+    const submit = dom.createElement('button');
+    submit.type = 'submit';
+    submit.textContent = '添加';
+    form.append(name.wrapper, routeKindLabel, routeFields, submit);
+    form.addEventListener('submit', (event) => {
+        event.preventDefault();
+        const route = routeKind.value === 'relay'
+            ? { kind: 'relay', deviceId: deviceId.input.value.trim(), relayEntryId: relayEntryId.input.value.trim(), transportVersion: transportVersion.input.value.trim() }
+            : { kind: 'lan', baseUrl: url.input.value.trim(), normalizedOrigin: '' };
+        void api.create({ displayName: name.input.value.trim(), route }).then(() => refreshList(list.parentElement, api)).then(() => { message.textContent = '已添加 PeerHost'; }).catch((error) => { message.textContent = error instanceof Error ? error.message : String(error); });
+    });
+    return form;
+}
+async function refreshList(overlay, api) {
+    const list = overlay.querySelector('[data-codingns-peer-host-list]');
+    if (list === null)
+        return;
+    list.textContent = '正在读取 PeerHost...';
+    try {
+        const records = await api.list();
+        list.textContent = '';
+        for (const record of records)
+            list.append(renderRecord(overlay.ownerDocument, api, record, list));
+    }
+    catch (error) {
+        list.textContent = error instanceof Error ? error.message : String(error);
+    }
+}
+function renderRecord(dom, api, record, list) {
+    const row = dom.createElement('article');
+    row.setAttribute('data-peer-host-id', record.id);
+    const title = dom.createElement('strong');
+    title.textContent = `${record.displayName} · ${record.route.kind} · ${record.status}`;
+    const detail = dom.createElement('div');
+    detail.textContent = `DSH ${record.dshVersion ?? '未知'} · 插件 ${record.pluginVersion ?? '未知'} · fingerprint ${redactFingerprint(record.fingerprint)}${record.lastErrorCode === null ? '' : ` · ${record.lastErrorCode}`}`;
+    const actions = dom.createElement('div');
+    actions.append(actionButton(dom, '编辑', () => edit(dom, api, record, run)), actionButton(dom, '检查', () => run(() => api.check(record.id))), actionButton(dom, '重连', () => run(() => api.reconnect(record.id))), actionButton(dom, '登录', () => login(dom, api, record.id, run)), actionButton(dom, '退出', () => run(() => api.logout(record.id))), actionButton(dom, '删除', () => {
+        if (dom.defaultView?.confirm(`确认删除 PeerHost“${record.displayName}”？`) !== true)
+            return;
+        run(() => api.remove(record.id));
+    }));
+    row.append(title, detail, actions);
+    return row;
+    function run(operation) {
+        void operation().then(() => refreshList(list.parentElement, api)).catch((error) => { detail.textContent = error instanceof Error ? error.message : String(error); });
+    }
+}
+function login(dom, api, peerHostId, run) {
+    const username = dom.defaultView?.prompt('目标 Host 用户名');
+    const password = dom.defaultView?.prompt('目标 Host 密码');
+    if (!username || !password)
+        return;
+    run(() => api.login({ peerHostId, username, password }));
+}
+function edit(dom, api, record, run) {
+    const displayName = dom.defaultView?.prompt('PeerHost 名称', record.displayName)?.trim();
+    if (!displayName)
+        return;
+    if (record.route.kind === 'lan') {
+        const baseUrl = dom.defaultView?.prompt('局域网地址（重新输入）')?.trim();
+        if (!baseUrl)
+            return;
+        run(() => api.update({ peerHostId: record.id, displayName, route: { kind: 'lan', baseUrl, normalizedOrigin: '' } }));
+        return;
+    }
+    const deviceId = dom.defaultView?.prompt('中转设备标识')?.trim();
+    const relayEntryId = dom.defaultView?.prompt('中转绑定标识')?.trim();
+    const transportVersion = dom.defaultView?.prompt('中转协议版本')?.trim();
+    if (!deviceId || !relayEntryId || !transportVersion)
+        return;
+    run(() => api.update({ peerHostId: record.id, displayName, route: { kind: 'relay', deviceId, relayEntryId, transportVersion } }));
+}
+function actionButton(dom, label, action) {
+    const button = dom.createElement('button');
+    button.type = 'button';
+    button.textContent = label;
+    button.addEventListener('click', action);
+    return button;
+}
+function input(dom, label, type) {
+    const wrapper = dom.createElement('label');
+    wrapper.textContent = label;
+    const control = dom.createElement('input');
+    control.type = type;
+    control.required = true;
+    wrapper.append(control);
+    return { wrapper, input: control };
+}
+function redactFingerprint(value) {
+    if (value === null || value.length <= 12)
+        return value ?? '未知';
+    return `${value.slice(0, 8)}...${value.slice(-4)}`;
+}
+//# sourceMappingURL=peer-host-management-panel.js.map

package/data/build/dist/client/peer-host-native-session-ui.d.ts

@@ -0,0 +1,60 @@
+import type { AggregateHostResult, HostScope } from '../shared/contracts/peer-host.js';
+import type { PeerHostEventSocketFactory, PeerHostScopedClient } from './peer-host-scoped-client.js';
+import type { PeerHostSessionController } from './peer-host-session-controller.js';
+export declare const PEER_HOST_NAVIGATION_ATTRIBUTE = "data-codingns-peer-host-navigation";
+export declare const PEER_HOST_SESSION_ATTRIBUTE = "data-codingns-peer-host-session";
+export declare const PEER_HOST_STATUS_ATTRIBUTE = "data-codingns-peer-host-status";
+export type PeerHostNativeUiStatus = 'ready' | 'degraded' | 'unavailable';
+export interface PeerHostNativeUiState {
+    readonly status: PeerHostNativeUiStatus;
+    readonly reason: string;
+}
+export interface PeerHostNativeNavigationOptions {
+    readonly document?: Document;
+    readonly controller: PeerHostSessionController;
+    readonly onSelect?: (scope: HostScope) => void | Promise<void>;
+    readonly onStatus?: (state: PeerHostNativeUiState) => void;
+}
+export interface PeerHostNativeNavigationController {
+    refresh(results: readonly AggregateHostResult[]): void;
+    setStatus(state: PeerHostNativeUiState): void;
+    dispose(): void;
+    readonly state: PeerHostNativeUiState;
+}
+/** 仅探测，不修改 DOM；供能力诊断和版本 fixture 使用。 */
+export declare function probePeerHostNativeNavigation(dom?: Document): PeerHostNativeUiState;
+/** 仅探测会话容器，不触发请求。 */
+export declare function probePeerHostNativeSession(dom?: Document): PeerHostNativeUiState;
+/**
+ * 将聚合导航挂到 DSH 已声明的 tree 容器。
+ *
+ * 这里不猜 React Fiber 或版本专属 class。只有同时存在 tree 和至少一个
+ * treeitem 才认为原生导航扩展点可用；否则保留明确的降级状态，不创建伪造
+ * 的工作区数据。
+ */
+export declare function startPeerHostNativeNavigation(options: PeerHostNativeNavigationOptions): PeerHostNativeNavigationController;
+export interface PeerHostNativeSessionOptions {
+    readonly document?: Document;
+    readonly controller: PeerHostSessionController;
+    readonly client: PeerHostScopedClient;
+    readonly socketFactory?: PeerHostEventSocketFactory;
+    readonly onStatus?: (state: PeerHostNativeUiState) => void;
+}
+export interface PeerHostNativeSessionController {
+    open(scope: HostScope): Promise<void>;
+    close(): void;
+    send(body: string): Promise<void>;
+    stop(): Promise<void>;
+    replyPermission(body: string): Promise<void>;
+    answerQuestion(body: string): Promise<void>;
+    readonly state: PeerHostNativeUiState;
+}
+/**
+ * 远端会话的原生三栏适配器。
+ *
+ * DSH 目前没有公开的 HostScope 会话 store 注入点，因此消息先落到当前
+ * conversation 容器中的插件节点。这个节点与原生布局同层渲染，明确标记
+ * 来源和作用域；若容器探测失败则报告 degraded，不把 iframe 当作原生 UI。
+ */
+export declare function startPeerHostNativeSession(options: PeerHostNativeSessionOptions): PeerHostNativeSessionController;
+//# sourceMappingURL=peer-host-native-session-ui.d.ts.map