dsh-session-rollover 0.0.0-stage → 1.2.0

package/src/application/rollover.mjs

@@ -0,0 +1,236 @@
+// dsh-session-rollover · 装配层（事务 T0–T8，细化稿 §3 方案 A：注入前置为第一方案）
+// 顺序：T0 轮次 → T1 mode 拦截 → T2 硬闸+快照+命名预演 → T3 八段摘要 → T4 建未定名新会话
+//      → T5 注入摘要（首条 user/message）→ T6 旧卷改名 → T7 新卷改名 → T8 提交（簇索引+turn_counts+-1 只读）
+// T0–T3 不过时不创建会话、不改名；注入失败登记待清理，新卷改名失败则尝试回滚旧卷标题。
+// 依赖注入：host（宿主适配器）与 state/index/persistence（存储）都由调用方给，夹具可全内存替换真跑。
+import {countTurns, hasOpenTurn, DEFAULT_THRESHOLD} from '../domain/turns.mjs';
+import {parseVolume, planVolumeTitles} from '../domain/naming.mjs';
+import {effectiveRolloverMode, markersFound, transitionInFlight} from '../domain/mode.mjs';
+import {buildHandoff, MAX_BYTES} from '../domain/handoff.mjs';
+import {eventsToMessages, renderHandoffMessage} from './handoff-message.mjs';
+import {buildSummarySegments, changedFilesFrom, constraintsFrom} from '../domain/summary.mjs';
+
+/**
+ * 跑一次分卷事务。host 接口（全部 async，夹具可内存实现）：
+ *   listEvents(sessionId) / getTitle(sessionId) / listTitles() / getTodos(sessionId)
+ *   inFlightTools(sessionId) / isSubagent(sessionId) / listRunningJobs(sessionId)
+ *   createSession({cwd}) -> {sessionId} / injectFirstMessage(sessionId, text) / renameSession(sessionId, title)
+ *   log(event, data)
+ * manual=true 仅绕过 T0/T1 自动门槛；只读、子会话、未收尾工具和完整消息字节预算仍生效。
+ * T8 的各文件分别提交，不是跨文件数据库事务；索引存储失败通过 degraded 显式返回。
+ */
+export async function performRollover({
+                                          host,
+                                          sessionId,
+                                          index,
+                                          persistence,
+                                          state,
+                                          config = {},
+                                          summarySegments,
+                                          currentStepIndex = null,
+                                          activeIndexes = [],
+                                          constraints,
+                                          changedFiles,
+                                          cwd,
+                                          userRenamed = false,
+                                          manual = false,
+                                          now = () => new Date().toISOString(),
+                                      }) {
+    const trace = [];
+    const mark = (step, data = {}) => {
+        const rec = {step, at: now(), ...data};
+        trace.push(rec);
+        host.log?.(`rollover:${step}`, rec);
+        return rec;
+    };
+    const done = (status, reason, extra = {}) => ({status, reason, sessionId, trace, ...extra});
+
+    // 只读卷（-1）一律不动：连触发都不许（AC-R3-7 的服务端闸）
+    if (state?.isReadonly(sessionId)) return done('skipped', 'readonly');
+
+    // T0 轮次口径由 domain/turns.mjs 统一定义，统计真实用户消息，执行安全由 open-turn 单独判断。
+    const events = await host.listEvents(sessionId);
+    if (transitionInFlight(events)) return done('skipped', 'transition-in-flight');
+    if (hasOpenTurn(events)) return done('skipped', 'turn-in-flight');
+    const turnCount = countTurns(events);
+    const threshold = config.threshold ?? DEFAULT_THRESHOLD;
+    mark('T0', {turnCount, threshold});
+    if (!manual && turnCount < threshold) return done('skipped', 'below-threshold', {turnCount});
+
+    // T1 mode 拦截（零副作用）：off 直接返回；manual 只提示；auto 检出外部分段特征降 manual
+    const markers = markersFound(eventsToMessages(events));
+    const {mode, downgraded} = effectiveRolloverMode(config.mode ?? 'auto', {
+        forceAuto: !!config.forceAuto,
+        hasMarkers: markers
+    });
+    mark('T1', {mode, downgraded, markers});
+    if (!manual && mode === 'off') return done('skipped', 'mode-off');
+    if (!manual && mode === 'manual') return done('skipped', 'manual-pending', {notice: true, downgraded});
+
+    // T2 硬闸 + 快照（同刻取 running job 全集，切点后新起的不入交接）
+    if (await host.isSubagent(sessionId)) return done('skipped', 'subagent-never');
+    const inFlight = await host.inFlightTools(sessionId);
+    mark('T2', {inFlight: inFlight.length, tools: inFlight.map((t) => t?.name ?? t?.callId ?? '?')});
+    if (inFlight.length > 0) return done('skipped', 'unsafe-cut-point', {inFlight: inFlight.length});
+
+    // 命名预演放在建会话之前：cluster-cap / user-renamed 也必须是零副作用
+    const currentTitle = await host.getTitle(sessionId);
+    const titles = (await host.listTitles()).map((t) => t.title);
+    const previous = index?.get(sessionId);
+    const renamed = userRenamed || await host.isUserRenamed?.(sessionId) || false;
+    const oldVolume = previous?.vol_no ?? (!renamed && parseVolume(currentTitle).k === 9 ? 9 : 1);
+    let plan = planVolumeTitles(currentTitle, titles, {preserveTitle: renamed, nameSuffix: !renamed ? previous?.name_suffix : undefined,
+        volumeNo: oldVolume});
+    // 达到卷号上限后，显式手动分卷允许新建独立接续系列，保留来源卷的标题与索引。
+    if (manual && !plan.ok && plan.reason === 'cluster-cap') {
+        const base = parseVolume(currentTitle).base;
+        let n = 1;
+        while (titles.includes(`${base}（接续 ${n}）`)) n++;
+        plan = {ok: true, independent: true, base: `${base}（接续 ${n}）`, oldTarget: null,
+            oldK: parseVolume(currentTitle).k, newK: 1, newTarget: `${base}（接续 ${n}）`};
+    }
+    mark('T2:plan', {currentTitle, ...plan});
+    if (!plan.ok) return done('skipped', plan.reason, {currentTitle, notice: true});
+
+    const jobs = await host.listRunningJobs(sessionId);
+    const todos = await host.getTodos(sessionId);
+    // 单次事务只捕获一次待办/jobs；四段正文、机器快照和页面八块都消费它。
+    activeIndexes = todos.flatMap((t, i) => t.status === 'in_progress' ? [i + 1] : []);
+    currentStepIndex = activeIndexes[0] ?? null;
+    constraints ??= constraintsFrom(events);
+    changedFiles ??= changedFilesFrom(events);
+    summarySegments ??= buildSummarySegments({events, todos, jobs, currentStepIndex});
+    mark('T2:snapshot', {jobs: jobs.length, todos: todos.length});
+
+    // T3 八段摘要（失败=不分卷，旧卷零动作；retry 计数由调用方按 index.summary_retry 维护）
+    if (!Array.isArray(summarySegments) || summarySegments.length === 0) return done('failed', 'summary-missing');
+    const clusterId = (!plan.independent && index?.get(sessionId)?.cluster_id) || `cluster:${plan.base}`;
+    const built = buildHandoff({
+        summarySegments, todos, activeIndexes, currentStepIndex, openJobs: jobs,
+        constraints, changedFiles, cluster: {cluster_id: clusterId, parent_session_id: plan.independent ? null : sessionId,
+            vol_no: plan.independent ? 1 : oldVolume + 1, independent: !!plan.independent}, fromSessionId: sessionId,
+        toSessionTitle: plan.newTarget,
+    });
+    mark('T3', {ok: built.ok, bytes: built.bytes, reason: built.reason});
+    if (!built.ok) return done('failed', built.reason, {bytes: built.bytes});
+    built.payload.from_title = plan.oldTarget ?? currentTitle;
+    built.payload.created_at = now();
+    built.payload.health = {summary_retry: state?.retryGet?.(sessionId)?.attempts ?? 0, snapshot_consistent: true};
+    const text = renderHandoffMessage(built.payload, {volume: built.payload.cluster.vol_no, at: now()});
+    const messageBytes = new TextEncoder().encode(text).length;
+    if (messageBytes > MAX_BYTES) return done('failed', 'oversize', {bytes: messageBytes});
+    try { state?.preflight?.(); } catch (e) {
+        return done('failed', 'storage-unavailable', {error: String(e.message)});
+    }
+    const pending = (rec) => { try { state?.pendingAdd(rec); } catch (e) { mark('cleanup-degraded', {error: String(e.message), sessionId: rec.sessionId}); } };
+
+    // T4 新建会话（暂不定名：宿主 create 本身没有标题参数）
+    let newSessionId;
+    try {
+        const created = await host.createSession({cwd});
+        newSessionId = created.sessionId;
+    } catch (e) {
+        mark('T4', {error: String(e?.message ?? e)});
+        return done('failed', 'create-failed', {error: String(e?.message ?? e)}); // 四无：无注入/无改名/无索引/无只读
+    }
+    mark('T4', {newSessionId});
+
+    // T5 注入摘要（首条 user/message）。炸了绝不改名：弃未定名卷、旧卷一字未动，挂待清理
+    try {
+        state?.handoffSave?.(newSessionId, {...built.payload, from_title: plan.oldTarget ?? currentTitle});
+        await host.injectFirstMessage(newSessionId, text);
+    } catch (e) {
+        mark('T5', {error: String(e?.message ?? e)});
+        pending({
+            sessionId: newSessionId,
+            kind: 'abandoned-untitled',
+            reason: 'inject-failed',
+            at: now(),
+            error: String(e?.message ?? e)
+        });
+        return done('failed', 'inject-failed', {newSessionId, abandoned: newSessionId, error: String(e?.message ?? e)});
+    }
+    mark('T5', {bytes: text.length});
+
+    // T6 旧卷改名（仅当旧卷还是原始标题；已是 -k 的卷不动）
+    const renamedOld = [];
+    if (plan.oldTarget && plan.oldTarget !== currentTitle) {
+        try {
+            await host.renameSession(sessionId, plan.oldTarget);
+            renamedOld.push({sessionId, from: currentTitle, to: plan.oldTarget});
+        } catch (e) {
+            mark('T6', {error: String(e?.message ?? e)});
+            pending({
+                sessionId: newSessionId,
+                kind: 'abandoned-untitled',
+                reason: 'rename-old-failed',
+                at: now(),
+                error: String(e?.message ?? e)
+            });
+            return done('failed', 'rename-old-failed', {newSessionId, abandoned: newSessionId});
+        }
+        mark('T6', {to: plan.oldTarget, bumped: plan.bumped});
+    } else {
+        mark('T6', {skipped: true, reason: 'already-volume'});
+    }
+
+    // T7 新卷改名。炸了回滚旧卷改名（保原名），新卷仍未定名挂待清理
+    try {
+        await host.renameSession(newSessionId, plan.newTarget);
+        mark('T7', {to: plan.newTarget, bumped: plan.bumped});
+    } catch (e) {
+        mark('T7', {error: String(e?.message ?? e)});
+        const rolledBack = [];
+        let rollbackFailed = false;
+        for (const r of renamedOld) {
+            try {
+                await host.renameSession(r.sessionId, r.from);
+                rolledBack.push(r);
+            } catch (e2) {
+                rollbackFailed = true;
+                mark('T7:rollback-failed', {sessionId: r.sessionId, error: String(e2?.message ?? e2)});
+            }
+        }
+        pending({
+            sessionId: newSessionId,
+            kind: 'abandoned-untitled',
+            reason: 'rename-new-failed',
+            at: now(),
+            error: String(e?.message ?? e)
+        });
+        // rollbackFailed 决定告警文案：回滚失败时「已保留原名」不成立（B6 第二句的前提，已核定）
+        return done('failed', 'rename-new-failed', {newSessionId, abandoned: newSessionId, rolledBack, rollbackFailed});
+    }
+
+    // T8 提交：簇索引（七字段）+ turn_counts 同文件同原子提交，旧卷置只读标记
+    const oldRec = plan.independent ? index.get(sessionId) : index.record({
+        sessionId, clusterId, parentSessionId: index.get(sessionId)?.parent_session_id ?? null,
+        volNo: oldVolume,
+        nameSuffix: plan.oldTarget ? `-${plan.oldTarget.match(/-(\d+)$/)?.[1]}` : plan.oldK ? `-${plan.oldK}` : '',
+        rolloverState: 'sealed', readonlyByRollover: true,
+    });
+    const newRec = index.record({
+        sessionId: newSessionId, clusterId, parentSessionId: plan.independent ? null : sessionId,
+        volNo: plan.independent ? 1 : oldVolume + 1, nameSuffix: `-${plan.newK}`, rolloverState: 'active', readonlyByRollover: false,
+    });
+    index.setTurnCounts?.({...index.turnCounts?.(), [sessionId]: turnCount, [newSessionId]: 0});
+    const persisted = persistence?.persist?.() ?? null; // null = 显式降级（L3），不静默丢：调用方看 persistence.degraded
+    let ro = null, readonlyDegraded = false;
+    try { ro = (!plan.independent && state?.markReadonly(sessionId, {
+        clusterId,
+        volNo: oldRec.vol_no,
+        rolledAt: now(),
+        rolledInto: newSessionId
+    })) || null; } catch (e) { readonlyDegraded = true; mark('readonly-degraded', {error: String(e.message)}); }
+    try { state?.pendingRemove(newSessionId); } catch (e) { mark('cleanup-degraded', {error: String(e.message)}); }
+    mark('T8', {clusterId, persisted, readonly: !!ro, degraded: !!persistence?.degraded || readonlyDegraded});
+
+    return {
+        status: 'rolled-over', reason: manual ? 'manual' : 'threshold-reached', sessionId, newSessionId, trace, turnCount,
+        clusterId,
+        from: {sessionId, title: plan.oldTarget ?? currentTitle, record: oldRec},
+        to: {sessionId: newSessionId, title: plan.newTarget, record: newRec},
+        persisted, degraded: persistence?.degraded ?? false,
+        handoffBytes: built.bytes,
+    };
+}

