@jingyi0605/codingns4dsh 0.1.0

package/data/build/dist/client/session-adapter-cache.d.ts

@@ -0,0 +1,18 @@
+import type { CodingNsSessionAdapterBinding } from '../shared/contracts/cli-adapter.js';
+import type { CodingNsRpcClient } from './features/types.js';
+type CacheListener = () => void;
+/** 返回一个会话当前绑定的适配器；查询成本为 O(1)。 */
+export declare function sessionAdapterId(sessionId: string): string | undefined;
+/** 同一浏览器内 Agent 选择变化时增量更新缓存。 */
+export declare function publishSessionAdapter(sessionId: string, adapterId: string): void;
+/** 用 Host 的一次脱敏快照替换缓存，不保留已经消失的旧绑定。 */
+export declare function replaceSessionAdapters(bindings: readonly CodingNsSessionAdapterBinding[]): void;
+/** 一次 RPC 读取全部脱敏绑定；不会按 DOM 行逐条请求。 */
+export declare function fetchSessionAdapters(rpc: CodingNsRpcClient): Promise<readonly CodingNsSessionAdapterBinding[]>;
+export declare function subscribeSessionAdapters(listener: CacheListener): () => void;
+/** 模块停用时清空内存关系，避免跨 generation 使用旧绑定。 */
+export declare function clearSessionAdapters(): void;
+/** 只供测试和诊断读取的脱敏快照。 */
+export declare function sessionAdapterSnapshot(): Readonly<Record<string, string>>;
+export {};
+//# sourceMappingURL=session-adapter-cache.d.ts.map

package/data/build/dist/client/session-adapter-cache.js

@@ -0,0 +1,84 @@
+import { callCliRpc } from './cli-catalog.js';
+const adaptersBySession = new Map();
+const listeners = new Set();
+/** 返回一个会话当前绑定的适配器；查询成本为 O(1)。 */
+export function sessionAdapterId(sessionId) {
+    return adaptersBySession.get(sessionId);
+}
+/** 同一浏览器内 Agent 选择变化时增量更新缓存。 */
+export function publishSessionAdapter(sessionId, adapterId) {
+    const normalizedSessionId = sessionId.trim();
+    const normalizedAdapterId = adapterId.trim();
+    if (normalizedSessionId === '' || normalizedAdapterId === '')
+        return;
+    if (adaptersBySession.get(normalizedSessionId) === normalizedAdapterId)
+        return;
+    adaptersBySession.set(normalizedSessionId, normalizedAdapterId);
+    notify();
+}
+/** 用 Host 的一次脱敏快照替换缓存，不保留已经消失的旧绑定。 */
+export function replaceSessionAdapters(bindings) {
+    const next = new Map();
+    for (const binding of bindings) {
+        const sessionId = binding.sessionId.trim();
+        const adapterId = binding.adapterId.trim();
+        if (sessionId !== '' && adapterId !== '')
+            next.set(sessionId, adapterId);
+    }
+    if (sameBindings(next))
+        return;
+    adaptersBySession.clear();
+    for (const [sessionId, adapterId] of next)
+        adaptersBySession.set(sessionId, adapterId);
+    notify();
+}
+/** 一次 RPC 读取全部脱敏绑定；不会按 DOM 行逐条请求。 */
+export async function fetchSessionAdapters(rpc) {
+    const value = await callCliRpc(rpc, 'session/adapter-map', {});
+    if (!Array.isArray(value))
+        return [];
+    return value
+        .filter(isSessionAdapterBinding)
+        .map((binding) => ({
+        sessionId: binding.sessionId.trim(),
+        adapterId: binding.adapterId.trim(),
+    }));
+}
+export function subscribeSessionAdapters(listener) {
+    listeners.add(listener);
+    return () => listeners.delete(listener);
+}
+/** 模块停用时清空内存关系，避免跨 generation 使用旧绑定。 */
+export function clearSessionAdapters() {
+    if (adaptersBySession.size === 0)
+        return;
+    adaptersBySession.clear();
+    notify();
+}
+/** 只供测试和诊断读取的脱敏快照。 */
+export function sessionAdapterSnapshot() {
+    return Object.fromEntries(adaptersBySession);
+}
+function sameBindings(next) {
+    if (next.size !== adaptersBySession.size)
+        return false;
+    for (const [sessionId, adapterId] of next) {
+        if (adaptersBySession.get(sessionId) !== adapterId)
+            return false;
+    }
+    return true;
+}
+function notify() {
+    for (const listener of [...listeners])
+        listener();
+}
+function isSessionAdapterBinding(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        return false;
+    const record = value;
+    return typeof record.sessionId === 'string'
+        && record.sessionId.trim() !== ''
+        && typeof record.adapterId === 'string'
+        && record.adapterId.trim() !== '';
+}
+//# sourceMappingURL=session-adapter-cache.js.map

package/data/build/dist/client/settings-bridge.d.ts

