@jingyi0605/codingns4dsh 0.1.0

package/data/build/dist/client/features/cli-adapters.js

@@ -0,0 +1,215 @@
+import { createElement, useEffect, useState } from 'react';
+import { archiveCliSession, callCliRpc, errorMessage, listCliSessions, restoreCliSession } from '../cli-catalog.js';
+import { dshFormRootStyle, dshPopupSurfaceStyle, dshSettingsButtonStyle, dshSettingsListRowStyle, dshThemeColor } from '../theme.js';
+import { useCodingNsTranslator } from '../locale.js';
+import { registerExternalToolStreamUi } from '../external-tool-stream.js';
+/** 外部 Agent 集成模块。Agent 进程在 Host 运行，浏览器只读取目录和状态。 */
+export const cliAdaptersFeature = {
+    descriptor: {
+        name: 'cliAdapters',
+        version: '0.1.0',
+        enabledByDefault: true,
+        dependencies: [],
+        runtime: 'client',
+        ui: {
+            label: '外部Agent集成',
+            description: '查看外部 Agent 的安装状态、版本、命令路径和可用模型，并单独启用或停用。',
+            labelKey: 'feature.cliAdapters.label',
+            descriptionKey: 'feature.cliAdapters.description',
+            order: 30,
+            defaultOpen: true,
+        },
+    },
+    start: async (context) => {
+        const slots = context.services.slots;
+        if (slots === undefined)
+            return;
+        context.resources.add(registerExternalToolStreamUi(context.services));
+        // CLI Slot 带有浏览器图片资源，启用模块时再加载，避免 Node 侧读取 Client 元数据时解析图片。
+        const { registerCliConversationSlots } = await import('../cli-slots.js');
+        const disposeSlots = registerCliConversationSlots(slots, context.services.rpc, context.services.locale);
+        context.resources.add(disposeSlots);
+    },
+    settingsPanel: CliAdaptersPanel,
+};
+/** 设置页中的 Agent 列表和详情模态框。 */
+export function CliAdaptersPanel({ services, enabled }) {
+    const t = useCodingNsTranslator(services.locale);
+    const [catalog, setCatalog] = useState([]);
+    const [selected, setSelected] = useState(null);
+    const [models, setModels] = useState(null);
+    const [loading, setLoading] = useState(false);
+    const [busyAdapterId, setBusyAdapterId] = useState(null);
+    const [sessions, setSessions] = useState([]);
+    const [sessionsLoading, setSessionsLoading] = useState(false);
+    const [restoringSessionId, setRestoringSessionId] = useState(null);
+    const [archivingSessionId, setArchivingSessionId] = useState(null);
+    const [message, setMessage] = useState('');
+    const disabled = !enabled;
+    useEffect(() => {
+        if (disabled)
+            return;
+        let active = true;
+        setLoading(true);
+        void callCliRpc(services.rpc, 'catalog', {})
+            .then((value) => { if (active)
+            setCatalog(value); })
+            .catch((error) => { if (active)
+            setMessage(errorMessage(error)); })
+            .finally(() => { if (active)
+            setLoading(false); });
+        return () => { active = false; };
+    }, [disabled, services.rpc]);
+    useEffect(() => {
+        if (disabled) {
+            setSessions([]);
+            return;
+        }
+        let active = true;
+        setSessionsLoading(true);
+        void listCliSessions(services.rpc)
+            .then((value) => { if (active)
+            setSessions(value); })
+            .catch((error) => { if (active)
+            setMessage(errorMessage(error)); })
+            .finally(() => { if (active)
+            setSessionsLoading(false); });
+        return () => { active = false; };
+    }, [disabled, services.rpc]);
+    useEffect(() => {
+        if (selected === null || disabled || !selected.installed || !selected.enabled) {
+            setModels(null);
+            return;
+        }
+        let active = true;
+        setModels(null);
+        setMessage('');
+        void callCliRpc(services.rpc, 'models', { adapterId: selected.id })
+            .then((value) => { if (active)
+            setModels(value); })
+            .catch((error) => { if (active)
+            setMessage(errorMessage(error)); });
+        return () => { active = false; };
+    }, [disabled, selected, services.rpc]);
+    const rowStyle = dshSettingsListRowStyle;
+    const buttonStyle = { ...dshSettingsButtonStyle, cursor: disabled ? 'not-allowed' : 'pointer' };
+    const toggleAdapter = async (adapter, next) => {
+        setBusyAdapterId(adapter.id);
+        setMessage('');
+        try {
+            await callCliRpc(services.rpc, 'adapter/set', { adapterId: adapter.id, enabled: next });
+            const refreshed = await callCliRpc(services.rpc, 'catalog', {});
+            setCatalog(refreshed);
+        }
+        catch (error) {
+            setMessage(errorMessage(error));
+        }
+        finally {
+            setBusyAdapterId(null);
+        }
+    };
+    const restoreSession = async (record) => {
+        setRestoringSessionId(record.dshSessionId);
+        setMessage('');
+        try {
+            await restoreCliSession(services.rpc, record);
+        }
+        catch (error) {
+            setMessage(errorMessage(error));
+        }
+        finally {
+            setRestoringSessionId(null);
+        }
+    };
+    const archiveSession = async (record) => {
+        setArchivingSessionId(record.dshSessionId);
+        setMessage('');
+        try {
+            await archiveCliSession(services.rpc, record.dshSessionId);
+            setSessions((current) => current.filter((item) => item.dshSessionId !== record.dshSessionId));
+        }
+        catch (error) {
+            setMessage(errorMessage(error));
+        }
+        finally {
+            setArchivingSessionId(null);
+        }
+    };
+    return createElement('div', { 'aria-disabled': disabled, style: { ...dshFormRootStyle, opacity: disabled ? 0.5 : 1, pointerEvents: disabled ? 'none' : 'auto' } }, loading && createElement('div', { role: 'status' }, t('cli.readingAgents')), !loading && catalog.length === 0 && createElement('div', { role: 'status', style: { opacity: 0.7 } }, t('cli.noAgents')), createElement('div', undefined, ...catalog.map((adapter) => createElement('div', { key: adapter.id, style: rowStyle }, createElement('button', {
+        type: 'button',
+        onClick: () => setSelected(adapter),
+        style: { flex: '1 1 auto', minWidth: 0, display: 'flex', alignItems: 'center', gap: 12, padding: 0, border: 0, color: 'inherit', textAlign: 'left', background: 'transparent', cursor: 'pointer' },
+        'aria-label': t('cli.viewDetails', { name: adapter.name }),
+    }, createElement('span', { style: { flex: '1 1 auto', minWidth: 0, fontWeight: 600 } }, adapter.name), createElement('span', { style: { color: adapter.installed ? dshThemeColor.success : dshThemeColor.labelTertiary } }, adapter.installed ? t('cli.installed') : t('cli.notInstalled')), createElement('span', { style: { minWidth: 70, color: dshThemeColor.labelTertiary } }, adapter.version ?? t('cli.notDetectedVersion'))), createElement('label', { style: { display: 'inline-flex', alignItems: 'center', gap: 6, flex: '0 0 auto' } }, createElement('input', { type: 'checkbox', role: 'switch', 'aria-label': t('cli.adapterToggle', { name: adapter.name }), checked: adapter.enabled, disabled: !adapter.installed || busyAdapterId === adapter.id, onChange: (event) => { void toggleAdapter(adapter, event.currentTarget.checked); }, style: { accentColor: dshThemeColor.accent } }), createElement('span', undefined, adapter.enabled ? t('cli.enabled') : t('cli.disabled')))))), createElement(CliSessionList, {
+        sessions,
+        loading: sessionsLoading,
+        restoringSessionId,
+        archivingSessionId,
+        onRestore: (record) => { void restoreSession(record); },
+        onArchive: (record) => { void archiveSession(record); },
+        t,
+    }), message && createElement('div', { role: 'alert', style: { marginTop: 10, color: dshThemeColor.error } }, message), selected !== null && createElement(AdapterDetailsDialog, {
+        adapter: selected,
+        models,
+        loading: selected.installed && selected.enabled && models === null && !message,
+        onClose: () => setSelected(null),
+        buttonStyle,
+        t,
+    }));
+}
+/** 外部会话索引入口；打开后交给 DSH 原生会话页面渲染消息。 */
+function CliSessionList({ sessions, loading, restoringSessionId, archivingSessionId, onRestore, onArchive, t }) {
+    return createElement('section', { 'aria-labelledby': 'codingns-cli-session-title', style: { marginTop: 20 } }, createElement('h4', { id: 'codingns-cli-session-title', style: { margin: '0 0 8px' } }, t('cli.sessions')), loading && createElement('div', { role: 'status' }, t('cli.readingSessions')), !loading && sessions.length === 0 && createElement('div', { style: { opacity: 0.7 } }, t('cli.noSessions')), !loading && sessions.length > 0 && createElement('div', { style: { display: 'flex', flexDirection: 'column', gap: 6 } }, ...sessions.map((record) => createElement('div', {
+        key: record.dshSessionId,
+        style: { display: 'flex', alignItems: 'center', gap: 10, padding: '8px 0', borderTop: `1px solid ${dshThemeColor.border}` },
+    }, createElement('div', { style: { flex: '1 1 auto', minWidth: 0 } }, createElement('div', { style: { overflow: 'hidden', textOverflow: 'ellipsis', whiteSpace: 'nowrap', fontWeight: 600 } }, record.title ?? t('cli.session', { id: record.adapterId })), createElement('div', {
+        title: record.providerStateReason,
+        style: { marginTop: 2, color: record.providerState === 'missing' ? dshThemeColor.error : dshThemeColor.labelTertiary, fontSize: 12 },
+    }, `${record.adapterId} · ${sessionStatusLabel(record, t)}`)), createElement('button', {
+        type: 'button',
+        onClick: () => onRestore(record),
+        disabled: restoringSessionId !== null,
+        'aria-label': `${t('cli.open')} ${record.title ?? t('cli.session', { id: record.adapterId })}`,
+        style: { ...dshSettingsButtonStyle, flex: '0 0 auto', cursor: restoringSessionId === null ? 'pointer' : 'not-allowed' },
+    }, restoringSessionId === record.dshSessionId ? t('cli.opening') : t('cli.open')), record.providerState === 'missing' && createElement('button', {
+        type: 'button',
+        onClick: () => onArchive(record),
+        disabled: archivingSessionId !== null,
+        'aria-label': t('cli.removeFromSidebar', { name: record.title ?? t('cli.session', { id: record.adapterId }) }),
+        style: { ...dshSettingsButtonStyle, flex: '0 0 auto', color: dshThemeColor.error, cursor: archivingSessionId === null ? 'pointer' : 'not-allowed' },
+    }, archivingSessionId === record.dshSessionId ? t('cli.removing') : t('cli.remove'))))));
+}
+function sessionStatusLabel(record, t) {
+    if (record.providerState === 'missing')
+        return t('cli.statusMissing');
+    if (record.providerState === 'corrupt')
+        return t('cli.statusCorrupt');
+    if (record.providerState === 'unreachable')
+        return t('cli.statusUnreachable');
+    if (record.providerState === 'ephemeral')
+        return t('cli.statusEphemeral');
+    if (record.status === 'active')
+        return t('cli.statusActive');
+    if (record.status === 'error')
+        return t('cli.statusError');
+    if (record.status === 'archived')
+        return t('cli.statusArchived');
+    return t('cli.statusPaused');
+}
+function AdapterDetailsDialog({ adapter, models, loading, onClose, buttonStyle, t }) {
+    return createElement('div', {
+        role: 'dialog',
+        'aria-modal': true,
+        'aria-labelledby': 'codingns-cli-adapter-title',
+        style: { position: 'fixed', inset: 0, zIndex: 1000, display: 'flex', alignItems: 'center', justifyContent: 'center', padding: 24, background: dshThemeColor.overlay },
+    }, createElement('div', { style: { ...dshPopupSurfaceStyle, width: 'min(100%, 620px)', maxHeight: 'min(720px, 90vh)', overflow: 'auto', boxSizing: 'border-box', padding: 24, borderRadius: 8 } }, createElement('div', { style: { display: 'flex', alignItems: 'center', justifyContent: 'space-between', gap: 12 } }, createElement('h3', { id: 'codingns-cli-adapter-title', style: { margin: 0, fontSize: 18 } }, adapter.name), createElement('button', { type: 'button', onClick: onClose, style: buttonStyle, 'aria-label': t('cli.closeDetails') }, t('cli.closeDetails'))), createElement('dl', { style: { display: 'grid', gridTemplateColumns: 'max-content 1fr', gap: '8px 16px', margin: '20px 0' } }, createElement('dt', undefined, t('cli.installStatus')), createElement('dd', { style: { margin: 0 } }, adapter.installed ? t('cli.installed') : t('cli.notInstalled')), createElement('dt', undefined, t('cli.enabledStatus')), createElement('dd', { style: { margin: 0 } }, adapter.enabled ? t('cli.enabled') : t('cli.disabled')), createElement('dt', undefined, t('cli.version')), createElement('dd', { style: { margin: 0 } }, adapter.version ?? t('cli.notDetectedVersion')), createElement('dt', undefined, t('cli.commandPath')), createElement('dd', { style: { margin: 0, overflowWrap: 'anywhere' } }, adapter.command ?? t('cli.notDetectedCommand')), createElement('dt', undefined, t('cli.protocol')), createElement('dd', { style: { margin: 0 } }, adapter.protocol ?? t('cli.undeclared')), createElement('dt', undefined, t('cli.capabilities')), createElement('dd', { style: { margin: 0, overflowWrap: 'anywhere' } }, adapter.capabilities?.join('、') ?? t('cli.undeclared'))), createElement('h4', { style: { margin: '16px 0 8px' } }, t('cli.modelCatalog')), !adapter.installed && createElement('div', { style: { opacity: 0.7 } }, t('cli.agentNotInstalled')), adapter.installed && !adapter.enabled && createElement('div', { style: { opacity: 0.7 } }, t('cli.agentDisabled')), adapter.installed && loading && createElement('div', { role: 'status' }, t('cli.readingModels')), adapter.installed && !loading && models !== null && createElement(ModelCatalog, { catalog: models, t }), createElement('div', { style: { display: 'flex', justifyContent: 'flex-end', marginTop: 20 } }, createElement('button', { type: 'button', onClick: onClose, style: buttonStyle }, t('cli.done')))));
+}
+function ModelCatalog({ catalog, t }) {
+    if (catalog.groups.length === 0)
+        return createElement('div', { style: { opacity: 0.7 } }, t('cli.noModels'));
+    return createElement('div', { style: { display: 'flex', flexDirection: 'column', gap: 14 } }, ...catalog.groups.map((group) => createElement('section', { key: group.id }, createElement('strong', undefined, group.name), createElement('div', { style: { display: 'flex', flexDirection: 'column', gap: 6, marginTop: 6 } }, ...group.models.map((model) => createElement(ModelRow, { key: model.id, model, t }))))));
+}
+function ModelRow({ model, t }) {
+    return createElement('div', { style: { padding: '8px 10px', border: `1px solid ${dshThemeColor.border}`, borderRadius: 6 } }, createElement('div', { style: { fontWeight: 600 } }, model.name), model.description && createElement('div', { style: { marginTop: 3, opacity: 0.7, fontSize: 13 } }, model.description), createElement('div', { style: { marginTop: 5, opacity: 0.7, fontSize: 13 } }, t('cli.thinkingLevel', { value: model.efforts.length > 0 ? model.efforts.join('、') : t('cli.defaultEffort') })));
+}
+//# sourceMappingURL=cli-adapters.js.map

