@jingyi0605/codingns4dsh 0.1.0

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

@@ -0,0 +1,25 @@
+/** 登录保护会话只放在当前浏览器标签页，关闭标签页即失效。 */
+export const LOGIN_PROTECTION_SESSION_KEY = 'codingns4dsh.login-protection.relay-token';
+export const LOGIN_PROTECTION_SESSION_EVENT = 'codingns4dsh-login-protection-session';
+let memoryToken;
+export function readLoginProtectionSession() {
+    try {
+        const value = globalThis.sessionStorage.getItem(LOGIN_PROTECTION_SESSION_KEY)?.trim();
+        return value === undefined || value === '' ? memoryToken : value;
+    }
+    catch {
+        return memoryToken;
+    }
+}
+export function writeLoginProtectionSession(token) {
+    memoryToken = token === undefined || token === '' ? undefined : token;
+    try {
+        if (memoryToken === undefined)
+            globalThis.sessionStorage.removeItem(LOGIN_PROTECTION_SESSION_KEY);
+        else
+            globalThis.sessionStorage.setItem(LOGIN_PROTECTION_SESSION_KEY, memoryToken);
+    }
+    catch { /* 浏览器隐私模式禁用存储时，使用当前页面内存中的票据。 */ }
+    globalThis.dispatchEvent(new Event(LOGIN_PROTECTION_SESSION_EVENT));
+}
+//# sourceMappingURL=login-protection-session.js.map

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

@@ -0,0 +1,4 @@
+import type { CodingNsClientFeatureModule } from './types.js';
+/** 独立的本地账号登录保护模块，位于局域网和中继访问模块之间。 */
+export declare const loginProtectionFeature: CodingNsClientFeatureModule;
+//# sourceMappingURL=login-protection.d.ts.map

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

@@ -0,0 +1,23 @@
+import { LoginProtectionPanel } from './login-protection-panel.js';
+/** 独立的本地账号登录保护模块，位于局域网和中继访问模块之间。 */
+export const loginProtectionFeature = {
+    descriptor: {
+        name: 'loginProtection',
+        version: '0.2.0',
+        enabledByDefault: true,
+        dependencies: [],
+        runtime: 'client',
+        ui: {
+            label: '登录保护',
+            description: '为局域网和中继访问设置统一的本地账号验证，本机回环地址始终放行。',
+            labelKey: 'feature.loginProtection.label',
+            descriptionKey: 'feature.loginProtection.description',
+            order: 15,
+            alwaysEnabled: true,
+            defaultOpen: true,
+        },
+    },
+    start: () => undefined,
+    settingsPanel: LoginProtectionPanel,
+};
+//# sourceMappingURL=login-protection.js.map

package/data/build/dist/client/features/reverse-proxy-panel.d.ts

@@ -0,0 +1,9 @@
+import type { ReactElement } from 'react';
+import type { FeaturePanelProps } from './types.js';
+/**
+ * 「中转访问服务」卡片的设置面板：Control API 地址、登录和 DSH 独立设备。
+ *
+ * 密码只在单次 RPC 中经过 Host，表单不保存它；refresh token 只存在于 Host。
+ */
+export declare function ReverseProxyPanel({ services, enabled, snapshot }: FeaturePanelProps): ReactElement;
+//# sourceMappingURL=reverse-proxy-panel.d.ts.map

package/data/build/dist/client/features/reverse-proxy-panel.js