@@ -0,0 +1,32 @@
+import type { SettingsScope, SettingsScopeSnapshot } from '@deepseek-ai/dsh-client-ui-settings/client';
+import type { CodingNsSettings } from '../shared/contracts/config.js';
+import type { CodingNsRpcClient } from './features/types.js';
+type SettingsMutation = Parameters<SettingsScope<CodingNsSettings>['mutate']>[0];
+type SnapshotListener = () => void;
+/**
+ * 把 DSH 本地设置和远程 Host 设置 RPC 统一成一个设置作用域。
+ * 非回环页面使用 RPC，回环页面完全复用 DSH 的原生设置传输。
+ */
+export declare class CodingNsSettingsBridge implements SettingsScope<CodingNsSettings> {
+    private readonly local;
+    private readonly rpc;
+    private snapshot;
+    private readonly listeners;
+    private readonly localUnsubscribe;
+    private remoteLoad;
+    private remoteLoaded;
+    constructor(local: SettingsScope<CodingNsSettings>, rpc: CodingNsRpcClient);
+    getSnapshot(): SettingsScopeSnapshot<CodingNsSettings>;
+    subscribe(listener: SnapshotListener): () => void;
+    load(): Promise<void>;
+    set(field: string, value: unknown): Promise<void>;
+    unset(field: string): Promise<void>;
+    mutate(ops: SettingsMutation, expectedRevision?: number): Promise<void>;
+    dispose(): void;
+    private call;
+    private publish;
+    private isRemote;
+}
+export declare function createCodingNsSettingsBridge(local: SettingsScope<CodingNsSettings>, rpc: CodingNsRpcClient): CodingNsSettingsBridge;
+export {};
+//# sourceMappingURL=settings-bridge.d.ts.map

package/data/build/dist/client/settings-bridge.js

@@ -0,0 +1,126 @@
+import { CODINGNS_RPC_CHANNEL } from '../shared/contracts/transport.js';
+/**
+ * 把 DSH 本地设置和远程 Host 设置 RPC 统一成一个设置作用域。
+ * 非回环页面使用 RPC，回环页面完全复用 DSH 的原生设置传输。
+ */
+export class CodingNsSettingsBridge {
+    local;
+    rpc;
+    snapshot;
+    listeners = new Set();
+    localUnsubscribe;
+    remoteLoad;
+    remoteLoaded = false;
+    constructor(local, rpc) {
+        this.local = local;
+        this.rpc = rpc;
+        this.snapshot = local.getSnapshot();
+        this.localUnsubscribe = local.subscribe(() => {
+            if (this.isRemote()) {
+                void this.load().catch(() => undefined);
+                return;
+            }
+            this.remoteLoaded = false;
+            this.publish(local.getSnapshot());
+        });
+    }
+    getSnapshot() { return this.snapshot; }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    async load() {
+        if (!this.isRemote())
+            return;
+        if (this.remoteLoaded)
+            return;
+        if (this.remoteLoad !== undefined)
+            return this.remoteLoad;
+        this.remoteLoad = this.call('settings/get', {}).then((response) => {
+            this.remoteLoaded = true;
+            this.publish({
+                status: 'ready',
+                value: response.value,
+                base: undefined,
+                user: undefined,
+                revision: response.revision,
+                writable: true,
+                mode: 'host',
+            });
+        }).finally(() => {
+            this.remoteLoad = undefined;
+        });
+        return this.remoteLoad;
+    }
+    async set(field, value) {
+        if (!this.isRemote())
+            return this.local.set(field, value);
+        return this.mutate([{ op: 'set', path: [field], value: toJsonValue(value) }]);
+    }
+    async unset(field) {
+        if (!this.isRemote())
+            return this.local.unset(field);
+        return this.mutate([{ op: 'unset', path: [field] }]);
+    }
+    async mutate(ops, expectedRevision) {
+        if (!this.isRemote())
+            return this.local.mutate(ops, expectedRevision);
+        const payload = expectedRevision === undefined ? { ops } : { ops, expectedRevision };
+        const response = await this.call('settings/set', payload);
+        this.remoteLoaded = true;
+        this.publish({
+            ...this.snapshot,
+            status: 'ready',
+            value: response.value,
+            revision: response.revision,
+            writable: true,
+            mode: 'host',
+        });
+    }
+    dispose() { this.localUnsubscribe(); }
+    async call(endpoint, payload) {
+        let result;
+        try {
+            result = await this.rpc.call(CODINGNS_RPC_CHANNEL, endpoint, payload);
+        }
+        catch (error) {
+            // DSH 原生连接通常把自定义 RPC 映射到 /api；保留逻辑通道兼容
+            // Codingns4DSH Transport，同时在普通 Web Host 上回退到实际 Fetch 路由。
+            const message = error instanceof Error ? error.message : String(error);
+            if (!/HTTP (?:404|405)\b/u.test(message))
+                throw error;
+            result = await this.rpc.call('/api', `codingns/${endpoint}`, payload);
+        }
+        if (!result.ok)
+            throw new Error(result.error.message);
+        return result.value;
+    }
+    publish(next) {
+        this.snapshot = next;
+        for (const listener of [...this.listeners])
+            listener();
+    }
+    isRemote() {
+        const snapshot = this.local.getSnapshot();
+        return snapshot.mode === 'memory' || snapshot.status === 'unavailable';
+    }
+}
+/** 设置 RPC 只能传 JSON；在浏览器边界尽早拒绝函数、循环引用等无效值。 */
+function toJsonValue(value) {
+    if (value === null || typeof value === 'string' || typeof value === 'boolean')
+        return value;
+    if (typeof value === 'number' && Number.isFinite(value))
+        return value;
+    if (Array.isArray(value))
+        return value.map(toJsonValue);
+    if (typeof value !== 'object')
+        throw new TypeError('设置值必须是可序列化的 JSON');
+    const result = {};
+    for (const [key, entry] of Object.entries(value))
+        result[key] = toJsonValue(entry);
+    return result;
+}
+export function createCodingNsSettingsBridge(local, rpc) {
+    return new CodingNsSettingsBridge(local, rpc);
+}
+//# sourceMappingURL=settings-bridge.js.map

