@jingyi0605/codingns4dsh 0.1.0 → 0.1.1

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

@@ -1,8 +1,9 @@
 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 { dshFormRootStyle, dshSettingsButtonStyle, dshSettingsFieldLabelStyle, dshSettingsFieldStyle, dshSettingsGridStyle, dshSettingsHelpStyle, dshSettingsNoteStyle, dshSettingsRowStyle, dshSettingsSectionHeaderStyle, dshThemeColor, } from '../theme.js';
 import { useCodingNsTranslator } from '../locale.js';
+import { debugInfo, debugWarn } from '../../shared/debug.js';
 const profileLabels = {
     system: 'terminal.systemRecommended',
     zsh: 'zsh',
@@ -12,15 +13,12 @@ const profileLabels = {
     'git-bash': 'Git Bash',
 };
 /** 终端默认行为与外观设置；终端 UI 由独立 Sidebar 模块负责。 */
-export function TerminalEnhancementPanel({ services, enabled, snapshot }) {
+export function TerminalEnhancementPanel({ services, enabled, snapshot, notify }) {
     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 appearance = resolveAppearance(value.appearance);
     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)
@@ -28,38 +26,45 @@ export function TerminalEnhancementPanel({ services, enabled, snapshot }) {
             setHostStatus(status); })
             .catch((error) => {
             if (active)
-                setMessage(error instanceof Error ? error.message : String(error));
+                notify({ kind: 'error', message: error instanceof Error ? error.message : String(error) });
         });
         return () => { active = false; };
     }, [services.rpc]);
     const save = (next) => {
-        setMessage('');
+        debugInfo('codingns4dsh: client terminal settings write begin', {
+            field: CODINGNS_TERMINAL_ENHANCEMENT_FIELD,
+            bindingScope: next.bindingScope ?? 'workspace',
+        });
         void services.settings.set(CODINGNS_TERMINAL_ENHANCEMENT_FIELD, next)
-            .then(() => setMessage(t('terminal.saved')))
-            .catch((error) => setMessage(error instanceof Error ? error.message : String(error)));
+            .then((written) => {
+            if (!written) {
+                debugWarn('codingns4dsh: client terminal settings write rejected');
+                throw new Error(t('terminal.saveRejected'));
+            }
+            debugInfo('codingns4dsh: client terminal settings write success', {
+                bindingScope: next.bindingScope ?? 'workspace',
+            });
+            notify({ kind: 'success', message: t('terminal.saved') });
+        })
+            .catch((error) => notify({ kind: 'error', message: error instanceof Error ? error.message : String(error) }));
     };
     const updateAppearance = (patch) => {
-        save({ ...value, appearance: { ...value.appearance, ...patch } });
+        save({ ...value, appearance: { ...value.appearance, theme: 'custom', ...patch } });
     };