@@ -0,0 +1,159 @@
+import { createElement, useEffect, useState } from 'react';
+import { CODINGNS_CONTROL_BASE_URL_FIELD, CODINGNS_CONTROL_BASE_URLS_FIELD, DEFAULT_CODINGNS_CONTROL_BASE_URLS, } from '../../shared/contracts/config.js';
+import { CODINGNS_RPC_CHANNEL } from '../../shared/contracts/transport.js';
+import { dshFormRootStyle, dshPopupSurfaceStyle, dshSettingsButtonStyle, dshSettingsFieldLabelStyle, dshSettingsFieldStyle, dshSettingsNoteStyle, dshSettingsPrimaryButtonStyle, dshSettingsRowStyle, dshThemeColor, } from '../theme.js';
+import { useCodingNsTranslator } from '../locale.js';
+/**
+ * 「中转访问服务」卡片的设置面板：Control API 地址、登录和 DSH 独立设备。
+ *
+ * 密码只在单次 RPC 中经过 Host，表单不保存它；refresh token 只存在于 Host。
+ */
+export function ReverseProxyPanel({ services, enabled, snapshot }) {
+    const { settings, rpc } = services;
+    const t = useCodingNsTranslator(services.locale);
+    const disabled = !enabled;
+    const controlsDisabled = disabled || snapshot.status === 'loading' || !snapshot.writable;
+    const [email, setEmail] = useState('');
+    const [password, setPassword] = useState('');
+    const [controlBaseUrl, setControlBaseUrl] = useState(resolveControlBaseUrl(snapshot.value?.controlBaseUrl));
+    const [controlBaseUrls, setControlBaseUrls] = useState(() => uniqueControlBaseUrls(snapshot.value?.controlBaseUrls, snapshot.value?.controlBaseUrl));
+    const [newControlBaseUrl, setNewControlBaseUrl] = useState('');
+    const [addAddressOpen, setAddAddressOpen] = useState(false);
+    const [addressError, setAddressError] = useState('');
+    const [auth, setAuth] = useState(loggedOutSnapshot());
+    const [devices, setDevices] = useState(null);
+    const [selectedDeviceId, setSelectedDeviceId] = useState('');
+    const [busy, setBusy] = useState(false);
+    const [message, setMessage] = useState('');
+    useEffect(() => {
+        const saved = snapshot.value?.controlBaseUrl;
+        const resolved = resolveControlBaseUrl(saved);
+        setControlBaseUrls(uniqueControlBaseUrls(snapshot.value?.controlBaseUrls, resolved));
+        setControlBaseUrl(resolved);
+        if (snapshot.status === 'ready' && snapshot.writable && saved !== resolved) {
+            void settings.set(CODINGNS_CONTROL_BASE_URL_FIELD, resolved).catch(() => undefined);
+        }
+    }, [settings, snapshot.status, snapshot.writable, snapshot.value?.controlBaseUrl, snapshot.value?.controlBaseUrls]);
+    useEffect(() => {
+        void callCodingNsRpc(rpc, 'auth/snapshot', {})
+            .then(setAuth)
+            .catch(() => setAuth(loggedOutSnapshot()));
+    }, [rpc]);
+    // 设置页打开时 Host 可能正在恢复登录会话；认证快照变为 authenticated
+    // 后立即刷新设备列表，避免用户必须再点一次“刷新设备”。
+    useEffect(() => {
+        if (!enabled || auth.status !== 'authenticated')
+            return;
+        void loadDevicesInternal().catch((error) => {
+            setMessage(error instanceof Error ? error.message : String(error));
+        });
+    }, [auth.status, enabled, rpc]);
+    const run = async (operation) => {
+        setBusy(true);
+        setMessage('');
+        try {
+            await operation();
+        }
+        catch (error) {
+            setMessage(error instanceof Error ? error.message : String(error));
+        }
+        finally {
+            setBusy(false);
+        }
+    };
+    const login = () => run(async () => {
+        const selectedUrl = normalizeControlBaseUrl(controlBaseUrl);
+        const nextUrls = uniqueControlBaseUrls(controlBaseUrls, selectedUrl);
+        await settings.set(CODINGNS_CONTROL_BASE_URLS_FIELD, nextUrls);
+        await settings.set(CODINGNS_CONTROL_BASE_URL_FIELD, selectedUrl);
+        const next = await callCodingNsRpc(rpc, 'auth/login', {
+            controlBaseUrl: selectedUrl,
+            email,
+            password,
+        });
+        setPassword('');
+        setAuth(next);
+        setMessage(t('relay.loginSuccess'));
+    });
+    const logout = () => run(async () => {
+        await callCodingNsRpc(rpc, 'auth/logout', {});
+        setAuth(loggedOutSnapshot());
+        setDevices(null);
+        setSelectedDeviceId('');
+        setMessage(t('relay.loggedOut'));
+    });
+    const loadDevices = () => run(async () => {
+        await loadDevicesInternal();
+    });
+    async function loadDevicesInternal() {
+        const next = await callCodingNsRpc(rpc, 'auth/dsh/device/list', {});
+        setDevices(next);
+        const preferred = next.devices.find((device) => device.online && device.status === 'active')?.dshDeviceId ?? '';
+        setSelectedDeviceId(preferred);
+    }
+    const addControlBaseUrl = async () => {
+        setBusy(true);
+        setAddressError('');
+        try {
+            const addedUrl = normalizeControlBaseUrl(newControlBaseUrl);
+            const nextUrls = uniqueControlBaseUrls(controlBaseUrls, addedUrl);
+            await settings.set(CODINGNS_CONTROL_BASE_URLS_FIELD, nextUrls);
+            await settings.set(CODINGNS_CONTROL_BASE_URL_FIELD, addedUrl);
+            setControlBaseUrls(nextUrls);
+            setControlBaseUrl(addedUrl);
+            setNewControlBaseUrl('');
+            setAddAddressOpen(false);
+            setMessage(t('relay.add'));
+        }
+        catch (error) {
+            setAddressError(error instanceof Error ? error.message : String(error));
+        }
+        finally {
+            setBusy(false);
+        }
+    };
+    const chooseControlBaseUrl = (value) => {
+        setControlBaseUrl(value);
+        void settings.set(CODINGNS_CONTROL_BASE_URL_FIELD, value).catch((error) => {
+            setMessage(error instanceof Error ? error.message : String(error));
+        });
+    };
+    const fieldStyle = dshSettingsFieldStyle;
+    const buttonStyle = dshSettingsButtonStyle;
+    const authenticated = auth.status === 'authenticated';
+    return createElement('div', { 'aria-disabled': controlsDisabled, style: { ...dshFormRootStyle, display: 'flex', flexDirection: 'column', gap: 16, opacity: controlsDisabled ? 0.5 : 1, pointerEvents: controlsDisabled ? 'none' : 'auto' } }, createElement('div', undefined, createElement('h3', { style: { margin: 0, fontSize: 17 } }, t('relay.settings')), createElement('p', { style: { margin: '6px 0 0', color: dshThemeColor.labelSecondary, fontSize: 13, lineHeight: 1.5 } }, t('relay.loginHint'))), createElement('label', { style: { display: 'flex', flexDirection: 'column', gap: 6 } }, createElement('span', { style: dshSettingsFieldLabelStyle }, t('relay.controlApi')), createElement('div', { style: dshSettingsRowStyle }, createElement('select', { value: controlBaseUrl, disabled: controlsDisabled || busy, onChange: (event) => chooseControlBaseUrl(event.currentTarget.value), style: { ...fieldStyle, flex: 1, minWidth: 0 } }, ...controlBaseUrls.map((url) => createElement('option', { key: url, value: url }, url))), createElement('button', { type: 'button', 'aria-haspopup': 'dialog', disabled: controlsDisabled || busy, onClick: () => { setAddressError(''); setAddAddressOpen(true); }, style: { ...buttonStyle, flex: '0 0 auto' } }, t('relay.add')))), addAddressOpen && createElement('div', { role: 'dialog', 'aria-modal': true, 'aria-labelledby': 'codingns-add-address-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%, 480px)', boxSizing: 'border-box', padding: 24, borderRadius: 8 } }, createElement('h3', { id: 'codingns-add-address-title', style: { margin: 0, fontSize: 18 } }, t('relay.addServer')), createElement('p', { style: { margin: '8px 0 16px', opacity: 0.7 } }, t('relay.addServerHint')), createElement('input', { type: 'url', autoFocus: true, value: newControlBaseUrl, placeholder: 'https://example.com:1443', disabled: disabled || busy, onChange: (event) => setNewControlBaseUrl(event.currentTarget.value), style: fieldStyle }), addressError && createElement('div', { role: 'alert', style: { marginTop: 8, color: dshThemeColor.error } }, addressError), createElement('div', { style: { display: 'flex', justifyContent: 'flex-end', gap: 8, marginTop: 20 } }, createElement('button', { type: 'button', disabled: busy, onClick: () => { setAddAddressOpen(false); setAddressError(''); }, style: buttonStyle }, t('relay.cancel')), createElement('button', { type: 'button', disabled: busy || !newControlBaseUrl.trim(), onClick: () => void addControlBaseUrl(), style: buttonStyle }, busy ? t('relay.adding') : t('relay.add'))))), !authenticated && createElement('form', { onSubmit: (event) => { event.preventDefault(); void login(); }, style: { display: 'flex', flexDirection: 'column', gap: 12 } }, createElement('label', { style: { display: 'flex', flexDirection: 'column', gap: 6 } }, createElement('span', { style: dshSettingsFieldLabelStyle }, t('relay.email')), createElement('input', { type: 'email', autoComplete: 'username', value: email, disabled: controlsDisabled || busy, onChange: (event) => setEmail(event.currentTarget.value), style: fieldStyle })), createElement('label', { style: { display: 'flex', flexDirection: 'column', gap: 6 } }, createElement('span', { style: dshSettingsFieldLabelStyle }, t('relay.password')), createElement('input', { type: 'password', autoComplete: 'current-password', value: password, disabled: controlsDisabled || busy, onChange: (event) => setPassword(event.currentTarget.value), style: fieldStyle })), createElement('button', { type: 'submit', disabled: controlsDisabled || busy || !controlBaseUrl || !email || !password, style: dshSettingsPrimaryButtonStyle }, busy ? t('relay.loggingIn') : t('relay.login'))), authenticated && createElement('div', { style: { display: 'flex', flexDirection: 'column', gap: 12 } }, createElement('div', { style: dshSettingsNoteStyle }, createElement('strong', undefined, auth.account?.email ?? t('relay.loggedIn')), createElement('div', { style: { marginTop: 6, opacity: 0.7 } }, t('relay.device', { value: devices?.devices.find((device) => device.dshDeviceId === selectedDeviceId)?.displayName ?? t('relay.unrecognized') })), createElement('div', { style: { marginTop: 4, opacity: 0.7 } }, t('relay.host', { value: selectedDeviceId || t('relay.unbound') }))), createElement('div', { style: { display: 'flex', gap: 8, flexWrap: 'wrap' } }, createElement('button', { type: 'button', disabled: controlsDisabled || busy, onClick: () => void loadDevices(), style: buttonStyle }, t('relay.refreshDevices')), createElement('button', { type: 'button', disabled: controlsDisabled || busy, onClick: () => void logout(), style: buttonStyle }, t('relay.logout'))), devices && createElement('div', { style: { display: 'flex', flexDirection: 'column', gap: 8 } }, createElement('strong', { style: dshSettingsFieldLabelStyle }, t('relay.dshDevices')), createElement('select', { value: selectedDeviceId, disabled: controlsDisabled || busy, onChange: (event) => setSelectedDeviceId(event.currentTarget.value), style: fieldStyle }, createElement('option', { value: '' }, t('relay.selectDevice')), ...devices.devices.map((device) => createElement('option', { key: device.dshDeviceId, value: device.dshDeviceId, disabled: !device.online || device.status !== 'active' }, `${device.displayName} · ${device.online ? t('relay.online') : t('relay.offline')}`))), createElement('div', { style: { fontSize: 13, opacity: 0.75 } }, t('relay.devicesSummary', { current: selectedDeviceId || t('relay.unknown'), count: devices.devices.length })))), message && createElement('div', { role: 'status', style: { color: message.includes('成功') ? dshThemeColor.success : dshThemeColor.error } }, message));
+}
+async function callCodingNsRpc(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;
+}
+function loggedOutSnapshot() {
+    return { status: 'logged_out', account: null, currentDevice: null, binding: null, expiresAt: null, errorCode: null };
+}
+function uniqueControlBaseUrls(saved, selected) {
+    const values = [...(saved ?? DEFAULT_CODINGNS_CONTROL_BASE_URLS), selected ?? ''];
+    return [...new Set(values.map((value) => value.trim()).filter((value) => value.length > 0))];
+}
+function resolveControlBaseUrl(value) {
+    const trimmed = value?.trim();
+    return trimmed || DEFAULT_CODINGNS_CONTROL_BASE_URLS[0] || '';
+}
+function normalizeControlBaseUrl(value) {
+    const trimmed = value.trim();
+    const parsed = new URL(trimmed);
+    if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:')
+        throw new TypeError('Control API 地址必须使用 HTTP(S)');
+    return parsed.toString().replace(/\/+$/u, '');
+}
+//# sourceMappingURL=reverse-proxy-panel.js.map