package/data/build/dist/client/features/debug.d.ts

@@ -0,0 +1,4 @@
+import type { CodingNsClientFeatureModule } from './types.js';
+/** 工作区调试面板模块；开关关闭时同时移除 Sidebar 标签和注入内容。 */
+export declare const debugFeature: CodingNsClientFeatureModule;
+//# sourceMappingURL=debug.d.ts.map

package/data/build/dist/client/features/debug.js

@@ -0,0 +1,24 @@
+import { registerDebugUi } from '../debug/ui.js';
+/** 工作区调试面板模块；开关关闭时同时移除 Sidebar 标签和注入内容。 */
+export const debugFeature = {
+    descriptor: {
+        name: 'debug',
+        version: '0.1.0',
+        enabledByDefault: true,
+        dependencies: [],
+        runtime: 'client',
+        ui: {
+            label: '工作区调试',
+            description: '按 Workspace 配置启动终端、检查端口并访问指定服务。',
+            order: 35,
+            defaultOpen: true,
+        },
+    },
+    start(context) {
+        const uiContext = context.services.uiContext;
+        if (uiContext === undefined)
+            throw new Error('工作区调试模块缺少 DSH UI 上下文');
+        context.resources.add(registerDebugUi(uiContext, context.services.rpc, context.services.remote));
+    },
+};
+//# sourceMappingURL=debug.js.map

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