package/data/build/dist/client/settings-section.d.ts

@@ -0,0 +1,30 @@
+import type { ReactElement } from 'react';
+import type { PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import type { SettingsScope, SettingsSectionOwnerProps } from '@deepseek-ai/dsh-client-ui-settings/client';
+import type { FeatureRegistry } from '../features/registry.js';
+import { type RestartFeatureStates, type CodingNsSettings } from '../shared/contracts/config.js';
+import type { CodingNsClientFeatureModule, CodingNsClientServices } from './features/types.js';
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface SlotMap {
+        'settings.section': {
+            kind: 'list';
+            scope: 'root';
+            owner: SettingsSectionOwnerProps;
+        };
+    }
+}
+export interface CodingNsSectionProps extends PropsRuntime<'settings.section'> {
+    readonly settings: SettingsScope<CodingNsSettings>;
+    readonly registry: FeatureRegistry<CodingNsClientServices, CodingNsClientFeatureModule>;
+    readonly services: CodingNsClientServices;
+    /** 当前 Client 进程启动时捕获的重启生效模块状态。 */
+    readonly restartStates?: RestartFeatureStates;
+}
+/**
+ * DSH 设置页中的 Codingns4DSH 区块。
+ *
+ * 它只做一件事：遍历注册表中带界面描述的模块并渲染卡片。卡片内容来自模块
+ * 自己的 settingsPanel，所以新增模块不会在这里产生分支。
+ */
+export declare function CodingNsSettingsSection({ settings, registry, services, restartStates }: CodingNsSectionProps): ReactElement;
+//# sourceMappingURL=settings-section.d.ts.map

package/data/build/dist/client/settings-section.js