package/data/build/dist/client/features/reverse-proxy.d.ts

@@ -0,0 +1,12 @@
+import type { CodingNsClientFeatureModule } from './types.js';
+import type { CodingNsRpcClient } from './types.js';
+/**
+ * 中转访问服务模块。
+ *
+ * 它把 DSH 页面接入 DSH-Codingns4DSH 独立设备隧道。登录和设备列表由 Host RPC 提供，
+ * 连接状态和设备选择由设置面板承载；隧道本身在模块启用时建立。
+ */
+export declare const reverseProxyFeature: CodingNsClientFeatureModule;
+/** 浏览器侧真实中继连接；refresh token 和 access token 只经过 Host RPC。 */
+export declare function startBrowserRelayConnection(rpc: CodingNsRpcClient, signal: AbortSignal, loginProtectionToken?: string): Promise<() => Promise<void>>;
+//# sourceMappingURL=reverse-proxy.d.ts.map

package/data/build/dist/client/features/reverse-proxy.js

@@ -0,0 +1,112 @@
+import { ReverseProxyPanel } from './reverse-proxy-panel.js';
+import { startDshH5Bootstrap } from '../dsh-h5-bootstrap.js';
+import { LOGIN_PROTECTION_SESSION_EVENT, readLoginProtectionSession } from './login-protection-session.js';
+import { CODINGNS_RPC_CHANNEL } from '../../shared/contracts/transport.js';
+function isRemoteWebContext() {
+    return globalThis.__CODINGNS4DSH_REMOTE_WEB_CONTEXT__ === true;
+}
+/**
+ * 中转访问服务模块。
+ *
+ * 它把 DSH 页面接入 DSH-Codingns4DSH 独立设备隧道。登录和设备列表由 Host RPC 提供，
+ * 连接状态和设备选择由设置面板承载；隧道本身在模块启用时建立。
+ */
+export const reverseProxyFeature = {
+    descriptor: {
+        name: 'reverseProxy',
+        version: '0.1.0',
+        enabledByDefault: false,
+        dependencies: [],
+        runtime: 'client',
+        ui: {
+            label: '中转访问服务',
+            description: '通过 DSH-Codingns4DSH 独立设备隧道访问 Host。',
+            labelKey: 'feature.reverseProxy.label',
+            descriptionKey: 'feature.reverseProxy.description',
+            order: 20,
+            defaultOpen: true,
+        },
+    },
+    /**
+     * 隧道连接属于后续阶段，当前模块只提供配置面，因此这里不创建任何资源。
+     * 接入连接后，流与订阅必须登记到 context.resources，由停用自动清理。
+     */
+    start(context) {
+        if (isRemoteWebContext()) {
+            // 远程 DSH Web 的外层已经拥有有效 Tunnel；这里只保留设置 UI 和其它
+            // 插件贡献，禁止同一页面重新申请票据并建立第二条中继连接。
+            return () => { };
+        }
+        const abort = new AbortController();
+        let disposeConnection;
+        let retryTimer;
+        let stopped = false;
+        let waitingForLogin = false;
+        const onLoginProtectionSession = () => {
+            waitingForLogin = false;
+            void attempt();
+        };
+        globalThis.addEventListener(LOGIN_PROTECTION_SESSION_EVENT, onLoginProtectionSession);
+        const attempt = async () => {
+            if (stopped || waitingForLogin)
+                return;
+            try {
+                const protection = await readLoginProtectionSettings(context.services.rpc);
+                const loginProtectionToken = readLoginProtectionSession();
+                if (protection.enabled && protection.scopes.relay && loginProtectionToken === undefined) {
+                    waitingForLogin = true;
+                    return;
+                }
+                const dispose = await startBrowserRelayConnection(context.services.rpc, abort.signal, loginProtectionToken);
+                if (stopped || abort.signal.aborted) {
+                    await dispose();
+                    return;
+                }
+                disposeConnection = dispose;
+            }
+            catch (error) {
+                if (stopped || abort.signal.aborted)
+                    return;
+                console.error('codingns4dsh: 中继连接建立失败，将在稍后重试', error);
+                retryTimer = setTimeout(() => { void attempt(); }, 5_000);
+            }
+        };
+        void attempt();
+        return async () => {
+            stopped = true;
+            globalThis.removeEventListener(LOGIN_PROTECTION_SESSION_EVENT, onLoginProtectionSession);
+            abort.abort();
+            if (retryTimer !== undefined)
+                clearTimeout(retryTimer);
+            await disposeConnection?.();
+        };
+    },
+    settingsPanel: ReverseProxyPanel,
+};
+/** 浏览器侧真实中继连接；refresh token 和 access token 只经过 Host RPC。 */
+export async function startBrowserRelayConnection(rpc, signal, loginProtectionToken) {
+    const bootstrap = await startDshH5Bootstrap({ rpc, signal, ...(loginProtectionToken === undefined ? {} : { loginProtectionToken }) });
+    const state = globalThis;
+    state.__CODINGNS4DSH_RELAY_MODE__ = bootstrap.relayMode;
+    return async () => {
+        if (state.__CODINGNS4DSH_RELAY_MODE__ === bootstrap.relayMode)
+            delete state.__CODINGNS4DSH_RELAY_MODE__;
+        await bootstrap.dispose();
+    };
+}
+async function readLoginProtectionSettings(rpc) {
+    let response;
+    try {
+        response = await rpc.call(CODINGNS_RPC_CHANNEL, 'lanAccessDsh/login/get', {});
+    }
+    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/lanAccessDsh/login/get', {});
+    }
+    if (!response.ok)
+        throw new Error(response.error.message);
+    return response.value;
+}
+//# sourceMappingURL=reverse-proxy.js.map

