@jingyi0605/codingns4dsh 0.1.2 → 0.1.7-rc.3

package/data/build/dist/client/session-changed-files-view.js

@@ -0,0 +1,337 @@
+import { createElement, useEffect, useMemo, useState } from 'react';
+import { callCodingNsRpc } from './settings-bridge.js';
+import { resolveGitWorkspaceId } from './git-management.js';
+export const SESSION_CHANGED_FILES_VIEW_ID = 'codingns4dsh/session-changed-files';
+/** 会话“修改文件”视图；数据只通过插件 RPC 和现有 Git RPC 读取。 */
+export function SessionChangedFilesView(props) {
+    const compactLayout = useCompactLayout();
+    const [workspaceId, setWorkspaceId] = useState();
+    const [changes, setChanges] = useState([]);
+    const [selectedPath, setSelectedPath] = useState();
+    const [diff, setDiff] = useState();
+    const [collapsed, setCollapsed] = useState(new Set());
+    const [hoveredPath, setHoveredPath] = useState();
+    const [loading, setLoading] = useState(true);
+    const [busy, setBusy] = useState(false);
+    const [error, setError] = useState();
+    const load = async () => {
+        setLoading(true);
+        setError(undefined);
+        try {
+            const resolved = await resolveGitWorkspaceId(props.remote, props.sessionId);
+            if (resolved === undefined)
+                throw new Error('当前会话没有可用的工作区');
+            const [sessionFiles, status] = await Promise.all([
+                call(props.rpc, 'fileManagement/session-changes', { sessionId: props.sessionId, workspaceId: resolved }),
+                call(props.rpc, 'git/status', { workspaceId: resolved }),
+            ]);
+            const touched = new Set(sessionFiles.paths.map(normalizePath));
+            const next = status.changes.filter((item) => touched.has(normalizePath(item.path)) || item.oldPath !== null && touched.has(normalizePath(item.oldPath)));
+            setWorkspaceId(resolved);
+            setChanges(next);
+            props.reportCount?.(props.sessionId, next.length);
+            setSelectedPath((current) => current !== undefined && next.some((item) => item.path === current) ? current : next[0]?.path);
+        }
+        catch (cause) {
+            setError(cause instanceof Error ? cause.message : String(cause));
+            setChanges([]);
+            setWorkspaceId(undefined);
+            props.reportCount?.(props.sessionId, 0);
+        }
+        finally {
+            setLoading(false);
+        }
+    };
+    useEffect(() => {
+        setDiff(undefined);
+        setCollapsed(new Set());
+        void load();
+        const timer = globalThis.setInterval(() => { void load(); }, 5_000);
+        return () => globalThis.clearInterval(timer);
+    }, [props.sessionId, props.remote]);
+    useEffect(() => {
+        if (workspaceId === undefined || selectedPath === undefined) {
+            setDiff(undefined);
+            return;
+        }
+        const selected = changes.find((item) => item.path === selectedPath);
+        if (selected === undefined)
+            return;
+        let cancelled = false;
+        void call(props.rpc, 'git/diff', { workspaceId, path: selected.path, staged: selected.staged })
+            .then((value) => { if (!cancelled)
+            setDiff(value); })
+            .catch((cause) => { if (!cancelled)
+            setError(cause instanceof Error ? cause.message : String(cause)); });
+        return () => { cancelled = true; };
+    }, [changes, props.rpc, selectedPath, workspaceId]);
+    const tree = useMemo(() => buildTree(changes), [changes]);
+    const unstaged = changes.filter((item) => !item.staged);
+    const stageTargets = async (targets, action) => {
+        if (workspaceId === undefined || targets.length === 0)
+            return;
+        setBusy(true);
+        try {
+            await call(props.rpc, `git/${action}`, { workspaceId, targets });
+            await load();
+        }
+        catch (cause) {
+            setError(cause instanceof Error ? cause.message : String(cause));
+        }
+        finally {
+            setBusy(false);
+        }
+    };
+    const toggle = (path) => {
+        setCollapsed((current) => {
+            const next = new Set(current);
+            if (next.has(path))
+                next.delete(path);
+            else
+                next.add(path);
+            return next;
+        });
+    };
+    const hasChanges = changes.length > 0;
+    const viewRootStyle = { ...rootStyle, padding: compactLayout ? '0 16px' : rootStyle.padding };
+    const viewToolbarStyle = {
+        ...toolbarStyle,
+        padding: compactLayout ? '10px 0' : toolbarStyle.padding,
+        borderBottom: hasChanges ? toolbarStyle.borderBottom : 'none',
+    };
+    const viewContentStyle = { ...contentStyle, gridTemplateColumns: compactLayout ? '1fr' : contentStyle.gridTemplateColumns };
+    const viewTreePaneStyle = {
+        ...treePaneStyle,
+        borderRight: compactLayout || !hasChanges ? 'none' : treePaneStyle.borderRight,
+        borderBottom: compactLayout && hasChanges ? treePaneStyle.borderRight : 'none',
+    };
+    return createElement('div', { style: viewRootStyle }, createElement('div', { style: viewToolbarStyle }, createElement('strong', { style: { fontSize: 15 } }, '修改文件'), createElement('span', { style: countStyle }, `${changes.length} 个文件`), createElement('span', { style: { flex: 1 } }), createElement('button', { type: 'button', disabled: loading || busy, onClick: () => void load(), style: toolbarRefreshButtonStyle, title: '刷新', 'aria-label': '刷新' }, createElement(RefreshIcon)), createElement('button', { type: 'button', disabled: busy || unstaged.length === 0, onClick: () => void stageTargets(unstaged.map((item) => item.path), 'stage'), style: toolbarStageButtonStyle, title: '全部暂存', 'aria-label': '全部暂存' }, createElement(StageIcon))), error === undefined ? null : createElement('div', { role: 'alert', style: errorStyle }, error), createElement('div', { style: viewContentStyle }, createElement('div', { style: viewTreePaneStyle }, loading ? createElement('div', { style: emptyStyle }, '正在读取会话修改…')
+        : changes.length === 0 ? createElement('div', { style: emptyStyle }, '本次会话没有已识别的修改文件')
+            : tree.map((node) => renderNode(node, 0, collapsed, hoveredPath, selectedPath, toggle, setSelectedPath, setHoveredPath, stageTargets))), hasChanges ? createElement('div', { style: diffPaneStyle }, selectedPath === undefined ? createElement('div', { style: emptyStyle }, '选择文件查看 Diff')
+        : diff?.content ? createElement('pre', { style: diffStyle }, renderDiff(diff.content))
+            : createElement('div', { style: emptyStyle }, '当前文件没有可显示的 Diff')) : null));
+}
+/** 注册 DSH 原生 conversation.view Slot；标签由 DSH 根据 Slot 的 id/label 自动投影。 */
+export function registerSessionChangedFilesView(ctx, rpc, remote) {
+    const runtime = globalThis;
+    // DSH 热重启可能先保留旧 Context 的 Slot；复用旧注册避免 id 冲突。
+    if (runtime.__CODINGNS4DSH_SESSION_CHANGED_FILES_VIEW__ !== undefined)
+        return undefined;
+    const value = asRecord(ctx);
+    const slots = value?.slots;
+    if (typeof slots?.inject !== 'function' || typeof slots.register !== 'function')
+        return undefined;
+    let disposeSlot;
+    let disposeCounterSlot;
+    let disposed = false;
+    let labelSessionId;
+    let labelCount = 0;
+    const reportCount = (sessionId, count) => {
+        if (disposed || (labelSessionId === sessionId && labelCount === count))
+            return;
+        labelSessionId = sessionId;
+        labelCount = count;
+        // DSH 标签的 label 是字符串快照；重新登记同一个 Slot 触发标签列表刷新。
+        const previous = disposeSlot;
+        disposeSlot = undefined;
+        previous?.();
+        try {
+            disposeSlot = registerSlot();
+        }
+        catch (error) {
+            console.warn('codingns4dsh: 修改文件标签数量刷新失败', error);
+        }
+    };
+    function registerSlot() {
+        return slots.inject('conversation.view', () => {
+            // 必须通过 SlotRegistry 实例调用 register，保留其 Cordis 调用上下文。
+            return slots.register({
+                name: 'conversation.view',
+                id: SESSION_CHANGED_FILES_VIEW_ID,
+                order: 100,
+                label: () => `修改文件 ${labelCount}`,
+                inject: () => ({ rpc, remote, reportCount }),
+            }, SessionChangedFilesView);
+        });
+    }
+    function registerCounterSlot() {
+        return slots.inject('conversation.session.header.actions', () => slots.register({
+            name: 'conversation.session.header.actions',
+            id: `${SESSION_CHANGED_FILES_VIEW_ID}/counter`,
+            order: 1000,
+            inject: () => ({ rpc, remote, reportCount }),
+        }, SessionChangedFilesCounter));
+    }
+    try {
+        disposeSlot = registerSlot();
+        disposeCounterSlot = registerCounterSlot();
+    }
+    catch (error) {
+        if (isDuplicateRegistrationError(error)) {
+            disposeSlot?.();
+            disposeCounterSlot?.();
+            return undefined;
+        }
+        disposeSlot?.();
+        disposeCounterSlot?.();
+        throw error;
+    }
+    const dispose = () => {
+        disposed = true;
+        disposeSlot?.();
+        disposeCounterSlot?.();
+        if (runtime.__CODINGNS4DSH_SESSION_CHANGED_FILES_VIEW__?.dispose === dispose) {
+            delete runtime.__CODINGNS4DSH_SESSION_CHANGED_FILES_VIEW__;
+        }
+    };
+    runtime.__CODINGNS4DSH_SESSION_CHANGED_FILES_VIEW__ = { dispose };
+    return dispose;
+}
+function isDuplicateRegistrationError(error) {
+    return error instanceof Error && /already registered|已注册/u.test(error.message);
+}
+function SessionChangedFilesCounter(props) {
+    useEffect(() => {
+        let disposed = false;
+        const load = async () => {
+            try {
+                const workspaceId = await resolveGitWorkspaceId(props.remote, props.sessionId);
+                if (workspaceId === undefined)
+                    throw new Error('当前会话没有可用的工作区');
+                const [sessionFiles, status] = await Promise.all([
+                    call(props.rpc, 'fileManagement/session-changes', { sessionId: props.sessionId, workspaceId }),
+                    call(props.rpc, 'git/status', { workspaceId }),
+                ]);
+                if (disposed)
+                    return;
+                const touched = new Set(sessionFiles.paths.map(normalizePath));
+                const count = status.changes.filter((item) => touched.has(normalizePath(item.path)) || item.oldPath !== null && touched.has(normalizePath(item.oldPath))).length;
+                props.reportCount(props.sessionId, count);
+            }
+            catch {
+                if (!disposed)
+                    props.reportCount(props.sessionId, 0);
+            }
+        };
+        void load();
+        const timer = globalThis.setInterval(() => { void load(); }, 5_000);
+        return () => { disposed = true; globalThis.clearInterval(timer); };
+    }, [props.remote, props.rpc, props.reportCount, props.sessionId]);
+    return null;
+}
+function renderDiff(content) {
+    const lines = content.split('\n');
+    return lines.map((line, index) => createElement('span', {
+        key: index,
+        style: diffLineStyle(line),
+    }, `${line}${index < lines.length - 1 ? '\n' : ''}`));
+}
+function RefreshIcon() {
+    return createElement('svg', { width: 18, height: 18, viewBox: '0 0 20 20', fill: 'none', 'aria-hidden': true }, createElement('path', { d: 'M16 8.5A6.2 6.2 0 1 0 16.1 12', stroke: 'currentColor', strokeWidth: 1.6, strokeLinecap: 'round' }), createElement('path', { d: 'M16 4.5v4h-4', stroke: 'currentColor', strokeWidth: 1.6, strokeLinecap: 'round', strokeLinejoin: 'round' }));
+}
+function StageIcon() {
+    return createElement('svg', { width: 18, height: 18, viewBox: '0 0 20 20', fill: 'none', 'aria-hidden': true }, createElement('path', { d: 'M4 13.5v2h12v-2', stroke: 'currentColor', strokeWidth: 1.6, strokeLinecap: 'round', strokeLinejoin: 'round' }), createElement('path', { d: 'M10 14V4.5m0 0L6.8 7.7M10 4.5l3.2 3.2', stroke: 'currentColor', strokeWidth: 1.6, strokeLinecap: 'round', strokeLinejoin: 'round' }));
+}
+function diffLineStyle(line) {
+    if (line.startsWith('+++') || line.startsWith('---'))
+        return diffHeaderLineStyle;
+    if (line.startsWith('+'))
+        return diffAddedLineStyle;
+    if (line.startsWith('-'))
+        return diffRemovedLineStyle;
+    if (line.startsWith('@@'))
+        return diffHunkLineStyle;
+    return diffContextLineStyle;
+}
+function renderNode(node, depth, collapsed, hoveredPath, selectedPath, toggle, select, hover, stageTargets) {
+    if (node.kind === 'directory') {
+        const expanded = !collapsed.has(node.path);
+        const files = flattenFiles(node);
+        return createElement('div', { key: `directory:${node.path}` }, createElement('div', { style: rowStyle(depth), onMouseEnter: () => hover(node.path), onMouseLeave: () => hover(undefined) }, createElement('button', { type: 'button', onClick: () => toggle(node.path), style: treeButtonStyle }, createElement('span', { style: treeChevronStyle }, expanded ? '⌄' : '›'), createElement('span', { style: folderIconStyle }, '▰'), createElement('span', { style: fileNameStyle, title: node.path }, node.name), createElement('span', { style: mutedCountStyle }, String(files.length))), hoveredPath === node.path ? createElement('button', { type: 'button', title: '暂存目录', disabled: files.every((item) => item.staged), onClick: () => void stageTargets(files.filter((item) => !item.staged).map((item) => item.path), 'stage'), style: iconButtonStyle }, '+') : null), expanded ? createElement('div', null, node.children.map((child) => renderNode(child, depth + 1, collapsed, hoveredPath, selectedPath, toggle, select, hover, stageTargets))) : null);
+    }
+    const item = node.change;
+    const isHovered = hoveredPath === item.path;
+    return createElement('div', { key: `file:${item.path}`, style: { ...rowStyle(depth), ...(selectedPath === item.path ? selectedRowStyle : {}) }, onMouseEnter: () => hover(item.path), onMouseLeave: () => hover(undefined) }, createElement('button', { type: 'button', onClick: () => select(item.path), style: fileButtonStyle }, createElement('span', { style: fileIconStyle }, fileIcon(node.name)), createElement('span', { style: fileNameStyle, title: item.path }, node.name), createElement('span', { style: statusStyle }, item.status)), isHovered ? createElement('span', { style: actionsStyle }, createElement('button', { type: 'button', title: item.staged ? '撤销暂存' : '添加到暂存区', onClick: () => void stageTargets([item.path], item.staged ? 'unstage' : 'stage'), style: iconButtonStyle }, item.staged ? '↶' : '+'), createElement('button', { type: 'button', title: '撤销变更', disabled: item.staged, onClick: () => void stageTargets([item.path], 'discard'), style: dangerButtonStyle }, '×')) : null);
+}
+function buildTree(changes) {
+    const root = new Map();
+    for (const change of changes) {
+        const parts = normalizePath(change.path).split('/').filter(Boolean);
+        let entries = root;
+        let currentPath = '';
+        parts.forEach((part, index) => {
+            currentPath = currentPath ? `${currentPath}/${part}` : part;
+            const key = index === parts.length - 1 ? `file:${currentPath}` : `directory:${currentPath}`;
+            if (index === parts.length - 1)
+                entries.set(key, { kind: 'file', name: part, change });
+            else {
+                const existing = entries.get(key);
+                const directory = existing?.kind === 'directory'
+                    ? existing
+                    : { kind: 'directory', name: part, path: currentPath, children: new Map() };
+                entries.set(key, directory);
+                entries = directory.children;
+            }
+        });
+    }
+    return sortNodes(finalizeTree([...root.values()]));
+}
+function finalizeTree(nodes) {
+    return nodes.map((node) => node.kind === 'directory'
+        ? { kind: 'directory', name: node.name, path: node.path, children: finalizeTree([...node.children.values()]) }
+        : node);
+}
+function sortNodes(nodes) {
+    return [...nodes].sort((left, right) => left.kind === right.kind ? left.name.localeCompare(right.name, 'zh-CN') : left.kind === 'directory' ? -1 : 1).map((node) => node.kind === 'directory' ? { ...node, children: sortNodes(node.children) } : node);
+}
+function flattenFiles(node) {
+    return node.children.flatMap((child) => child.kind === 'directory' ? flattenFiles(child) : [child.change]);
+}
+function normalizePath(value) { return value.replaceAll('\\', '/').replace(/^\.\//u, '').replace(/^\/+|\/+$/gu, ''); }
+function fileIcon(name) { return name.includes('.') ? '·' : '□'; }
+function asRecord(value) { return typeof value === 'object' && value !== null ? value : undefined; }
+async function call(rpc, endpoint, payload) { return await callCodingNsRpc(rpc, endpoint, payload); }
+function useCompactLayout() {
+    const [compact, setCompact] = useState(() => typeof window !== 'undefined' && window.matchMedia?.('(max-width: 700px)').matches === true);
+    useEffect(() => {
+        if (typeof window === 'undefined' || typeof window.matchMedia !== 'function')
+            return;
+        const media = window.matchMedia('(max-width: 700px)');
+        const update = () => setCompact(media.matches);
+        update();
+        media.addEventListener?.('change', update);
+        return () => media.removeEventListener?.('change', update);
+    }, []);
+    return compact;
+}
+const rootStyle = { display: 'flex', flexDirection: 'column', alignItems: 'center', height: 'auto', minHeight: '100%', overflow: 'visible', padding: '0 64px', boxSizing: 'border-box', color: 'var(--dsw-alias-label-primary,inherit)', background: 'var(--dsw-alias-bg-base,transparent)', fontSize: 13 };
+const toolbarStyle = { display: 'flex', alignItems: 'center', gap: 8, width: '100%', maxWidth: 1280, boxSizing: 'border-box', padding: '12px 16px', borderBottom: '1px solid var(--dsw-alias-border-l3,#ddd)', flex: '0 0 auto' };
+const countStyle = { color: 'var(--dsw-alias-label-tertiary,#777)' };
+const contentStyle = { display: 'grid', gridTemplateColumns: '3.5fr 6.5fr', width: '100%', maxWidth: 1280, flex: '0 0 auto', minHeight: 0 };
+const treePaneStyle = { padding: '8px 0', borderRight: '1px solid var(--dsw-alias-border-l3,#ddd)' };
+const diffPaneStyle = { minWidth: 0, background: 'var(--dsw-alias-bg-layer-1,transparent)' };
+const rowStyle = (depth) => ({ display: 'flex', alignItems: 'center', gap: 7, minHeight: 28, padding: `0 8px 0 ${8 + depth * 14}px`, fontSize: 12 });
+const treeButtonStyle = { display: 'flex', alignItems: 'center', gap: 7, width: '100%', minWidth: 0, minHeight: 28, border: 0, background: 'transparent', color: 'inherit', font: 'inherit', cursor: 'pointer', textAlign: 'left', padding: 0, fontWeight: 600 };
+const fileButtonStyle = { display: 'flex', alignItems: 'center', gap: 7, border: 0, background: 'transparent', color: 'inherit', font: 'inherit', cursor: 'pointer', textAlign: 'left', flex: 1, minWidth: 0, padding: 0 };
+const selectedRowStyle = { background: 'var(--dsw-alias-interactive-bg-selected,rgba(80,120,200,.16))' };
+const fileIconStyle = { width: 12, color: 'var(--dsw-alias-label-tertiary,#777)', fontSize: 12, textAlign: 'center', flex: '0 0 12px' };
+const treeChevronStyle = { width: 12, color: 'var(--dsw-alias-label-tertiary,#777)', fontSize: 12, flex: '0 0 12px' };
+const folderIconStyle = { color: 'var(--dsw-alias-state-business-primary,#356ae6)', fontSize: 11, flex: '0 0 auto' };
+const fileNameStyle = { overflow: 'hidden', textOverflow: 'ellipsis', whiteSpace: 'nowrap', flex: 1 };
+const statusStyle = { color: 'var(--dsw-alias-label-tertiary,#777)', flex: '0 0 auto', fontWeight: 700 };
+const mutedCountStyle = { color: 'var(--dsw-alias-label-tertiary,#777)', fontVariantNumeric: 'tabular-nums', flex: '0 0 auto' };
+const actionsStyle = { display: 'inline-flex', gap: 2, flex: '0 0 auto' };
+const iconButtonStyle = { display: 'inline-flex', alignItems: 'center', justifyContent: 'center', width: 24, height: 24, border: 0, borderRadius: 4, padding: 0, background: 'transparent', color: 'var(--dsw-alias-label-secondary,#777)', cursor: 'pointer', fontSize: 16 };
+const dangerButtonStyle = { ...iconButtonStyle, color: 'var(--dsw-alias-state-danger,#c43d3d)' };
+const toolbarIconButtonStyle = { ...iconButtonStyle, width: 36, height: 36, border: '1px solid var(--dsw-alias-border-l2,#ccc)', borderRadius: 8, background: 'var(--dsw-alias-bg-layer-2,rgba(127,127,127,.08))', boxShadow: '0 1px 2px rgba(0,0,0,.12)', fontSize: 18 };
+const toolbarRefreshButtonStyle = { ...toolbarIconButtonStyle, color: 'var(--dsw-alias-state-business-primary,#356ae6)' };
+const toolbarStageButtonStyle = { ...toolbarIconButtonStyle, color: 'var(--dsw-alias-state-success,#18864b)' };
+const emptyStyle = { padding: 24, color: 'var(--dsw-alias-label-tertiary,#777)', textAlign: 'center' };
+const errorStyle = { padding: '8px 16px', color: 'var(--dsw-alias-state-danger,#c43d3d)', borderBottom: '1px solid var(--dsw-alias-border-l3,#ddd)' };
+const diffStyle = { margin: 0, padding: 16, minHeight: '100%', overflow: 'visible', whiteSpace: 'pre-wrap', wordBreak: 'break-word', font: '12px/1.55 var(--dsw-font-mono,ui-monospace,monospace)' };
+const diffHeaderLineStyle = { display: 'block', color: 'var(--dsw-alias-label-tertiary,#777)' };
+const diffHunkLineStyle = { display: 'block', color: 'var(--dsw-alias-state-business-primary,#356ae6)', background: 'rgba(53,106,230,.08)' };
+const diffAddedLineStyle = { display: 'block', color: '#137333', background: 'rgba(34,197,94,.12)' };
+const diffRemovedLineStyle = { display: 'block', color: '#b42318', background: 'rgba(220,38,38,.12)' };
+const diffContextLineStyle = { display: 'block' };
+//# sourceMappingURL=session-changed-files-view.js.map

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

@@ -1,12 +1,15 @@
 import type { SettingsScope } from '@deepseek-ai/dsh-client-ui-settings/client';
 import type { CodingNsSettings } from '../shared/contracts/config.js';
 import type { CodingNsRpcClient } from './features/types.js';
-import type { CodingNsSettingsSnapshot, CodingNsSettingsStore } from '../dsh-capabilities/settings-store.js';
+import { type CodingNsSettingsSnapshot, type CodingNsSettingsStore } from '../dsh-capabilities/settings-store.js';
 type SettingsMutation = Parameters<SettingsScope<CodingNsSettings>['mutate']>[0];
 type SnapshotListener = () => void;
 /**
  * 把 DSH 本地设置和远程 Host 设置 RPC 统一成一个设置作用域。
- * 非回环页面使用 RPC，回环页面完全复用 DSH 的原生设置传输。
+ *
+ * 没有本地镜像时（`local` 为 undefined）完全使用 Host RPC：DSH 只向回环页面或
+ * 声明了 Host 所有权的页面下发持久设置，非回环页面会降级为 memory 模式，此时
+ * 插件设置必须走自己的 Host 写入边界才能保持可读写。
  */
 export declare class CodingNsSettingsBridge implements CodingNsSettingsStore<CodingNsSettings> {
     private readonly local;
@@ -16,7 +19,7 @@ export declare class CodingNsSettingsBridge implements CodingNsSettingsStore<Cod
     private readonly localUnsubscribe;
     private remoteLoad;
     private remoteLoaded;
-    constructor(local: SettingsScope<CodingNsSettings>, rpc: CodingNsRpcClient);
+    constructor(local: SettingsScope<CodingNsSettings> | undefined, rpc: CodingNsRpcClient);
     getSnapshot(): CodingNsSettingsSnapshot<CodingNsSettings>;
     subscribe(listener: SnapshotListener): () => void;
     load(): Promise<void>;
@@ -25,11 +28,18 @@ export declare class CodingNsSettingsBridge implements CodingNsSettingsStore<Cod
     mutate(ops: SettingsMutation, expectedRevision?: number): Promise<boolean>;
     dispose(): void;
     private call;
+    private localSnapshot;
+    /**
+     * 内容未变化时不替换快照引用、不唤醒订阅者。
+     *
+     * DSH 的本地设置镜像会在后台索引（例如 cliSessions 心跳）更新时反复通知；
+     * 每次都发布新对象会让设置页持续重渲染，并使按快照身份触发的 effect 反复执行。
+     */
     private publish;
     private isRemote;
 }
 /** 调用 Codingns4DSH Host RPC，并兼容 DSH 原生连接与普通 Web API 回退。 */
 export declare function callCodingNsRpc<T>(rpc: CodingNsRpcClient, endpoint: string, payload: unknown): Promise<T>;
-export declare function createCodingNsSettingsBridge(local: SettingsScope<CodingNsSettings>, rpc: CodingNsRpcClient): CodingNsSettingsBridge;
+export declare function createCodingNsSettingsBridge(local: SettingsScope<CodingNsSettings> | undefined, rpc: CodingNsRpcClient): CodingNsSettingsBridge;
 export {};
 //# sourceMappingURL=settings-bridge.d.ts.map

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

@@ -1,8 +1,25 @@
 import { CODINGNS_RPC_CHANNEL } from '../shared/contracts/transport.js';
 import { debugInfo, debugWarn } from '../shared/debug.js';
+import { sameSettingsSnapshot, } from '../dsh-capabilities/settings-store.js';
+/**
+ * DSH 未提供设置镜像（memory 模式、命名空间未下发或版本缺少 ConfigForm）时的占位快照。
+ *
+ * 它必须是稳定引用：设置页通过 `useSyncExternalStore` 读取快照，每次返回新对象
+ * 会让 React 在每次渲染后都判定快照失效并强制再次渲染，最终以 React #185 崩溃整
+ * 个设置分区。
+ */
+const UNAVAILABLE_LOCAL_SNAPSHOT = Object.freeze({
+    status: 'unavailable',
+    value: undefined,
+    revision: undefined,
+    writable: false,
+});
 /**
  * 把 DSH 本地设置和远程 Host 设置 RPC 统一成一个设置作用域。
- * 非回环页面使用 RPC，回环页面完全复用 DSH 的原生设置传输。
+ *
+ * 没有本地镜像时（`local` 为 undefined）完全使用 Host RPC：DSH 只向回环页面或
+ * 声明了 Host 所有权的页面下发持久设置，非回环页面会降级为 memory 模式，此时
+ * 插件设置必须走自己的 Host 写入边界才能保持可读写。
  */
 export class CodingNsSettingsBridge {
     local;
@@ -15,15 +32,15 @@ export class CodingNsSettingsBridge {
     constructor(local, rpc) {
         this.local = local;
         this.rpc = rpc;
-        this.snapshot = toStoreSnapshot(local.getSnapshot());
-        this.localUnsubscribe = local.subscribe(() => {
+        this.snapshot = toStoreSnapshot(local?.getSnapshot() ?? UNAVAILABLE_LOCAL_SNAPSHOT);
+        this.localUnsubscribe = local?.subscribe(() => {
             if (this.isRemote()) {
                 void this.load().catch(() => undefined);
                 return;
             }
             this.remoteLoaded = false;
-            this.publish(toStoreSnapshot(local.getSnapshot()));
-        });
+            this.publish(toStoreSnapshot(this.localSnapshot()));
+        }) ?? (() => undefined);
     }
     getSnapshot() { return this.snapshot; }
     subscribe(listener) {
@@ -53,22 +70,25 @@ export class CodingNsSettingsBridge {
         return this.remoteLoad;
     }
     async set(field, value) {
-        if (!this.isRemote()) {
-            await this.local.set(field, value);
+        const local = this.local;
+        if (local !== undefined && !this.isRemote()) {
+            await local.set(field, value);
             return true;
         }
         return this.mutate([{ op: 'set', path: [field], value: toJsonValue(value) }]);
     }
     async unset(field) {
-        if (!this.isRemote()) {
-            await this.local.unset(field);
+        const local = this.local;
+        if (local !== undefined && !this.isRemote()) {
+            await local.unset(field);
             return true;
         }
         return this.mutate([{ op: 'unset', path: [field] }]);
     }
     async mutate(ops, expectedRevision) {
-        if (!this.isRemote()) {
-            await this.local.mutate(ops, expectedRevision);
+        const local = this.local;
+        if (local !== undefined && !this.isRemote()) {
+            await local.mutate(ops, expectedRevision);
             return true;
         }
         const payload = expectedRevision === undefined ? { ops } : { ops, expectedRevision };
@@ -87,16 +107,43 @@ export class CodingNsSettingsBridge {
     async call(endpoint, payload) {
         return callCodingNsRpc(this.rpc, endpoint, payload);
     }
+    localSnapshot() {
+        return this.local?.getSnapshot() ?? UNAVAILABLE_LOCAL_SNAPSHOT;
+    }
+    /**
+     * 内容未变化时不替换快照引用、不唤醒订阅者。
+     *
+     * DSH 的本地设置镜像会在后台索引（例如 cliSessions 心跳）更新时反复通知；
+     * 每次都发布新对象会让设置页持续重渲染，并使按快照身份触发的 effect 反复执行。
+     */
     publish(next) {
+        if (sameSettingsSnapshot(this.snapshot, next))
+            return;
         this.snapshot = next;
         for (const listener of [...this.listeners])
             listener();
     }
     isRemote() {
+        if (this.local === undefined)
+            return true;
         const snapshot = this.local.getSnapshot();
-        return snapshot.mode === 'memory' || snapshot.status === 'unavailable';
+        // 远程 DSH Web iframe 内的 settingsScope 属于被访问的 DSH Web Host；
+        // CodingNS 插件设置仍归外层 CodingNS Host 所有，不能误写入 DSH Web 的本地缓存。
+        return isRemoteWebContext() || snapshot.mode === 'memory' || snapshot.status === 'unavailable'
+            // 某些 DSH 版本只向 Client 暴露只读设置镜像，但当前 Host 仍提供
+            // Codingns4DSH 自有 settings/set RPC。此时必须切换到 Host 写入边界，
+            // 否则设置页会永久把所有模块开关显示为不可操作。
+            || snapshot.writable === false;
     }
 }
+function isRemoteWebContext() {
+    const runtime = globalThis;
+    // 中转 iframe 有显式标记；局域网代理直接打开 DSH Web 时没有 iframe，
+    // 但同样属于浏览器 Host，插件设置仍应通过 CodingNS Host RPC 读取。
+    return runtime.__CODINGNS4DSH_REMOTE_WEB_CONTEXT__ === true
+        || runtime.location?.protocol === 'http:'
+        || runtime.location?.protocol === 'https:';
+}
 /** 调用 Codingns4DSH Host RPC，并兼容 DSH 原生连接与普通 Web API 回退。 */
 export async function callCodingNsRpc(rpc, endpoint, payload) {
     let result;

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

@@ -1,4 +1,4 @@
-import { createElement, useEffect, useState, useSyncExternalStore } from 'react';
+import { createElement, useEffect, useMemo, 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, dshSettingsToastStyle, dshThemeColor, } from './theme.js';
@@ -12,7 +12,10 @@ const CODINGNS_GITHUB_URL = 'https://github.com/jingyi0605/Codingns4DSH';
  * 自己的 settingsPanel，所以新增模块不会在这里产生分支。
  */
 export function CodingNsSettingsSection({ settings, registry, services, restartStates = {} }) {
-    const snapshot = useSyncExternalStore((listener) => settings.subscribe(listener), () => settings.getSnapshot(), () => settings.getSnapshot());
+    // useSyncExternalStore 要求 subscribe/getSnapshot 保持稳定引用，否则 React
+    // 会在每次渲染后重新订阅并强制再次渲染整个设置分区。
+    const store = useMemo(() => settingsSnapshotHandle(settings), [settings]);
+    const snapshot = useSyncExternalStore(store.subscribe, store.getSnapshot, store.getSnapshot);
     const t = useCodingNsTranslator(services.locale);
     const [toast, setToast] = useState(null);
     useEffect(() => {
@@ -35,16 +38,24 @@ export function CodingNsSettingsSection({ settings, registry, services, restartS
         notify,
     }))), createElement('details', { style: { alignSelf: 'center', display: 'flex', flexDirection: 'column-reverse', alignItems: 'center', marginTop: 4, color: dshThemeColor.labelTertiary, textAlign: 'center', fontSize: 12, lineHeight: 1.5 } }, createElement('summary', { style: { cursor: 'pointer', color: dshThemeColor.labelSecondary, listStylePosition: 'inside' } }, t('settings.version', { version: CODINGNS_VERSION })), createElement('div', { style: { display: 'flex', flexDirection: 'column', gap: 4, alignItems: 'center', maxWidth: 'min(100%, 560px)', marginBottom: 8, padding: '8px 12px', border: `1px solid ${dshThemeColor.border}`, borderRadius: 6, background: dshThemeColor.surfaceSubtle } }, createElement('div', undefined, t('settings.compatibility', { range: DSH_COMPATIBILITY })), createElement('a', { href: CODINGNS_GITHUB_URL, target: '_blank', rel: 'noreferrer', style: { color: dshThemeColor.accent, overflowWrap: 'anywhere' } }, CODINGNS_GITHUB_URL))));
 }
+/** 稳定引用包装：设置页只依赖内部 Store 契约，不感知 DSH 侧实现。 */
+function settingsSnapshotHandle(settings) {
+    return {
+        subscribe: (listener) => settings.subscribe(listener),
+        getSnapshot: () => settings.getSnapshot(),
+    };
+}
 /** 通用功能模块卡片：标题栏开关由 descriptor.ui 决定，内容由模块自己提供。 */
 function FeatureCard({ entry, snapshot, services, restartStates, notify }) {
     const { module, ui } = entry;
     const t = useCodingNsTranslator(services.locale);
     const versionCompatible = isFeatureDshVersionCompatible(module.descriptor, services.dshVersion);
     const requestedEnabled = isFeatureEnabled(module.descriptor, snapshot.value);
-    const enabled = versionCompatible && requestedEnabled;
+    const temporarilyDisabled = module.descriptor.disabled === true;
+    const enabled = !temporarilyDisabled && versionCompatible && requestedEnabled;
     const panel = module.settingsPanel;
     // 常驻模块不提供关闭入口；设置未就绪或只读时也不允许切换。
-    const switchDisabled = ui.alwaysEnabled === true || !versionCompatible || snapshot.status === 'loading' || !snapshot.writable;
+    const switchDisabled = temporarilyDisabled || ui.alwaysEnabled === true || !versionCompatible || snapshot.status === 'loading' || !snapshot.writable;
     const toggle = (next) => {
         if (!versionCompatible) {
             notify({ kind: 'error', message: t('settings.versionBlocked', {
@@ -83,6 +94,8 @@ function FeatureCard({ entry, snapshot, services, restartStates, notify }) {
             version: services.dshVersion,
             minimum: module.descriptor.minimumDshVersion ?? '未知版本',
         }))
+        : null, temporarilyDisabled
+        ? createElement('div', { role: 'status', style: { marginBottom: 10, color: dshThemeColor.labelSecondary } }, '该模块当前由维护策略停用，设置不会启动它。')
         : null, panel === undefined ? null : createElement(panel, { services, enabled, snapshot, notify })));
 }
 /** 标题栏开关：真实 checkbox 语义，点击不会连带折叠卡片。 */