@@ -0,0 +1,33 @@
+import type { FeatureRegistry } from '../../features/registry.js';
+import type { FeatureUiDescriptor } from '../../shared/contracts/feature.js';
+import { lanAccessFeature } from './lan-access.js';
+import { reverseProxyFeature } from './reverse-proxy.js';
+import { loginProtectionFeature } from './login-protection.js';
+import { cliAdaptersFeature } from './cli-adapters.js';
+import { terminalEnhancementFeature } from './terminal-enhancement.js';
+import { workspaceSessionEnhancementFeature } from './workspace-session-enhancement.js';
+import { debugFeature } from './debug.js';
+import type { CodingNsClientFeatureModule, CodingNsClientServices } from './types.js';
+/** Client 侧功能模块清单：新增模块在这里登记一行，不需要改动设置页和入口。 */
+export declare const CLIENT_FEATURES: readonly CodingNsClientFeatureModule[];
+/** 设置页要显示的一个模块及其界面描述。 */
+export interface CodingNsSettingsModule {
+    readonly module: CodingNsClientFeatureModule;
+    readonly ui: FeatureUiDescriptor;
+}
+/**
+ * 汇总需要在设置页显示的模块，按 ui.order 升序。
+ *
+ * 归属 Host 的模块由 Host 侧配置承载，这里跳过；没有 ui 描述的模块不显示。
+ */
+export declare function settingsModules(registry: FeatureRegistry<CodingNsClientServices, CodingNsClientFeatureModule>): readonly CodingNsSettingsModule[];
+export { lanAccessFeature, loginProtectionFeature, reverseProxyFeature, cliAdaptersFeature, workspaceSessionEnhancementFeature, terminalEnhancementFeature, debugFeature };
+export { startBrowserRelayConnection } from './reverse-proxy.js';
+export { LanAccessPanel } from './lan-access-panel.js';
+export { LoginProtectionPanel } from './login-protection-panel.js';
+export { ReverseProxyPanel } from './reverse-proxy-panel.js';
+export { CliAdaptersPanel } from './cli-adapters.js';
+export { TerminalEnhancementPanel } from './terminal-enhancement-panel.js';
+export { WorkspaceSessionEnhancementPanel } from './workspace-session-enhancement-panel.js';
+export type { CodingNsClientFeatureModule, CodingNsClientServices, CodingNsRpcClient, CodingNsRpcResult, FeaturePanelProps, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,44 @@
+import { lanAccessFeature } from './lan-access.js';
+import { reverseProxyFeature } from './reverse-proxy.js';
+import { loginProtectionFeature } from './login-protection.js';
+import { cliAdaptersFeature } from './cli-adapters.js';
+import { terminalEnhancementFeature } from './terminal-enhancement.js';
+import { workspaceSessionEnhancementFeature } from './workspace-session-enhancement.js';
+import { debugFeature } from './debug.js';
+/** Client 侧功能模块清单：新增模块在这里登记一行，不需要改动设置页和入口。 */
+export const CLIENT_FEATURES = [
+    lanAccessFeature,
+    loginProtectionFeature,
+    reverseProxyFeature,
+    cliAdaptersFeature,
+    workspaceSessionEnhancementFeature,
+    terminalEnhancementFeature,
+    debugFeature,
+];
+/**
+ * 汇总需要在设置页显示的模块，按 ui.order 升序。
+ *
+ * 归属 Host 的模块由 Host 侧配置承载，这里跳过；没有 ui 描述的模块不显示。
+ */
+export function settingsModules(registry) {
+    const entries = [];
+    for (const module of registry.modules()) {
+        if (module.descriptor.runtime === 'host')
+            continue;
+        const ui = module.descriptor.ui;
+        if (ui === undefined)
+            continue;
+        entries.push({ module, ui });
+    }
+    entries.sort((left, right) => (left.ui.order ?? 0) - (right.ui.order ?? 0));
+    return entries;
+}
+export { lanAccessFeature, loginProtectionFeature, reverseProxyFeature, cliAdaptersFeature, workspaceSessionEnhancementFeature, terminalEnhancementFeature, debugFeature };
+export { startBrowserRelayConnection } from './reverse-proxy.js';
+export { LanAccessPanel } from './lan-access-panel.js';
+export { LoginProtectionPanel } from './login-protection-panel.js';
+export { ReverseProxyPanel } from './reverse-proxy-panel.js';
+export { CliAdaptersPanel } from './cli-adapters.js';
+export { TerminalEnhancementPanel } from './terminal-enhancement-panel.js';
+export { WorkspaceSessionEnhancementPanel } from './workspace-session-enhancement-panel.js';
+//# sourceMappingURL=index.js.map

package/data/build/dist/client/features/lan-access-panel.d.ts

@@ -0,0 +1,5 @@
+import type { ReactElement } from 'react';
+import type { FeaturePanelProps } from './types.js';
+/** “局域网访问DSH”设置卡片：只配置一条监听并转发到当前 DSH Web。 */
+export declare function LanAccessPanel({ services, enabled, snapshot: settingsSnapshot }: FeaturePanelProps): ReactElement;
+//# sourceMappingURL=lan-access-panel.d.ts.map

package/data/build/dist/client/features/lan-access-panel.js

@@ -0,0 +1,146 @@
+import { createElement, useEffect, useState } from 'react';
+import { CODINGNS_RPC_CHANNEL } from '../../shared/contracts/transport.js';
+import { dshFormRootStyle, dshSettingsButtonStyle, dshSettingsFieldLabelStyle, dshSettingsFieldStyle, dshSettingsNoteStyle, dshSettingsPrimaryButtonStyle, dshSettingsRowStyle, dshThemeColor, } from '../theme.js';
+import { useCodingNsTranslator } from '../locale.js';
+/** “局域网访问DSH”设置卡片：只配置一条监听并转发到当前 DSH Web。 */
+export function LanAccessPanel({ services, enabled, snapshot: settingsSnapshot }) {
+    const { rpc, settings } = services;
+    const t = useCodingNsTranslator(services.locale);
+    const [savedSettings, setSavedSettings] = useState();
+    const disabled = !enabled;
+    const controlsDisabled = disabled || settingsSnapshot.status === 'loading' || !settingsSnapshot.writable;
+    const [listenHosts, setListenHosts] = useState(['0.0.0.0']);
+    const [listenHost, setListenHost] = useState('0.0.0.0');
+    const [listenPort, setListenPort] = useState('13080');
+    const [dshPort, setDshPort] = useState('');
+    const [autoStart, setAutoStart] = useState(false);
+    const [detectedDshPorts, setDetectedDshPorts] = useState([]);
+    const [snapshot, setSnapshot] = useState(null);
+    const [busy, setBusy] = useState(false);
+    const [message, setMessage] = useState('');
+    useEffect(() => {
+        if (disabled)
+            return;
+        void callRpc(rpc, 'lanAccessDsh/addresses', {})
+            .then((addresses) => {
+            setListenHosts(addresses);
+            if (!addresses.includes(listenHost))
+                setListenHost(addresses[0] ?? '0.0.0.0');
+        })
+            .catch(() => undefined);
+        void callRpc(rpc, 'lanAccessDsh/get', {})
+            .then((current) => {
+            if (!current)
+                return;
+            setSnapshot(current);
+        })
+            .catch(() => undefined);
+        void callRpc(rpc, 'lanAccessDsh/settings/get', {})
+            .then(setSavedSettings)
+            .catch(() => {
+            const fallback = settings.getSnapshot().value?.lanAccessDsh;
+            if (fallback !== undefined)
+                setSavedSettings(fallback);
+        });
+    }, [disabled, rpc, settings]);
+    useEffect(() => {
+        if (savedSettings === undefined)
+            return;
+        setAutoStart(savedSettings.autoStart);
+        setListenHost(savedSettings.listenHost);
+        setListenPort(String(savedSettings.listenPort));
+        setDshPort(savedSettings.dshPort > 0 ? String(savedSettings.dshPort) : '');
+    }, [savedSettings]);
+    const run = async (operation) => {
+        setBusy(true);
+        setMessage('');
+        try {
+            await operation();
+        }
+        catch (error) {
+            setMessage(error instanceof Error ? error.message : String(error));
+        }
+        finally {
+            setBusy(false);
+        }
+    };
+    const detect = () => run(async () => {
+        const result = await callRpc(rpc, 'lanAccessDsh/detect', {});
+        setDetectedDshPorts(result.ports);
+        if (result.ports.length === 1)
+            setDshPort(String(result.ports[0]));
+        setMessage(result.ports.length === 0 ? t('lan.detectNone') : t('lan.detected', { ports: result.ports.join('、') }));
+    });
+    const saveMapping = async (nextAutoStart = autoStart) => {
+        const saved = await callRpc(rpc, 'lanAccessDsh/settings/set', readMapping(listenHost, listenPort, dshPort, nextAutoStart));
+        setSavedSettings(saved);
+    };
+    const saveMappingOnBlur = () => {
+        if (!autoStart)
+            return;
+        void saveMapping().catch((error) => {
+            setMessage(error instanceof Error ? error.message : String(error));
+        });
+    };
+    const start = () => run(async () => {
+        const saved = readMapping(listenHost, listenPort, dshPort, autoStart);
+        await saveMapping();
+        const payload = {
+            listenHost: saved.listenHost,
+            listenPort: saved.listenPort,
+            ...(saved.dshPort > 0 ? { dshPort: saved.dshPort } : {}),
+        };
+        const current = await callRpc(rpc, 'lanAccessDsh/start', payload);
+        setSnapshot(current);
+        setDshPort(String(current.dshPort));
+        setListenPort(String(current.listenPort));
+        setMessage(t('lan.started', { host: current.listenHost, port: current.actualListenPort ?? current.listenPort, dshPort: current.dshPort }));
+    });
+    const stop = () => run(async () => {
+        await callRpc(rpc, 'lanAccessDsh/stop', {});
+        setSnapshot(null);
+        setMessage(t('lan.stopped'));
+    });
+    const toggleAutoStart = () => run(async () => {
+        const next = !autoStart;
+        await saveMapping(next);
+        setAutoStart(next);
+        setMessage(next ? t('lan.autoStartOn') : t('lan.autoStartOff'));
+    });
+    const fieldStyle = dshSettingsFieldStyle;
+    const buttonStyle = dshSettingsButtonStyle;
+    return createElement('div', { 'aria-disabled': controlsDisabled, style: { ...dshFormRootStyle, display: 'flex', flexDirection: 'column', gap: 14, opacity: controlsDisabled ? 0.5 : 1, pointerEvents: controlsDisabled ? 'none' : 'auto' } }, createElement('p', { style: { margin: 0, color: dshThemeColor.labelSecondary, fontSize: 13, lineHeight: 1.5 } }, t('lan.description')), createElement('label', { style: { display: 'flex', flexDirection: 'column', gap: 6 } }, createElement('span', { style: dshSettingsFieldLabelStyle }, t('lan.listenHost')), createElement('select', { value: listenHost, disabled: controlsDisabled || busy, onChange: (event) => setListenHost(event.currentTarget.value), onBlur: saveMappingOnBlur, style: fieldStyle }, ...listenHosts.map((host) => createElement('option', { key: host, value: host }, host === '0.0.0.0' ? t('lan.allInterfaces') : host)))), createElement('label', { style: { display: 'flex', flexDirection: 'column', gap: 6 } }, createElement('span', { style: dshSettingsFieldLabelStyle }, t('lan.listenPort')), createElement('input', { type: 'number', min: 0, max: 65535, placeholder: t('lan.listenPort'), value: listenPort, disabled: controlsDisabled || busy, onChange: (event) => setListenPort(event.currentTarget.value), onBlur: saveMappingOnBlur, style: fieldStyle })), createElement('label', { style: { display: 'flex', flexDirection: 'column', gap: 6 } }, createElement('span', { style: dshSettingsFieldLabelStyle }, t('lan.dshPort')), createElement('div', { style: dshSettingsRowStyle }, createElement('input', { type: 'number', min: 1, max: 65535, placeholder: t('lan.dshPort'), value: dshPort, disabled: controlsDisabled || busy, onChange: (event) => setDshPort(event.currentTarget.value), onBlur: saveMappingOnBlur, style: { ...fieldStyle, flex: 1, minWidth: 0 } }), createElement('button', { type: 'button', disabled: controlsDisabled || busy, onClick: () => void detect(), style: buttonStyle }, t('lan.detect')))), detectedDshPorts.length > 1 && createElement('div', { style: dshSettingsNoteStyle }, t('lan.detectMultiple', { ports: detectedDshPorts.join('、') })), createElement('label', { style: { display: 'flex', alignItems: 'center', gap: 8, cursor: controlsDisabled || busy ? 'not-allowed' : 'pointer', color: dshThemeColor.labelSecondary, fontSize: 13 } }, createElement('input', { type: 'checkbox', checked: autoStart, disabled: controlsDisabled || busy, onChange: () => void toggleAutoStart(), style: { accentColor: dshThemeColor.accent } }), createElement('span', undefined, t('lan.autoStart'))), createElement('div', { style: dshSettingsRowStyle }, createElement('button', { type: 'button', disabled: controlsDisabled || busy || !listenPort, onClick: () => void start(), style: { ...dshSettingsPrimaryButtonStyle, flex: 1 } }, busy ? t('lan.processing') : snapshot ? t('lan.update') : t('lan.start')), snapshot && createElement('button', { type: 'button', disabled: controlsDisabled || busy, onClick: () => void stop(), style: buttonStyle }, t('lan.stop'))), snapshot && createElement('div', { role: 'status', style: dshSettingsNoteStyle }, t('lan.forwarding', { host: snapshot.listenHost, port: snapshot.actualListenPort ?? snapshot.listenPort, dshPort: snapshot.dshPort })), message && createElement('div', { role: 'status', style: { color: message.includes('已') ? dshThemeColor.success : dshThemeColor.error } }, message));
+}
+function readMapping(listenHost, listenPort, dshPort, autoStart) {
+    return {
+        autoStart,
+        listenHost,
+        listenPort: parsePort(listenPort, '监听端口', true),
+        dshPort: dshPort.trim() === '' ? 0 : parsePort(dshPort, 'DSH 本地端口', false),
+    };
+}
+function parsePort(value, field, allowZero) {
+    if (!/^\d+$/u.test(value))
+        throw new Error(`${field} 必须是数字`);
+    const port = Number(value);
+    const minimum = allowZero ? 0 : 1;
+    if (!Number.isInteger(port) || port < minimum || port > 65535)
+        throw new Error(`${field} 必须是 ${minimum} 到 65535 的整数`);
+    return port;
+}
+async function callRpc(rpc, endpoint, payload) {
+    let response;
+    try {
+        response = 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;
+        response = await rpc.call('/api', `codingns/${endpoint}`, payload);
+    }
+    if (!response.ok)
+        throw new Error(response.error.message);
+    return response.value;
+}
+//# sourceMappingURL=lan-access-panel.js.map

package/data/build/dist/client/features/lan-access.d.ts

@@ -0,0 +1,9 @@
+import type { CodingNsClientFeatureModule } from './types.js';
+/**
+ * 局域网访问DSH模块。
+ *
+ * 入口加载时会补齐 `crypto.randomUUID`（见 client/index.ts）；设置面板另外承载
+ * 监听转发配置。它的 start 是幂等的，重复执行不会覆盖浏览器原生实现。
+ */
+export declare const lanAccessFeature: CodingNsClientFeatureModule;
+//# sourceMappingURL=lan-access.d.ts.map

package/data/build/dist/client/features/lan-access.js

@@ -0,0 +1,30 @@
+import { ensureCryptoRandomUUID } from '../lan-access.js';
+import { LanAccessPanel } from './lan-access-panel.js';
+/**
+ * 局域网访问DSH模块。
+ *
+ * 入口加载时会补齐 `crypto.randomUUID`（见 client/index.ts）；设置面板另外承载
+ * 监听转发配置。它的 start 是幂等的，重复执行不会覆盖浏览器原生实现。
+ */
+export const lanAccessFeature = {
+    descriptor: {
+        name: 'lanAccess',
+        version: '0.1.0',
+        enabledByDefault: true,
+        dependencies: [],
+        runtime: 'client',
+        ui: {
+            label: '局域网访问DSH',
+            description: '通过局域网 IP 访问 DSH，自动补齐 crypto.randomUUID，并将监听端口转发到当前 DSH Web。',
+            labelKey: 'feature.lanAccess.label',
+            descriptionKey: 'feature.lanAccess.description',
+            order: 10,
+            alwaysEnabled: true,
+        },
+    },
+    start: () => {
+        ensureCryptoRandomUUID();
+    },
+    settingsPanel: LanAccessPanel,
+};
+//# sourceMappingURL=lan-access.js.map

package/data/build/dist/client/features/login-protection-panel.d.ts

@@ -0,0 +1,5 @@
+import type { ReactElement } from 'react';
+import type { FeaturePanelProps } from './types.js';
+/** 独立的登录保护设置卡片，凭据实际由 Host 保存和校验。 */
+export declare function LoginProtectionPanel({ services, enabled, snapshot }: FeaturePanelProps): ReactElement;
+//# sourceMappingURL=login-protection-panel.d.ts.map

package/data/build/dist/client/features/login-protection-panel.js

@@ -0,0 +1,91 @@
+import { createElement, useEffect, useState } from 'react';
+import { CODINGNS_RPC_CHANNEL } from '../../shared/contracts/transport.js';
+import { dshFormRootStyle, dshSettingsButtonStyle, dshSettingsFieldLabelStyle, dshSettingsFieldStyle, dshSettingsNoteStyle, dshSettingsPrimaryButtonStyle, dshThemeColor, } from '../theme.js';
+import { writeLoginProtectionSession } from './login-protection-session.js';
+const DEFAULT_SCOPES = { lan: true, relay: true };
+/** 独立的登录保护设置卡片，凭据实际由 Host 保存和校验。 */
+export function LoginProtectionPanel({ services, enabled, snapshot }) {
+    const { rpc } = services;
+    const controlsDisabled = !enabled || snapshot.status === 'loading' || !snapshot.writable;
+    const [saved, setSaved] = useState({ enabled: false, username: '', passwordConfigured: false, timeoutSeconds: 1800, scopes: DEFAULT_SCOPES });
+    const [active, setActive] = useState(false);
+    const [username, setUsername] = useState('');
+    const [password, setPassword] = useState('');
+    const [timeoutSeconds, setTimeoutSeconds] = useState('1800');
+    const [scopes, setScopes] = useState(DEFAULT_SCOPES);
+    const [busy, setBusy] = useState(false);
+    const [message, setMessage] = useState('');
+    useEffect(() => {
+        if (!enabled)
+            return;
+        void callRpc(rpc, 'lanAccessDsh/login/get', {})
+            .then((value) => {
+            setSaved(value);
+            setActive(value.enabled);
+            setUsername(value.username);
+            setTimeoutSeconds(String(value.timeoutSeconds));
+            setScopes(value.scopes ?? DEFAULT_SCOPES);
+        })
+            .catch((error) => setMessage(error instanceof Error ? error.message : String(error)));
+    }, [enabled, rpc]);
+    const save = async () => {
+        setBusy(true);
+        setMessage('');
+        try {
+            const parsedTimeout = Number(timeoutSeconds);
+            if (!Number.isInteger(parsedTimeout) || parsedTimeout < 60 || parsedTimeout > 604800)
+                throw new Error('会话超时时间必须是 60 到 604800 秒');
+            if (active && !Object.values(scopes).some(Boolean))
+                throw new Error('至少选择一个应用范围');
+            const value = await callRpc(rpc, 'lanAccessDsh/login/set', {
+                enabled: active,
+                username,
+                password,
+                timeoutSeconds: parsedTimeout,
+                scopes,
+            });
+            setSaved(value);
+            setActive(value.enabled);
+            if (value.relaySession?.token !== undefined) {
+                writeLoginProtectionSession(value.relaySession.token);
+            }
+            else if (!value.enabled || !value.scopes.relay) {
+                writeLoginProtectionSession(undefined);
+            }
+            setPassword('');
+            setMessage(value.enabled && value.scopes.relay && password === '' ? '设置已保存；中继访问需要重新输入密码以建立当前标签页会话' : '登录保护设置已保存');
+        }
+        catch (error) {
+            setMessage(error instanceof Error ? error.message : String(error));
+        }
+        finally {
+            setBusy(false);
+        }
+    };
+    const toggleScope = (scope) => setScopes((current) => ({ ...current, [scope]: !current[scope] }));
+    const field = dshSettingsFieldStyle;
+    const button = dshSettingsButtonStyle;
+    return createElement('div', {
+        style: { ...dshFormRootStyle, display: 'flex', flexDirection: 'column', gap: 14, opacity: controlsDisabled ? 0.5 : 1 },
+        'aria-disabled': controlsDisabled,
+    }, createElement('p', { style: { margin: 0, color: dshThemeColor.labelSecondary, fontSize: 13, lineHeight: 1.5 } }, '为局域网和中继访问统一增加本地账号验证。本机 127.0.0.1 / ::1 永远不受此保护。密码只在 Host 侧验证，不会进入浏览器设置或 URL。'), createElement('label', { style: { display: 'flex', alignItems: 'center', gap: 8, color: dshThemeColor.labelSecondary, fontSize: 13 } }, createElement('input', { type: 'checkbox', checked: active, disabled: controlsDisabled || busy, onChange: (event) => setActive(event.currentTarget.checked), style: { accentColor: dshThemeColor.accent } }), createElement('span', undefined, '启用登录保护')), createElement('label', { style: { display: 'flex', flexDirection: 'column', gap: 6 } }, createElement('span', { style: dshSettingsFieldLabelStyle }, '本地用户名'), createElement('input', { value: username, disabled: controlsDisabled || busy || !active, autoComplete: 'username', onChange: (event) => setUsername(event.currentTarget.value), style: field })), createElement('label', { style: { display: 'flex', flexDirection: 'column', gap: 6 } }, createElement('span', { style: dshSettingsFieldLabelStyle }, saved.passwordConfigured ? '新密码（留空保持不变）' : '密码（至少 8 位）'), createElement('input', { type: 'password', value: password, disabled: controlsDisabled || busy || !active, autoComplete: 'new-password', onChange: (event) => setPassword(event.currentTarget.value), style: field })), createElement('label', { style: { display: 'flex', flexDirection: 'column', gap: 6 } }, createElement('span', { style: dshSettingsFieldLabelStyle }, '会话超时（秒）'), createElement('input', { type: 'number', min: 60, max: 604800, value: timeoutSeconds, disabled: controlsDisabled || busy || !active, onChange: (event) => setTimeoutSeconds(event.currentTarget.value), style: field })), createElement('fieldset', { disabled: controlsDisabled || busy || !active, style: { display: 'flex', flexDirection: 'column', gap: 8, margin: 0, padding: 12, border: `1px solid ${dshThemeColor.border}`, borderRadius: 6 } }, createElement('legend', { style: dshSettingsFieldLabelStyle }, '应用范围'), ...[
+        ['lan', '局域网访问', '局域网网卡入口'],
+        ['relay', '中继访问', 'DSH-Codingns4DSH 中继'],
+    ].map(([key, label, hint]) => createElement('label', { key, style: { display: 'flex', alignItems: 'center', gap: 8, color: dshThemeColor.labelSecondary, fontSize: 13 } }, createElement('input', { type: 'checkbox', checked: scopes[key], onChange: () => toggleScope(key), style: { accentColor: dshThemeColor.accent } }), createElement('span', undefined, `${label}（${hint}）`)))), createElement('button', { type: 'button', disabled: controlsDisabled || busy, onClick: () => void save(), style: dshSettingsPrimaryButtonStyle }, busy ? '保存中…' : '保存登录保护'), message && createElement('div', { role: 'status', style: message.includes('已') ? { color: dshThemeColor.success } : { ...dshSettingsNoteStyle, color: dshThemeColor.error } }, message));
+}
+async function callRpc(rpc, endpoint, payload) {
+    let response;
+    try {
+        response = 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;
+        response = await rpc.call('/api', `codingns/${endpoint}`, payload);
+    }
+    if (!response.ok)
+        throw new Error(response.error.message);
+    return response.value;
+}
+//# sourceMappingURL=login-protection-panel.js.map

package/data/build/dist/client/features/login-protection-session.d.ts

@@ -0,0 +1,6 @@
+/** 登录保护会话只放在当前浏览器标签页，关闭标签页即失效。 */
+export declare const LOGIN_PROTECTION_SESSION_KEY = "codingns4dsh.login-protection.relay-token";
+export declare const LOGIN_PROTECTION_SESSION_EVENT = "codingns4dsh-login-protection-session";
+export declare function readLoginProtectionSession(): string | undefined;
+export declare function writeLoginProtectionSession(token: string | undefined): void;
+//# sourceMappingURL=login-protection-session.d.ts.map