@@ -0,0 +1,93 @@
+import { createElement, useState, useSyncExternalStore } from 'react';
+import { CODINGNS_MODULES_FIELD, isFeatureEnabled, isFeatureDshVersionCompatible, } from '../shared/contracts/config.js';
+import { settingsModules } from './features/index.js';
+import { dshSettingsBodyStyle, dshSettingsCardStyle, dshSettingsHeaderStyle, dshSettingsPageStyle, dshSettingsSubtitleStyle, dshSettingsSummaryDescriptionStyle, dshSettingsSummaryLabelStyle, dshSettingsSummaryStyle, dshSettingsSummaryTextStyle, dshSettingsTitleStyle, dshThemeColor, } from './theme.js';
+import { useCodingNsTranslator } from './locale.js';
+import { isLegacyDshVersion } from '../shared/contracts/version.js';
+/**
+ * DSH 设置页中的 Codingns4DSH 区块。
+ *
+ * 它只做一件事：遍历注册表中带界面描述的模块并渲染卡片。卡片内容来自模块
+ * 自己的 settingsPanel，所以新增模块不会在这里产生分支。
+ */
+export function CodingNsSettingsSection({ settings, registry, services, restartStates = {} }) {
+    const snapshot = useSyncExternalStore((listener) => settings.subscribe(listener), () => settings.getSnapshot(), () => settings.getSnapshot());
+    const t = useCodingNsTranslator(services.locale);
+    return createElement('section', { style: dshSettingsPageStyle }, createElement('header', { style: dshSettingsHeaderStyle }, createElement('h2', { style: dshSettingsTitleStyle }, t('settings.title')), createElement('p', { style: dshSettingsSubtitleStyle }, t('settings.subtitle'))), createElement('div', { style: { display: 'flex', flexDirection: 'column', gap: 12 } }, settingsModules(registry).map((entry) => createElement(FeatureCard, {
+        key: entry.module.descriptor.name,
+        entry,
+        snapshot,
+        services,
+        restartStates,
+    }))));
+}
+/** 通用功能模块卡片：标题栏开关由 descriptor.ui 决定，内容由模块自己提供。 */
+function FeatureCard({ entry, snapshot, services, restartStates }) {
+    const { module, ui } = entry;
+    const t = useCodingNsTranslator(services.locale);
+    const [writeError, setWriteError] = useState(null);
+    const versionCompatible = isFeatureDshVersionCompatible(module.descriptor, services.dshVersion);
+    const requestedEnabled = isFeatureEnabled(module.descriptor, snapshot.value);
+    const enabled = versionCompatible && requestedEnabled;
+    const effectiveEnabled = module.descriptor.activation === 'restart'
+        ? versionCompatible && (restartStates[module.descriptor.name] ?? module.descriptor.enabledByDefault)
+        : enabled;
+    const panel = module.settingsPanel;
+    // 常驻模块不提供关闭入口；设置未就绪或只读时也不允许切换。
+    const switchDisabled = ui.alwaysEnabled === true || !versionCompatible || snapshot.status === 'loading' || !snapshot.writable;
+    const toggle = (next) => {
+        setWriteError(null);
+        if (!versionCompatible) {
+            setWriteError(t('settings.versionBlocked', {
+                version: services.dshVersion,
+                minimum: module.descriptor.minimumDshVersion ?? '未知版本',
+            }));
+            return;
+        }
+        void services.settings
+            .mutate([{ op: 'set', path: [CODINGNS_MODULES_FIELD, module.descriptor.name], value: next }])
+            .catch((cause) => {
+            setWriteError(cause instanceof Error ? cause.message : String(cause));
+        });
+    };
+    return createElement('details', {
+        defaultOpen: ui.defaultOpen === true,
+        style: dshSettingsCardStyle,
+    }, createElement('summary', {
+        style: dshSettingsSummaryStyle,
+    }, createElement('span', { style: dshSettingsSummaryTextStyle }, createElement('span', { style: dshSettingsSummaryLabelStyle }, t(ui.labelKey ?? ui.label)), createElement('span', { style: dshSettingsSummaryDescriptionStyle }, t(ui.descriptionKey ?? ui.description))), createElement(FeatureSwitch, {
+        label: t(ui.labelKey ?? ui.label),
+        checked: enabled,
+        disabled: switchDisabled,
+        onChange: toggle,
+    })), createElement('div', { style: dshSettingsBodyStyle }, versionCompatible && ui.legacyFallback === true && isLegacyDshVersion(services.dshVersion)
+        ? createElement('div', { role: 'status', style: { marginBottom: 10, color: dshThemeColor.labelSecondary } }, t(ui.legacyFallbackKey ?? 'settings.legacyFallback'))
+        : null, !versionCompatible
+        ? createElement('div', { role: 'alert', style: { marginBottom: 10, color: dshThemeColor.error } }, t('settings.versionBlocked', {
+            version: services.dshVersion,
+            minimum: module.descriptor.minimumDshVersion ?? '未知版本',
+        }))
+        : null, module.descriptor.activation !== 'restart' ? null : createElement('div', { role: 'status', style: { display: 'flex', flexDirection: 'column', gap: 4, padding: 10, border: `1px solid ${dshThemeColor.border}`, borderRadius: 6, fontSize: 13 } }, createElement('span', undefined, t('settings.restartTarget', { state: enabled ? t('settings.enabled') : t('settings.disabled') })), effectiveEnabled === enabled
+        ? createElement('span', undefined, t('settings.runtimeReported'))
+        : createElement('strong', undefined, t('settings.restartRequired'))), panel === undefined ? null : createElement(panel, { services, enabled, snapshot }), writeError === null ? null : createElement('div', { role: 'alert', style: { color: dshThemeColor.error } }, writeError)));
+}
+/** 标题栏开关：真实 checkbox 语义，点击不会连带折叠卡片。 */
+function FeatureSwitch({ label, checked, disabled, onChange }) {
+    return createElement('label', {
+        style: { position: 'relative', display: 'inline-flex', flex: '0 0 auto', width: 44, height: 24, opacity: disabled ? 0.55 : 1, cursor: disabled ? 'not-allowed' : 'pointer' },
+        onClick: (event) => event.stopPropagation(),
+    }, createElement('input', {
+        type: 'checkbox',
+        role: 'switch',
+        'aria-label': label,
+        checked,
+        disabled,
+        onChange: (event) => onChange(event.currentTarget.checked),
+        style: { position: 'absolute', inset: 0, width: '100%', height: '100%', margin: 0, opacity: 0, cursor: 'inherit', zIndex: 1 },
+    }), createElement('span', {
+        style: { position: 'absolute', inset: 0, display: 'flex', alignItems: 'center', padding: 2, borderRadius: 999, background: checked ? dshThemeColor.accent : dshThemeColor.surfaceSubtle, border: `1px solid ${dshThemeColor.border}`, boxSizing: 'border-box', transition: 'background 160ms ease' },
+    }, createElement('span', {
+        style: { width: 18, height: 18, flex: '0 0 18px', borderRadius: '50%', background: dshThemeColor.switchThumb, boxShadow: dshThemeColor.subtleShadow, transform: `translateX(${checked ? 20 : 0}px)`, transition: 'transform 160ms ease' },
+    })));
+}
+//# sourceMappingURL=settings-section.js.map

package/data/build/dist/client/subscription-slot.d.ts