package/src/assembly.mjs

@@ -0,0 +1,4 @@
+// 兼容旧装配入口；实现已按事务、消息排版、磁盘状态分别归类。
+export {performRollover} from './application/rollover.mjs';
+export {eventsToMessages, renderHandoffMessage} from './application/handoff-message.mjs';
+export {PENDING_FILE, READONLY_FILE, readonlyFileOf, createRolloverState} from './storage/rollover-state.mjs';

package/src/client/rollover-ui.js

@@ -0,0 +1,311 @@
+/** R3 只承担会话状态与交接卡；待办进度复用 R2，不另建任务状态。 */
+export function createRolloverUI(React) {
+    const {createElement: h, useState, useEffect, useRef} = React;
+    const API = '/api-dsh-session-rollover/session';
+    const entries = new Map();
+    let navigate = null;
+    let renderInline = false;
+    const clientWarnings = new Set();
+    function unavailable(feature, error) {
+        clientWarnings.add(feature);
+        console.warn('[dsh-session-rollover] client capability unavailable:', feature, error?.message ?? '');
+    }
+    function inject(ctx, names, setup) {
+        try {
+            ctx.inject(names, scope => {
+                try { return setup(scope); } catch (error) { unavailable(names.join(','), error); }
+            });
+        } catch (error) { unavailable(names.join(','), error); }
+    }
+
+    async function request(sessionId, action) {
+        const response = await fetch(action ? API : `${API}?session=${encodeURIComponent(sessionId)}`, action ? {
+            method: 'POST', credentials: 'same-origin', headers: {'content-type': 'application/json'},
+            body: JSON.stringify({sessionId, ...action}),
+        } : {credentials: 'same-origin', cache: 'no-store'});
+        const result = await response.json();
+        if (!response.ok) throw new Error(result.message ?? result.error ?? '会话状态读取失败');
+        return result;
+    }
+
+    function entry(id) {
+        if (!entries.has(id)) entries.set(id, {value: null, listeners: new Set(), stop: null});
+        return entries.get(id);
+    }
+
+    function publish(id, value) {
+        const item = entry(id);
+        item.value = value;
+        for (const listener of item.listeners) listener(value);
+    }
+
+    function useInfo(id) {
+        const [state, setState] = useState(() => entry(id).value);
+        useEffect(() => {
+            if (!id) return;
+            const item = entry(id);
+            let alive = true;
+            const receive = value => { if (alive) setState(value); };
+            item.listeners.add(receive);
+            receive(item.value);
+            if (!item.stop) {
+                let stopped = false, timer;
+                const poll = async () => {
+                    try {
+                        const value = await request(id);
+                        if (!stopped) publish(id, value);
+                    } catch (e) {
+                        if (!stopped) publish(id, {...item.value, sessionId: id, error: '暂时无法读取会话状态，请稍后重试。'});
+                    }
+                    if (!stopped) timer = setTimeout(poll, 1000);
+                };
+                item.stop = () => { stopped = true; clearTimeout(timer); };
+                void poll();
+            }
+            return () => {
+                alive = false;
+                item.listeners.delete(receive);
+                if (!item.listeners.size) { item.stop?.(); item.stop = null; entries.delete(id); }
+            };
+        }, [id]);
+        // 会话切换当帧不借用上一会话的只读状态。
+        return state?.sessionId === id ? state : null;
+    }
+
+    function Source({source}) {
+        return source ? h('button', {type: 'button', className: 'dsr-link',
+            disabled: !navigate, onClick: () => navigate?.(source.sessionId),
+            'aria-label': `跳转到上一卷 ${source.title}`}, `承自 ${source.title}`) : null;
+    }
+
+    function ReadonlyControl({info}) {
+        const [busy, setBusy] = useState(false);
+        const [error, setError] = useState('');
+        if (!info?.sealed) return null;
+        return h('div', {className: 'dsr-archive', role: 'status'},
+            h('span', null, info.readonly ? '此会话已归档，默认只读。历史可回看。' : '此会话已归档，已允许再次写入。'),
+            h('button', {type: 'button', role: 'switch', 'aria-checked': !info.readonly,
+                disabled: busy, onClick: async () => {
+                    setBusy(true); setError('');
+                    try { publish(info.sessionId, await request(info.sessionId, {action: 'readonly', readonly: !info.readonly})); }
+                    catch { setError('保存失败，请重试；写入权限未改变。'); }
+                    finally { setBusy(false); }
+                }}, busy ? '正在保存…' : info.readonly ? '允许再次写入' : '恢复只读'),
+            error ? h('span', {role: 'alert'}, error) : null);
+    }
+
+    function Header(props) {
+        const info = useInfo(props.sessionId);
+        const [busy, setBusy] = useState(false);
+        const [error, setError] = useState('');
+        const dialog = useRef(null);
+        const [showHelp, setShowHelp] = useState(false);
+        const action = async type => {
+            setBusy(true); setError('');
+            try {
+                const result = await request(props.sessionId, {action: type});
+                if (result.newSessionId ?? result.sessionId) navigate?.(result.newSessionId ?? result.sessionId);
+                dialog.current?.close();
+            } catch { setError('操作未完成，请稍后重试或检查会话状态。'); }
+            finally { setBusy(false); }
+        };
+        if (!info) return null;
+        return h('div', {className: 'dsr-header'},
+            h('span', {className: 'dsr-chip'}, `本卷第 ${info.turnCount} 轮 / 阈值 ${info.threshold}`),
+            info.volume ? h('span', {className: 'dsr-chip'}, `卷 ${info.volume}/${info.cap}`) : null,
+            info.sealed ? h('span', {className: 'dsr-chip'}, info.readonly ? '归档只读' : '归档 · 已恢复写入') : null,
+            info.source ? h('span', {className: 'dsr-source'}, h(Source, {source: info.source}),
+                info.previousTurnCount != null ? ` · 第 ${info.previousTurnCount} 轮` : '') : null,
+            h('button', {type: 'button', 'aria-label': '会话分卷操作', onClick: () => { setShowHelp(false); dialog.current?.showModal(); }}, '⋯'),
+            h('dialog', {ref: dialog, className: 'dsr-actions', 'aria-label': '会话操作'},
+                showHelp ? h('section', {className: 'dsr-help', 'aria-label': '会话分卷使用说明'},
+                    h('h3', null, '会话分卷与续接 · 使用说明'),
+                    h('p', null, '长会话达到阈值后，在本轮执行结束且没有未完成工具调用或压缩时创建下一卷。默认每 10 条真实用户消息分卷，同一系列最多 9 卷。系统上下文和交接消息不计数。'),
+                    h('h4', null, '从哪里开始'),
+                    h('p', null, '标题栏查看本卷轮数、阈值和卷序。菜单中的“现在换会话”可提前交接；“新建独立会话”会携带快照另开一个系列。操作需等待当前执行结束。'),
+                    h('h4', null, '交接卡与任务进度'),
+                    h('p', null, '新卷首条接续摘要保留切卷时的待办、当前步骤、约束、文件线索及后台任务状态。可展开摘要、查看或复制完整 JSON，并点击来源回看上一卷。右侧实时任务进度由可选的 dsh-todo-progress 插件提供，历史快照不会随任务进度变化。'),
+                    h('h4', null, '回看与恢复写入'),
+                    h('p', null, '旧卷默认归档只读，可在输入区域上方切换“允许再次写入 / 恢复只读”。开关会保存；恢复写入不会让旧卷再次自动分卷。达到 9 卷后请新建独立会话。'),
+                    h('h4', null, '配置与数据'),
+                    h('p', null, '在宿主插件配置中调整 mode（auto / manual / off）、threshold 和 dataDir。manual 达阈值只提示，off 关闭自动判定；显式手动操作仍可使用。数据默认存于 DSH_HOME/plugin-data/dsh-session-rollover，卸载不会清除。'),
+                    h('h4', null, '能力边界'),
+                    h('p', null, '摘要为确定性摘录，不额外调用模型；继续对话使用 DSH 已配置的模型，无需额外 API Key。后台任务仅记录句柄和状态，不迁移或重启进程。摘要或存储异常会提示，复杂内容超预算时可能无法交接。'),
+                    h('p', {className: 'dsr-help-credit'}, 'dsh-session-rollover · Oak-liuhj')) : null,
+                h('div', {className: 'dsr-actions-body'},
+                    h('button', {type: 'button', 'aria-expanded': showHelp, onClick: () => setShowHelp(!showHelp)}, showHelp ? '收起使用说明' : '使用说明'),
+                    h('button', {type: 'button', disabled: busy || info.sealed || !navigate || info.compatibility?.compatible === false, onClick: () => action('rollover')}, '现在换会话'),
+                    h('button', {type: 'button', disabled: busy || !navigate || info.compatibility?.compatible === false, onClick: () => action('new')}, '新建独立会话'),
+                    h('button', {type: 'button', onClick: () => dialog.current?.close()}, '关闭'))),
+            error ? h('span', {role: 'alert'}, error) : null);
+    }
+
+    function Badges(props) {
+        const info = useInfo(props.sessionId);
+        if (!info?.volume) return null;
+        return h('span', {className: `dsr-row-badges${props.compact ? ' dsr-row-compact' : ''}`, title: `卷 ${info.volume}/${info.cap}${info.readonly ? ' · 归档只读' : ''}`},
+            info.readonly ? h('span', null, '只读') : null, h('span', null, `${info.volume}/${info.cap}`));
+    }
+
+    function Card({payload, source}) {
+        const [expanded, setExpanded] = useState(false);
+        const [jsonOpen, setJsonOpen] = useState(false);
+        const [message, setMessage] = useState('');
+        if (!payload) return null;
+        const todos = Array.isArray(payload.todos) ? payload.todos : [];
+        const summary = payload.summary ?? {};
+        const active = payload.current_step?.active_items ?? [];
+        const text = Object.entries(summary).map(([k, v]) => `${k}\n${v}`).join('\n');
+        const chunks = [
+            ['上轮工作摘要', summary['上轮工作摘要'] ?? summary['任务目标'] ?? '本轮未提供'],
+            ['当前工作', active.length ? active.map(n => `第 ${n} 步进行中：${todos[n - 1]?.content ?? ''}`).join('\n') : '尚未开始'],
+            ['关键约束（原文）', (payload.constraints ?? []).join('\n') || '本轮未提供'],
+            ['文件与代码', (payload.changed_files ?? []).map(f => `${f.path}${f.deleted ? '（已删除）' : ''}`).join('\n') || '本轮未提供'],
+            ['未竟后台任务', (payload.open_jobs ?? []).map(j => `${j.id} · ${j.command ?? ''} · ${j.status}${j.recoverable === false ? '（需重跑）' : ''}`).join('\n') || '无后台任务'],
+            ['待办快照', todos.length ? todos.map((t, i) => `${i + 1}. ${t.content} · ${{completed: '已完成', in_progress: '进行中', pending: '待办', failed: '中断'}[t.status] ?? t.status}`).join('\n') : '无结构化待办'],
+        ];
+        return h('section', {className: 'dsr-card', 'aria-label': '接续摘要'},
+            h('div', {className: 'dsr-card-head'}, h('strong', null, '接续摘要'), h(Source, {source}),
+                payload.cluster?.vol_no ? h('span', {className: 'dsr-chip'}, `卷 ${payload.cluster.vol_no}/9`) : null,
+                payload.health ? h('span', {className: 'dsr-chip'}, `摘要重试 ${payload.health.summary_retry}/2`) : null),
+            h('div', {className: expanded ? 'dsr-card-content' : 'dsr-card-preview'},
+                expanded ? chunks.map(([name, value]) => h('div', {className: 'dsr-section', key: name},
+                    h('h4', null, name), h('div', {className: 'dsr-prewrap'}, value))) : text),
+            h('button', {type: 'button', className: 'dsr-link dsr-expand', 'aria-expanded': expanded,
+                onClick: () => setExpanded(!expanded)}, expanded ? '收起摘要' : '展开全部'),
+            h('div', {className: 'dsr-json-controls'},
+                h('button', {type: 'button', 'aria-expanded': jsonOpen, onClick: () => setJsonOpen(!jsonOpen)}, jsonOpen ? '收起快照 JSON' : '展开快照 JSON'),
+                h('button', {type: 'button', onClick: async () => {
+                    try { await navigator.clipboard.writeText(JSON.stringify(payload, null, 2)); setMessage('快照已复制'); }
+                    catch { setJsonOpen(true); setMessage('复制失败，可选择下方 JSON 手动复制。'); }
+                }}, '复制快照')),
+            jsonOpen ? h('pre', {className: 'dsr-json', tabIndex: 0, 'aria-label': '完整交接快照 JSON'}, JSON.stringify(payload, null, 2)) : null,
+            message ? h('div', {role: 'status'}, message) : null);
+    }
+
+    function Dock(props) {
+        const info = useInfo(props.sessionId);
+        const previous = useRef(null);
+        useEffect(() => {
+            const next = info?.completedSessionId;
+            // 只自动跳转浏览器亲历的“活动→封卷”；回看历史旧卷时不能被再次弹回新卷。
+            if (next && previous.current?.sessionId === props.sessionId && previous.current.sealed === false && info.sealed && navigate) navigate(next);
+            if (info) previous.current = info;
+        }, [info, props.sessionId]);
+        if (!info) return null;
+        return h('div', {className: 'dsr-dock'},
+            info.error ? h('div', {role: 'alert'}, info.error) : null,
+            info.compatibility?.compatible === false ? h('div', {role: 'alert', className: 'dsr-warning'}, info.compatibility.message) : null,
+            clientWarnings.size ? h('div', {role: 'alert', className: 'dsr-warning'}, '部分会话界面功能与当前 DSH 不兼容，请更新插件。') : null,
+            h(ReadonlyControl, {key: props.sessionId, info}),
+            info.capped ? h('div', {role: 'status', className: 'dsr-warning'}, '同簇已达 9 卷上限（9/9），请通过会话操作新建独立会话。') : null,
+            info.retryLimitReached ? h('div', {role: 'status', className: 'dsr-warning'}, '摘要生成失败，已停止自动重试。可在修正内容后手动换会话。') : null,
+            info.degraded ? h('div', {role: 'alert'}, '分卷索引保存失败，重启前请检查数据目录权限。') : null,
+            !renderInline && info.handoff ? h(Card, {key: props.sessionId, payload: info.handoff, source: info.source}) : null);
+    }
+
+    function parseHandoff(text) {
+        if (!text.startsWith('【分卷交接】')) return null;
+        try {
+            const payload = JSON.parse(/```json\s*([\s\S]*?)```/.exec(text)?.[1]);
+            return payload.rollover === 'v1' ? payload : null;
+        } catch { return null; }
+    }
+
+    /** 释放时仅撤销自己的禁用；保留模型选择等其他插件后来设置的阻塞原因。 */
+    function blockComposer(blocks, id, reason) {
+        if (typeof blocks?.storeFor !== 'function' || typeof blocks?.set !== 'function') throw new Error('composer blocks unavailable');
+        const store = blocks.storeFor(id);
+        if (typeof store?.getSnapshot !== 'function' || typeof store?.subscribe !== 'function') throw new Error('composer store unavailable');
+        let previous = store.getSnapshot();
+        const own = {reason};
+        let writing = false;
+        const enforce = () => {
+            if (writing || store.getSnapshot() === own) return;
+            previous = store.getSnapshot();
+            writing = true;
+            try { blocks.set(id, own); } finally { writing = false; }
+        };
+        const off = store.subscribe(enforce);
+        enforce();
+        return () => { off(); if (store.getSnapshot() === own) blocks.set(id, previous); };
+    }
+
+    function apply(ctx) {
+        if (!ctx?.inject) return;
+        const style = document.createElement('style');
+        style.textContent = CSS;
+        style.setAttribute('data-dsh-plugin', 'dsh-session-rollover-ui');
+        document.head.appendChild(style);
+        ctx.effect?.(() => () => { style.remove(); for (const item of entries.values()) item.stop?.(); entries.clear(); });
+        inject(ctx, ['uiWorkspace'], scope => {
+            if (typeof scope.uiWorkspace?.openSession !== 'function') throw new Error('session navigation unavailable');
+            navigate = id => scope.uiWorkspace.openSession(id);
+            scope.effect?.(() => () => { navigate = null; });
+        });
+        inject(ctx, ['slots'], scope => {
+            const slots = scope.slots;
+            if (typeof slots?.inject !== 'function' || typeof slots?.register !== 'function') throw new Error('slots unavailable');
+            const mount = (name, Component, options = {}, owner = scope) => owner.effect(() => owner.slots.inject(name, () => owner.slots.register({name,
+                id: 'dsh-session-rollover', order: 35, ...options}, Component)));
+            mount('conversation.session.header.actions', Header);
+            mount('conversation.input.dock', Dock);
+            mount('sidebar.session.row.trailing', Badges);
+            // 已安装的较旧宿主只开放 leading；新宿主优先 trailing，避免重复徽标。
+            mount('sidebar.session.row.leading', props => slots.snapshot?.('sidebar.session.row.trailing')?.length
+                ? null : h(Badges, {...props, compact: true}));
+            // 使用宿主公开 composer block 服务；覆盖输入组件会破坏其子槽授权。
+            inject(scope, ['conversation'], inputScope => {
+                if (typeof inputScope.conversation?.blocks?.storeFor !== 'function' || typeof inputScope.conversation?.blocks?.set !== 'function') {
+                    throw new Error('composer blocks unavailable');
+                }
+                function ComposerGuard(props) {
+                    const info = useInfo(props.sessionId);
+                    const reason = !info ? '正在读取会话状态…' : info.readonly
+                        ? '归档会话：不可输入，可通过上方开关恢复写入。' : info.error;
+                    useEffect(() => {
+                        if (props.sessionId && reason) {
+                            try { return blockComposer(inputScope.conversation.blocks, props.sessionId, reason); }
+                            catch (error) { unavailable('conversation.blocks', error); }
+                        }
+                    },
+                    [props.sessionId, reason]);
+                    return null;
+                }
+                inputScope.effect(() => slots.inject('conversation.input.dock', () => slots.register({
+                    name: 'conversation.input.dock', id: 'dsr-readonly-guard', order: 34}, ComposerGuard)));
+            });
+            inject(scope, ['uiConversation'], textScope => {
+                if (!textScope.uiConversation.userText?.register) return;
+                textScope.effect(() => textScope.uiConversation.userText.register({id: 'dsr-handoff', order: -100,
+                    match(text, from) {
+                        if (from !== 0) return;
+                        const payload = parseHandoff(text);
+                        return payload ? {id: 'dsr-handoff', start: 0, end: text.length, data: payload} : undefined;
+                    }}));
+                // 插槽必须随 uiConversation 的注入子作用域释放，不能挂在较长寿命的 slots 父作用域。
+                // 新宿主重连/热替换领域服务时会重建该子作用域；挂在父级会重复占用同一个 keyed slot。
+                mount('conversation.user.text.node', props => h(Card, {payload: props.node.data,
+                    source: props.node.data.from_session_id && !props.node.data.cluster?.independent ? {sessionId: props.node.data.from_session_id, title: props.node.data.from_title ?? '上一卷'} : null}), {key: 'dsr-handoff'}, textScope);
+                renderInline = true;
+                textScope.effect?.(() => () => { renderInline = false; });
+            });
+        });
+    }
+
+    const CSS = `
+.dsr-header,.dsr-dock,.dsr-card,.dsr-row-badges{--dsr-bg:var(--dsw-alias-bg-base, #fff);--dsr-fg:var(--dsw-alias-label-primary, #111827);--dsr-muted:#61666b;--dsr-line:rgba(0,0,0,.12);--dsr-accent:#3d56d6;--dsr-weak:rgba(77,107,254,.09);color:var(--dsr-fg);font:13px/20px -apple-system,BlinkMacSystemFont,'Segoe UI','Microsoft YaHei',sans-serif;box-sizing:border-box}
+body[data-ds-dark-theme] :is(.dsr-header,.dsr-dock,.dsr-card,.dsr-row-badges),html[data-theme=dark] :is(.dsr-header,.dsr-dock,.dsr-card,.dsr-row-badges),html.dark :is(.dsr-header,.dsr-dock,.dsr-card,.dsr-row-badges){--dsr-bg:#171a1f;--dsr-fg:#f9fafb;--dsr-muted:#cfd3d6;--dsr-line:rgba(255,255,255,.16);--dsr-accent:#95a8ff;--dsr-weak:rgba(107,133,255,.13)}
+@media(prefers-color-scheme:dark){html:not([data-theme=light]):not([data-ds-theme-source=light]) :is(.dsr-header,.dsr-dock,.dsr-card,.dsr-row-badges){--dsr-bg:#171a1f;--dsr-fg:#f9fafb;--dsr-muted:#cfd3d6;--dsr-line:rgba(255,255,255,.16);--dsr-accent:#95a8ff}}
+.dsr-header{display:flex;gap:6px;align-items:center;flex-wrap:wrap;min-width:0}.dsr-chip{display:inline-flex;align-items:center;border:1px solid var(--dsr-line);border-radius:99px;padding:1px 7px;font-size:11.5px;white-space:nowrap;color:var(--dsr-muted)}
+.dsr-source{font-size:12px;color:var(--dsr-muted)}.dsr-link{color:var(--dsr-accent)!important;background:none!important}.dsr-header button,.dsr-dock button,.dsr-card button,.dsr-actions summary{font:inherit;cursor:pointer;min-height:28px;min-width:28px;border:1px solid var(--dsr-line);background:var(--dsr-bg);color:inherit;border-radius:6px;padding:3px 8px}.dsr-link{border:0!important}.dsr-header button:disabled,.dsr-dock button:disabled{opacity:.6;cursor:default}
+.dsr-dock{width:100%;min-width:0;display:flex;flex-direction:column;gap:8px}.dsr-archive{display:flex;align-items:center;gap:8px;flex-wrap:wrap;padding:8px 10px;border:1px solid var(--dsr-line);border-radius:8px;background:var(--dsr-weak)}.dsr-archive button{margin-left:auto}.dsr-warning{padding:8px 10px;border:1px solid var(--dsr-line);border-radius:8px}
+.dsr-card{display:block;flex:0 0 auto;min-width:0;max-width:100%;border:1px solid var(--dsr-line);border-radius:10px;background:var(--dsr-bg);overflow-wrap:anywhere;white-space:normal;margin:8px 0}.dsr-card-head{display:flex;align-items:center;flex-wrap:wrap;gap:6px;background:var(--dsr-weak);border-radius:10px 10px 0 0;padding:10px 12px}.dsr-card-preview{display:-webkit-box;-webkit-line-clamp:3;-webkit-box-orient:vertical;overflow:hidden;margin:10px 12px;white-space:pre-wrap}.dsr-card-content{display:block}.dsr-section{padding:8px 12px;border-top:1px solid var(--dsr-line)}.dsr-section h4{font-size:12px;line-height:20px;color:var(--dsr-muted);margin:0 0 4px;font-weight:500}.dsr-prewrap{white-space:pre-wrap}.dsr-expand{margin:0 4px 6px}.dsr-json-controls{display:flex;gap:8px;flex-wrap:wrap;padding:8px 12px;border-top:1px solid var(--dsr-line)}.dsr-json{font:12px/18px Consolas,monospace;max-height:240px;overflow:auto;background:var(--dsr-weak);padding:10px;margin:0 12px 12px;white-space:pre-wrap;overflow-wrap:anywhere}.dsr-row-badges{display:inline-flex;gap:3px;font-size:10px;white-space:nowrap}.dsr-row-badges span{background:var(--dsr-weak);padding:0 4px;border-radius:4px}
+.dsr-actions{border:1px solid var(--dsr-line);border-radius:10px;background:var(--dsr-bg);color:var(--dsr-fg);max-width:calc(100vw - 32px)}.dsr-actions::backdrop{background:rgba(0,0,0,.25)}.dsr-actions-body{display:flex;gap:6px;flex-wrap:wrap;padding:6px 0}.dsr-header :focus-visible,.dsr-dock :focus-visible,.dsr-card :focus-visible{outline:2px solid var(--dsr-accent);outline-offset:2px}.dsr-card [role=status]{padding:4px 12px;color:var(--dsr-muted)}
+.dsr-row-compact{flex-direction:column;align-items:center;justify-content:center;gap:0;width:20px;max-width:20px;font-size:9px;line-height:11px}.dsr-row-compact span{padding:0 1px}
+.dsr-actions:has(.dsr-help){width:560px;max-height:calc(100dvh - 48px);overflow:auto}.dsr-help{max-width:100%;line-height:1.7;overflow-wrap:anywhere}.dsr-help h3{margin:4px 0 12px;font-size:17px}.dsr-help h4{margin:14px 0 4px;font-size:13px}.dsr-help p{margin:4px 0 10px}.dsr-help-credit{font-size:11px;color:var(--dsr-muted)}
+@media(max-width:600px){.dsr-header{gap:3px;flex-wrap:nowrap;max-width:calc(100vw - 156px)}.dsr-header>.dsr-chip,.dsr-header>.dsr-source{display:none}.dsr-header>.dsr-chip:first-child{display:inline-flex;font-size:10px;padding:1px 3px}}
+@media(prefers-reduced-motion:reduce){.dsr-card *{animation:none!important;transition:none!important}}
+`;
+    return {apply, Header, Dock, Card, Badges, useInfo, parseHandoff, publish, blockComposer, clientWarnings, CSS};
+}