@jingyi0605/codingns4dsh 0.1.0 → 0.1.2

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

@@ -1,4 +1,5 @@
-import { CODINGNS_SETTINGS_NAMESPACE } from '../shared/contracts/config.js';
+import { CODINGNS_SETTINGS_NAMESPACE, isCodingNsSettingsEntryId } from '../shared/contracts/config.js';
+import { debugInfo, debugWarn } from '../shared/debug.js';
 import { CodingNsRpcError } from './rpc-table.js';
 /**
  * 创建 Codingns4DSH Host RPC 主处理器。
@@ -9,16 +10,30 @@ import { CodingNsRpcError } from './rpc-table.js';
  * 凭据存储。
  */
 export function createCodingNsRpcHandler(table) {
-    return async (endpoint, payload) => {
+    return async (endpoint, payload, signal) => {
+        debugInfo('codingns4dsh: host rpc request', { endpoint });
         const target = table.resolve(endpoint);
         if (target === null) {
+            debugWarn('codingns4dsh: host rpc endpoint not found', { endpoint });
             return failure('CODINGNS_RPC_NOT_FOUND', `未知 Codingns4DSH RPC: ${endpoint}`);
         }
         try {
-            return success(await target.handler(target.action, payload));
+            const value = await target.handler(target.action, payload, { signal });
+            debugInfo('codingns4dsh: host rpc success', { endpoint });
+            return success(value);
         }
         catch (error) {
-            return failure(errorCode(error), error instanceof Error ? error.message : String(error));
+            const code = errorCode(error);
+            const details = { endpoint, code, error };
+            if (code === 'CODINGNS_RPC_UNAUTHENTICATED') {
+                // 未登录是正常的业务状态，不能把它伪装成 Host 故障；RPC 仍返回失败，
+                // 让客户端根据稳定错误码决定是否等待登录。
+                console.warn('codingns4dsh: host rpc request rejected', details);
+            }
+            else {
+                console.error('codingns4dsh: host rpc handler failed', details);
+            }
+            return failure(code, error instanceof Error ? error.message : String(error));
         }
     };
 }
@@ -29,16 +44,27 @@ export function registerCodingNsRpc(ctx, table, settingsProvider) {
     // 注入的服务实例，挂载同协议的前缀路由，避免把 RPC 请求落到 SPA fallback。
     const webServer = ctx.webServer;
     const connection = ctx.connection;
+    debugInfo('codingns4dsh: host rpc registration begin', {
+        hasConnectionRpc: typeof connection.rpc?.handle === 'function',
+        endpointCount: CODINGNS_RPC_ENDPOINTS.length,
+    });
     ctx.effect(() => {
         const unregisterSettings = settingsProvider === undefined
             ? undefined
             : table.register('settings', createCodingNsSettingsRpcHandler(settingsProvider));
         const handler = createCodingNsRpcHandler(table);
+        // DSH 0.1.7 的 connection.rpc.handle() 会在当前插件 Fiber 中再次读取
+        // webServer；该 Fiber 没有 webServer 注入时会直接抛错。这里使用当前
+        // Host 已明确注入的 webServer 注册插件自有前缀，避免 Host RPC 装配中断。
         const unregisterChannel = webServer.register({
             kind: 'prefix',
             path: '/codingns',
             handler: (request, response) => handleChannelRequest(request, response, connection, handler),
         });
+        debugInfo('codingns4dsh: host rpc channel registered', {
+            transport: 'webServer.prefix',
+            channel: '/codingns',
+        });
         // 保留旧的精确 Fetch 路由，兼容早期 H5/桌面载体直接访问 `/api/codingns/*`
         // 的调用方。两条入口共享同一个 handler，不复制任何业务逻辑。
         const disposeFetch = CODINGNS_RPC_ENDPOINTS.map((endpoint) => ctx.connection.fetch.register({
@@ -47,11 +73,17 @@ export function registerCodingNsRpc(ctx, table, settingsProvider) {
             requestBody: 'buffered',
             fetch: async (request) => handleFetchRpc(request, endpoint, handler),
         }));
+        debugInfo('codingns4dsh: host rpc fetch routes registered', {
+            prefix: '/api/codingns/',
+            count: disposeFetch.length,
+            endpoints: CODINGNS_RPC_ENDPOINTS,
+        });
         return async () => {
             for (const dispose of disposeFetch.reverse())
                 await dispose();
-            unregisterChannel();
+            await unregisterChannel();
             unregisterSettings?.();
+            debugInfo('codingns4dsh: host rpc channel disposed');
         };
     }, 'codingns4dsh: Host RPC');
 }
@@ -146,6 +178,7 @@ const CODINGNS_RPC_ENDPOINTS = [
     'debug/config/get', 'debug/config/save', 'debug/config/update', 'debug/config/delete', 'debug/profile/list', 'debug/profile/launch',
     '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',
     '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',
 ];
@@ -158,22 +191,33 @@ export function createCodingNsSettingsRpcHandler(provider) {
             if (!provider.writable)
                 throw new CodingNsRpcError('CODINGNS_SETTINGS_READ_ONLY', 'Host 设置提供器当前只读');
             const input = parseSettingsMutation(payload);
-            await provider.mutate(CODINGNS_SETTINGS_NAMESPACE, input.ops, input.expectedRevision);
+            await provider.mutate(resolveCodingNsSettingsNamespace(provider), input.ops, input.expectedRevision);
             return readCodingNsSettings(provider);
         }
         throw new CodingNsRpcError('CODINGNS_RPC_NOT_FOUND', `未知 Codingns4DSH RPC: settings/${action}`);
     };
 }
 function readCodingNsSettings(provider) {
-    const descriptor = provider.describe({ redactSecrets: true }).find((item) => item.ns === CODINGNS_SETTINGS_NAMESPACE);
+    const descriptor = findCodingNsSettingsDescriptor(provider);
     if (descriptor === undefined)
         throw new CodingNsRpcError('CODINGNS_SETTINGS_UNAVAILABLE', 'Codingns4DSH 设置尚未注册');
-    const value = provider.get(CODINGNS_SETTINGS_NAMESPACE);
+    // 0.1.7 的 ConfigForm namespace 由 Bundle entry id 决定。包名改为 scoped 后，
+    // descriptor.ns 可能是 `@jingyi0605/codingns4dsh`，不能继续固定读取旧的 `codingns`。
+    const providerValue = typeof provider.get === 'function'
+        ? provider.get(descriptor.ns)
+        : undefined;
+    const value = providerValue ?? descriptor.value;
     // cliSessions 是 Host-only 索引，包含 providerSessionId/rawStoreRef，不能通过设置 RPC
     // 暴露给浏览器。外部会话列表必须走 cli/session/list，由 Host 按需返回摘要。
     const { cliSessions: _cliSessions, ...clientValue } = value;
     return { value: clientValue, revision: descriptor.revision };
 }