@@ -0,0 +1,18 @@
+import type { ReactElement } from 'react';
+import type { SlotRegistry } from '@deepseek-ai/dsh-client-ui-renderer/client';
+import type { CodingNsRpcClient } from './features/types.js';
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface SessionStandardProps {
+        sessionId: string;
+    }
+}
+interface SubscriptionSlotProps {
+    readonly rpc: CodingNsRpcClient;
+    readonly sessionId?: string;
+}
+/** 在 DSH 原生步骤统计左侧显示当前 Agent 的订阅余量。 */
+export declare function registerSubscriptionSlot(slots: SlotRegistry, rpc: CodingNsRpcClient): () => void;
+declare function CommandCodeSubscriptionSlot(props: SubscriptionSlotProps): ReactElement | null;
+export { CommandCodeSubscriptionSlot };
+export declare const registerCommandCodeSubscriptionSlot: typeof registerSubscriptionSlot;
+//# sourceMappingURL=subscription-slot.d.ts.map

package/data/build/dist/client/subscription-slot.js

@@ -0,0 +1,223 @@
+import { createElement, useEffect, useRef, useState } from 'react';
+import { callCliRpc } from './cli-catalog.js';
+import { dshPopupSurfaceStyle, dshThemeColor } from './theme.js';
+/** 在 DSH 原生步骤统计左侧显示当前 Agent 的订阅余量。 */
+export function registerSubscriptionSlot(slots, rpc) {
+    return slots.inject('conversation.composer.dock', () => slots.register({
+        name: 'conversation.composer.dock',
+        id: 'codingns4dsh-subscription',
+        order: -20,
+        label: 'Agent 订阅余量',
+        inject: (sessionId) => ({ rpc, sessionId }),
+    }, CommandCodeSubscriptionSlot));
+}
+function CommandCodeSubscriptionSlot(props) {
+    const [usage, setUsage] = useState(null);
+    const [adapterId, setAdapterId] = useState(null);
+    const [eligible, setEligible] = useState(false);
+    const [open, setOpen] = useState(false);
+    const [loading, setLoading] = useState(false);
+    const [clock, setClock] = useState(() => Date.now());
+    const rootRef = useRef(null);
+    useEffect(() => {
+        const sessionId = props.sessionId?.trim();
+        if (!sessionId) {
+            setEligible(false);
+            setUsage(null);
+            setAdapterId(null);
+            setOpen(false);
+            return;
+        }
+        let active = true;
+        setEligible(false);
+        setUsage(null);
+        setAdapterId(null);
+        setOpen(false);
+        const refresh = async () => {
+            setLoading(true);
+            try {
+                const selection = await callCliRpc(props.rpc, 'session/get', { sessionId });
+                const adapterId = selection.adapterId;
+                if (!active || !isSubscriptionAdapter(adapterId)) {
+                    if (active) {
+                        setEligible(false);
+                        setUsage(null);
+                        setAdapterId(null);
+                    }
+                    return;
+                }
+                if (active) {
+                    setEligible(true);
+                    setAdapterId(adapterId);
+                }
+                const next = await callCliRpc(props.rpc, 'subscription', { adapterId });
+                if (active)
+                    setUsage(next);
+            }
+            catch {
+                if (active) {
+                    setEligible(false);
+                    setUsage(null);
+                }
+            }
+            finally {
+                if (active)
+                    setLoading(false);
+            }
+        };
+        void refresh();
+        const timer = globalThis.setInterval(() => { void refresh(); }, 5 * 60_000);
+        return () => {
+            active = false;
+            globalThis.clearInterval(timer);
+        };
+    }, [props.rpc, props.sessionId]);
+    useEffect(() => {
+        if (!eligible || usage === null)
+            return;
+        const timer = globalThis.setInterval(() => setClock(Date.now()), 60_000);
+        return () => globalThis.clearInterval(timer);
+    }, [eligible, usage]);
+    useEffect(() => {
+        if (!open)
+            return;
+        const closeOnPointerDown = (event) => {
+            const target = event.target;
+            if (target instanceof Node && !rootRef.current?.contains(target))
+                setOpen(false);
+        };
+        const closeOnEscape = (event) => {
+            if (event.key === 'Escape')
+                setOpen(false);
+        };
+        document.addEventListener('pointerdown', closeOnPointerDown);
+        document.addEventListener('keydown', closeOnEscape);
+        return () => {
+            document.removeEventListener('pointerdown', closeOnPointerDown);
+            document.removeEventListener('keydown', closeOnEscape);
+        };
+    }, [open]);
+    // 未拿到真实订阅数据时不占用底部栏空间；加载状态不能伪装成订阅存在。
+    if (!eligible || usage === null || (usage.sub2api === undefined && resolveDisplayWindow(usage) === null))
+        return null;
+    const sub2api = usage.sub2api;
+    const displayWindow = sub2api === undefined ? resolveDisplayWindow(usage) : null;
+    const remaining = displayWindow?.remainingPercent ?? null;
+    const resetLabel = displayWindow === null ? null : formatCountdown(displayWindow.resetsAt, clock);
+    const providerName = subscriptionProviderName(adapterId);
+    const label = sub2api === undefined
+        ? `${providerName} 订阅余量 ${formatPercent(remaining ?? 0)}%`
+        : `${providerName} 上游余额 ${formatSub2ApiMoney(sub2api.balance, sub2api.unit)}`;
+    const logoSource = sub2api === undefined ? '' : (sub2api.logoDataUrl ?? (isRemoteWebContext() ? '' : sub2api.logoUrl));
+    return createElement('div', { ref: rootRef, style: subscriptionRootStyle }, createElement('button', {
+        type: 'button',
+        onClick: () => setOpen((value) => !value),
+        disabled: loading && usage === null,
+        'aria-label': label,
+        'aria-expanded': open,
+        style: subscriptionTriggerStyle,
+    }, sub2api === undefined
+        ? createElement('span', { 'aria-hidden': true, style: progressRingStyle() }, createElement('span', { style: { ...progressRingVisualStyle, background: progressRingVisualBackground(remaining === null ? 0 : remaining / 100, false) } }, createElement('span', { style: progressRingValueStyle }, createElement('span', undefined, formatRingPercentage(remaining ?? 0)), createElement('span', { style: progressRingSuffixStyle }, '%'))))
+        : createElement('span', { 'aria-hidden': true, style: sub2apiIdentityStyle }, logoSource !== '' && createElement('img', { src: logoSource, alt: '', width: 20, height: 20, style: sub2apiLogoStyle }), createElement('span', undefined, formatSub2ApiMoney(sub2api.balance, sub2api.unit))), createElement('span', { className: 'bOPqQW_label', style: subscriptionLabelStyle }, sub2api === undefined ? (resetLabel ?? '订阅余量') : `今日 ${formatSub2ApiMoney(sub2api.today.cost, sub2api.unit)}`)), open && createElement(SubscriptionPopover, { usage, providerName }));
+}
+function SubscriptionPopover({ usage, providerName }) {
+    if (usage.sub2api !== undefined)
+        return createElement(Sub2ApiPopover, { usage: usage.sub2api, providerName });
+    const windows = [
+        ['5 小时额度', usage.primary],
+        ['周额度', usage.secondary],
+        ['月额度', usage.monthly],
+    ];
+    return createElement('div', { role: 'dialog', 'aria-label': `${providerName} 订阅使用情况`, style: subscriptionPopoverStyle }, createElement('div', { style: popoverHeadingStyle }, createElement('strong', undefined, `${providerName} 订阅`), usage.planType && createElement('span', { style: { color: dshThemeColor.labelTertiary } }, formatPlanType(usage.planType))), ...windows.map(([label, window]) => window === null ? null : createElement('section', { key: label, style: windowStyle }, createElement('div', { style: windowHeadingStyle }, createElement('span', undefined, label), createElement('span', undefined, `${formatPercent(window.remainingPercent)}%`)), createElement('div', { role: 'progressbar', 'aria-label': `${label}剩余 ${formatPercent(window.remainingPercent)}%`, 'aria-valuemin': 0, 'aria-valuemax': 100, 'aria-valuenow': window.remainingPercent, style: barStyle }, createElement('span', { style: { ...barFillStyle, width: `${window.remainingPercent}%` } })), window.resetsAt !== null && createElement('div', { style: resetStyle }, `重置于 ${formatCountdown(window.resetsAt)}`))));
+}
+function Sub2ApiPopover({ usage, providerName }) {
+    return createElement('div', { role: 'dialog', 'aria-label': `${providerName} 上游用量`, style: subscriptionPopoverStyle }, createElement('div', { style: popoverHeadingStyle }, createElement('strong', undefined, `${providerName} 上游用量`), createElement('span', { style: { color: dshThemeColor.labelTertiary } }, formatSub2ApiMoney(usage.balance, usage.unit))), createElement('div', { style: upstreamMetaStyle }, createElement('span', { style: upstreamTypeStyle }, usage.upstreamType), usage.upstreamUrl === ''
+        ? createElement('span', { style: upstreamMutedStyle }, '地址未提供')
+        : createElement('a', { href: usage.upstreamUrl, target: '_blank', rel: 'noreferrer', title: usage.upstreamUrl, style: upstreamLinkStyle }, usage.upstreamUrl)), createElement('div', { style: sub2apiStatsGridStyle }, createSub2ApiStat('今日请求数', formatInteger(usage.today.requests)), createSub2ApiStat('今日 Token 用量', formatSub2ApiTokens(usage.today.totalTokens)), createSub2ApiStat('今日费用', formatSub2ApiMoney(usage.today.cost, usage.unit)), createSub2ApiStat('累计请求数', formatInteger(usage.total.requests)), createSub2ApiStat('累计 Token 用量', formatSub2ApiTokens(usage.total.totalTokens)), createSub2ApiStat('累计费用', formatSub2ApiMoney(usage.total.cost, usage.unit)), createSub2ApiStat('今日缓存命中率', formatSub2ApiPercent(usage.today.cacheHitRate)), createSub2ApiStat('累计缓存命中率', formatSub2ApiPercent(usage.total.cacheHitRate))), createElement('section', { style: sub2apiSectionStyle }, createElement('strong', { style: sub2apiSectionTitleStyle }, '按模型统计'), usage.models.length === 0
+        ? createElement('div', { style: resetStyle }, '暂无按模型统计')
+        : createElement('div', { style: sub2apiTableScrollStyle }, createElement('table', { style: sub2apiTableStyle }, createElement('thead', undefined, createElement('tr', undefined, createElement('th', { style: sub2apiThStyle }, '模型'), createElement('th', { style: sub2apiThStyle }, '请求'), createElement('th', { style: sub2apiThStyle }, 'Token'), createElement('th', { style: sub2apiThStyle }, '费用'), createElement('th', { style: sub2apiThStyle }, '缓存'))), createElement('tbody', undefined, ...usage.models.map((model) => createModelRow(model, usage.unit)))))));
+}
+function createSub2ApiStat(label, value) {
+    return createElement('div', { style: sub2apiStatStyle }, createElement('span', { style: sub2apiStatLabelStyle }, label), createElement('strong', undefined, value));
+}
+function createModelRow(model, unit) {
+    return createElement('tr', { key: model.model }, createElement('td', { style: sub2apiTdStyle }, model.model), createElement('td', { style: sub2apiTdStyle }, formatInteger(model.requests)), createElement('td', { style: sub2apiTdStyle }, formatSub2ApiTokens(model.totalTokens)), createElement('td', { style: sub2apiTdStyle }, formatSub2ApiMoney(model.cost, unit)), createElement('td', { style: sub2apiTdStyle }, formatSub2ApiPercent(model.cacheHitRate)));
+}
+function resolveDisplayWindow(usage) {
+    return usage.primary ?? usage.secondary ?? usage.monthly;
+}
+function isSubscriptionAdapter(adapterId) {
+    return adapterId === 'command-code' || adapterId === 'codex' || adapterId === 'claude-code' || adapterId === 'dsh' || adapterId === 'grok' || adapterId === 'opencode';
+}
+function isRemoteWebContext() {
+    return globalThis.__CODINGNS4DSH_REMOTE_WEB_CONTEXT__ === true;
+}
+function subscriptionProviderName(adapterId) {
+    switch (adapterId) {
+        case 'command-code': return 'Command Code';
+        case 'codex': return 'Codex';
+        case 'claude-code': return 'Claude Code';
+        case 'dsh': return 'DSH';
+        case 'grok': return 'Grok';
+        case 'opencode': return 'OpenCode';
+        default: return 'Agent';
+    }
+}
+function formatPercent(value) { return Math.max(0, Math.min(100, value)).toFixed(0); }
+function formatRingPercentage(value) { return String(Math.floor(Math.max(0, Math.min(100, value)))); }
+function formatSub2ApiMoney(value, unit) {
+    const normalizedUnit = unit.trim().toUpperCase();
+    if (normalizedUnit === 'USD')
+        return `$${value.toFixed(2)}`;
+    return `${value.toFixed(2)}${normalizedUnit === '' ? '' : ` ${normalizedUnit}`}`;
+}
+function formatSub2ApiTokens(value) { return new Intl.NumberFormat('zh-CN', { notation: 'compact', maximumFractionDigits: 1 }).format(value); }
+function formatSub2ApiPercent(value) { return `${Math.max(0, Math.min(100, value)).toFixed(1)}%`; }
+function formatInteger(value) { return new Intl.NumberFormat('zh-CN').format(Math.max(0, Math.round(value))); }
+function formatPlanType(value) { return value.replace(/^individual-/u, '').replace(/(^|-)([a-z])/gu, (_match, _separator, letter) => ` ${letter.toUpperCase()}`).trim(); }
+function formatCountdown(timestampSeconds, nowMs = Date.now()) {
+    if (timestampSeconds === null)
+        return null;
+    const minutes = Math.max(0, Math.ceil((timestampSeconds * 1000 - nowMs) / 60_000));
+    const days = Math.floor(minutes / 1440);
+    const hours = Math.floor((minutes % 1440) / 60);
+    const remainder = minutes % 60;
+    if (days > 0)
+        return `${days}天${hours}小时后`;
+    if (hours > 0)
+        return `${hours}小时${remainder > 0 ? `${remainder}分钟` : ''}后`;
+    return `${remainder}分钟后`;
+}
+const subscriptionRootStyle = { position: 'relative', minWidth: 0, display: 'inline-flex', alignItems: 'center' };
+const subscriptionTriggerStyle = { display: 'inline-flex', alignItems: 'center', gap: 6, height: 28, border: 0, borderRadius: 14, padding: '0 8px 0 4px', color: dshThemeColor.labelSecondary, background: 'transparent', cursor: 'pointer', fontSize: 13, lineHeight: '20px' };
+const subscriptionLabelStyle = { whiteSpace: 'nowrap' };
+const sub2apiIdentityStyle = { display: 'inline-flex', alignItems: 'center', gap: 5, whiteSpace: 'nowrap', fontVariantNumeric: 'tabular-nums' };
+const sub2apiLogoStyle = { display: 'block', borderRadius: 4, objectFit: 'contain' };
+const progressRingVisualStyle = { boxSizing: 'border-box', width: '100%', height: '100%', display: 'inline-flex', alignItems: 'center', justifyContent: 'center', padding: 2, borderRadius: 'inherit' };
+const progressRingValueStyle = { boxSizing: 'border-box', width: '100%', height: '100%', display: 'inline-flex', alignItems: 'center', justifyContent: 'center', gap: 0.5, borderRadius: 'inherit', background: dshThemeColor.menuBackground, fontSize: 7, lineHeight: 1, fontWeight: 700, color: dshThemeColor.labelPrimary, whiteSpace: 'nowrap' };
+const progressRingSuffixStyle = { fontSize: 5.5, lineHeight: 1, color: dshThemeColor.labelTertiary, transform: 'translateY(1px)' };
+const popoverHeadingStyle = { display: 'flex', justifyContent: 'space-between', alignItems: 'center', gap: 18, paddingBottom: 10, borderBottom: `1px solid ${dshThemeColor.border}`, fontSize: 14 };
+const upstreamMetaStyle = { display: 'flex', alignItems: 'center', gap: 6, minWidth: 0, paddingTop: 8, color: dshThemeColor.labelTertiary, fontSize: 11, lineHeight: '16px' };
+const upstreamTypeStyle = { flex: '0 0 auto', color: dshThemeColor.labelSecondary, fontWeight: 600 };
+const upstreamLinkStyle = { minWidth: 0, overflow: 'hidden', color: dshThemeColor.accent, textOverflow: 'ellipsis', whiteSpace: 'nowrap', textDecoration: 'none' };
+const upstreamMutedStyle = { flex: '0 0 auto', whiteSpace: 'nowrap' };
+const windowStyle = { display: 'grid', gap: 6, paddingTop: 10 };
+const windowHeadingStyle = { display: 'flex', justifyContent: 'space-between', gap: 12, color: dshThemeColor.labelSecondary, fontSize: 13 };
+const barStyle = { height: 7, overflow: 'hidden', borderRadius: 4, background: dshThemeColor.border };
+const barFillStyle = { display: 'block', height: '100%', borderRadius: 4, background: dshThemeColor.accent, transition: 'width .2s ease' };
+const resetStyle = { color: dshThemeColor.labelTertiary, fontSize: 12 };
+const subscriptionPopoverStyle = { ...dshPopupSurfaceStyle, position: 'absolute', zIndex: 1200, bottom: 'calc(100% + 8px)', left: 0, width: 'max-content', minWidth: 280, maxWidth: 'min(400px, calc(100vw - 24px))', boxSizing: 'border-box', padding: 14, borderRadius: 12 };
+const sub2apiStatsGridStyle = { display: 'grid', gridTemplateColumns: 'repeat(2, minmax(0, 1fr))', gap: 8, paddingTop: 12 };
+const sub2apiStatStyle = { display: 'grid', gap: 2, minWidth: 0 };
+const sub2apiStatLabelStyle = { color: dshThemeColor.labelTertiary, fontSize: 11 };
+const sub2apiSectionStyle = { display: 'grid', gap: 8, paddingTop: 14 };
+const sub2apiSectionTitleStyle = { fontSize: 12, color: dshThemeColor.labelSecondary };
+const sub2apiTableScrollStyle = { maxWidth: '100%', overflow: 'visible' };
+const sub2apiTableStyle = { width: '100%', tableLayout: 'fixed', borderCollapse: 'collapse', fontSize: 11 };
+const sub2apiThStyle = { padding: '4px 5px', textAlign: 'left', color: dshThemeColor.labelTertiary, fontWeight: 500 };
+const sub2apiTdStyle = { padding: '5px', borderTop: `1px solid ${dshThemeColor.border}`, color: dshThemeColor.labelSecondary, overflowWrap: 'anywhere' };
+function progressRingStyle() { return { position: 'relative', display: 'inline-flex', flex: '0 0 28px', width: 28, height: 28, alignItems: 'center', justifyContent: 'center', borderRadius: '50%', padding: 0, border: 0, boxShadow: `inset 0 0 0 1px ${dshThemeColor.border}`, background: 'transparent' }; }
+function progressRingVisualBackground(progress, loading) { return loading ? dshThemeColor.border : `conic-gradient(${dshThemeColor.accent} ${Math.max(0, Math.min(1, progress)) * 360}deg, ${dshThemeColor.border} 0deg)`; }
+export { CommandCodeSubscriptionSlot };
+export const registerCommandCodeSubscriptionSlot = registerSubscriptionSlot;
+//# sourceMappingURL=subscription-slot.js.map

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

@@ -0,0 +1,4 @@
+export { CodingNsWebTerminals, CodingNsTerminalView } from './model.js';
+export type { TerminalCloseFailure, TerminalLaunchShells, TerminalObservable, TerminalRemote, TerminalRemoteSource, TerminalViewState } from './model.js';
+export { registerCodingNsTerminalUi, TERMINAL_KIND, TERMINAL_PROVIDER_ID } from './ui.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,3 @@
+export { CodingNsWebTerminals, CodingNsTerminalView } from './model.js';
+export { registerCodingNsTerminalUi, TERMINAL_KIND, TERMINAL_PROVIDER_ID } from './ui.js';
+//# sourceMappingURL=index.js.map