-    const saveFontFamily = () => {
-        try {
-            updateAppearance({ fontFamily: normalizeFontFamily(fontFamily) });
-        }
-        catch (error) {
-            setMessage(error instanceof Error ? error.message : String(error));
-        }
+    const resetAppearance = () => {
+        save({ ...value, appearance: { ...DEFAULT_TERMINAL_ENHANCEMENT_SETTINGS.appearance, theme: 'custom' } });
     };
     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', {
+        : t('terminal.currentStatus', { status: hostStatus.effectiveEnabled ? t('terminal.enhanced') : t('terminal.basic'), platform: platformLabel(hostStatus.platform, t) })), createElement(Field, { label: t('terminal.newDefault'), help: t('terminal.defaultProfileHelp') }, 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', {
+    }, ...profileOptions(value.defaultProfile, hostStatus, t).map((profile) => createElement('option', { key: profile.profileId, value: profile.profileId, disabled: !profile.available }, profile.label))), hostStatus?.fallbackReason === undefined ? null : createElement('small', { style: helpStyle }, hostStatus.fallbackReason)), createElement(Field, { label: t('terminal.bindingScope'), help: t('terminal.workspaceBindingHelp') }, createElement('select', {
         value: value.bindingScope ?? 'workspace',
         disabled,
         onChange: (event) => save({
@@ -67,42 +72,50 @@ export function TerminalEnhancementPanel({ services, enabled, snapshot }) {
             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', {
+    }, createElement('option', { value: 'workspace' }, t('terminal.workspaceBinding')), createElement('option', { value: 'session' }, t('terminal.sessionBinding')))), createElement('div', { style: dshSettingsSectionHeaderStyle }, createElement('h3', { style: { margin: 0, color: dshThemeColor.labelPrimary, fontSize: 14, lineHeight: 1.35 } }, t('terminal.appearanceTitle')), createElement('button', { type: 'button', disabled, onClick: resetAppearance, style: { ...buttonStyle, minWidth: 132 } }, t('terminal.resetAppearance'))), createElement('div', { style: dshSettingsGridStyle }, createElement(ColorField, { label: t('terminal.background'), value: appearance.background, disabled, onChange: (background) => updateAppearance({ background }) }), createElement(ColorField, { label: t('terminal.foreground'), value: appearance.foreground, disabled, onChange: (foreground) => updateAppearance({ foreground }) }), createElement(ColorField, { label: t('terminal.cursorColor'), value: appearance.cursorColor, disabled, onChange: (cursorColor) => updateAppearance({ cursorColor }) }), createElement(Field, { label: t('terminal.cursorBlink') }, createElement('label', { style: { display: 'inline-flex', alignItems: 'center', gap: 8, minHeight: 36, opacity: disabled ? 0.6 : 1 } }, createElement('input', {
         type: 'checkbox', role: 'switch', 'aria-label': t('terminal.cursorBlink'),
-        checked: value.appearance.cursorBlink ?? false, disabled: customDisabled,
+        checked: appearance.cursorBlink, disabled,
         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));
+    }), appearance.cursorBlink ? t('terminal.cursorOn') : t('terminal.cursorOff'))), createElement(NumberField, { label: t('terminal.fontSize'), value: appearance.fontSize, min: 10, max: 32, step: 1, disabled, onChange: (fontSize) => updateAppearance({ fontSize }) }), createElement(NumberField, { label: t('terminal.lineHeight'), value: appearance.lineHeight, min: 1, max: 2, step: 0.1, disabled, onChange: (lineHeight) => updateAppearance({ lineHeight }) }), createElement(Field, { label: t('terminal.cursorShape') }, createElement('select', {
+        value: appearance.cursorStyle, disabled,
+        onChange: (event) => updateAppearance({ cursorStyle: parseCursorStyle(event.currentTarget.value) }),
+        style: fieldStyle,
+    }, createElement('option', { value: 'block' }, t('terminal.cursorBlock')), createElement('option', { value: 'bar' }, t('terminal.cursorBar')), createElement('option', { value: 'underline' }, t('terminal.cursorUnderline')))), createElement(NumberField, { label: t('terminal.scrollback'), value: appearance.scrollback, min: 1000, max: 100000, step: 1000, disabled, onChange: (scrollback) => updateAppearance({ scrollback }) })));
+}
+function Field({ label, help, children }) {
+    return createElement('div', { style: { display: 'flex', flexDirection: 'column', gap: 6 } }, createElement('div', { style: fieldHeadingStyle }, createElement('span', { style: dshSettingsFieldLabelStyle }, label), help === undefined ? null : createElement(InfoButton, { label: help })), children);
 }