+function findCodingNsSettingsDescriptor(provider) {
+    return provider.describe({ redactSecrets: true }).find((item) => isCodingNsSettingsEntryId(item.ns));
+}
+function resolveCodingNsSettingsNamespace(provider) {
+    return findCodingNsSettingsDescriptor(provider)?.ns ?? CODINGNS_SETTINGS_NAMESPACE;
+}
 function parseSettingsMutation(value) {
     if (!isRecord(value) || !Array.isArray(value.ops) || value.ops.length === 0 || value.ops.length > 8) {
         throw new TypeError('settings/set 参数必须包含 1 到 8 个 ops');
@@ -205,9 +249,9 @@ 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'].includes(path[1] ?? '');
+        return path.length === 2 && ['lanAccess', 'reverseProxy', 'cliAdapters', 'terminalEnhancement', 'workspaceSessionEnhancement', 'debug', 'gitManagement'].includes(path[1] ?? '');
     if (path[0] === 'workspaceSessionEnhancement') {
-        return path.length === 2 && ['showAdapterLogo', 'showArchivedSessions', 'showSubscriptionUsage'].includes(path[1] ?? '');
+        return path.length === 2 && ['showAdapterLogo', 'showArchivedSessions', 'showWorkspaceHiding', 'hiddenWorkspaceIds', 'showSubscriptionUsage', 'showQuickPhrases', 'quickPhrases', 'quickPhrasesSeeded'].includes(path[1] ?? '');
     }
     return path[0] === 'lanAccessDsh' && path.length === 2 && ['autoStart', 'listenHost', 'listenPort', 'dshPort'].includes(path[1] ?? '');
 }
@@ -215,6 +259,11 @@ function isRecord(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }
 async function handleFetchRpc(request, endpoint, handler) {
+    debugInfo('codingns4dsh: host fetch rpc request', {
+        endpoint,
+        method: request.method,
+        path: new URL(request.url).pathname,
+    });
     let body;
     try {
         body = await request.json();
@@ -230,6 +279,7 @@ async function handleFetchRpc(request, endpoint, handler) {
         return new Response('invalid RPC envelope', { status: 400 });
     }
     const result = await handler(endpoint, envelope.payload, request.signal);
+    debugInfo('codingns4dsh: host fetch rpc response', { endpoint, ok: result.ok });
     return Response.json({ type: 'server-response', rpcId: envelope.rpcId, result });
 }
 function success(value) {

package/data/build/dist/host/session-migration-repair.d.ts

@@ -0,0 +1,19 @@
+export interface LegacySessionRepairOptions {
+    readonly root: string;
+    readonly signal?: AbortSignal;
+    readonly logger?: (message: string, error?: unknown) => void;
+}
+export interface LegacySessionRepairReport {
+    readonly scanned: number;
+    readonly repaired: number;
+    readonly skipped: number;
+    readonly failed: number;
+}
+/**
+ * 在官方 v3->v4 迁移前修复外部 Agent 写入的裸 tool/call。
+ * 每个文件独立处理，单文件失败不会影响其他历史会话。
+ */
+export declare function repairLegacySessionLogs(options: LegacySessionRepairOptions): Promise<LegacySessionRepairReport>;
+/** 修复一个 v3/v4 日志；返回 true 表示已发布修复文件。 */
+export declare function repairLegacySessionLog(path: string, signal?: AbortSignal): Promise<boolean>;
+//# sourceMappingURL=session-migration-repair.d.ts.map

package/data/build/dist/host/session-migration-repair.js

@@ -0,0 +1,395 @@
+import { copyFile, mkdtemp, readFile, readdir, rename, rm, writeFile } from 'node:fs/promises';
+import { basename, join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { zstdCompressSync, zstdDecompressSync } from 'node:zlib';
+const ZSTD_MAGIC = Buffer.from([0x28, 0xb5, 0x2f, 0xfd]);
+// v4 文件也可能是由旧版插件直接写入的裸 tool/call；DSH 0.1.7
+// 会在恢复时直接拒绝它，因此必须在 open 边界前一并修复。
+const LEGACY_FILE = /^session\.v[34]\.(jsonl|jsonl\.zstd)$/u;
+const REFERENCE_KEYS = new Set([
+    'sourceEventSeq',
+    'sourceEventSeqs',
+    'headerSeq',
+    'throughSeq',
+    'messageSeqs',
+    'shadowedSeqs',
+    'startSeq',
+    'endSeq',
+]);
+/**
+ * 在官方 v3->v4 迁移前修复外部 Agent 写入的裸 tool/call。
+ * 每个文件独立处理，单文件失败不会影响其他历史会话。
+ */
+export async function repairLegacySessionLogs(options) {
+    const files = await findLegacyLogs(options.root, options.signal);
+    let repaired = 0;
+    let skipped = 0;
+    let failed = 0;
+    for (const path of files) {
+        throwIfAborted(options.signal);
+        try {
+            const result = await repairLegacySessionLog(path, options.signal);
+            if (result)
+                repaired += 1;
+            else
+                skipped += 1;
+        }
+        catch (error) {
+            failed += 1;
+            options.logger?.(`历史会话修复失败：${path}`, error);
+        }
+    }
+    return { scanned: files.length, repaired, skipped, failed };
+}
+/** 修复一个 v3/v4 日志；返回 true 表示已发布修复文件。 */
+export async function repairLegacySessionLog(path, signal) {
+    const source = await readFileBytes(path);
+    throwIfAborted(signal);
+    const parsed = decodeLog(path, source);
+    const repaired = repairEvents(parsed.events, isV4Log(path, parsed.header));
+    if (repaired === null)
+        return false;
+    throwIfAborted(signal);
+    await publishRepair(path, parsed.header, repaired, parsed.compression, source, signal);
+    return true;
+}
+async function findLegacyLogs(root, signal) {
+    const result = [];
+    const queue = [root];
+    while (queue.length > 0) {
+        throwIfAborted(signal);
+        const current = queue.shift();
+        let entries;
+        try {
+            entries = await readdir(current, { withFileTypes: true });
+        }
+        catch (error) {
+            if (errorCode(error) === 'ENOENT')
+                continue;
+            throw error;
+        }
+        for (const entry of entries) {
+            const path = join(current, entry.name);
+            if (entry.isDirectory())
+                queue.push(path);
+            else if (entry.isFile() && LEGACY_FILE.test(entry.name))
+                result.push(path);
+        }
+    }
+    return result;
+}
+async function readFileBytes(path) {
+    const readBinary = readFile;
+    return readBinary(path);
+}
+function decodeLog(path, bytes) {
+    const compression = path.endsWith('.zstd') ? 'zstd' : 'none';
+    const text = compression === 'zstd' ? decodeZstd(bytes) : bytes.toString('utf8');
+    const rows = text.split('\n').filter((line) => line.trim() !== '').map((line, index) => {
+        const value = JSON.parse(line);
+        if (!isRecord(value))
+            throw new Error(`历史会话第 ${String(index + 1)} 行不是对象`);
+        return value;
+    });
+    const header = rows.shift();
+    if (header === undefined || header.type !== 'session')
+        throw new Error('历史会话缺少 session 头');
+    const events = rows.map((row, index) => {
+        if (typeof row.seq !== 'number' || row.seq !== index)
+            throw new Error(`历史会话 seq 不连续：期望 ${String(index)}，得到 ${String(row.seq)}`);
+        if (typeof row.type !== 'string')
+            throw new Error(`历史会话事件 ${String(index)} 缺少 type`);
+        return row;
+    });
+    return { header, events, compression };
+}
+function decodeZstd(bytes) {
+    const chunks = [];
+    let offset = 0;
+    while (offset < bytes.length) {
+        const next = bytes.indexOf(ZSTD_MAGIC, offset + 1);
+        const frame = bytes.subarray(offset, next === -1 ? bytes.length : next);
+        chunks.push(zstdDecompressSync(frame));
+        offset = next === -1 ? bytes.length : next;
+    }
+    return Buffer.concat(chunks).toString('utf8');
+}
+function repairEvents(events, canonicalizeV4Results = false) {
+    const mapping = [];
+    const insertBefore = new Map();
+    const pending = new Set();
+    const normalizedAssistantMessages = new Map();
+    let canonicalized = false;
+    for (const event of events) {
+        const oldSeq = event.seq;
+        if (event.type === 'assistant/message')
+            registerDeclaredCalls(event, pending);
+        if (event.type === 'tool/call') {
+            const call = toolCallData(event);
+            if (call !== null && !pending.has(call.callId)) {
+                insertBefore.set(oldSeq, call);
+                pending.add(call.callId);
+            }
+            if (call !== null)
+                pending.add(call.callId);
+        }
+        if (event.type === 'tool/result') {
+            const callId = toolResultCallId(event);
+            if (callId !== null)
+                pending.delete(callId);
+        }
+    }
+    const declaredExternalCalls = new Set();
+    for (const event of events) {
+        if (event.type === 'step/start' || event.type === 'turn/start')
+            declaredExternalCalls.clear();
+        const normalized = canonicalizeExternalAssistantMessage(event, declaredExternalCalls);
+        if (normalized !== event) {
+            normalizedAssistantMessages.set(event.seq, normalized);
+            canonicalized = true;
+        }
+        if (event.type === 'step/end' || event.type === 'turn/end')
+            declaredExternalCalls.clear();
+    }
+    if (insertBefore.size === 0 && !canonicalizeV4Results && !canonicalized)
+        return null;
+    if (canonicalizeV4Results) {
+        for (const event of events) {
+            if (canonicalizeV4ToolResult(event) !== event) {
+                canonicalized = true;
+                break;
+            }
+        }
+    }
+    if (insertBefore.size === 0 && !canonicalized)
+        return null;
+    let nextSeq = 0;
+    for (const event of events) {
+        const oldSeq = event.seq;
+        if (insertBefore.has(oldSeq))
+            nextSeq += 1;
+        mapping[oldSeq] = nextSeq;
+        nextSeq += 1;
+    }
+    const output = [];
+    for (const event of events) {
+        const oldSeq = event.seq;
+        const call = insertBefore.get(oldSeq);
+        if (call !== undefined)
+            output.push(createDeclaration(event, call, mapping[oldSeq] - 1));
+        const deduplicated = normalizedAssistantMessages.get(oldSeq) ?? event;
+        const normalized = canonicalizeV4Results ? canonicalizeV4ToolResult(deduplicated) : deduplicated;
+        output.push(remapEvent(normalized, mapping[oldSeq], mapping));
+    }
+    return output;
+}
+function isV4Log(path, header) {
+    return header.version === 4 || /\.v4\.jsonl(?:\.zstd)?$/u.test(path);
+}
+/** 将插件旧版在 V4 文件中留下的 V3 tool-result wrapper 提升为 tool-role 消息。 */
+function canonicalizeV4ToolResult(event) {
+    if (event.type !== 'tool/result')
+        return event;
+    const data = isRecord(event.data) ? event.data : undefined;
+    const message = data && isRecord(data.message) ? data.message : undefined;
+    if (message?.role !== 'user')
+        return event;
+    const source = isRecord(message.source) ? message.source : undefined;
+    const callId = source?.kind === 'tool' && typeof source.callId === 'string' ? source.callId : undefined;
+    const content = message.content;
+    if (callId === undefined || !Array.isArray(content) || content.length !== 1)
+        return event;
+    const wrapper = content[0];
+    if (!isRecord(wrapper) || wrapper.type !== 'tool-result' || wrapper.toolCallId !== callId || !Array.isArray(wrapper.content))
+        return event;
+    if (wrapper.isError !== undefined && typeof wrapper.isError !== 'boolean')
+        return event;
+    const { content: _legacyContent, ...rest } = message;
+    const normalizedMessage = {
+        ...rest,
+        role: 'tool',
+        toolCallId: callId,
+        content: wrapper.content,
+        ...(wrapper.isError === undefined ? {} : { isError: wrapper.isError }),
+    };
+    return { ...event, data: { ...data, message: normalizedMessage } };
+}
+/** 删除外部适配器累积消息中的历史 tool-call，保留当前消息新增的声明。 */
+function canonicalizeExternalAssistantMessage(event, declared) {
+    if (event.type !== 'assistant/message')
+        return event;
+    const data = isRecord(event.data) ? event.data : undefined;
+    const message = data && isRecord(data.message) ? data.message : undefined;
+    if (!message || !Array.isArray(message.content) || !Array.isArray(data?.stream) || data.stream.length !== 0)
+        return event;
+    let changed = false;
+    const content = message.content.filter((block) => {
+        if (!isRecord(block) || block.type !== 'tool-call' || typeof block.id !== 'string')
+            return true;
+        if (declared.has(block.id)) {
+            changed = true;
+            return false;
+        }
+        declared.add(block.id);
+        return true;
+    });
+    return changed ? { ...event, data: { ...data, message: { ...message, content } } } : event;
+}
+function registerDeclaredCalls(event, pending) {
+    const data = isRecord(event.data) ? event.data : undefined;
+    const message = data && isRecord(data.message) ? data.message : undefined;
+    const content = message?.content;
+    if (!Array.isArray(content))
+        return;
+    for (const block of content) {
+        if (!isRecord(block) || block.type !== 'tool-call' || typeof block.id !== 'string')
+            continue;
+        pending.add(block.id);
+    }
+}
+function toolCallData(event) {
+    const data = isRecord(event.data) ? event.data : undefined;
+    if (!data || typeof data.callId !== 'string' || typeof data.name !== 'string' || typeof data.arguments !== 'string')
+        return null;
+    if (!Number.isSafeInteger(data.turn) || !Number.isSafeInteger(data.step))
+        return null;
+    return { callId: data.callId, name: data.name, arguments: data.arguments, turn: data.turn, step: data.step };
+}
+function toolResultCallId(event) {
+    const data = isRecord(event.data) ? event.data : undefined;
+    const message = data && isRecord(data.message) ? data.message : undefined;
+    if (typeof message?.toolCallId === 'string')
+        return message.toolCallId;
+    const content = message?.content;
+    if (!Array.isArray(content) || content.length !== 1)
+        return null;
+    const wrapper = content[0];
+    return isRecord(wrapper) && wrapper.type === 'tool-result' && typeof wrapper.toolCallId === 'string'
+        ? wrapper.toolCallId
+        : null;
+}
+function createDeclaration(event, call, seq) {
+    return {
+        type: 'assistant/message',
+        seq,
+        ...(typeof event.time === 'number' ? { time: event.time } : {}),
+        data: {
+            turn: call.turn,
+            step: call.step,
+            message: {
+                id: `external-tool-${call.callId}-${call.turn}-${call.step}`,
+                role: 'assistant',
+                content: [{ type: 'tool-call', id: call.callId, name: call.name, arguments: call.arguments }],
+                source: { kind: 'model', provider: 'codingns-external', model: 'external-agent' },
+            },
+            stream: [],
+        },
+        surfaceOp: 'append',
+    };
+}
+function remapEvent(event, seq, mapping) {
+    if (seq === event.seq)
+        return event;
+    const data = remapReferences(event.data, mapping);
+    const surfaceOp = remapReferences(event.surfaceOp, mapping);
+    const sourceEventSeqs = event.sourceEventSeqs === undefined ? undefined : event.sourceEventSeqs.map((value) => mapReference(value, mapping));
+    return {
+        ...event,
+        seq,
+        ...(data === event.data ? {} : { data }),
+        ...(surfaceOp === event.surfaceOp ? {} : { surfaceOp }),
+        ...(sourceEventSeqs === undefined ? {} : { sourceEventSeqs }),
+    };
+}
+function remapReferences(value, mapping, key, range = false, targetSeq = false) {
+    if (typeof value === 'number' && key !== undefined && (REFERENCE_KEYS.has(key) || range && (key === 'start' || key === 'end') || targetSeq && key === 'seq'))
+        return mapReference(value, mapping);
+    if (Array.isArray(value))
+        return value.map((item) => remapReferences(item, mapping, key, range, targetSeq));
+    if (!isRecord(value))
+        return value;
+    let changed = false;
+    const copy = {};
+    for (const [childKey, child] of Object.entries(value)) {
+        const mapped = remapReferences(child, mapping, childKey, key === 'shadowedRange', key === 'targets' || targetSeq);
+        copy[childKey] = mapped;
+        changed ||= mapped !== child;
+    }
+    return changed ? copy : value;
+}
+function mapReference(value, mapping) {
+    const mapped = mapping[value];
+    if (mapped === undefined)
+        throw new Error(`历史会话引用了不存在的 seq：${String(value)}`);
+    return mapped;
+}
+async function publishRepair(path, header, events, compression, original, signal) {
+    const tempDir = await mkdtemp(join(tmpdir(), 'codingns-session-repair-'));
+    const tempPath = join(tempDir, basename(path));
+    const backupPath = `${path}.codingns-repair-backup`;
+    try {
+        const body = [header, ...events].map((value) => `${JSON.stringify(value)}\n`).join('');
+        const encoded = compression === 'zstd'
+            ? Buffer.concat([zstdCompressSync(Buffer.from(`${JSON.stringify(header)}\n`)), zstdCompressSync(Buffer.from(events.map((event) => `${JSON.stringify(event)}\n`).join('')))])
+            : Buffer.from(body);
+        const writeBinary = writeFile;
+        await writeBinary(tempPath, encoded, { flag: 'wx', mode: 0o600 });
+        throwIfAborted(signal);
+        if (!(await sameBytes(path, original)))
+            throw new Error('历史会话在修复期间发生变化');
+        try {
+            await copyFile(path, backupPath, 1);
+        }
+        catch (error) {
+            if (errorCode(error) !== 'EEXIST')
+                throw error;
+        }
+        await replaceFile(tempPath, path, `${path}.codingns-repair-displaced-${basename(tempDir)}`);
+    }
+    finally {
+        await rm(tempDir, { recursive: true, force: true });
+    }
+}
+/** POSIX rename 可以直接替换；Windows 在目标存在时先暂存旧文件再发布。 */
+async function replaceFile(tempPath, targetPath, displacedPath) {
+    try {
+        await rename(tempPath, targetPath);
+        return;
+    }
+    catch (error) {
+        if (!['EEXIST', 'EPERM', 'ENOTEMPTY'].includes(errorCode(error) ?? ''))
+            throw error;
+    }
+    await rename(targetPath, displacedPath);
+    try {
+        await rename(tempPath, targetPath);
+    }
+    catch (error) {
+        try {
+            await rename(displacedPath, targetPath);
+        }
+        catch { }
+        throw error;
+    }
+    await rm(displacedPath, { force: true });
+}
+async function sameBytes(path, expected) {
+    try {
+        const current = await readFileBytes(path);
+        return current.equals(expected);
+    }
+    catch {
+        return false;
+    }
+}
+function throwIfAborted(signal) {
+    if (signal?.aborted)
+        throw signal.reason instanceof Error ? signal.reason : new Error('历史会话修复已取消');
+}
+function errorCode(error) {
+    return isRecord(error) && typeof error.code === 'string' ? error.code : undefined;
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+//# sourceMappingURL=session-migration-repair.js.map

package/data/build/dist/host/settings.d.ts

@@ -1,7 +1,7 @@
 import type { Context } from '@deepseek-ai/cordis';
 import z from '@deepseek-ai/schemastery';
 import type { SettingsScope } from '@deepseek-ai/dsh-settings';
-import { type CodingNsSettings } from '../shared/contracts/config.js';
+import { type CodingNsConfig, type CodingNsSettings } from '../shared/contracts/config.js';
 /**
  * DSH 设置服务使用的 Codingns4DSH namespace schema。
  *
@@ -9,6 +9,13 @@ import { type CodingNsSettings } from '../shared/contracts/config.js';
  * 也不需要改 CodingNsSettings 接口。
  */
 export declare const CodingNsSettingsSchema: z<CodingNsSettings>;
+/**
+ * DSH 0.1.7 只会把 `volatile` 配置投影成可编辑 ConfigForm。
+ *
+ * 整个根节点标记为 volatile，保留 Host 侧 `cliSessions` 的持久化能力；
+ * Client 适配器会在镜像配置时剔除这个 Host-only 字段，避免会话索引进入浏览器。
+ */
+export declare const CodingNsConfigSchema: z<CodingNsConfig>;
 /**
  * 在 Host 设置文档中注册 Codingns4DSH 的持久化选项。
  *