@jingyi0605/codingns4dsh 0.1.0

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

@@ -0,0 +1,66 @@
+import { createElement, useState } 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 }) {
+    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));
+        });
+    };
+    return createElement('div', {
+        'aria-disabled': disabled,
+        style: {
+            ...dshFormRootStyle,
+            display: 'flex',
+            flexDirection: 'column',
+            gap: 12,
+            opacity: disabled ? 0.5 : 1,
+            pointerEvents: disabled ? 'none' : 'auto',
+        },
+    }, createElement('label', {
+        style: dshSettingsListRowStyle,
+    }, createElement('span', { style: { minWidth: 0 } }, createElement('strong', { style: { display: 'block', fontSize: 13, lineHeight: 1.4 } }, t('workspace.showLogo')), createElement('span', { style: { display: 'block', marginTop: 3, ...dshSettingsHelpStyle } }, t('workspace.logoDescription'))), createElement('input', {
+        type: 'checkbox',
+        role: 'switch',
+        'aria-label': t('workspace.showLogo'),
+        checked: value.showAdapterLogo,
+        disabled,
+        onChange: (event) => updateSetting('showAdapterLogo', 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',
+        'aria-label': t('workspace.showSubscriptionUsage'),
+        checked: value.showSubscriptionUsage,
+        disabled,
+        onChange: (event) => updateSetting('showSubscriptionUsage', 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.showArchivedSessions')), createElement('span', { style: { display: 'block', marginTop: 3, ...dshSettingsHelpStyle } }, t('workspace.archivedSessionsDescription'))), createElement('input', {
+        type: 'checkbox',
+        role: 'switch',
+        'aria-label': t('workspace.showArchivedSessions'),
+        checked: value.showArchivedSessions,
+        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));
+}
+//# sourceMappingURL=workspace-session-enhancement-panel.js.map

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

@@ -0,0 +1,4 @@
+import type { CodingNsClientFeatureModule } from './types.js';
+/** DSH 0.1.6 原生会话行增强：Logo 与归档会话入口共用同一生命周期。 */
+export declare const workspaceSessionEnhancementFeature: CodingNsClientFeatureModule;
+//# sourceMappingURL=workspace-session-enhancement.d.ts.map

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

@@ -0,0 +1,101 @@
+import { DEFAULT_WORKSPACE_SESSION_ENHANCEMENT_SETTINGS } from '../../shared/contracts/config.js';
+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 { WorkspaceSessionEnhancementPanel } from './workspace-session-enhancement-panel.js';
+import { registerSubscriptionSlot } from '../subscription-slot.js';
+/** DSH 0.1.6 原生会话行增强：Logo 与归档会话入口共用同一生命周期。 */
+export const workspaceSessionEnhancementFeature = {
+    descriptor: {
+        name: 'workspaceSessionEnhancement',
+        version: '0.1.0',
+        enabledByDefault: false,
+        dependencies: ['cliAdapters'],
+        runtime: 'client',
+        ui: {
+            label: '工作区会话增强',
+            description: '在原生工作区会话行显示 Agent Logo、归档入口和订阅/用量信息。',
+            labelKey: 'feature.workspaceSession.label',
+            descriptionKey: 'feature.workspaceSession.description',
+            order: 35,
+            defaultOpen: true,
+            legacyFallback: true,
+            legacyFallbackKey: 'feature.workspaceSession.legacyFallback',
+        },
+    },
+    start(context) {
+        let generation = 0;
+        let logoDom;
+        let archiveDom;
+        let disposeSubscription;
+        const disableLogo = () => {
+            generation += 1;
+            logoDom?.dispose();
+            logoDom = undefined;
+            clearSessionAdapters();
+        };
+        const enableArchive = () => {
+            if (archiveDom === undefined)
+                archiveDom = startWorkspaceSessionArchiveDom({ remote: context.services.remote });
+        };
+        const enableSubscription = () => {
+            if (disposeSubscription !== undefined || context.services.slots === undefined)
+                return;
+            disposeSubscription = registerSubscriptionSlot(context.services.slots, context.services.rpc);
+        };
+        const disableSubscription = () => {
+            disposeSubscription?.();
+            disposeSubscription = undefined;
+        };
+        const disposeAll = () => {
+            disableLogo();
+            archiveDom?.dispose();
+            archiveDom = undefined;
+            disableSubscription();
+        };
+        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 sync = () => {
+            const workspaceSettings = context.services.settings.getSnapshot().value?.workspaceSessionEnhancement;
+            const showArchivedSessions = workspaceSettings?.showArchivedSessions
+                ?? DEFAULT_WORKSPACE_SESSION_ENHANCEMENT_SETTINGS.showArchivedSessions;
+            if (showArchivedSessions)
+                enableArchive();
+            else {
+                archiveDom?.dispose();
+                archiveDom = undefined;
+            }
+            const showAdapterLogo = workspaceSettings?.showAdapterLogo
+                ?? DEFAULT_WORKSPACE_SESSION_ENHANCEMENT_SETTINGS.showAdapterLogo;
+            if (showAdapterLogo)
+                enableLogo();
+            else
+                disableLogo();
+            const showSubscriptionUsage = workspaceSettings?.showSubscriptionUsage
+                ?? DEFAULT_WORKSPACE_SESSION_ENHANCEMENT_SETTINGS.showSubscriptionUsage;
+            if (showSubscriptionUsage)
+                enableSubscription();
+            else
+                disableSubscription();
+        };
+        sync();
+        const unsubscribe = context.services.settings.subscribe(sync);
+        context.resources.add(unsubscribe);
+        context.resources.add(disposeAll);
+    },
+    settingsPanel: WorkspaceSessionEnhancementPanel,
+};
+//# sourceMappingURL=workspace-session-enhancement.js.map

package/data/build/dist/client/h5-bootstrap-entry.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=h5-bootstrap-entry.d.ts.map

package/data/build/dist/client/h5-bootstrap-entry.js

@@ -0,0 +1,17 @@
+import { createHttpDshH5ControlApi, startDshH5BrowserBootstrap } from './dsh-h5-bootstrap.js';
+/**
+ * 独立 H5 静态项目使用的浏览器入口。
+ * 这里故意只暴露无凭据的工厂和启动函数；Cookie 由浏览器自动管理，
+ * 页面脚本永远拿不到 Control API 的 HttpOnly 会话内容。
+ */
+const runtime = {
+    createHttpDshH5ControlApi,
+    startDshH5BrowserBootstrap,
+};
+Object.defineProperty(globalThis, 'DshCodingNsH5', {
+    configurable: true,
+    enumerable: false,
+    value: runtime,
+    writable: false,
+});
+//# sourceMappingURL=h5-bootstrap-entry.js.map

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

@@ -0,0 +1,31 @@
+/**
+ * DSH Client 入口。
+ *
+ * 该文件只使用浏览器安全的 TypeScript/JavaScript。Client 侧能力全部以功能模块
+ * 形式交给 FeatureRegistry 管理：设置页遍历注册表渲染卡片，设置里的启用开关
+ * 驱动模块 start/disable 与资源清理。入口只负责装配与依赖声明。
+ */
+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 { chooseDshDevice, createHttpDshH5ControlApi, startDshH5Bootstrap, startDshH5BrowserBootstrap } from './dsh-h5-bootstrap.js';
+export type { DshH5BootstrapOptions, DshH5BootstrapResult, DshH5BrowserBootstrapOptions, DshH5BrowserBootstrapResult, DshH5BrowserControlApi, } from './dsh-h5-bootstrap.js';
+export { RemoteDshWebContext } from './remote-web-context.js';
+export type { RemoteDshWebBoot, RemoteDshWebContextOptions } from './remote-web-context.js';
+export 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 { 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"];
+/**
+ * 把 Codingns4DSH 设置页挂载到 DSH 设置左侧导航，并让模块开关驱动启停。
+ *
+ * 设置页与启停同步共享同一个注册表实例，所以界面上的模块清单就是运行时实际
+ * 管理的模块清单，两者不会漂移。
+ */
+export declare function apply(ctx?: Context): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,98 @@
+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 { 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 { CodingNsWebTerminals, registerCodingNsTerminalUi } from './terminal/index.js';
+import { startCodingNsAccountBar } from './account-bar.js';
+import { assertInjectedDshVersion } from './dsh-runtime-version.js';
+export { ensureCryptoRandomUUID } from './lan-access.js';
+export { CLIENT_FEATURES, settingsModules, startBrowserRelayConnection } 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 { 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'];
+/**
+ * 把 Codingns4DSH 设置页挂载到 DSH 设置左侧导航，并让模块开关驱动启停。
+ *
+ * 设置页与启停同步共享同一个注册表实例，所以界面上的模块清单就是运行时实际
+ * 管理的模块清单，两者不会漂移。
+ */
+export function apply(ctx) {
+    if (ctx === undefined)
+        return;
+    const dshVersion = assertInjectedDshVersion();
+    // 版本门禁通过后才修改浏览器全局，避免不兼容 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,
+        });
+        // 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 webTerminals = new CodingNsWebTerminals(settingsCtx, terminalRemote);
+        const disposeTerminalUi = registerCodingNsTerminalUi(settingsCtx, webTerminals, settings);
+        const services = {
+            dshVersion,
+            settings,
+            rpc: connection.rpc,
+            remote: settingsCtx.remote,
+            slots: settingsCtx.slots,
+            locale: settingsCtx.locale,
+            uiConversation: settingsCtx.uiConversation,
+            uiContext: settingsCtx,
+        };
+        const disposeAccountBar = startCodingNsAccountBar(connection.rpc, undefined, settings);
+        const registry = new FeatureRegistry(services);
+        registry.registerMany(CLIENT_FEATURES);
+        registry.validate();
+        const restartStates = {};
+        let restartStatesCaptured = false;
+        settingsCtx.effect(() => {
+            const sync = () => {
+                const snapshot = settings.getSnapshot();
+                if (!restartStatesCaptured && snapshot.status === 'ready') {
+                    Object.assign(restartStates, captureRestartFeatureStates(registry.descriptors(), snapshot.value, dshVersion));
+                    restartStatesCaptured = true;
+                }
+                void registry
+                    .reconcile(enabledFeatureNames(registry.descriptors(), snapshot.value, restartStates, dshVersion))
+                    .catch((error) => {
+                    console.error('codingns4dsh: 功能模块状态同步失败', error);
+                });
+            };
+            sync();
+            void settings.load().catch((error) => {
+                console.error('codingns4dsh: 远程设置读取失败', error);
+            });
+            const unsubscribe = settings.subscribe(sync);
+            return () => {
+                unsubscribe();
+                disposeTerminalUi();
+                disposeAccountBar.dispose();
+                void webTerminals.dispose();
+                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));
+    });
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1,28 @@
+/**
+ * 局域网访问兼容模块。
+ *
+ * 非 HTTPS 页面通常仍然暴露 `crypto.getRandomValues`，但部分浏览器不会
+ * 暴露只在安全上下文提供的 `crypto.randomUUID`。DSH 页面依赖后者生成会话
+ * 标识，因此在 Client 入口加载时补齐一个 RFC 4122 v4 实现。
+ */
+export interface LanAccessCrypto {
+    randomUUID?: () => string;
+    getRandomValues?: (array: Uint8Array) => Uint8Array;
+}
+export interface LanAccessGlobal {
+    crypto?: LanAccessCrypto;
+}
+export interface CryptoRandomUUIDInstallResult {
+    /** 安装调用结束后，目标是否拥有可调用的 randomUUID。 */
+    readonly available: boolean;
+    /** 本次调用是否新增了 randomUUID 实现。 */
+    readonly installed: boolean;
+}
+/**
+ * 确保目标页面拥有 `crypto.randomUUID`。
+ *
+ * 该函数幂等且可注入目标对象，便于在浏览器和测试环境中复用。无法修改
+ * 浏览器原生 crypto 时返回 available=false，不会阻止 DSH 继续启动。
+ */
+export declare function ensureCryptoRandomUUID(target?: LanAccessGlobal): CryptoRandomUUIDInstallResult;
+//# sourceMappingURL=lan-access.d.ts.map

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

@@ -0,0 +1,68 @@
+/**
+ * 局域网访问兼容模块。
+ *
+ * 非 HTTPS 页面通常仍然暴露 `crypto.getRandomValues`，但部分浏览器不会
+ * 暴露只在安全上下文提供的 `crypto.randomUUID`。DSH 页面依赖后者生成会话
+ * 标识，因此在 Client 入口加载时补齐一个 RFC 4122 v4 实现。
+ */
+/**
+ * 确保目标页面拥有 `crypto.randomUUID`。
+ *
+ * 该函数幂等且可注入目标对象，便于在浏览器和测试环境中复用。无法修改
+ * 浏览器原生 crypto 时返回 available=false，不会阻止 DSH 继续启动。
+ */
+export function ensureCryptoRandomUUID(target = globalThis) {
+    const cryptoObject = target.crypto;
+    if (cryptoObject === undefined)
+        return { available: false, installed: false };
+    if (typeof cryptoObject.randomUUID === 'function')
+        return { available: true, installed: false };
+    const getRandomValues = typeof cryptoObject.getRandomValues === 'function'
+        ? cryptoObject.getRandomValues.bind(cryptoObject)
+        : undefined;
+    const randomUUID = () => createUuidV4(getRandomValues);
+    try {
+        Object.defineProperty(cryptoObject, 'randomUUID', {
+            configurable: true,
+            enumerable: false,
+            value: randomUUID,
+            writable: true,
+        });
+    }
+    catch {
+        try {
+            cryptoObject.randomUUID = randomUUID;
+        }
+        catch {
+            return { available: false, installed: false };
+        }
+    }
+    return typeof cryptoObject.randomUUID === 'function'
+        ? { available: true, installed: true }
+        : { available: false, installed: false };
+}
+function createUuidV4(getRandomValues) {
+    const bytes = new Uint8Array(16);
+    if (getRandomValues !== undefined) {
+        try {
+            getRandomValues(bytes);
+        }
+        catch {
+            fillWithMathRandom(bytes);
+        }
+    }
+    else {
+        fillWithMathRandom(bytes);
+    }
+    // RFC 4122: version 4 and the variant used by the standard UUID string form.
+    bytes[6] = (bytes[6] & 0x0f) | 0x40;
+    bytes[8] = (bytes[8] & 0x3f) | 0x80;
+    const hex = Array.from(bytes, (value) => value.toString(16).padStart(2, '0')).join('');
+    return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+}
+function fillWithMathRandom(bytes) {
+    for (let index = 0; index < bytes.length; index += 1) {
+        bytes[index] = Math.floor(Math.random() * 256);
+    }
+}
+//# sourceMappingURL=lan-access.js.map

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

@@ -0,0 +1,20 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type { LocaleRuntime } from '@deepseek-ai/dsh-client-locale/client';
+import type { Translate } from '@deepseek-ai/dsh-client-ui-slots';
+/** Codingns4DSH 自有词典命名空间。词典缺少的语言由 DSH 自动回退到英文。 */
+export declare const CODINGNS_LOCALE_NS: "codingns";
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        codingns: string;
+    }
+}
+/** Client 侧服务中实际使用的 DSH 语言运行时最小接口。 */
+export type CodingNsLocale = Pick<LocaleRuntime, 'bind' | 'getSnapshot' | 'subscribe' | 'register'>;
+export type CodingNsTranslator = Translate<string>;
+/** 在当前 Client Cordis 作用域注册中英文词典。 */
+export declare function registerCodingNsLocale(ctx: Context): () => void;
+/** 订阅 DSH 语言修订，并返回当前 Codingns4DSH 命名空间翻译函数。 */
+export declare function useCodingNsTranslator(locale: CodingNsLocale): CodingNsTranslator;
+/** 非 React 注册回调使用的翻译函数。 */
+export declare function codingNsTranslator(locale: CodingNsLocale): CodingNsTranslator;
+//# sourceMappingURL=locale.d.ts.map