package/data/build/dist/client/features/terminal-enhancement-panel.d.ts

@@ -0,0 +1,5 @@
+import type { ReactElement } from 'react';
+import type { FeaturePanelProps } from './types.js';
+/** 终端默认行为与外观设置；终端 UI 由独立 Sidebar 模块负责。 */
+export declare function TerminalEnhancementPanel({ services, enabled, snapshot }: FeaturePanelProps): ReactElement;
+//# sourceMappingURL=terminal-enhancement-panel.d.ts.map

package/data/build/dist/client/features/terminal-enhancement-panel.js

@@ -0,0 +1,160 @@
+import { createElement, useEffect, useState } from 'react';
+import { CODINGNS_TERMINAL_ENHANCEMENT_FIELD, DEFAULT_TERMINAL_ENHANCEMENT_SETTINGS, } from '../../shared/contracts/config.js';
+import { CODINGNS_RPC_CHANNEL } from '../../shared/contracts/transport.js';
+import { dshFormRootStyle, dshSettingsButtonStyle, dshSettingsFieldLabelStyle, dshSettingsFieldStyle, dshSettingsHelpStyle, dshSettingsNoteStyle, dshSettingsRowStyle, dshThemeColor, } from '../theme.js';
+import { useCodingNsTranslator } from '../locale.js';
+const profileLabels = {
+    system: 'terminal.systemRecommended',
+    zsh: 'zsh',
+    bash: 'bash',
+    powershell: 'PowerShell',
+    cmd: 'cmd',
+    'git-bash': 'Git Bash',
+};
+/** 终端默认行为与外观设置；终端 UI 由独立 Sidebar 模块负责。 */
+export function TerminalEnhancementPanel({ services, enabled, snapshot }) {
+    const t = useCodingNsTranslator(services.locale);
+    const value = snapshot.value?.terminalEnhancement ?? DEFAULT_TERMINAL_ENHANCEMENT_SETTINGS;
+    const [fontFamily, setFontFamily] = useState(value.appearance.fontFamily ?? '');
+    const [message, setMessage] = useState('');
+    const [hostStatus, setHostStatus] = useState(null);
+    const disabled = !enabled || snapshot.status === 'loading' || !snapshot.writable;
+    const customDisabled = disabled || value.appearance.theme !== 'custom';
+    useEffect(() => setFontFamily(value.appearance.fontFamily ?? ''), [value.appearance.fontFamily]);
+    useEffect(() => {
+        let active = true;
+        void callTerminalStatus(services.rpc)
+            .then((status) => { if (active)
+            setHostStatus(status); })
+            .catch((error) => {
+            if (active)
+                setMessage(error instanceof Error ? error.message : String(error));
+        });
+        return () => { active = false; };
+    }, [services.rpc]);
+    const save = (next) => {
+        setMessage('');
+        void services.settings.set(CODINGNS_TERMINAL_ENHANCEMENT_FIELD, next)
+            .then(() => setMessage(t('terminal.saved')))
+            .catch((error) => setMessage(error instanceof Error ? error.message : String(error)));
+    };
+    const updateAppearance = (patch) => {
+        save({ ...value, appearance: { ...value.appearance, ...patch } });
+    };
+    const saveFontFamily = () => {
+        try {
+            updateAppearance({ fontFamily: normalizeFontFamily(fontFamily) });
+        }
+        catch (error) {
+            setMessage(error instanceof Error ? error.message : String(error));
+        }
+    };
+    return createElement('div', {
+        'aria-disabled': disabled,
+        style: { ...dshFormRootStyle, display: 'flex', flexDirection: 'column', gap: 16, opacity: disabled ? 0.5 : 1, pointerEvents: disabled ? 'none' : 'auto' },
+    }, createElement('div', { role: 'note', style: noteStyle }, t('terminal.restartNote')), createElement('div', { role: 'status', style: noteStyle }, hostStatus === null
+        ? t('terminal.readingStatus')
+        : t('terminal.currentStatus', { status: hostStatus.effectiveEnabled ? t('terminal.enhanced') : t('terminal.basic'), platform: platformLabel(hostStatus.platform, t) })), createElement(Field, { label: t('terminal.newDefault') }, createElement('select', {
+        value: value.defaultProfile,
+        disabled,
+        onChange: (event) => save({ ...value, defaultProfile: event.currentTarget.value }),
+        style: fieldStyle,
+    }, ...profileOptions(value.defaultProfile, hostStatus, t).map((profile) => createElement('option', { key: profile.profileId, value: profile.profileId, disabled: !profile.available }, profile.label))), createElement('small', { style: helpStyle }, t('terminal.defaultProfileHelp')), hostStatus?.fallbackReason === undefined ? null : createElement('small', { style: helpStyle }, hostStatus.fallbackReason)), createElement(Field, { label: t('terminal.bindingScope') }, createElement('select', {
+        value: value.bindingScope ?? 'workspace',
+        disabled,
+        onChange: (event) => save({
+            ...value,
+            bindingScope: event.currentTarget.value === 'session' ? 'session' : 'workspace',
+        }),
+        style: fieldStyle,
+    }, createElement('option', { value: 'workspace' }, t('terminal.workspaceBinding')), createElement('option', { value: 'session' }, t('terminal.sessionBinding'))), createElement('small', { style: helpStyle }, t('terminal.workspaceBindingHelp'))), createElement(Field, { label: t('terminal.theme') }, createElement('select', {
+        value: value.appearance.theme,
+        disabled,
+        onChange: (event) => updateAppearance({ theme: event.currentTarget.value === 'custom' ? 'custom' : 'inherit' }),
+        style: fieldStyle,
+    }, createElement('option', { value: 'inherit' }, t('terminal.inheritDshTheme')), createElement('option', { value: 'custom' }, t('terminal.custom')))), createElement(ColorField, { label: t('terminal.background'), value: value.appearance.background, disabled: customDisabled, onChange: (background) => updateAppearance({ background }), inheritLabel: t('terminal.inherit'), resetLabel: t('terminal.resetInherit') }), createElement(ColorField, { label: t('terminal.foreground'), value: value.appearance.foreground, disabled: customDisabled, onChange: (foreground) => updateAppearance({ foreground }), inheritLabel: t('terminal.inherit'), resetLabel: t('terminal.resetInherit') }), createElement(ColorField, { label: t('terminal.cursorColor'), value: value.appearance.cursorColor, disabled: customDisabled, onChange: (cursorColor) => updateAppearance({ cursorColor }), inheritLabel: t('terminal.inherit'), resetLabel: t('terminal.resetInherit') }), createElement(Field, { label: t('terminal.font') }, createElement('div', { style: rowStyle }, createElement('input', {
+        type: 'text', value: fontFamily, maxLength: 128, disabled: customDisabled,
+        placeholder: t('terminal.inheritFont'),
+        onChange: (event) => setFontFamily(event.currentTarget.value),
+        onBlur: saveFontFamily,
+        style: { ...fieldStyle, flex: 1, minWidth: 0 },
+    }), createElement(ResetButton, { disabled: customDisabled || value.appearance.fontFamily === null, onClick: () => { setFontFamily(''); updateAppearance({ fontFamily: null }); }, label: t('terminal.resetInherit') }))), createElement(NumberField, { label: t('terminal.fontSize'), value: value.appearance.fontSize, min: 10, max: 32, step: 1, disabled: customDisabled, onChange: (fontSize) => updateAppearance({ fontSize }), inheritLabel: t('terminal.inherit'), resetLabel: t('terminal.resetInherit') }), createElement(NumberField, { label: t('terminal.lineHeight'), value: value.appearance.lineHeight, min: 1, max: 2, step: 0.1, disabled: customDisabled, onChange: (lineHeight) => updateAppearance({ lineHeight }), inheritLabel: t('terminal.inherit'), resetLabel: t('terminal.resetInherit') }), createElement(Field, { label: t('terminal.cursorShape') }, createElement('select', {
+        value: value.appearance.cursorStyle ?? '', disabled: customDisabled,
+        onChange: (event) => updateAppearance({ cursorStyle: parseCursorStyle(event.currentTarget.value) }),
+        style: fieldStyle,
+    }, createElement('option', { value: '' }, t('terminal.cursorInherit')), createElement('option', { value: 'block' }, t('terminal.cursorBlock')), createElement('option', { value: 'bar' }, t('terminal.cursorBar')), createElement('option', { value: 'underline' }, t('terminal.cursorUnderline')))), createElement(Field, { label: t('terminal.cursorBlink') }, createElement('div', { style: rowStyle }, createElement('label', { style: { display: 'inline-flex', alignItems: 'center', gap: 8 } }, createElement('input', {
+        type: 'checkbox', role: 'switch', 'aria-label': t('terminal.cursorBlink'),
+        checked: value.appearance.cursorBlink ?? false, disabled: customDisabled,
+        onChange: (event) => updateAppearance({ cursorBlink: event.currentTarget.checked }),
+    }), value.appearance.cursorBlink === null ? t('terminal.inherit') : (value.appearance.cursorBlink ? t('terminal.cursorOn') : t('terminal.cursorOff'))), createElement(ResetButton, { disabled: customDisabled || value.appearance.cursorBlink === null, onClick: () => updateAppearance({ cursorBlink: null }), label: t('terminal.resetInherit') }))), createElement(NumberField, { label: t('terminal.scrollback'), value: value.appearance.scrollback, min: 1000, max: 100000, step: 1000, disabled, onChange: (scrollback) => updateAppearance({ scrollback }), inheritLabel: t('terminal.inherit'), resetLabel: t('terminal.resetInherit') }), message && createElement('div', { role: 'status', style: { color: message.includes('已保存') ? dshThemeColor.success : dshThemeColor.error } }, message));
+}
+function Field({ label, children }) {
+    return createElement('label', { style: { display: 'flex', flexDirection: 'column', gap: 6 } }, createElement('span', { style: dshSettingsFieldLabelStyle }, label), children);
+}
+function ColorField({ label, value, disabled, onChange, inheritLabel, resetLabel }) {
+    return createElement(Field, { label }, createElement('div', { style: rowStyle }, createElement('input', { type: 'color', value: value ?? '#000000', disabled, 'aria-label': label, onChange: (event) => onChange(event.currentTarget.value), style: { width: 48, height: 34 } }), createElement('code', { style: { flex: 1 } }, value ?? inheritLabel), createElement(ResetButton, { disabled: disabled || value === null, onClick: () => onChange(null), label: resetLabel })));
+}
+function NumberField({ label, value, min, max, step, disabled, onChange, inheritLabel, resetLabel }) {
+    return createElement(Field, { label }, createElement('div', { style: rowStyle }, createElement('input', {
+        type: 'number', value: value ?? '', min, max, step, disabled, placeholder: inheritLabel,
+        onChange: (event) => onChange(event.currentTarget.value === '' ? null : Number(event.currentTarget.value)),
+        style: { ...fieldStyle, flex: 1, minWidth: 0 },
+    }), createElement(ResetButton, { disabled: disabled || value === null, onClick: () => onChange(null), label: resetLabel })));
+}
+function ResetButton({ disabled, onClick, label }) {
+    return createElement('button', { type: 'button', disabled, onClick, style: buttonStyle }, label);
+}
+function profileOptions(selected, status, t) {
+    if (status === null)
+        return [{ profileId: 'system', label: t(profileLabels.system), available: true }];
+    const profiles = status.profiles.map((profile) => ({
+        profileId: profile.profileId,
+        label: profile.name,
+        available: true,
+    }));
+    const options = [{ profileId: 'system', label: t(profileLabels.system), available: profiles.length > 0 }, ...profiles];
+    if (options.some((profile) => profile.profileId === selected))
+        return options;
+    return [...options, { profileId: selected, label: t('terminal.profileUnavailable', { profile: t(profileLabels[selected]) }), available: false }];
+}
+function platformLabel(platform, t) {
+    if (platform === 'darwin')
+        return 'macOS';
+    if (platform === 'win32')
+        return 'Windows';
+    if (platform === 'linux')
+        return 'Linux';
+    return t('terminal.unsupportedPlatform');
+}
+async function callTerminalStatus(rpc) {
+    let response;
+    try {
+        response = await rpc.call(CODINGNS_RPC_CHANNEL, 'terminal/status', {});
+    }
+    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/terminal/status', {});
+    }
+    if (!response.ok)
+        throw new Error(response.error.message);
+    return response.value;
+}
+function normalizeFontFamily(value) {
+    const trimmed = value.trim();
+    if (trimmed === '')
+        return null;
+    if (trimmed.length > 128 || /[\u0000-\u001F\u007F]/u.test(trimmed))
+        throw new TypeError('字体名称格式无效');
+    return trimmed;
+}
+function parseCursorStyle(value) {
+    return value === 'block' || value === 'bar' || value === 'underline' ? value : null;
+}
+const fieldStyle = dshSettingsFieldStyle;
+const buttonStyle = { ...dshSettingsButtonStyle, flex: '0 0 auto', minWidth: 92 };
+const rowStyle = dshSettingsRowStyle;
+const helpStyle = dshSettingsHelpStyle;
+const noteStyle = dshSettingsNoteStyle;
+//# sourceMappingURL=terminal-enhancement-panel.js.map

