@jingyi0605/codingns4dsh 0.1.1 → 0.1.7-rc.2

package/data/build/dist/host/native-session-bridge.js

@@ -16,9 +16,17 @@ export function createCodingNsNativeSessionBridge(ctx, dshVersion) {
         ? ctx.on.bind(ctx)
         : undefined;
     const externalHandles = new Map();
+    const compactionStates = new Map();
+    const confirmedContextWindows = new Map();
+    // Agent.inject() 只是把消息放进队列，新的 DSH step 会在稍后的事件循环中
+    // 才创建。此期间 activeStep 仍然指向旧 step，工具追加必须暂缓，否则会把
+    // 下一步的工具写进旧 step；step/start 到达后由工具投影器重试。
+    const pendingStepTransitions = new Set();
     let injectedStepSequence = 0;
     const modernInjectedSource = isModernDshVersion(dshVersion);
     const appendNativeToolCall = (sessionId, call) => {
+        if (on !== undefined && pendingStepTransitions.has(sessionId))
+            return null;
         const session = appendableSession(store?.get(sessionId));
         const position = session === null ? null : activeStep(session);
         if (session === null || position === null)
@@ -91,11 +99,60 @@ export function createCodingNsNativeSessionBridge(ctx, dshVersion) {
             // 投影先清空旧 pressure，再等待下一条 usage，ContextMeter 因而闪烁。
             // 保留已有容量并跳过等价事件，让用量更新直接落到同一个组件上。
             const previous = latestRequestContext(session);
-            if (previous !== null
-                && previous.provider === context.provider
-                && previous.model === context.model
-                && (context.contextWindow === undefined || previous.contextWindow === context.contextWindow))
-                return true;
+            const contextKey = `${sessionId}\u0000${context.provider}\u0000${context.model}`;
+            if (previous !== null && previous.provider === context.provider && previous.model === context.model) {
+                const historicalWindow = historicalUsageContextWindow(session);
+                if (context.contextWindow === undefined) {
+                    if (historicalWindow !== undefined && previous.contextWindow !== historicalWindow) {
+                        session.append('request/context', {
+                            provider: context.provider,
+                            model: context.model,
+                            contextWindow: historicalWindow,
+                        });
+                    }
+                    return true;
+                }
+                if (previous.contextWindow === context.contextWindow
+                    && context.confirmed === true
+                    && historicalWindow !== undefined
+                    && historicalWindow !== context.contextWindow) {
+                    session.append('request/context', {
+                        provider: context.provider,
+                        model: context.model,
+                        contextWindow: historicalWindow,
+                    });
+                    confirmedContextWindows.set(contextKey, historicalWindow);
+                    return true;
+                }
+                if (previous.contextWindow === context.contextWindow) {
+                    if (context.confirmed === true && context.source !== 'catalog' && context.contextWindow !== undefined) {
+                        confirmedContextWindows.set(contextKey, context.contextWindow);
+                    }
+                    return true;
+                }
+                // 已经确认过的同一路由容量是会话级事实。迟到/全局 usage 不能覆盖它。
+                // DSH 每个新 step 会先写入一次通用 1M 占位值。catalog 提示必须能把
+                // 这个占位值恢复为已知容量，但真实 Provider usage 仍由锁定值保护。
+                if (confirmedContextWindows.has(contextKey) && context.source !== 'catalog')
+                    return true;
+                // 进程重启后仍可从历史 usage 恢复稳定容量，避免尾部遗留的错误
+                // request/context=1M 在第二轮开始时再次成为当前窗口。
+                if (context.confirmed === true && historicalWindow !== undefined && historicalWindow !== context.contextWindow) {
+                    if (previous.contextWindow !== historicalWindow) {
+                        session.append('request/context', {
+                            provider: context.provider,
+                            model: context.model,
+                            contextWindow: historicalWindow,
+                        });
+                    }
+                    confirmedContextWindows.set(contextKey, historicalWindow);
+                    return true;
+                }
+                // 允许本次运行首次明确确认的 usage 修正历史遗留的路由占位值，
+                // 例如旧日志中的 1M 随后被 Codex usage 明确纠正为 258400。
+                if (context.confirmed !== true)
+                    return true;
+            }
             // Registry 在一轮开始时只能提供适配器身份，不能提供 Provider 容量。
             // 继承上一条已知容量，避免先写无容量事件导致 ContextMeter 卸载；
             // 真正的 usage 到达后，投影器会用 Provider 的最新容量覆盖它。
@@ -105,6 +162,9 @@ export function createCodingNsNativeSessionBridge(ctx, dshVersion) {
                 model: context.model,
                 ...(contextWindow === undefined ? {} : { contextWindow }),
             });
+            if (context.confirmed === true && context.source !== 'catalog' && context.contextWindow !== undefined) {
+                confirmedContextWindows.set(contextKey, context.contextWindow);
+            }
             return true;
         }
         catch {
@@ -117,6 +177,18 @@ export function createCodingNsNativeSessionBridge(ctx, dshVersion) {
         if (session === null || position === null)
             return false;
         try {
+            const previousContext = latestRequestContext(session);
+            const normalizedUsage = previousContext?.contextWindow !== undefined
+                && usage.contextWindow !== undefined
+                && usage.contextWindow !== previousContext.contextWindow
+                ? {
+                    ...usage,
+                    contextWindow: previousContext.contextWindow,
+                    ...(usage.contextTokens === undefined ? {} : {
+                        contextUsageRatio: Number(Math.min(1, usage.contextTokens / previousContext.contextWindow).toFixed(6)),
+                    }),
+                }
+                : usage;
             session.append('assistant/attempt', {
                 turn: position.turn,
                 step: position.step,
@@ -125,7 +197,7 @@ export function createCodingNsNativeSessionBridge(ctx, dshVersion) {
                         time: Date.now(),
                         chunk: {
                             type: 'usage',
-                            usage: compactUsage(usage),
+                            usage: compactUsage(normalizedUsage),
                         },
                     }],
             });
@@ -135,6 +207,72 @@ export function createCodingNsNativeSessionBridge(ctx, dshVersion) {
             return false;
         }
     };
+    const appendNativeCompactionEvent = (sessionId, event) => {
+        const session = appendableSession(store?.get(sessionId));
+        if (session === null)
+            return false;
+        try {
+            if (event.phase === 'start') {
+                if (compactionStates.has(sessionId))
+                    return true;
+                const compactionId = event.compactionId?.trim() || `codingns-compaction-${randomUUID()}`;
+                const position = activeStep(session);
+                session.append('compaction/start', {
+                    compactionId,
+                    turn: position?.turn ?? null,
+                });
+                compactionStates.set(sessionId, {
+                    compactionId,
+                    turn: position?.turn ?? null,
+                    summaryAppended: false,
+                });
+                return true;
+            }
+            const state = compactionStates.get(sessionId);
+            if (state === undefined)
+                return false;
+            if ((event.phase === 'summary' || event.phase === 'end' && event.summary !== undefined) && !state.summaryAppended) {
+                const range = compactionSurfaceRange(session);
+                if (range !== null) {
+                    const summary = boundCompactionSummary(event.summary);
+                    session.append('compaction/summary', {
+                        compactionId: state.compactionId,
+                        summary: [{ type: 'text', text: summary }],
+                        shadowedRange: { start: range.start, end: range.end },
+                        shadowedSeqs: range.seqs,
+                        shadowedTokenCount: safeCount(event.shadowedTokenCount),
+                        provider: event.provider?.trim() || 'codingns-external',
+                        model: event.model?.trim() || 'external-agent',
+                    });
+                    // DSH 前端的 compaction 节点由紧随 summary 的 checkpoint 替换事件生成。
+                    session.append('user/message', {
+                        id: `codingns-compaction-${state.compactionId}`,
+                        role: 'user',
+                        content: [{ type: 'text', text: summary }],
+                        source: { kind: 'plugin', plugin: 'compact' },
+                    }, {
+                        surfaceOp: { op: 'replace', startSeq: range.start, endSeq: range.end },
+                        sourceEventSeqs: range.seqs,
+                    });
+                    state.summaryAppended = true;
+                }
+                return true;
+            }
+            if (event.phase === 'end') {
+                session.append('compaction/end', {
+                    compactionId: state.compactionId,
+                    turn: state.turn,
+                    ...(event.error?.trim() ? { error: event.error.trim().slice(0, 512) } : !state.summaryAppended ? { error: 'Provider 未返回可投影的压缩摘要。' } : {}),
+                });
+                compactionStates.delete(sessionId);
+            }
+            return true;
+        }
+        catch {
+            // 原生服务缺失或版本不支持 compaction 事件时，不能阻断 Provider 回合。
+            return false;
+        }
+    };
     const injectNativeNextStep = (sessionId, summary = '外部工具已完成，继续处理当前任务。') => {
         const agent = nativeAgent(ctx, sessionId);
         if (agent === null || typeof agent.inject !== 'function')
@@ -142,7 +280,8 @@ export function createCodingNsNativeSessionBridge(ctx, dshVersion) {
         injectedStepSequence += 1;
         const boundedSummary = summary.trim().slice(0, 120) || '外部工具已完成，继续处理当前任务。';
         try {
-            ;
+            if (on !== undefined)
+                pendingStepTransitions.add(sessionId);
             agent.inject({
                 id: `codingns-external-step-${injectedStepSequence}-${randomUUID()}`,
                 role: 'user',
@@ -154,6 +293,7 @@ export function createCodingNsNativeSessionBridge(ctx, dshVersion) {
             return true;
         }
         catch {
+            pendingStepTransitions.delete(sessionId);
             return false;
         }
     };
@@ -222,6 +362,9 @@ export function createCodingNsNativeSessionBridge(ctx, dshVersion) {
         appendUsageSample(sessionId, usage) {
             return appendNativeUsageSample(sessionId, usage);
         },
+        appendCompactionEvent(sessionId, event) {
+            return appendNativeCompactionEvent(sessionId, event);
+        },
         canInjectNextStep(sessionId) {
             return canInjectNativeNextStep(sessionId);
         },
@@ -319,7 +462,15 @@ export function createCodingNsNativeSessionBridge(ctx, dshVersion) {
         subscribe(handlers) {
             const disposers = [];
             if (on !== undefined && handlers.onEvent !== undefined) {
-                disposers.push(on('session/event', (session, event) => handlers.onEvent?.(session, event)));
+                disposers.push(on('session/event', (session, event) => {
+                    if (isNativeStepStart(event)) {
+                        for (const sessionId of pendingStepTransitions) {
+                            if (store?.get(sessionId) === session)
+                                pendingStepTransitions.delete(sessionId);
+                        }
+                    }
+                    handlers.onEvent?.(session, event);
+                }));
             }
             if (on !== undefined && handlers.onFlush !== undefined) {
                 disposers.push(on('session/flush', (session) => handlers.onFlush?.(session)));
@@ -336,6 +487,9 @@ function appendableSession(value) {
         return null;
     return value;
 }
+function isNativeStepStart(value) {
+    return isRecord(value) && value.type === 'step/start';
+}
 function latestRequestContext(session) {
     let events;
     try {
@@ -362,6 +516,37 @@ function latestRequestContext(session) {
     }
     return null;
 }
+function historicalUsageContextWindow(session) {
+    let events;
+    try {
+        events = session.snapshotEvents();
+    }
+    catch {
+        return undefined;
+    }
+    const counts = new Map();
+    for (const candidate of events) {
+        const event = isRecord(candidate) && candidate.type === 'assistant/attempt' ? candidate : null;
+        const data = isRecord(event?.data) ? event.data : null;
+        const stream = Array.isArray(data?.stream) ? data.stream : [];
+        for (const entry of stream) {
+            const chunk = isRecord(entry) && isRecord(entry.chunk) ? entry.chunk : null;
+            const usage = isRecord(chunk?.usage) ? chunk.usage : null;
+            const window = usage?.contextWindow;
+            if (typeof window === 'number' && Number.isFinite(window) && window > 0)
+                counts.set(window, (counts.get(window) ?? 0) + 1);
+        }
+    }
+    let selected;
+    let count = 0;
+    for (const [window, occurrences] of counts) {
+        if (occurrences >= count) {
+            selected = window;
+            count = occurrences;
+        }
+    }
+    return selected;
+}
 function activeStep(session) {
     let events;
     try {
@@ -390,6 +575,45 @@ function activeStep(session) {
 function eventSeq(value) {
     return isRecord(value) ? finiteInteger(value.seq) : null;
 }
+function compactionSurfaceRange(session) {
+    let nodes = [];
+    try {
+        if (Array.isArray(session.surface?.nodes))
+            nodes = session.surface.nodes;
+        if (nodes.length === 0) {
+            nodes = session.snapshotEvents().flatMap((candidate) => {
+                if (!isRecord(candidate) || typeof candidate.seq !== 'number' || candidate.type === 'system/message')
+                    return [];
+                const op = candidate.surfaceOp;
+                return op === 'append' ? [candidate.seq] : [];
+            });
+        }
+        const events = session.snapshotEvents();
+        let usable = nodes.filter((seq) => {
+            const event = session.eventAt?.(seq) ?? events[seq];
+            return !(isRecord(event) && event.type === 'system/message');
+        });
+        // 当前回合刚追加的 user/message 不是历史压缩对象，保留它避免把用户本轮
+        // 输入一并替换；旧 assistant/tool 节点仍可作为压缩范围。
+        const last = usable.at(-1);
+        const lastEvent = last === undefined ? undefined : session.eventAt?.(last) ?? events[last];
+        if (last !== undefined && isRecord(lastEvent) && lastEvent.type === 'user/message')
+            usable = usable.slice(0, -1);
+        if (usable.length === 0)
+            return null;
+        return { start: usable[0], end: usable.at(-1), seqs: usable };
+    }
+    catch {
+        return null;
+    }
+}
+function boundCompactionSummary(summary) {
+    const value = summary?.trim() || 'Codex 已压缩较早的上下文。';
+    return value.slice(0, 120);
+}
+function safeCount(value) {
+    return value !== undefined && Number.isSafeInteger(value) && value >= 0 ? value : 0;
+}
 function finiteInteger(value) {
     return typeof value === 'number' && Number.isSafeInteger(value) && value >= 0 ? value : null;
 }

package/data/build/dist/host/remote-web-runtime.js

@@ -358,7 +358,7 @@ export function createLocalDshWebRuntimeProvider(options) {
             if (input.headers !== undefined)
                 init.headers = Object.fromEntries(input.headers);
             if (input.body !== undefined)
-                init.body = input.body;
+                init.body = normalizeConnectionRpcBody(path, input.method ?? 'GET', input.body);
             await ensureAuthenticated();
             const response = await fetchLocal(path, init);
             debug.log('web.provider.request.response', { sessionId: session.sessionId, path, method: input.method ?? 'GET', status: response.status });
@@ -409,6 +409,31 @@ function getSetCookie(headers) {
     }
     return undefined;
 }
+/**
+ * DSH Gateway 的 Connection RPC 要求请求参数位于 payload.args。
+ * 旧版 DSH Web Client 曾把单个参数对象直接放进 payload；只在 `/api/*`
+ * 的 POST RPC 请求上补这一层，已经符合协议的请求保持字节级语义不变。
+ */
+function normalizeConnectionRpcBody(path, method, body) {
+    if (method.toUpperCase() !== 'POST' || !path.startsWith('/api/'))
+        return body;
+    try {
+        const message = JSON.parse(body);
+        if (!isOfficialConnectionRpcMessage(message) || !isRecord(message.payload) || 'args' in message.payload)
+            return body;
+        return JSON.stringify({ ...message, payload: { args: message.payload } });
+    }
+    catch {
+        return body;
+    }
+}
+/** 只兼容 DSH 官方两段式 Remote endpoint，不能改写 CodingNS 自有 RPC。 */
+function isOfficialConnectionRpcMessage(value) {
+    if (!isRecord(value) || value.type !== 'client-request' || typeof value.method !== 'string')
+        return false;
+    const parts = value.method.split('/');
+    return parts.length === 2 && parts.every((part) => part !== '') && parts[0] !== 'codingns';
+}
 class RemoteWebRuntimeError extends Error {
     code;
     constructor(code, message) {

package/data/build/dist/host/rpc.js

@@ -179,7 +179,9 @@ const CODINGNS_RPC_ENDPOINTS = [
     'debug/runtime/get', 'debug/runtime/list', 'debug/runtime/stop',
     'debug/port/check', 'debug/port/terminate', 'debug/port/kill', 'debug/proxy/get', 'debug/proxy/enable', 'debug/proxy/disable',
     'git/status', 'git/init', 'git/diff', 'git/stage', 'git/unstage', 'git/discard', 'git/commit', 'git/commit-diff', 'git/history', 'git/branches', 'git/switch', 'git/fetch', 'git/pull', 'git/push', 'git/undo',
-    'lanAccessDsh/addresses', 'lanAccessDsh/detect', 'lanAccessDsh/get', 'lanAccessDsh/settings/get', 'lanAccessDsh/settings/set', 'lanAccessDsh/login/get', 'lanAccessDsh/login/set', 'lanAccessDsh/login/session/open', 'lanAccessDsh/start', 'lanAccessDsh/stop',
+    'fileManagement/session-changes', 'fileManagement/read', 'fileManagement/download', 'fileManagement/write', 'fileManagement/create-file', 'fileManagement/create-directory', 'fileManagement/rename', 'fileManagement/copy', 'fileManagement/move', 'fileManagement/delete', 'fileManagement/git-ignore',
+    'lanAccessDsh/addresses', 'lanAccessDsh/detect', 'lanAccessDsh/get', 'lanAccessDsh/settings/get', 'lanAccessDsh/settings/set', 'lanAccessDsh/login/get', 'lanAccessDsh/login/set', 'lanAccessDsh/login/session/open', 'lanAccessDsh/login/session/refresh', 'lanAccessDsh/start', 'lanAccessDsh/stop',
+    'peerHost/list', 'peerHost/diagnostics', 'peerHost/create', 'peerHost/update', 'peerHost/remove', 'peerHost/check', 'peerHost/reconnect', 'peerHost/login', 'peerHost/logout', 'peerHost/request', 'peerHost/wsEndpoint', 'peerHost/aggregate',
     'cli/catalog', 'cli/models', 'cli/adapter/set', 'cli/session/get', 'cli/session/set', 'cli/session/list', 'cli/session/adapter-map', 'cli/session/archive', 'cli/session/steer', 'cli/session/follow-up', 'cli/session/interrupt', 'cli/subscription',
 ];
 /** 创建远程设置处理器；只允许 Codingns4DSH 自己的 namespace 和路径编辑。 */
@@ -249,9 +251,12 @@ function isAllowedSettingsPath(path) {
     if (path.length === 1)
         return ['controlBaseUrl', 'controlBaseUrls', 'terminalEnhancement', 'workspaceSessionEnhancement'].includes(path[0] ?? '');
     if (path[0] === 'modules')
-        return path.length === 2 && ['lanAccess', 'reverseProxy', 'cliAdapters', 'terminalEnhancement', 'workspaceSessionEnhancement', 'debug', 'gitManagement'].includes(path[1] ?? '');
+        return path.length === 2 && ['lanAccess', 'reverseProxy', 'cliAdapters', 'terminalEnhancement', 'workspaceSessionEnhancement', 'debug', 'gitManagement', 'fileManagement', 'peerHost'].includes(path[1] ?? '');
     if (path[0] === 'workspaceSessionEnhancement') {
-        return path.length === 2 && ['showAdapterLogo', 'showArchivedSessions', 'showWorkspaceHiding', 'hiddenWorkspaceIds', 'showSubscriptionUsage', 'showQuickPhrases', 'quickPhrases', 'quickPhrasesSeeded'].includes(path[1] ?? '');
+        return path.length === 2 && ['showAdapterLogo', 'showArchivedSessions', 'showWorkspaceHiding', 'hiddenWorkspaceIds', 'showSubscriptionUsage', 'showQuickPhrases', 'rememberConversationRightbarRatio', 'quickPhrases', 'quickPhrasesSeeded'].includes(path[1] ?? '');
+    }
+    if (path[0] === 'fileManagement') {
+        return path.length === 2 && ['menuEnhancement', 'fileEditor', 'sessionChangedFiles'].includes(path[1] ?? '');
     }
     return path[0] === 'lanAccessDsh' && path.length === 2 && ['autoStart', 'listenHost', 'listenPort', 'dshPort'].includes(path[1] ?? '');
 }

package/data/build/dist/host/session-changes.d.ts

@@ -0,0 +1,5 @@
+import type { SessionChangedFiles } from '../shared/contracts/file-management.js';
+import type { CodingNsHostServices } from './features/types.js';
+/** 优先从 DSH 原生 Session 事件读取，原生事件不可用时回退到 JSONL。 */
+export declare function readSessionChangedFiles(services: CodingNsHostServices, sessionId: string, workspaceRoot: string): Promise<SessionChangedFiles>;
+//# sourceMappingURL=session-changes.d.ts.map

package/data/build/dist/host/session-changes.js

@@ -0,0 +1,163 @@
+import { readFile } from 'node:fs/promises';
+import { isAbsolute, normalize, relative, resolve } from 'node:path';
+const PATH_KEYS = new Set([
+    'path', 'paths', 'filePath', 'file_path', 'srcPath', 'src_path',
+    'dstPath', 'dst_path', 'oldPath', 'old_path', 'newPath', 'new_path',
+    'sourcePath', 'source_path', 'targetPath', 'target_path',
+]);
+/** 优先从 DSH 原生 Session 事件读取，原生事件不可用时回退到 JSONL。 */
+export async function readSessionChangedFiles(services, sessionId, workspaceRoot) {
+    let session = services.nativeSessions?.get(sessionId);
+    if (session === undefined && services.nativeSessions?.listRemote !== undefined) {
+        try {
+            const candidates = await services.nativeSessions.listRemote();
+            session = candidates.find((candidate) => sessionIdentity(candidate) === sessionId);
+        }
+        catch {
+            // 原生列表接口不可用时继续走 JSONL 降级。
+        }
+    }
+    const root = resolve(workspaceRoot);
+    const nativeEvents = snapshotEvents(session);
+    const nativePaths = extractToolPaths(nativeEvents, root);
+    if (nativePaths.size > 0)
+        return { paths: [...nativePaths].sort() };
+    const jsonlPath = findJsonlReference(session);
+    if (jsonlPath === undefined)
+        return { paths: [] };
+    try {
+        const content = await readFile(jsonlPath, 'utf8');
+        const events = content.split(/\r?\n/u).flatMap((line) => {
+            try {
+                const parsed = JSON.parse(line);
+                return [parsed];
+            }
+            catch {
+                return [];
+            }
+        });
+        return { paths: [...extractToolPaths(events, root)].sort() };
+    }
+    catch {
+        // JSONL 是降级数据源；文件不存在或不可读时保持可解释的空结果。
+        return { paths: [] };
+    }
+}
+function snapshotEvents(value) {
+    if (!isRecord(value))
+        return [];
+    if (typeof value.snapshotEvents === 'function') {
+        try {
+            const events = value.snapshotEvents();
+            if (Array.isArray(events))
+                return events;
+        }
+        catch {
+            // 单个会话损坏时继续尝试其内嵌事件数组。
+        }
+    }
+    return Array.isArray(value.events) ? value.events : [];
+}
+function extractToolPaths(events, workspaceRoot) {
+    const paths = new Set();
+    for (const candidate of events) {
+        const event = isRecord(candidate) ? candidate : undefined;
+        if (event === undefined)
+            continue;
+        const data = isRecord(event.data) ? event.data : event;
+        if (event.type === 'tool/call') {
+            collectInputPaths(data.arguments, workspaceRoot, paths);
+            continue;
+        }
+        if (event.type === 'tool/result') {
+            collectInputPaths(data.meta, workspaceRoot, paths);
+            continue;
+        }
+        if (event.type !== 'assistant/message')
+            continue;
+        const message = isRecord(data.message) ? data.message : undefined;
+        const content = message?.content;
+        if (!Array.isArray(content))
+            continue;
+        for (const block of content) {
+            if (!isRecord(block) || block.type !== 'tool-call')
+                continue;
+            collectInputPaths(block.arguments, workspaceRoot, paths);
+        }
+    }
+    return paths;
+}
+function collectInputPaths(value, workspaceRoot, paths) {
+    if (typeof value !== 'string') {
+        if (Array.isArray(value)) {
+            for (const item of value)
+                collectInputPaths(item, workspaceRoot, paths);
+            return;
+        }
+        if (isRecord(value)) {
+            for (const [key, nested] of Object.entries(value)) {
+                if (typeof nested === 'string' && PATH_KEYS.has(key))
+                    addPath(nested, workspaceRoot, paths);
+                else
+                    collectInputPaths(nested, workspaceRoot, paths);
+            }
+        }
+        return;
+    }
+    const trimmed = value.trim();
+    if (!trimmed.startsWith('{') && !trimmed.startsWith('[')) {
+        for (const line of trimmed.split(/\r?\n/u)) {
+            const match = /^\*\*\* (?:Update|Add|Delete) File:\s+(.+)$/u.exec(line)
+                ?? /^\*\*\* Move to:\s+(.+)$/u.exec(line);
+            if (match?.[1] !== undefined)
+                addPath(match[1], workspaceRoot, paths);
+        }
+        return;
+    }
+    try {
+        collectInputPaths(JSON.parse(trimmed), workspaceRoot, paths);
+    }
+    catch {
+        // 工具参数不是 JSON 时只使用 apply_patch 文本格式。
+    }
+}
+function addPath(value, workspaceRoot, paths) {
+    const trimmed = value.trim().replace(/^['"]+|['"]+$/gu, '');
+    if (trimmed === '' || trimmed === '.' || trimmed === './')
+        return;
+    const candidate = isAbsolute(trimmed) ? normalize(trimmed) : resolve(workspaceRoot, trimmed);
+    const relativePath = relative(workspaceRoot, candidate).replaceAll('\\', '/');
+    if (relativePath === '' || relativePath.startsWith('../') || isAbsolute(relativePath))
+        return;
+    paths.add(relativePath.replace(/^\.\//u, ''));
+}
+function findJsonlReference(value, depth = 0) {
+    if (depth > 5 || !isRecord(value))
+        return undefined;
+    for (const key of ['rawStoreRef', 'jsonlPath', 'sessionPath', 'filePath']) {
+        const candidate = value[key];
+        if (typeof candidate === 'string' && /\.jsonl(?:\.zstd)?$/u.test(candidate.trim()))
+            return candidate.trim();
+    }
+    for (const nested of Object.values(value)) {
+        const result = findJsonlReference(nested, depth + 1);
+        if (result !== undefined)
+            return result;
+    }
+    return undefined;
+}
+function sessionIdentity(value) {
+    if (!isRecord(value))
+        return undefined;
+    for (const key of ['sessionId', 'id']) {
+        const candidate = value[key];
+        if (typeof candidate === 'string' && candidate.trim() !== '')
+            return candidate.trim();
+    }
+    const header = value.header;
+    return isRecord(header) && typeof header.id === 'string' ? header.id.trim() : undefined;
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=session-changes.js.map

package/data/build/dist/host/settings.js

@@ -60,6 +60,7 @@ export const CodingNsSettingsSchema = z.object({
         hiddenWorkspaceIds: z.array(z.string().min(1).max(512)).default(DEFAULT_CODINGNS_SETTINGS.workspaceSessionEnhancement.hiddenWorkspaceIds),
         showSubscriptionUsage: z.boolean().default(DEFAULT_CODINGNS_SETTINGS.workspaceSessionEnhancement.showSubscriptionUsage),
         showQuickPhrases: z.boolean().default(DEFAULT_CODINGNS_SETTINGS.workspaceSessionEnhancement.showQuickPhrases),
+        rememberConversationRightbarRatio: z.boolean().default(DEFAULT_CODINGNS_SETTINGS.workspaceSessionEnhancement.rememberConversationRightbarRatio),
         quickPhrases: z.array(z.object({
             id: z.string().min(1).max(128),
             text: z.string().min(1).max(4000),
@@ -67,6 +68,11 @@ export const CodingNsSettingsSchema = z.object({
         // 缺少该字段说明是旧配置；Client 首次加载时会补齐内置快捷会话。
         quickPhrasesSeeded: z.boolean().default(false),
     }).default(DEFAULT_CODINGNS_SETTINGS.workspaceSessionEnhancement),
+    fileManagement: z.object({
+        menuEnhancement: z.boolean().default(DEFAULT_CODINGNS_SETTINGS.fileManagement.menuEnhancement),
+        fileEditor: z.boolean().default(DEFAULT_CODINGNS_SETTINGS.fileManagement.fileEditor),
+        sessionChangedFiles: z.boolean().default(DEFAULT_CODINGNS_SETTINGS.fileManagement.sessionChangedFiles),
+    }).default(DEFAULT_CODINGNS_SETTINGS.fileManagement),
 });
 /**
  * DSH 0.1.7 只会把 `volatile` 配置投影成可编辑 ConfigForm。

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

@@ -20,7 +20,7 @@ export { createHttpDshH5ControlApi, startDshH5BrowserBootstrap } from './client/
 export type { DshH5BrowserBootstrapOptions, DshH5BrowserBootstrapResult, DshH5BrowserControlApi } from './client/dsh-h5-bootstrap.js';
 export { CODINGNS_RPC_CHANNEL } from './shared/contracts/transport.js';
 export { CODINGNS4DSH_DEBUG_ENV, debugInfo, debugWarn, resolveCodingNsDebugEnabled, } from './shared/debug.js';
-export { CODINGNS_CONTROL_BASE_URL_FIELD, CODINGNS_CONTROL_BASE_URLS_FIELD, CODINGNS_LAN_ACCESS_DSH_FIELD, CODINGNS_MODULES_FIELD, CODINGNS_SETTINGS_NAMESPACE, DEFAULT_CODINGNS_CONTROL_BASE_URL, DEFAULT_CODINGNS_CONTROL_BASE_URLS, DEFAULT_CODINGNS_SETTINGS, enabledFeatureNames, isFeatureEnabled, } from './shared/contracts/config.js';
+export { CODINGNS_CONTROL_BASE_URL_FIELD, CODINGNS_CONTROL_BASE_URLS_FIELD, CODINGNS_LAN_ACCESS_DSH_FIELD, CODINGNS_FILE_MANAGEMENT_FIELD, CODINGNS_MODULES_FIELD, CODINGNS_SETTINGS_NAMESPACE, DEFAULT_CODINGNS_CONTROL_BASE_URL, DEFAULT_CODINGNS_CONTROL_BASE_URLS, DEFAULT_CODINGNS_SETTINGS, DEFAULT_FILE_MANAGEMENT_SETTINGS, enabledFeatureNames, isFeatureEnabled, } from './shared/contracts/config.js';
 export type * from './shared/index.js';
 export * from './dsh-capabilities/index.js';
 export { dispatchCodingNsRpc, type CodingNsRpcContext, type CodingNsRpcDispatchResult } from './dsh-capabilities/host/connection-rpc-adapter.js';

package/data/build/dist/index.js

@@ -18,7 +18,7 @@ export { RemoteDshWebContext } from './client/remote-web-context.js';
 export { createHttpDshH5ControlApi, startDshH5BrowserBootstrap } from './client/dsh-h5-bootstrap.js';
 export { CODINGNS_RPC_CHANNEL } from './shared/contracts/transport.js';
 export { CODINGNS4DSH_DEBUG_ENV, debugInfo, debugWarn, resolveCodingNsDebugEnabled, } from './shared/debug.js';
-export { CODINGNS_CONTROL_BASE_URL_FIELD, CODINGNS_CONTROL_BASE_URLS_FIELD, CODINGNS_LAN_ACCESS_DSH_FIELD, CODINGNS_MODULES_FIELD, CODINGNS_SETTINGS_NAMESPACE, DEFAULT_CODINGNS_CONTROL_BASE_URL, DEFAULT_CODINGNS_CONTROL_BASE_URLS, DEFAULT_CODINGNS_SETTINGS, enabledFeatureNames, isFeatureEnabled, } from './shared/contracts/config.js';
+export { CODINGNS_CONTROL_BASE_URL_FIELD, CODINGNS_CONTROL_BASE_URLS_FIELD, CODINGNS_LAN_ACCESS_DSH_FIELD, CODINGNS_FILE_MANAGEMENT_FIELD, CODINGNS_MODULES_FIELD, CODINGNS_SETTINGS_NAMESPACE, DEFAULT_CODINGNS_CONTROL_BASE_URL, DEFAULT_CODINGNS_CONTROL_BASE_URLS, DEFAULT_CODINGNS_SETTINGS, DEFAULT_FILE_MANAGEMENT_SETTINGS, enabledFeatureNames, isFeatureEnabled, } from './shared/contracts/config.js';
 export * from './dsh-capabilities/index.js';
 export { dispatchCodingNsRpc } from './dsh-capabilities/host/connection-rpc-adapter.js';
 export { FeatureRegistry, FeatureRegistryError, FeatureResourceScopeImpl, } from './features/registry.js';