@jingyi0605/codingns4dsh 0.1.0 → 0.1.1

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

@@ -9,7 +9,7 @@ import type { Context } from '@deepseek-ai/cordis';
 import './provider-icon-assets.js';
 export { ensureCryptoRandomUUID } from './lan-access.js';
 export type { CryptoRandomUUIDInstallResult, LanAccessCrypto, LanAccessGlobal, } from './lan-access.js';
-export { CLIENT_FEATURES, settingsModules, startBrowserRelayConnection } from './features/index.js';
+export { CLIENT_FEATURES, settingsModules, startBrowserRelayConnection, gitManagementFeature } 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';
@@ -17,10 +17,11 @@ export type { RemoteDshWebBoot, RemoteDshWebContextOptions } from './remote-web-
 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';
+export { startWorkspaceSessionVisibilityDom, WORKSPACE_SESSION_HIDDEN_ATTRIBUTE, WORKSPACE_SESSION_HIDDEN_MENU_ATTRIBUTE, WORKSPACE_SESSION_HIDDEN_LIST_ATTRIBUTE, } from './workspace-session-visibility-dom.js';
 export { CodingNsTerminalView, CodingNsWebTerminals, registerCodingNsTerminalUi } from './terminal/index.js';
 export { registerSubscriptionSlot, registerCommandCodeSubscriptionSlot, CommandCodeSubscriptionSlot } from './subscription-slot.js';
 /** Client Runner 用于等待服务就绪的 Cordis 依赖声明。 */
-export declare const inject: readonly ["slots", "settingsScope", "connection", "remote", "remote.workspace", "remote.session", "remote.terminal", "sidebarRight", "sidebarRightTabs", "theme", "locale", "uiConversation"];
+export declare const inject: readonly ["slots", "connection", "remote", "remote.workspace", "remote.session", "sidebarRight", "sidebarRightTabs", "theme", "locale", "uiConversation"];
 /**
  * 把 Codingns4DSH 设置页挂载到 DSH 设置左侧导航，并让模块开关驱动启停。
  *

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

@@ -1,24 +1,29 @@
 import './provider-icon-assets.js';
 import { FeatureRegistry } from '../features/registry.js';
 import { registerCodingNsLocale } from './locale.js';
-import { CODINGNS_SETTINGS_NAMESPACE, captureRestartFeatureStates, enabledFeatureNames, } from '../shared/contracts/config.js';
+import { CODINGNS_SETTINGS_NAMESPACE, CODINGNS_SETTINGS_ENTRY_IDS, captureRestartFeatureStates, enabledFeatureNames, } from '../shared/contracts/config.js';
 import { CLIENT_FEATURES } from './features/index.js';
 import { ensureCryptoRandomUUID } from './lan-access.js';
 import { CodingNsSettingsSection } from './settings-section.js';
-import { createCodingNsSettingsBridge } from './settings-bridge.js';
+import { callCodingNsRpc, createCodingNsSettingsBridge } from './settings-bridge.js';
+import { debugInfo } 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';
 export { ensureCryptoRandomUUID } from './lan-access.js';
-export { CLIENT_FEATURES, settingsModules, startBrowserRelayConnection } from './features/index.js';
+export { CLIENT_FEATURES, settingsModules, startBrowserRelayConnection, gitManagementFeature } from './features/index.js';
 export { chooseDshDevice, createHttpDshH5ControlApi, startDshH5Bootstrap, startDshH5BrowserBootstrap } from './dsh-h5-bootstrap.js';
 export { RemoteDshWebContext } from './remote-web-context.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';
 export { CodingNsTerminalView, CodingNsWebTerminals, registerCodingNsTerminalUi } from './terminal/index.js';
 export { registerSubscriptionSlot, registerCommandCodeSubscriptionSlot, CommandCodeSubscriptionSlot } from './subscription-slot.js';
 /** Client Runner 用于等待服务就绪的 Cordis 依赖声明。 */