package/data/build/dist/client/features/terminal-enhancement.d.ts

@@ -0,0 +1,4 @@
+import type { CodingNsClientFeatureModule } from './types.js';
+/** “终端强化”只切换 backend；插件 controller 与 Sidebar UI 始终存在。 */
+export declare const terminalEnhancementFeature: CodingNsClientFeatureModule;
+//# sourceMappingURL=terminal-enhancement.d.ts.map

package/data/build/dist/client/features/terminal-enhancement.js

@@ -0,0 +1,24 @@
+import { TerminalEnhancementPanel } from './terminal-enhancement-panel.js';
+/** “终端强化”只切换 backend；插件 controller 与 Sidebar UI 始终存在。 */
+export const terminalEnhancementFeature = {
+    descriptor: {
+        name: 'terminalEnhancement',
+        version: '0.1.0',
+        enabledByDefault: false,
+        dependencies: [],
+        runtime: 'client',
+        activation: 'restart',
+        ui: {
+            label: '终端强化',
+            description: '配置持久终端的默认 shell 与插件终端外观。启用和禁用均需重启 DSH。',
+            labelKey: 'feature.terminal.label',
+            descriptionKey: 'feature.terminal.description',
+            order: 40,
+            defaultOpen: true,
+            legacyFallback: true,
+        },
+    },
+    start: () => undefined,
+    settingsPanel: TerminalEnhancementPanel,
+};
+//# sourceMappingURL=terminal-enhancement.js.map

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