-function Field({ label, children }) {
-    return createElement('label', { style: { display: 'flex', flexDirection: 'column', gap: 6 } }, createElement('span', { style: dshSettingsFieldLabelStyle }, label), children);
+function InfoButton({ label }) {
+    return createElement('button', {
+        type: 'button',
+        title: label,
+        'aria-label': label,
+        style: infoButtonStyle,
+    }, 'ⓘ');
 }
-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 ColorField({ label, value, disabled, onChange }) {
+    return createElement(Field, { label }, createElement('div', { style: rowStyle }, createElement('input', { type: 'color', value, disabled, 'aria-label': label, onChange: (event) => onChange(event.currentTarget.value), style: { width: 48, height: 34 } }), createElement('code', { style: { flex: 1 } }, value)));
 }
-function NumberField({ label, value, min, max, step, disabled, onChange, inheritLabel, resetLabel }) {
+function NumberField({ label, value, min, max, step, disabled, onChange }) {
     return createElement(Field, { label }, createElement('div', { style: rowStyle }, createElement('input', {
-        type: 'number', value: value ?? '', min, max, step, disabled, placeholder: inheritLabel,
+        type: 'number', value, min, max, step, disabled,
         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);
+/** 将旧配置中的 null 映射为 xterm 当前实际使用的默认值，设置页始终显示可编辑值。 */
+function resolveAppearance(appearance) {
+    const foreground = appearance.foreground ?? '#f3f3f3';
+    return {
+        background: appearance.background ?? '#111111',
+        foreground,
+        cursorColor: appearance.cursorColor ?? foreground,
+        fontSize: appearance.fontSize ?? 13,
+        lineHeight: appearance.lineHeight ?? 1,
+        cursorStyle: appearance.cursorStyle ?? 'block',
+        cursorBlink: appearance.cursorBlink ?? true,
+        scrollback: appearance.scrollback ?? 1000,
+    };
 }
 function profileOptions(selected, status, t) {
     if (status === null)
@@ -141,14 +154,6 @@ async function callTerminalStatus(rpc) {
         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;
 }
@@ -157,4 +162,6 @@ const buttonStyle = { ...dshSettingsButtonStyle, flex: '0 0 auto', minWidth: 92
 const rowStyle = dshSettingsRowStyle;
 const helpStyle = dshSettingsHelpStyle;
 const noteStyle = dshSettingsNoteStyle;
+const fieldHeadingStyle = { display: 'flex', alignItems: 'center', justifyContent: 'space-between', gap: 8 };
+const infoButtonStyle = { display: 'inline-flex', alignItems: 'center', justifyContent: 'center', width: 20, height: 20, flex: '0 0 20px', padding: 0, border: `1px solid ${dshThemeColor.border}`, borderRadius: '50%', color: dshThemeColor.labelSecondary, background: dshThemeColor.surfaceSubtle, cursor: 'help', fontSize: 12, lineHeight: 1 };
 //# sourceMappingURL=terminal-enhancement-panel.js.map

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

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

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

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

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

@@ -1,10 +1,10 @@
 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';
+import type { CodingNsSettingsSnapshot, CodingNsSettingsStore } from '../../dsh-capabilities/settings-store.js';
 /** 一次 Codingns4DSH RPC 的结果，与 DSH Connection 的结果形状一致。 */
 export type CodingNsRpcResult = {
     readonly ok: true;
@@ -24,10 +24,12 @@ export interface CodingNsRpcClient {
 export interface CodingNsClientServices {
     /** 当前 DSH 实际运行版本，由 Host 注入。 */
     readonly dshVersion: string;
-    readonly settings: SettingsScope<CodingNsSettings>;
+    readonly settings: CodingNsSettingsStore<CodingNsSettings>;
     readonly rpc: CodingNsRpcClient;
     /** DSH Typert Remote；归档会话模块只通过运行时探测调用可选方法。 */
     readonly remote?: unknown;
+    /** Codingns4DSH 自有终端 Remote；调试页不能依赖已停用的 DSH 官方 terminal。 */
+    readonly terminalRemote?: () => unknown;
     /** DSH 语言运行时；所有 Client 文案都从 Codingns4DSH 命名空间读取。 */
     readonly locale: CodingNsLocale;
     /** DSH 对话装配服务；用于注册不写入 Session 的流式临时节点。 */
@@ -37,6 +39,13 @@ export interface CodingNsClientServices {
     /** 当前 Client Cordis 上下文；只供需要注册 DSH UI Slot 的功能模块使用。 */
     readonly uiContext?: Context;
 }
+/** 设置页统一反馈的提示级别。 */
+export type SettingsNoticeKind = 'success' | 'error' | 'info';
+/** 由功能面板提交给设置页顶部 Toast 的反馈。 */
+export interface SettingsNotice {
+    readonly kind: SettingsNoticeKind;
+    readonly message: string;
+}
 /** 设置卡片传给模块面板的属性。 */
 export interface FeaturePanelProps {
     /** 宿主注入的服务，与模块 start 中拿到的是同一份。 */
@@ -44,7 +53,9 @@ export interface FeaturePanelProps {
     /** 当前是否启用；未启用时面板需要自行灰显并禁用输入。 */
     readonly enabled: boolean;
     /** 设置快照，用于读取表单初值和可写状态。 */
-    readonly snapshot: SettingsScopeSnapshot<CodingNsSettings>;
+    readonly snapshot: CodingNsSettingsSnapshot<CodingNsSettings>;
+    /** 将设置写入结果显示在设置区域顶部。 */
+    readonly notify: (notice: SettingsNotice) => void;
 }
 /**
  * 可在浏览器侧启停、并可出现在设置页的功能模块。

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

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

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

@@ -1,22 +1,26 @@
-import { createElement, useState } from 'react';
+import { createElement } from 'react';
 import { CODINGNS_WORKSPACE_SESSION_ENHANCEMENT_FIELD, DEFAULT_WORKSPACE_SESSION_ENHANCEMENT_SETTINGS, } from '../../shared/contracts/config.js';
 import { dshFormRootStyle, dshSettingsHelpStyle, dshSettingsListRowStyle, dshThemeColor, } from '../theme.js';
 import { useCodingNsTranslator } from '../locale.js';
 /** 工作区会话增强的单列设置面板。 */
-export function WorkspaceSessionEnhancementPanel({ services, enabled, snapshot }) {
+export function WorkspaceSessionEnhancementPanel({ services, enabled, snapshot, notify }) {
     const t = useCodingNsTranslator(services.locale);
-    const [writeError, setWriteError] = useState(null);
     const value = snapshot.value?.workspaceSessionEnhancement
         ?? DEFAULT_WORKSPACE_SESSION_ENHANCEMENT_SETTINGS;
     const disabled = !enabled || snapshot.status === 'loading' || !snapshot.writable;
     const updateSetting = (field, nextValue) => {
-        setWriteError(null);
         void services.settings.mutate([{
                 op: 'set',
                 path: [CODINGNS_WORKSPACE_SESSION_ENHANCEMENT_FIELD, field],
                 value: nextValue,
-            }]).catch((cause) => {
-            setWriteError(cause instanceof Error ? cause.message : String(cause));
+            }]).then((accepted) => {
+            if (!accepted) {
+                notify({ kind: 'error', message: t('settings.moduleWriteRejected') });
+                return;
+            }
+            notify({ kind: 'success', message: '工作区会话设置已保存' });
+        }).catch((cause) => {
+            notify({ kind: 'error', message: cause instanceof Error ? cause.message : String(cause) });
         });
     };
     return createElement('div', {
@@ -41,6 +45,16 @@ export function WorkspaceSessionEnhancementPanel({ services, enabled, snapshot }
         style: { flex: '0 0 auto', accentColor: dshThemeColor.accent },
     })), createElement('label', {
         style: dshSettingsListRowStyle,
+    }, createElement('span', { style: { minWidth: 0 } }, createElement('strong', { style: { display: 'block', fontSize: 13, lineHeight: 1.4 } }, t('workspace.showWorkspaceHiding')), createElement('span', { style: { display: 'block', marginTop: 3, ...dshSettingsHelpStyle } }, t('workspace.workspaceHidingDescription'))), createElement('input', {
+        type: 'checkbox',
+        role: 'switch',
+        'aria-label': t('workspace.showWorkspaceHiding'),
+        checked: value.showWorkspaceHiding,
+        disabled,
+        onChange: (event) => updateSetting('showWorkspaceHiding', event.currentTarget.checked),
+        style: { flex: '0 0 auto', accentColor: dshThemeColor.accent },
+    })), createElement('label', {
+        style: dshSettingsListRowStyle,
     }, createElement('span', { style: { minWidth: 0 } }, createElement('strong', { style: { display: 'block', fontSize: 13, lineHeight: 1.4 } }, t('workspace.showSubscriptionUsage')), createElement('span', { style: { display: 'block', marginTop: 3, ...dshSettingsHelpStyle } }, t('workspace.subscriptionUsageDescription'))), createElement('input', {
         type: 'checkbox',
         role: 'switch',
@@ -59,8 +73,16 @@ export function WorkspaceSessionEnhancementPanel({ services, enabled, snapshot }
         disabled,
         onChange: (event) => updateSetting('showArchivedSessions', event.currentTarget.checked),
         style: { flex: '0 0 auto', accentColor: dshThemeColor.accent },
-    })), writeError === null
-        ? null
-        : createElement('div', { role: 'alert', style: { color: dshThemeColor.error, fontSize: 12 } }, writeError));
+    })), createElement('label', {
+        style: dshSettingsListRowStyle,
+    }, createElement('span', { style: { minWidth: 0 } }, createElement('strong', { style: { display: 'block', fontSize: 13, lineHeight: 1.4 } }, t('workspace.showQuickPhrases')), createElement('span', { style: { display: 'block', marginTop: 3, ...dshSettingsHelpStyle } }, t('workspace.quickPhrasesDescription'))), createElement('input', {
+        type: 'checkbox',
+        role: 'switch',
+        'aria-label': t('workspace.showQuickPhrases'),
+        checked: value.showQuickPhrases,
+        disabled,
+        onChange: (event) => updateSetting('showQuickPhrases', event.currentTarget.checked),
+        style: { flex: '0 0 auto', accentColor: dshThemeColor.accent },
+    })));
 }
 //# sourceMappingURL=workspace-session-enhancement-panel.js.map

package/data/build/dist/client/features/workspace-session-enhancement.js

@@ -2,19 +2,21 @@ import { DEFAULT_WORKSPACE_SESSION_ENHANCEMENT_SETTINGS } from '../../shared/con
 import { clearSessionAdapters, fetchSessionAdapters, replaceSessionAdapters, } from '../session-adapter-cache.js';
 import { startWorkspaceSessionLogoDom } from '../workspace-session-logo-dom.js';
 import { startWorkspaceSessionArchiveDom } from '../workspace-session-archive-dom.js';
+import { startWorkspaceSessionVisibilityDom } from '../workspace-session-visibility-dom.js';
 import { WorkspaceSessionEnhancementPanel } from './workspace-session-enhancement-panel.js';
 import { registerSubscriptionSlot } from '../subscription-slot.js';
+import { registerQuickPhraseSlot } from '../quick-phrase-slot.js';
 /** DSH 0.1.6 原生会话行增强：Logo 与归档会话入口共用同一生命周期。 */
 export const workspaceSessionEnhancementFeature = {
     descriptor: {
         name: 'workspaceSessionEnhancement',
-        version: '0.1.0',
+        version: '0.1.1',
         enabledByDefault: false,
         dependencies: ['cliAdapters'],
         runtime: 'client',
         ui: {
             label: '工作区会话增强',
-            description: '在原生工作区会话行显示 Agent Logo、归档入口和订阅/用量信息。',
+            description: '在原生工作区会话行显示 Agent Logo、归档入口、工作区隐藏/恢复入口和订阅/用量信息，并提供本地快捷会话。',
             labelKey: 'feature.workspaceSession.label',
             descriptionKey: 'feature.workspaceSession.description',
             order: 35,
@@ -27,17 +29,45 @@ export const workspaceSessionEnhancementFeature = {
         let generation = 0;
         let logoDom;
         let archiveDom;
+        let visibilityDom;
+        let adapterRefreshTimer;
         let disposeSubscription;
+        let disposeQuickPhrases;
         const disableLogo = () => {
             generation += 1;
             logoDom?.dispose();
             logoDom = undefined;
+            if (adapterRefreshTimer !== undefined) {
+                globalThis.clearInterval(adapterRefreshTimer);
+                adapterRefreshTimer = undefined;
+            }
             clearSessionAdapters();
         };
         const enableArchive = () => {
             if (archiveDom === undefined)
                 archiveDom = startWorkspaceSessionArchiveDom({ remote: context.services.remote });
         };
+        const enableWorkspaceVisibility = (hiddenWorkspaceIds) => {
+            if (visibilityDom === undefined) {
+                visibilityDom = startWorkspaceSessionVisibilityDom({
+                    remote: context.services.remote,
+                    hiddenWorkspaceIds,
+                    onHiddenWorkspaceIdsChange: async (ids) => {
+                        await context.services.settings.mutate([{
+                                op: 'set',
+                                path: ['workspaceSessionEnhancement', 'hiddenWorkspaceIds'],
+                                value: [...ids],
+                            }]);
+                    },
+                });
+                return;
+            }
+            visibilityDom.setHiddenWorkspaceIds(hiddenWorkspaceIds);
+        };
+        const disableWorkspaceVisibility = () => {
+            visibilityDom?.dispose();
+            visibilityDom = undefined;
+        };
         const enableSubscription = () => {
             if (disposeSubscription !== undefined || context.services.slots === undefined)
                 return;
@@ -47,26 +77,43 @@ export const workspaceSessionEnhancementFeature = {
             disposeSubscription?.();
             disposeSubscription = undefined;
         };
+        const enableQuickPhrases = () => {
+            if (disposeQuickPhrases !== undefined || context.services.slots === undefined || context.services.locale === undefined)
+                return;
+            disposeQuickPhrases = registerQuickPhraseSlot(context.services.slots, context.services.settings, context.services.locale);
+        };
+        const disableQuickPhrases = () => {
+            disposeQuickPhrases?.();
+            disposeQuickPhrases = undefined;
+        };
         const disposeAll = () => {
             disableLogo();
             archiveDom?.dispose();
             archiveDom = undefined;
+            disableWorkspaceVisibility();
             disableSubscription();
+            disableQuickPhrases();
         };
         const enableLogo = () => {
             if (logoDom !== undefined)
                 return;
             const currentGeneration = ++generation;
             logoDom = startWorkspaceSessionLogoDom();
-            void fetchSessionAdapters(context.services.rpc)
-                .then((bindings) => {
-                if (generation !== currentGeneration || logoDom === undefined)
-                    return;
-                replaceSessionAdapters(bindings);
-                logoDom.refresh();
-                archiveDom?.refresh();
-            })
-                .catch(() => undefined);
+            const refreshAdapters = () => {
+                void fetchSessionAdapters(context.services.rpc)
+                    .then((bindings) => {
+                    if (generation !== currentGeneration || logoDom === undefined)
+                        return;
+                    replaceSessionAdapters(bindings);
+                    logoDom.refresh();
+                    archiveDom?.refresh();
+                })
+                    .catch(() => undefined);
+            };
+            refreshAdapters();
+            // 旧会话在 DSH 中按需加载；加载后 Host 才能识别其适配器。定期拉取
+            // 脱敏映射，确保侧栏不会一直停留在首次扫描时的默认 DSH 图标。
+            adapterRefreshTimer = globalThis.setInterval(refreshAdapters, 2_000);
         };
         const sync = () => {
             const workspaceSettings = context.services.settings.getSnapshot().value?.workspaceSessionEnhancement;
@@ -78,6 +125,14 @@ export const workspaceSessionEnhancementFeature = {
                 archiveDom?.dispose();
                 archiveDom = undefined;
             }
+            const showWorkspaceHiding = workspaceSettings?.showWorkspaceHiding
+                ?? DEFAULT_WORKSPACE_SESSION_ENHANCEMENT_SETTINGS.showWorkspaceHiding;
+            const hiddenWorkspaceIds = workspaceSettings?.hiddenWorkspaceIds
+                ?? DEFAULT_WORKSPACE_SESSION_ENHANCEMENT_SETTINGS.hiddenWorkspaceIds;
+            if (showWorkspaceHiding)
+                enableWorkspaceVisibility(hiddenWorkspaceIds);
+            else
+                disableWorkspaceVisibility();
             const showAdapterLogo = workspaceSettings?.showAdapterLogo
                 ?? DEFAULT_WORKSPACE_SESSION_ENHANCEMENT_SETTINGS.showAdapterLogo;
             if (showAdapterLogo)
@@ -90,6 +145,12 @@ export const workspaceSessionEnhancementFeature = {
                 enableSubscription();
             else
                 disableSubscription();
+            const showQuickPhrases = workspaceSettings?.showQuickPhrases
+                ?? DEFAULT_WORKSPACE_SESSION_ENHANCEMENT_SETTINGS.showQuickPhrases;
+            if (showQuickPhrases)
+                enableQuickPhrases();
+            else
+                disableQuickPhrases();
         };
         sync();
         const unsubscribe = context.services.settings.subscribe(sync);

package/data/build/dist/client/git-management.d.ts

@@ -0,0 +1,16 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type { CodingNsClientFeatureModule, CodingNsRpcClient } from './features/types.js';
+export declare const GIT_PROVIDER_ID = "codingns4dsh/git";
+export declare const GIT_KIND = "git";
+/** 兼容早期调用方使用的面板标识；实际注册已迁移到右侧 Sidebar。 */
+export declare const GIT_PANEL_ID = "codingns4dsh/git";
+type GitServices = {
+    readonly rpc: CodingNsRpcClient;
+    readonly remote?: unknown;
+};
+/** 注册 DSH 右侧 Sidebar 的 Git 标签类型，数据按 Workspace 复用。 */
+export declare function registerGitManagementUi(ctx: Context, services: GitServices): () => void;
+export declare function resolveGitWorkspaceId(remote: unknown, sessionId: string): Promise<string | undefined>;
+export declare const gitManagementFeature: CodingNsClientFeatureModule;
+export {};
+//# sourceMappingURL=git-management.d.ts.map