-export const inject = ['slots', 'settingsScope', 'connection', 'remote', 'remote.workspace', 'remote.session', 'remote.terminal', 'sidebarRight', 'sidebarRightTabs', 'theme', 'locale', 'uiConversation'];
+export const inject = ['slots', 'connection', 'remote', 'remote.workspace', 'remote.session', 'sidebarRight', 'sidebarRightTabs', 'theme', 'locale', 'uiConversation'];
 /**
  * 把 Codingns4DSH 设置页挂载到 DSH 设置左侧导航，并让模块开关驱动启停。
  *
@@ -28,36 +33,65 @@ export const inject = ['slots', 'settingsScope', 'connection', 'remote', 'remote
 export function apply(ctx) {
     if (ctx === undefined)
         return;
-    const dshVersion = assertInjectedDshVersion();
+    const dshVersion = assertInjectedDshVersion(ctx);
+    debugInfo('codingns4dsh: client apply entered', { dshVersion });
     // 版本门禁通过后才修改浏览器全局，避免不兼容 Client 留下半初始化状态。
     ensureCryptoRandomUUID();
     ctx.effect(() => registerCodingNsLocale(ctx), 'codingns4dsh: Client 词典');
-    ctx.inject(['slots', 'settingsScope', 'connection', 'remote', 'remote.workspace', 'remote.session', 'remote.terminal', 'sidebarRight', 'sidebarRightTabs', 'theme', 'locale', 'uiConversation'], (settingsCtx) => {
-        const localSettings = settingsCtx.settingsScope.bind({
-            namespace: CODINGNS_SETTINGS_NAMESPACE,
+    ctx.inject(['slots', 'connection', 'remote', 'remote.workspace', 'remote.session', 'sidebarRight', 'sidebarRightTabs', 'theme', 'locale', 'uiConversation'], async (settingsCtx) => {
+        debugInfo('codingns4dsh: client inject ready', {
+            hasConnection: settingsCtx.connection !== undefined,
+            hasRemote: settingsCtx.remote !== undefined,
+            hasSlots: settingsCtx.slots !== undefined,
+            hasSidebarRight: settingsCtx.sidebarRight !== undefined,
+            hasSidebarRightTabs: settingsCtx.sidebarRightTabs !== undefined,
+            hasTheme: settingsCtx.theme !== undefined,
+            hasLocale: settingsCtx.locale !== undefined,
+            hasUiConversation: settingsCtx.uiConversation !== undefined,
         });
         // Host 与 Client 共用同一个 cordis Context 类型，而 DSH 的 Host 侧声明会把
         // connection 收窄成 Host 句柄；浏览器侧按 ConnectionHandle 收窄回真实形状。
         const connection = settingsCtx.connection;
-        const settings = createCodingNsSettingsBridge(localSettings, connection.rpc);
-        // Typert manifest 可能晚于立即加载的 Client 入口完成登记，必须在每次调用时取 Remote。
-        const terminalRemote = () => settingsCtx.remote.terminal;
+        const settings = createClientSettingsStore(settingsCtx, connection.rpc);
+        debugInfo('codingns4dsh: client settings store ready');
+        const disposeTerminalRemote = await ensureTerminalRemote(settingsCtx);
+        // `remote` 是 Cordis 代理，读取嵌套命名空间必须在当前 Fiber 显式声明注入。
+        // 独立注入避免把 DSH 0.1.7 自动提供的官方 `remote.terminal` 当成插件终端。
+        let mountedTerminalRemote;
+        const terminalRemote = () => mountedTerminalRemote;
         const webTerminals = new CodingNsWebTerminals(settingsCtx, terminalRemote);
+        settingsCtx.inject(['remote.codingnsTerminal'], (terminalCtx) => {
+            mountedTerminalRemote = terminalCtx.get('remote.codingnsTerminal');
+            debugInfo('codingns4dsh: client terminal remote ready');
+            webTerminals.remoteReady();
+        });
+        debugInfo('codingns4dsh: client terminal UI registration begin');
         const disposeTerminalUi = registerCodingNsTerminalUi(settingsCtx, webTerminals, settings);
+        debugInfo('codingns4dsh: client terminal UI registration ready');
         const services = {
             dshVersion,
             settings,
             rpc: connection.rpc,
             remote: settingsCtx.remote,
+            terminalRemote,
             slots: settingsCtx.slots,
             locale: settingsCtx.locale,
             uiConversation: settingsCtx.uiConversation,
             uiContext: settingsCtx,
         };
+        debugInfo('codingns4dsh: client account bar registration begin');
         const disposeAccountBar = startCodingNsAccountBar(connection.rpc, undefined, settings);
-        const registry = new FeatureRegistry(services);
+        debugInfo('codingns4dsh: client account bar registration ready');
+        const capabilityProfile = createDshCapabilityRegistry(dshVersion, 'client', settingsCtx).getProfile(settingsCtx);
+        debugInfo('codingns4dsh: client capabilities resolved', {
+            dshVersion,
+            capabilities: [...capabilityProfile.capabilities.entries()].map(([capability, resolution]) => ({ capability, status: resolution.status, route: resolution.routeId, reason: resolution.reason ?? null })),
+            diagnostics: capabilityProfile.diagnostics,
+        });
+        const registry = new FeatureRegistry(services, capabilityProfile);
         registry.registerMany(CLIENT_FEATURES);
         registry.validate();
+        debugInfo('codingns4dsh: client feature registry ready', { features: registry.descriptors().map((item) => item.name) });
         const restartStates = {};
         let restartStatesCaptured = false;
         settingsCtx.effect(() => {
@@ -67,32 +101,123 @@ export function apply(ctx) {
                     Object.assign(restartStates, captureRestartFeatureStates(registry.descriptors(), snapshot.value, dshVersion));
                     restartStatesCaptured = true;
                 }
+                const enabled = enabledFeatureNames(registry.descriptors(), snapshot.value, restartStates, dshVersion);
+                debugInfo('codingns4dsh: client feature sync', {
+                    settingsStatus: snapshot.status,
+                    settingsRevision: snapshot.revision,
+                    enabled,
+                    states: registry.list(),
+                });
                 void registry
-                    .reconcile(enabledFeatureNames(registry.descriptors(), snapshot.value, restartStates, dshVersion))
+                    .reconcile(enabled)
                     .catch((error) => {
                     console.error('codingns4dsh: 功能模块状态同步失败', error);
                 });
             };
             sync();
-            void settings.load().catch((error) => {
-                console.error('codingns4dsh: 远程设置读取失败', error);
-            });
+            const loading = settings.load?.();
+            if (loading !== undefined) {
+                void loading.catch((error) => {
+                    console.error('codingns4dsh: 远程设置读取失败', error);
+                });
+            }
             const unsubscribe = settings.subscribe(sync);
-            return () => {
+            return async () => {
                 unsubscribe();
+                await registry.reconcile([]);
                 disposeTerminalUi();
-                disposeAccountBar.dispose();
-                void webTerminals.dispose();
-                settings.dispose();
+                await disposeAccountBar.dispose();
+                await disposeTerminalRemote();
+                await webTerminals.dispose();
+                await settings.dispose?.();
             };
         }, 'codingns4dsh: 功能模块启停同步');
-        settingsCtx.slots.inject('settings.section', () => settingsCtx.slots.register({
-            name: 'settings.section',
-            id: 'codingns',
-            order: 30,
-            label: 'Codingns4DSH',
-            inject: () => ({ settings, registry, services, restartStates }),
-        }, CodingNsSettingsSection));
+        try {
+            debugInfo('codingns4dsh: client settings slot registration begin');
+            settingsCtx.slots.inject('settings.section', () => {
+                debugInfo('codingns4dsh: client settings slot injector invoked');
+                return settingsCtx.slots.register({
+                    name: 'settings.section',
+                    id: 'codingns',
+                    order: 30,
+                    label: 'Codingns4DSH',
+                    inject: () => ({ settings, registry, services, restartStates }),
+                }, CodingNsSettingsSection);
+            });
+            debugInfo('codingns4dsh: client settings slot registration requested');
+        }
+        catch (error) {
+            console.error('codingns4dsh: client settings slot registration failed', error);
+            throw error;
+        }
     });
 }
+/** 按需挂载 Codingns4DSH 自有 Remote 描述，不能复用 DSH 官方 terminal。 */
+async function ensureTerminalRemote(ctx) {
+    // 这里只能读取已经声明的 `remote`。直接探测
+    // `remote.codingnsTerminal` 会触发 Cordis 的 without-inject 错误；
+    // Remote 贡献由当前 Client assembly 负责挂载，重复挂载由上层生命周期避免。
+    const remote = ctx.get('remote');
+    const dispose = await remote.$mount(TYPERT_REMOTE);
+    debugInfo('codingns4dsh: client terminal remote mounted');
+    return dispose;
+}
+/** 在设置服务改名期间选择旧 Scope 或 0.1.7 ConfigForm，业务层只接收内部 Store。 */
+function createClientSettingsStore(ctx, rpc) {
+    const scopeBinder = ctx.get('settingsScope');
+    if (typeof scopeBinder?.bind === 'function') {
+        debugInfo('codingns4dsh: client settings source=settingsScope');
+        const local = scopeBinder.bind({ namespace: CODINGNS_SETTINGS_NAMESPACE });
+        return createCodingNsSettingsBridge(local, 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 }),
+        });
+}
+function findConfigForm(forms) {
+    if (forms === undefined)
+        return undefined;
+    // ConfigForms.get 对未知 entry 也会返回一个 Form；必须先看共享 mirror 中
+    // Host 实际提供的 namespace，否则会永远拿到旧的 `codingns` 空表单。
+    try {
+        const namespaces = forms.describe?.().getSnapshot().view?.namespaces;
+        debugInfo('codingns4dsh: client config form namespaces', {
+            namespaces: namespaces?.map((item) => item.ns),
+        });
+        const servedId = CODINGNS_SETTINGS_ENTRY_IDS.find((id) => namespaces?.some((item) => item.ns === id));
+        if (servedId !== undefined) {
+            const form = forms.get(servedId);
+            debugInfo('codingns4dsh: client config form namespace selected', { namespace: servedId, hasForm: form !== undefined });
+            return form;
+        }
+    }
+    catch {
+        // mirror 尚未就绪时继续按 scoped entry 优先的兼容顺序探测。
+    }
+    for (const id of CODINGNS_SETTINGS_ENTRY_IDS) {
+        try {
+            const form = forms.get(id);
+            if (form !== undefined && form.getSnapshot().status !== 'unavailable') {
+                debugInfo('codingns4dsh: client config form namespace fallback selected', {
+                    namespace: id,
+                    status: form.getSnapshot().status,
+                    revision: form.getSnapshot().revision,
+                });
+                return form;
+            }
+        }
+        catch {
+            // 不同 0.1.7 构建可能只接受其中一个 entry id，继续尝试别名。
+        }
+    }
+    return undefined;
+}
 //# sourceMappingURL=index.js.map

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