@@ -0,0 +1,58 @@
+import type { ReactElement } from 'react';
+import type { Context } from '@deepseek-ai/cordis';
+import type { SlotRegistry } from '@deepseek-ai/dsh-client-ui-renderer/client';
+import type { SettingsScope, SettingsScopeSnapshot } from '@deepseek-ai/dsh-client-ui-settings/client';
+import type { FeatureModule } from '../../shared/contracts/feature.js';
+import type { CodingNsSettings } from '../../shared/contracts/config.js';
+import type { CodingNsLocale } from '../locale.js';
+/** 一次 Codingns4DSH RPC 的结果，与 DSH Connection 的结果形状一致。 */
+export type CodingNsRpcResult = {
+    readonly ok: true;
+    readonly value: unknown;
+} | {
+    readonly ok: false;
+    readonly error: {
+        readonly code: string;
+        readonly message: string;
+    };
+};
+/** Client 侧 RPC 调用句柄，由 DSH Connection 提供。 */
+export interface CodingNsRpcClient {
+    call(channel: string, endpoint: string, payload: unknown, signal?: AbortSignal): Promise<CodingNsRpcResult>;
+}
+/** Client 侧功能模块在 start 中取用的服务集合。 */
+export interface CodingNsClientServices {
+    /** 当前 DSH 实际运行版本，由 Host 注入。 */
+    readonly dshVersion: string;
+    readonly settings: SettingsScope<CodingNsSettings>;
+    readonly rpc: CodingNsRpcClient;
+    /** DSH Typert Remote；归档会话模块只通过运行时探测调用可选方法。 */
+    readonly remote?: unknown;
+    /** DSH 语言运行时；所有 Client 文案都从 Codingns4DSH 命名空间读取。 */
+    readonly locale: CodingNsLocale;
+    /** DSH 对话装配服务；用于注册不写入 Session 的流式临时节点。 */
+    readonly uiConversation?: unknown;
+    /** 对话工具栏 Slot 服务；测试和非 Web 宿主可以不提供。 */
+    readonly slots?: SlotRegistry;
+    /** 当前 Client Cordis 上下文；只供需要注册 DSH UI Slot 的功能模块使用。 */
+    readonly uiContext?: Context;
+}
+/** 设置卡片传给模块面板的属性。 */
+export interface FeaturePanelProps {
+    /** 宿主注入的服务，与模块 start 中拿到的是同一份。 */
+    readonly services: CodingNsClientServices;
+    /** 当前是否启用；未启用时面板需要自行灰显并禁用输入。 */
+    readonly enabled: boolean;
+    /** 设置快照，用于读取表单初值和可写状态。 */
+    readonly snapshot: SettingsScopeSnapshot<CodingNsSettings>;
+}
+/**
+ * 可在浏览器侧启停、并可出现在设置页的功能模块。
+ *
+ * 模块自带设置面板，设置页只负责遍历注册表渲染，因此新增模块不需要修改设置页。
+ */
+export interface CodingNsClientFeatureModule extends FeatureModule<CodingNsClientServices> {
+    /** 卡片内容；不提供时该模块只显示标题栏开关。 */
+    readonly settingsPanel?: (props: FeaturePanelProps) => ReactElement | null;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/data/build/dist/client/features/workspace-session-enhancement-panel.d.ts

@@ -0,0 +1,5 @@
+import type { ReactElement } from 'react';
+import type { FeaturePanelProps } from './types.js';
+/** 工作区会话增强的单列设置面板。 */
+export declare function WorkspaceSessionEnhancementPanel({ services, enabled, snapshot }: FeaturePanelProps): ReactElement;
+//# sourceMappingURL=workspace-session-enhancement-panel.d.ts.map