@@ -5,26 +5,26 @@ const en = {
     'common.brand': 'Codingns4DSH',
     'settings.title': 'Codingns4DSH features',
     'settings.subtitle': 'Configure modules without changing DSH global settings.',
-    'settings.restartTarget': 'Target after restart: {state}',
-    'settings.enabled': 'Enabled',
-    'settings.disabled': 'Disabled',
-    'settings.runtimeReported': 'The current process state is reported by the module runtime.',
-    'settings.restartRequired': 'Restart DSH to apply this change.',
+    'settings.version': 'Codingns4DSH v{version}',
+    'settings.compatibility': 'Compatible with DSH {range}',
     'settings.toggle': '{label} toggle',
     'settings.legacyFallback': 'This DSH version uses compatibility mode; multi-tab and shell-selection extensions are unavailable.',
     'settings.versionBlocked': 'This module is unavailable on DSH {version}; it requires DSH {minimum} or newer.',
+    'settings.moduleEnabled': '{label} enabled.',
+    'settings.moduleDisabled': '{label} disabled.',
+    'settings.moduleWriteRejected': 'The setting change was rejected; please retry.',
     'feature.workspaceSession.legacyFallback': 'DSH 0.1.5 compatibility path is enabled but not verified. Session-row DOM injection and archive entry placement may vary; restoring archived sessions is unavailable.',
     'feature.lanAccess.label': 'LAN access to DSH',
     'feature.lanAccess.description': 'Access DSH through a LAN IP, provide crypto.randomUUID when needed, and forward the listener to the current DSH Web port.',
     'feature.loginProtection.label': 'Login protection',
     'feature.loginProtection.description': 'Protect LAN and relay DSH Web access with one local account; loopback access is always allowed.',
     'feature.reverseProxy.label': 'Relay access service',
-    'feature.reverseProxy.description': 'Access a DSH Host through the isolated DSH-Codingns4DSH relay.',
+    'feature.reverseProxy.description': 'Access a DSH Host through the isolated Codingns4DSH relay.',
     '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 the Agent logo, archived-session entry, and subscription or usage information.',
-    'feature.terminal.label': 'Terminal enhancement',
+    'feature.workspaceSession.description': 'Show Agent logos, archived-session entries, workspace hiding controls, subscription or usage information, and local quick sessions.',
+    'feature.terminal.label': 'Terminal enhancements',
     'feature.terminal.description': 'Configure the default shell and terminal appearance. Enabling or disabling requires a DSH restart.',
     'terminal.title': 'Terminal',
     'terminal.new': 'New terminal',
@@ -40,8 +40,11 @@ const en = {
     'terminal.enhanced': 'Terminal enhancement enabled',
     'terminal.basic': 'Basic local terminal',
     'terminal.saved': 'Terminal settings saved',
+    'terminal.saveRejected': 'Host rejected the terminal settings change; please retry.',
     'terminal.readingStatus': 'Reading Host terminal status…',
     'terminal.restartNote': 'Enabling or disabling requires a DSH restart. Disabling stops restoration and connection only; existing tmux or ConPTY sessions are not terminated.',
+    'terminal.appearanceTitle': 'Terminal appearance',
+    'terminal.resetAppearance': 'Reset appearance defaults',
     'terminal.newDefault': 'New terminal default',
     'terminal.theme': 'Theme',
     'terminal.bindingScope': 'Terminal binding scope',
@@ -49,15 +52,13 @@ const en = {
     'terminal.inheritDshTheme': 'Inherit DSH theme',
     'terminal.custom': 'Custom',
     'terminal.background': 'Background color',
-    'terminal.foreground': 'Foreground color',
+    'terminal.foreground': 'Text color',
     'terminal.cursorColor': 'Cursor color',
-    'terminal.font': 'Font',
     'terminal.fontSize': 'Font size (px)',
     'terminal.lineHeight': 'Line height',
     'terminal.cursorShape': 'Cursor shape',
     'terminal.cursorBlink': 'Cursor blink',
     'terminal.scrollback': 'Scrollback lines',
-    'terminal.inheritFont': 'Inherit DSH native font',
     'terminal.inherit': 'Inherit',
     'terminal.workspaceBinding': 'Bind by workspace (recommended)',
     'terminal.sessionBinding': 'Bind by DSH session',
@@ -70,7 +71,6 @@ const en = {
     'terminal.cursorUnderline': 'Underline',
     'terminal.cursorOn': 'On',
     'terminal.cursorOff': 'Off',
-    'terminal.resetInherit': 'Restore inherited',
     'terminal.unsupportedPlatform': 'Unsupported platform',
     'lan.listenHost': 'Listen host',
     'lan.description': 'Add a listener on this machine and redirect access to the current DSH Web. This is LAN access and does not use the cross-NAT relay service.',
@@ -91,7 +91,7 @@ const en = {
     'lan.autoStartOn': 'Auto-start enabled. The mapping will be restored the next time DSH starts.',
     'lan.autoStartOff': 'Auto-start disabled',
     'lan.processing': 'Processing…',
-    'relay.controlApi': 'Control API address',
+    'relay.controlApi': 'Relay service address',
     'relay.add': 'Add',
     'relay.cancel': 'Cancel',
     'relay.adding': 'Adding…',
@@ -110,16 +110,27 @@ const en = {
     'relay.addServerHint': 'Enter a new Control API address.',
     'relay.login': 'Log in',
     'relay.loggingIn': 'Logging in…',
+    'relay.noAccountPrefix': 'No account? ',
+    'relay.register': 'Register here',
+    'relay.noAccountSuffix': '.',
     'relay.loggedIn': 'Logged in',
     'relay.loggingOut': 'Logged out',
     'relay.loginSuccess': 'Login succeeded',
+    'relay.h5LoginAddress': 'H5 login page',
+    'relay.copied': 'Copied',
+    'relay.copyAddressHint': 'Click address to copy',
+    'relay.copySuccess': 'H5 login address copied',
+    'relay.copyFailed': 'Unable to copy the H5 login address',
     'relay.loggedOut': 'Logged out',
     'relay.bindSuccess': 'Host bound successfully',
     'relay.unbindSuccess': 'Host unbound',
     'relay.device': 'Device: {value}',
+    'relay.dshVersion': 'DSH version: {value}',
+    'relay.computerName': 'Computer name: {value}',
     'relay.host': 'Host: {value}',
     'relay.devicesSummary': 'Current device {current}; other active devices: {count}',
-    'relay.dshDevices': 'DSH-Codingns4DSH devices',
+    'relay.deviceStatus': 'Device status: {value}',
+    'relay.dshDevices': 'Codingns4DSH devices',
     'relay.selectDevice': 'Select a DSH Host',
     'relay.online': 'online',
     'relay.offline': 'offline',
@@ -185,33 +196,53 @@ const en = {
     'workspace.logoDescription': 'Display the selected external Agent logo in native workspace session rows.',
     'workspace.showArchivedSessions': 'Show archived workspace sessions',
     'workspace.archivedSessionsDescription': 'Display an archived-session folder entry above each workspace\'s more-sessions button.',
+    'workspace.showWorkspaceHiding': 'Show workspace hiding controls',
+    'workspace.workspaceHidingDescription': 'Add a Hide workspace action to each workspace menu and show hidden workspaces through the workspace filter.',
     'workspace.showSubscriptionUsage': 'Show subscription and usage',
     '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.quickPhrasesTitle': 'Quick sessions',
+    'workspace.quickPhrasesHint': 'Click an item in the composer to fill the current draft.',
+    'workspace.quickPhrasesEmpty': 'No quick sessions yet.',
+    'workspace.quickPhrasesPlaceholder': 'Enter a reusable session instruction',
+    'workspace.quickPhrasesAdd': 'Add quick session',
+    'workspace.quickPhrasesCancel': 'Cancel',
+    'workspace.quickPhrasesAddDialogLabel': 'Add a quick session',
+    'workspace.quickPhrasesDelete': 'Delete quick session',
+    'workspace.quickPhrasesMoveUp': 'Move quick session up',
+    'workspace.quickPhrasesMoveDown': 'Move quick session down',
+    'workspace.quickPhrasesDrag': 'Drag to reorder quick session',
+    'workspace.quickPhrasesSaved': 'Quick session settings saved',
+    'workspace.quickPhrasesSaveFailed': 'Unable to save quick session settings',
+    'workspace.quickPhrasesTrigger': 'Quick sessions',
+    'workspace.quickPhrasesDialogLabel': 'Choose a quick session',
+    'workspace.quickPhrasesClose': 'Close quick sessions',
 };
 const zh = {
     'common.brand': 'Codingns4DSH',
     'settings.title': 'Codingns4DSH 功能模块',
     'settings.subtitle': '按模块配置 Codingns4DSH 功能，不影响 DSH 的全局设置。',
-    'settings.restartTarget': '下次启动目标：{state}',
-    'settings.enabled': '启用',
-    'settings.disabled': '禁用',
-    'settings.runtimeReported': '当前进程状态由模块运行时报告',
-    'settings.restartRequired': '重启 DSH 后生效',
+    'settings.version': 'Codingns4DSH v{version}',
+    'settings.compatibility': '兼容 DSH {range}',
     'settings.toggle': '{label}开关',
     'settings.legacyFallback': '当前 DSH 版本使用兼容模式；多 Tab 和 Shell 选择扩展不可用。',
     'settings.versionBlocked': '当前 DSH {version} 不支持此模块；需要 DSH {minimum} 或更高版本。',
+    'settings.moduleEnabled': '已启用{label}',
+    'settings.moduleDisabled': '已禁用{label}',
+    'settings.moduleWriteRejected': '设置未被接受，请重试。',
     'feature.workspaceSession.legacyFallback': '已启用 DSH 0.1.5 兼容路径，但尚未完成验证。会话行 DOM 注入和归档入口位置可能存在差异；当前版本不支持取消归档。',
     'feature.lanAccess.label': '局域网访问DSH',
     'feature.lanAccess.description': '通过局域网 IP 访问 DSH，自动补齐 crypto.randomUUID，并将监听端口转发到当前 DSH Web。',
     'feature.loginProtection.label': '登录保护',
     'feature.loginProtection.description': '使用统一的本地账号保护局域网和中继 DSH Web 访问，本机回环地址始终放行。',
     'feature.reverseProxy.label': '中转访问服务',
-    'feature.reverseProxy.description': '通过隔离的 DSH-Codingns4DSH 中继访问 DSH Host。',
+    'feature.reverseProxy.description': '通过隔离的 Codingns4DSH 中继访问 DSH Host。',
     'feature.cliAdapters.label': '外部Agent集成',
     'feature.cliAdapters.description': '查看外部 Agent 的安装状态、版本、命令路径和可用模型，并单独启用或停用。',
     'feature.workspaceSession.label': '工作区会话增强',
-    'feature.workspaceSession.description': '在原生工作区会话行显示 Agent Logo、归档会话入口和订阅/用量信息。',
-    'feature.terminal.label': '终端强化',
+    'feature.workspaceSession.description': '在原生工作区会话行显示 Agent Logo、归档会话入口、工作区隐藏功能和订阅/用量信息，并提供本地快捷会话。',
+    'feature.terminal.label': '终端增强',
     'feature.terminal.description': '配置持久终端的默认 shell 与插件终端外观。启用和禁用均需重启 DSH。',
     'terminal.title': '终端',
     'terminal.new': '新建终端',
@@ -224,11 +255,14 @@ const zh = {
     'terminal.rename': '双击重命名终端',
     'terminal.cleanupFailed': '终端「{title}」未能结束：{message}',
     'terminal.currentStatus': '当前运行状态：{status}；Host 平台：{platform}',
-    'terminal.enhanced': '终端强化已启用',
+    'terminal.enhanced': '终端增强已启用',
     'terminal.basic': '基础本地终端',
     'terminal.saved': '终端设置已保存',
+    'terminal.saveRejected': 'Host 拒绝了终端设置变更，请重试。',
     'terminal.readingStatus': '正在读取 Host 终端状态...',
     'terminal.restartNote': '启用或禁用需要重启 DSH。禁用只会停止恢复和连接，不会结束已有的 tmux 或 ConPTY 会话。',
+    'terminal.appearanceTitle': '终端样式',
+    'terminal.resetAppearance': '重置为默认样式',
     'terminal.newDefault': '新建终端默认项',
     'terminal.theme': '主题',
     'terminal.bindingScope': '终端绑定范围',
@@ -236,15 +270,13 @@ const zh = {
     'terminal.inheritDshTheme': '继承 DSH 主题',
     'terminal.custom': '自定义',
     'terminal.background': '背景色',
-    'terminal.foreground': '前景色',
+    'terminal.foreground': '文本颜色',
     'terminal.cursorColor': '光标颜色',
-    'terminal.font': '字体',
     'terminal.fontSize': '字号（px）',
     'terminal.lineHeight': '行高',
     'terminal.cursorShape': '光标形状',
     'terminal.cursorBlink': '光标闪烁',
     'terminal.scrollback': '回滚行数',
-    'terminal.inheritFont': '继承 DSH 原生字体',
     'terminal.inherit': '继承',
     'terminal.workspaceBinding': '按工作区绑定（推荐）',
     'terminal.sessionBinding': '按 DSH 会话绑定',
@@ -257,7 +289,6 @@ const zh = {
     'terminal.cursorUnderline': '下划线',
     'terminal.cursorOn': '开启',
     'terminal.cursorOff': '关闭',
-    'terminal.resetInherit': '恢复继承',
     'terminal.unsupportedPlatform': '不支持的平台',
     'lan.listenHost': '监听地址',
     'lan.description': '在本机增加一个监听端口，将访问重定向到当前 DSH Web。此功能属于局域网访问，不经过跨 NAT 中转服务。',
@@ -278,7 +309,7 @@ const zh = {
     'lan.autoStartOn': '已开启自动启动，下一次启动 DSH 时将自动恢复映射',
     'lan.autoStartOff': '已关闭自动启动',
     'lan.processing': '处理中…',
-    'relay.controlApi': 'Control API 地址',
+    'relay.controlApi': '中转服务地址',
     'relay.add': '添加',
     'relay.cancel': '取消',
     'relay.adding': '添加中…',
@@ -297,16 +328,27 @@ const zh = {
     'relay.addServerHint': '请输入新的 Control API 地址。',
     'relay.login': '登录',
     'relay.loggingIn': '登录中…',
+    'relay.noAccountPrefix': '没有账号，',
+    'relay.register': '点这里注册',
+    'relay.noAccountSuffix': '。',
     'relay.loggedIn': '已登录',
     'relay.loggingOut': '退出登录',
     'relay.loginSuccess': '登录成功',
+    'relay.h5LoginAddress': 'H5 登录页面地址',
+    'relay.copied': '已复制',
+    'relay.copyAddressHint': '点击地址复制',
+    'relay.copySuccess': 'H5 登录页面地址复制成功',
+    'relay.copyFailed': '无法复制 H5 登录页面地址',
     'relay.bindSuccess': 'Host 绑定成功',
     'relay.unbindSuccess': 'Host 已解绑',
     'relay.loggedOut': '已退出登录',
     'relay.device': '设备：{value}',
+    'relay.dshVersion': 'DSH 版本：{value}',
+    'relay.computerName': '计算机名：{value}',
     'relay.host': 'Host：{value}',
     'relay.devicesSummary': '当前设备 {current}，其他活动设备 {count} 台',
-    'relay.dshDevices': 'DSH-Codingns4DSH 设备',
+    'relay.deviceStatus': '设备状态：{value}',
+    'relay.dshDevices': 'Codingns4DSH 设备',
     'relay.selectDevice': '选择 DSH Host',
     'relay.online': '在线',
     'relay.offline': '离线',
@@ -372,8 +414,28 @@ const zh = {
     'workspace.logoDescription': '在原生工作区会话行显示所选外部 Agent 的 Logo。',
     'workspace.showArchivedSessions': '显示工作区归档会话',
     'workspace.archivedSessionsDescription': '在每个工作区的“展开其余会话”按钮上方显示已归档的会话入口。',
+    'workspace.showWorkspaceHiding': '显示工作区隐藏功能',
+    'workspace.workspaceHidingDescription': '在工作区菜单中加入“隐藏工作区”，通过工作区筛选菜单显示隐藏的工作区并支持恢复。',
     'workspace.showSubscriptionUsage': '显示订阅/用量检测',
     'workspace.subscriptionUsageDescription': '在对话底部检测并显示 Agent 订阅余额和上游用量。',
+    'workspace.showQuickPhrases': '显示快捷会话',
+    'workspace.quickPhrasesDescription': '在 Codingns4DSH 内本地保存可复用的会话指令，并将快捷会话按钮显示在输入工具区。',
+    'workspace.quickPhrasesTitle': '快捷会话',
+    'workspace.quickPhrasesHint': '点击条目即可填入当前对话框。',
+    'workspace.quickPhrasesEmpty': '还没有快捷会话。',
+    'workspace.quickPhrasesPlaceholder': '输入可复用的会话指令',
+    'workspace.quickPhrasesAdd': '添加快捷会话',
+    'workspace.quickPhrasesCancel': '取消',
+    'workspace.quickPhrasesAddDialogLabel': '添加快捷会话',
+    'workspace.quickPhrasesDelete': '删除快捷会话',
+    'workspace.quickPhrasesMoveUp': '上移快捷会话',
+    'workspace.quickPhrasesMoveDown': '下移快捷会话',
+    'workspace.quickPhrasesDrag': '拖动以调整快捷会话顺序',
+    'workspace.quickPhrasesSaved': '快捷会话设置已保存',
+    'workspace.quickPhrasesSaveFailed': '快捷会话设置保存失败',
+    'workspace.quickPhrasesTrigger': '快捷会话',
+    'workspace.quickPhrasesDialogLabel': '选择快捷会话',
+    'workspace.quickPhrasesClose': '关闭快捷会话',
 };
 /** 在当前 Client Cordis 作用域注册中英文词典。 */
 export function registerCodingNsLocale(ctx) {

package/data/build/dist/client/quick-phrase-layout.d.ts

@@ -0,0 +1,49 @@
+/**
+ * 快捷短语按钮在 DSH 输入工具栏里的落位。
+ *
+ * DSH 原生结构是「添加附件按钮 → 权限/规划组 → conversation.input.left 槽位」，
+ * 槽位里的控件默认排在权限组件右边。这里不改 DOM 顺序，只给这些项各加一个 flex order：
+ * 三者仍共用宿主工具栏的 flex 行，既不互相覆盖，间距也由宿主 gap 统一决定。
+ */
+export declare const QUICK_PHRASE_TRIGGER_ORDER = 1;
+export declare const QUICK_PHRASE_PERMISSION_ORDER = 2;
+/** 快捷短语两侧保留的间距比例：只留宿主原生间距的一半，入口更紧凑。 */
+export declare const QUICK_PHRASE_GAP_SCALE = 0.5;
+/** 读不到宿主 gap 时按 DSH 当前的 12px 估算，留出一半间距。 */
+export declare const QUICK_PHRASE_FALLBACK_MARGIN = -6;
+/** 读取计算样式的入口；测试可注入替身。 */
+export interface QuickPhraseLayoutEnvironment {
+    readonly computedStyle?: (element: Element) => {
+        readonly display: string;
+        readonly columnGap?: string;
+    };
+}
+/** 重排结果：被排到快捷短语之后的工具栏项与还原函数。 */
+export interface QuickPhraseOrderHandle {
+    /** 从添加附件按钮到快捷短语之间的工具栏项（DSH 中是权限/规划组）；布局变化导致找不到时为空。 */
+    readonly reordered: readonly HTMLElement[];
+    /** 承载这些控件的工具栏行；DSH 结构变化时为 null。 */
+    readonly container: HTMLElement | null;
+    dispose(): void;
+}
+export interface QuickPhraseOrderRequest {
+    /** 插件自己的快捷短语根节点。 */
+    readonly trigger: HTMLElement;
+    /** DSH 的添加附件按钮，用来定位它之后的工具栏项。 */
+    readonly addButton: HTMLElement;
+}
+/**
+ * 把快捷短语按钮排到添加附件按钮之后、权限设置组件之前。
+ * @param request - 快捷短语根节点与添加附件按钮。
+ * @param environment - 计算样式读取入口。
+ * @returns 被重排的工具栏项、工具栏行与还原函数。
+ */
+export declare function applyQuickPhraseOrder(request: QuickPhraseOrderRequest, environment?: QuickPhraseLayoutEnvironment): QuickPhraseOrderHandle;
+/**
+ * 快捷短语两侧要用的负外边距：把宿主原生 gap 收窄到 {@link QUICK_PHRASE_GAP_SCALE}。
+ * @param container - 承载工具栏项的 flex 行。
+ * @param environment - 计算样式读取入口。
+ * @returns 左右外边距（px，负值）。
+ */
+export declare function readQuickPhraseMargin(container: Element | null, environment?: QuickPhraseLayoutEnvironment): number;
+//# sourceMappingURL=quick-phrase-layout.d.ts.map