@deepseek-harness-tui/dsh-tui 0.13.0 → 0.14.1

package/lib/types/components/sidePanel/btw/threads.js

@@ -0,0 +1,302 @@
+/**
+ * btw 线程 store：sideQuery 的问答线程只是 UI 状态——按 session id 隔离、
+ * 只在内存里、进程重启即清空，不写会话记录（DSH SessionEvent / Claude
+ * JSONL 都不碰）。每次追问带上最近 N 组完成的问答（有字符预算，按整轮从
+ * 最旧裁剪）；新话题清空线程并中止在途的一轮。
+ *
+ * sideQuery 仍是一次无工具的单答调用：submit 只经调用方传入的 ask
+ * （= channel.sideQuestion）调用一次，上下文由 sideThreadQuestion 拼进
+ * question。本模块不 import 后端，也没有任何写主会话的入口。
+ *
+ * 并发：每个线程最多一轮在途（忙则拒绝，不隐式取消）；全局最多 2 轮
+ * （切换 session 后旧线程仍可流完）。每次写回前核对线程 generation 与
+ * 这一轮的 phase，新话题或中止之后迟到的 onText/result 都丢弃。
+ */
+import { sideThreadQuestion } from '../../../channel/side-prompts.js';
+import { t } from '../../../i18n.js';
+/** 最近 N 组问答：默认 4，可配范围 1–8（normalize 钳制）。 */
+export const BTW_RECENT_TURNS_DEFAULT = 4;
+export const BTW_RECENT_TURNS_MIN = 1;
+export const BTW_RECENT_TURNS_MAX = 8;
+/** 线程上下文总字符预算（问题+裁剪后答案）。 */
+export const BTW_CONTEXT_CHAR_BUDGET = 24_000;
+/** 单条答案进入上下文时的裁剪上限。 */
+export const BTW_ANSWER_CHAR_BUDGET = 8_000;
+/** 跨线程并发上限：超过显示忙，不隐式取消。 */
+export const BTW_MAX_CONCURRENT_ASKS = 2;
+/** 钳到 1–8；非有限值取默认 4。 */
+export function normalizeRecentTurnsLimit(value) {
+    if (value === undefined || !Number.isFinite(value))
+        return BTW_RECENT_TURNS_DEFAULT;
+    return Math.min(BTW_RECENT_TURNS_MAX, Math.max(BTW_RECENT_TURNS_MIN, Math.round(value)));
+}
+/** 按字符预算从尾部裁（不撕裂代理对；与 sideQuestion.ts 的 clip 同语义）。 */
+function clip(text, limit) {
+    if (text.length <= limit)
+        return text;
+    const code = text.charCodeAt(limit - 1);
+    const end = code >= 0xd800 && code <= 0xdbff ? limit - 1 : limit;
+    return `${text.slice(0, end)}…`;
+}
+/**
+ * 选出下一次 ask 携带的上下文：先取最近 N 组**完成**轮，再按字符预算
+ * （单答案 8k 裁剪后计入、总计 24k）从最旧开始整轮丢弃；被丢的轮数
+ * （窗口外 + 超预算）汇成 omittedOlderCount。纯函数。
+ */
+export function selectContextTurns(turns, limit = BTW_RECENT_TURNS_DEFAULT, budgets = {}) {
+    const window = normalizeRecentTurnsLimit(limit);
+    const total = budgets.total ?? BTW_CONTEXT_CHAR_BUDGET;
+    // 单答预算内部派生（设置裁定：用户心智一个总量键就够）：默认 8k，
+    // 但永远不超过总量的一半——一个收紧的总量不该被单答上限架空。
+    const perAnswer = budgets.perAnswer ?? Math.min(BTW_ANSWER_CHAR_BUDGET, Math.floor(total / 2));
+    const completed = turns.filter(turn => turn.phase === 'completed');
+    if (completed.length === 0)
+        return { included: [], omittedOlderCount: 0 };
+    const recent = completed.slice(-window);
+    const accepted = [];
+    let used = 0;
+    for (let index = recent.length - 1; index >= 0; index -= 1) {
+        const turn = recent[index];
+        const clippedAnswer = clip(turn.answer, perAnswer);
+        const size = turn.question.length + clippedAnswer.length;
+        if (accepted.length > 0 && used + size > total)
+            break;
+        accepted.unshift({ ...turn, answer: clippedAnswer });
+        used += size;
+    }
+    return { included: accepted, omittedOlderCount: completed.length - accepted.length };
+}
+/** DSH 空答案的字面错误映射成本地化文案（Claude 侧已有 i18n 键）。 */
+function presentableError(error) {
+    return error === 'No response received' ? t('btw-output-unavailable') : error;
+}
+function buildSnapshot(record) {
+    const active = record.turns.find(turn => turn.phase === 'queued' || turn.phase === 'running') ?? null;
+    let unreadCount = 0;
+    let unreadError = false;
+    for (const turn of record.turns) {
+        if (turn.seq <= record.seenThroughSeq)
+            continue;
+        if (turn.phase === 'completed')
+            unreadCount += 1;
+        else if (turn.phase === 'failed') {
+            unreadCount += 1;
+            unreadError = true;
+        }
+    }
+    return Object.freeze({
+        sessionId: record.sessionId,
+        threadId: record.threadId,
+        createdAt: record.createdAt,
+        generation: record.generation,
+        turns: Object.freeze([...record.turns]),
+        activeTurnId: active === null ? null : active.turnId,
+        draft: record.draft,
+        unread: Object.freeze({ count: unreadCount, error: unreadError }),
+        version: record.version,
+    });
+}
+class BtwThreadStore {
+    threads = new Map();
+    controllers = new Map();
+    listeners = new Set();
+    turnSeq = 0;
+    threadSeq = 0;
+    subscribe = (listener) => {
+        this.listeners.add(listener);
+        return () => { this.listeners.delete(listener); };
+    };
+    /** 当前 session 的线程快照（缺失 = 无线程；快照在两次更新间恒等）。 */
+    get(sessionId) {
+        return this.threads.get(sessionId)?.snapshot;
+    }
+    /**
+     * 发起一轮追问：拼好线程上下文作为 question 整段交给 ask（一次
+     * sideQuery 调用），流式增量与落定都经代际/相位守卫写回。同线程
+     * 在途时 busy 拒绝；全局并发超上限 congested 拒绝（都不隐式取消）。
+     */
+    submit(sessionId, question, ask, opts) {
+        const trimmed = question.trim();
+        if (trimmed === '')
+            return { ok: false, reason: 'empty' };
+        const record = this.recordOf(sessionId);
+        if (record.turns.some(turn => turn.phase === 'queued' || turn.phase === 'running')) {
+            return { ok: false, reason: 'busy' };
+        }
+        let runningElsewhere = 0;
+        for (const other of this.threads.values()) {
+            if (other === record)
+                continue;
+            if (other.turns.some(turn => turn.phase === 'queued' || turn.phase === 'running'))
+                runningElsewhere += 1;
+        }
+        if (runningElsewhere >= BTW_MAX_CONCURRENT_ASKS)
+            return { ok: false, reason: 'congested' };
+        const selection = selectContextTurns(record.turns, opts?.recentTurnsLimit, {
+            ...(opts?.contextBudget === undefined ? {} : { total: opts.contextBudget }),
+        });
+        const seq = ++this.turnSeq;
+        const turn = {
+            turnId: `btw-${seq}`,
+            seq,
+            question: trimmed,
+            answer: '',
+            phase: 'running',
+            startedAt: Date.now(),
+            includedContextTurnIds: selection.included.map(prior => prior.turnId),
+            omittedOlderCount: selection.omittedOlderCount,
+        };
+        record.turns.push(turn);
+        this.bump(record);
+        const controller = new AbortController();
+        this.controllers.set(turn.turnId, controller);
+        const generation = record.generation;
+        const prompt = sideThreadQuestion(trimmed, selection.included.map((prior) => ({ question: prior.question, answer: prior.answer })), selection.omittedOlderCount);
+        const settle = (write) => {
+            const current = this.threads.get(sessionId);
+            if (current === undefined || current.generation !== generation)
+                return;
+            const index = current.turns.findIndex(candidate => candidate.turnId === turn.turnId);
+            if (index < 0)
+                return;
+            const existing = current.turns[index];
+            if (existing.phase !== 'running')
+                return;
+            current.turns[index] = write({ ...existing, finishedAt: Date.now() });
+            this.bump(current);
+        };
+        ask(prompt, {
+            signal: controller.signal,
+            onText: delta => {
+                const current = this.threads.get(sessionId);
+                if (current === undefined || current.generation !== generation || controller.signal.aborted)
+                    return;
+                const index = current.turns.findIndex(candidate => candidate.turnId === turn.turnId);
+                if (index < 0)
+                    return;
+                const existing = current.turns[index];
+                if (existing.phase !== 'running')
+                    return;
+                current.turns[index] = { ...existing, answer: existing.answer + delta };
+                this.bump(current);
+            },
+        }).then(result => {
+            this.controllers.delete(turn.turnId);
+            settle(existing => {
+                if (controller.signal.aborted)
+                    return { ...existing, phase: 'cancelled' };
+                if (result.answer !== null)
+                    return { ...existing, answer: result.answer, phase: 'completed' };
+                if (result.error !== undefined)
+                    return { ...existing, error: presentableError(result.error), phase: 'failed' };
+                return { ...existing, phase: 'cancelled' };
+            });
+        }, error => {
+            this.controllers.delete(turn.turnId);
+            settle(existing => ({
+                ...existing,
+                error: presentableError(error instanceof Error ? error.message : String(error)),
+                phase: 'failed',
+            }));
+        });
+        return { ok: true, turnId: turn.turnId };
+    }
+    /** 中止在途追问（相位立即转 cancelled；迟到的流/结果被守卫丢弃）。 */
+    abortActive(sessionId) {
+        const record = this.threads.get(sessionId);
+        if (record === undefined)
+            return false;
+        const active = record.turns.find(turn => turn.phase === 'queued' || turn.phase === 'running');
+        if (active === undefined)
+            return false;
+        const index = record.turns.indexOf(active);
+        record.turns[index] = { ...active, phase: 'cancelled', finishedAt: Date.now() };
+        this.bump(record);
+        this.controllers.get(active.turnId)?.abort();
+        this.controllers.delete(active.turnId);
+        return true;
+    }
+    /**
+     * 新话题：abort 在途、清 turns/draft/unread、换 thread id、generation+1。
+     * 不影响其它 session 的线程，也不触发任何持久化。
+     */
+    newTopic(sessionId) {
+        const record = this.threads.get(sessionId);
+        if (record === undefined)
+            return false;
+        this.abortActive(sessionId);
+        record.threadId = `btw-thread-${++this.threadSeq}-${Date.now().toString(36)}`;
+        record.createdAt = Date.now();
+        record.generation += 1;
+        record.turns = [];
+        record.draft = '';
+        record.seenThroughSeq = this.turnSeq;
+        this.bump(record);
+        return true;
+    }
+    setDraft(sessionId, text) {
+        const record = this.recordOf(sessionId);
+        if (record.draft === text)
+            return;
+        record.draft = text;
+        this.bump(record);
+    }
+    /** 看到最新线程：把已落定轮全部记为已读（running 轮落定时再见分晓）。 */
+    markSeen(sessionId) {
+        const record = this.threads.get(sessionId);
+        if (record === undefined)
+            return;
+        const newestSettled = record.turns.reduce((max, turn) => turn.phase === 'completed' || turn.phase === 'failed' ? Math.max(max, turn.seq) : max, record.seenThroughSeq);
+        if (newestSettled === record.seenThroughSeq)
+            return;
+        record.seenThroughSeq = newestSettled;
+        this.bump(record);
+    }
+    /** 测试/多夹具隔离用：清空全部线程状态。 */
+    resetForTest() {
+        for (const record of this.threads.values())
+            this.abortActive(record.sessionId);
+        this.threads.clear();
+        this.emit();
+    }
+    recordOf(sessionId) {
+        let record = this.threads.get(sessionId);
+        if (record === undefined) {
+            record = {
+                sessionId,
+                threadId: `btw-thread-${++this.threadSeq}-${Date.now().toString(36)}`,
+                createdAt: Date.now(),
+                generation: 0,
+                turns: [],
+                draft: '',
+                seenThroughSeq: this.turnSeq,
+                version: 0,
+                snapshot: Object.freeze({
+                    sessionId,
+                    threadId: '',
+                    createdAt: 0,
+                    generation: 0,
+                    turns: Object.freeze([]),
+                    activeTurnId: null,
+                    draft: '',
+                    unread: Object.freeze({ count: 0, error: false }),
+                    version: 0,
+                }),
+            };
+            record.snapshot = buildSnapshot(record);
+            this.threads.set(sessionId, record);
+        }
+        return record;
+    }
+    bump(record) {
+        record.version += 1;
+        record.snapshot = buildSnapshot(record);
+        this.emit();
+    }
+    emit() {
+        for (const listener of [...this.listeners])
+            listener();
+    }
+}
+/** 进程级单例（与 jobsFocusStore 同款挂法）。 */
+export const btwThreads = new BtwThreadStore();

package/lib/types/components/sidePanel/builtinPanels.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builtinPanels.d.ts","sourceRoot":"","sources":["../../../../src/components/sidePanel/builtinPanels.tsx"],"names":[],"mappings":"AAsLA,2BAA2B;AAC3B,wBAAgB,qBAAqB,IAAI,IAAI,CAwF5C"}
+{"version":3,"file":"builtinPanels.d.ts","sourceRoot":"","sources":["../../../../src/components/sidePanel/builtinPanels.tsx"],"names":[],"mappings":"AA6NA,2BAA2B;AAC3B,wBAAgB,qBAAqB,IAAI,IAAI,CAmG5C"}

package/lib/types/components/sidePanel/builtinPanels.js

@@ -1,11 +1,5 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-/**
- * 内置 Panel 注册（设计文档 §16.3：内置与插件从第一天走同一个
- * PanelStore.register；source 只是标记）。模块首次导入时注册——
- * SidePanelColumn 引用本模块，所以任何挂到侧栏的树（含回归夹具）
- * 都会自动带上内置 Panel；插件 Panel 在 Phase 6 经准入外壳进同一个
- * store。
- */
+/** Register built-in panels in the shared panel store. */
 import React from 'react';
 import { t } from '../../i18n.js';
 import { GoalTodoPanel } from '../GoalTodoPanel.js';
@@ -16,10 +10,13 @@ import { CompanionPanel } from './companion/CompanionPanel.js';
 import { InfoPanel } from './InfoPanel.js';
 import { TrajectoryPanel } from './TrajectoryPanel.js';
 import { WorkspacePanel } from './WorkspacePanel.js';
+import { BtwPanelAdapter } from './btw/BtwPanelAdapter.js';
 import { panelStore } from './PanelStore.js';
 import { useSidePanelChannel } from './SidePanelRuntimeContext.js';
 import { usePanelInput } from './usePanelInput.js';
 import { jobsFocusStore } from './jobsFocusStore.js';
+import { agentViewStore } from './agentViewStore.js';
+import { agentComposeTargetOf } from '../messages/agentTeam.js';
 /** todo：GoalTodoPanel 的 panel variant（同一份 store，不重写业务）。 */
 function TodoPanelAdapter({ width, height, focused, visible }) {
     const channel = useSidePanelChannel();
@@ -54,6 +51,13 @@ function JobsPanelAdapter({ focused, visible }) {
     const jobs = channel.backgroundJobs;
     const version = channel.version;
     const focusRequest = React.useSyncExternalStore(jobsFocusStore.subscribe, jobsFocusStore.get);
+    // A backend whose job output is read on demand keeps the focused job's
+    // tail fresh while this panel shows it (the same seam the full-screen
+    // panel and the transcript cards use); one identity per capability.
+    const jobControlRef = React.useRef(channel.jobControl);
+    jobControlRef.current = channel.jobControl;
+    const outputWatchable = typeof channel.jobControl?.watchOutput === 'function';
+    const watchOutput = React.useMemo(() => outputWatchable ? (id) => jobControlRef.current?.watchOutput?.(id) ?? (() => undefined) : undefined, [outputWatchable]);
     // 已读基线：上次 visible=true 时见过的 failed id 集合。
     const seenFailedRef = React.useRef(new Set());
     React.useEffect(() => {
@@ -71,42 +75,67 @@ function JobsPanelAdapter({ focused, visible }) {
         panelStore.setBadge('jobs', unread > 0 ? { level: 'error', unread } : running > 0 ? { level: 'info', unread: 0 } : null);
         // eslint-disable-next-line react-hooks/exhaustive-deps -- badge derives from the channel version bump
     }, [version, visible]);
-    return (_jsx(JobsPanel, { jobs: jobs, variant: "panel", focused: focused, visible: visible, focusRequest: focusRequest, onKill: (id) => {
+    return (_jsx(JobsPanel, { jobs: jobs, variant: "panel", focused: focused, visible: visible, focusRequest: focusRequest, onWatchOutput: watchOutput, onKill: (id) => {
             // Stub channels (verify harnesses) have no jobControl — surface
             // the same failure toast as a refused kill instead of throwing.
             if (channel.jobControl?.kill(id) !== true) {
                 channel.notify(t('jobs-kill-failed', { id }), { color: 'error' });
             }
         }, onSendToChat: (job) => {
-            // Send to Chat（§6.7）：任务摘要附为下一次提交的上下文；chip 在
-            // 输入框上方出现，Esc 可撤、提交即消耗。
+            // Attach a localized job summary as the next message context.
             if (typeof channel.attachContext !== 'function')
                 return;
             const lines = job.outputLines ?? [];
+            const statusLabel = {
+                running: t('jobs-status-running'),
+                stopping: t('jobs-status-stopping'),
+                completed: t('jobs-status-completed'),
+                failed: t('jobs-status-failed'),
+                killed: t('jobs-status-killed'),
+            }[job.status];
+            const command = job.command !== undefined && job.command !== '' ? job.command : job.label;
             const summary = [
-                `后台任务 ${job.id}（${job.status}）`,
-                job.command !== undefined && job.command !== '' ? `命令：${job.command}` : `命令：${job.label}`,
+                t('jobs-panel-context-heading', { id: job.id, status: statusLabel }),
+                t('jobs-panel-context-command', { command }),
                 lines.length > 0
-                    ? `输出（末 ${Math.min(10, lines.length)} 行）：\n${lines.slice(-10).map(line => line.text).join('\n')}`
-                    : '（暂无输出）',
+                    ? t('jobs-panel-context-output', { n: Math.min(10, lines.length) }) + '\n' + lines.slice(-10).map(line => line.text).join('\n')
+                    : t('jobs-panel-context-no-output'),
             ].join('\n');
-            channel.attachContext({ source: 'panel', sourceId: job.id, title: `Job ${job.id}`, content: summary });
+            channel.attachContext({ source: 'panel', sourceId: job.id, title: t('jobs-panel-context-title', { id: job.id }), content: summary });
             channel.notify(t('panel-sent-to-chat', { title: job.id }), { color: 'success' });
         } }));
 }
+/** 主屏 Agent View 盖过 Chat 时整棵主树（含本面板）会卸载；重挂载时从这里
+ *  恢复最后的路由。 */
+let lastAgentsRoute = 'dashboard';
 /**
- * agents：SubagentDashboard / SubagentDetailScene 的 panel variant——同一份
- * channel.subagents 与 subagentControl，布局与键盘按侧栏契约重排。二级路由
- * 是组件内 state：mountPolicy:'enabled' 让它在切面板 / 收侧栏时保留（评审
- * §四的硬需求）。badge 派生：running/starting>0 → info；面板不可见期间新
- * 出现的 failed → error（unread 计数）；两者皆无 → 清空；可见时把当前
- * failed 集合记为已读。
+ * agents: the dashboard and detail scene share the panel's agent roster and
+ * message control. The route stays mounted while another panel is active. Badges
+ * reflect running agents and unseen failures.
  */
 function AgentsPanelAdapter({ focused, visible }) {
     const channel = useSidePanelChannel();
     const subagents = channel.subagents;
     const version = channel.version;
-    const [route, setRoute] = React.useState('dashboard');
+    const [route, setRoute] = React.useState(lastAgentsRoute);
+    React.useEffect(() => { lastAgentsRoute = route; }, [route]);
+    // subagentControl.message 缺失 = 没有 composer 和消息流。可选链是给没有
+    // subagentControl 的桩 channel（回归夹具）用的。
+    const messageControl = channel.subagentControl?.message;
+    const detailAgentId = typeof route === 'object' ? route.detail : null;
+    const detailMessages = detailAgentId !== null && messageControl !== undefined
+        ? messageControl.messages().filter(m => m.from === detailAgentId || m.to === detailAgentId)
+        : [];
+    const detailTarget = React.useMemo(() => {
+        if (detailAgentId === null)
+            return undefined;
+        const labels = new Map(subagents.map(s => [s.agentId, s.description]));
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- roster may lag the route
+        return labels.has(detailAgentId) ? agentComposeTargetOf(detailAgentId, labels) : undefined;
+    }, [detailAgentId, subagents]);
+    const detailCompose = detailTarget !== undefined && messageControl !== undefined
+        ? { control: messageControl, target: detailTarget }
+        : undefined;
     // 已读基线：上次 visible=true 时见过的 failed id 集合。
     const seenFailedRef = React.useRef(new Set());
     React.useEffect(() => {
@@ -131,9 +160,9 @@ function AgentsPanelAdapter({ focused, visible }) {
         ? subagents.find(s => s.agentId === route.detail)
         : undefined;
     if (typeof route === 'object' && detail !== undefined) {
-        return (_jsx(SubagentDetailScene, { subagent: detail, variant: "panel", focused: focused, visible: visible, onBack: () => setRoute('dashboard'), onInterrupt: (id) => channel.subagentControl.interrupt(id) }));
+        return (_jsx(SubagentDetailScene, { subagent: detail, variant: "panel", focused: focused, visible: visible, onBack: () => setRoute('dashboard'), onInterrupt: (id) => channel.subagentControl?.interrupt(id), ...(channel.subagentControl?.history === undefined ? {} : { loadTranscript: channel.subagentControl.history }), onOpenView: () => agentViewStore.request(detail.agentId, 'agent-detail', true), messages: detailMessages, ...(detailCompose === undefined ? {} : { compose: detailCompose }) }));
     }
-    return (_jsx(SubagentDashboard, { subagents: subagents, variant: "panel", focused: focused, visible: visible, onSelect: (id) => setRoute({ detail: id }) }));
+    return (_jsx(SubagentDashboard, { subagents: subagents, variant: "panel", focused: focused, visible: visible, onSelect: (id) => setRoute({ detail: id }), onOpenView: (id) => agentViewStore.request(id, 'agents-dashboard', true), messages: messageControl?.messages() }));
 }
 let registered = false;
 /** 幂等：重复调用（夹具多次挂载）不再注册。 */
@@ -183,8 +212,7 @@ export function registerBuiltinPanels() {
         order: 15,
         source: 'builtin',
         mountPolicy: 'enabled',
-        // opt-in（在 dsh-tui.sidePanel.panels 里加入才出现，同 companion）。
-        defaultEnabled: false,
+        defaultEnabled: true,
         minColumns: 24,
         capabilities: { scroll: true },
         component: InfoPanel,
@@ -196,7 +224,7 @@ export function registerBuiltinPanels() {
         order: 25,
         source: 'builtin',
         mountPolicy: 'enabled',
-        defaultEnabled: false,
+        defaultEnabled: true,
         minColumns: 28,
         // 整屏对应物 = Ctrl+T / /trace 的 TrajectoryScene（分屏时那两者也走本面板）。
         capabilities: { scroll: true, fullscreen: true },
@@ -209,12 +237,25 @@ export function registerBuiltinPanels() {
         order: 35,
         source: 'builtin',
         mountPolicy: 'enabled',
-        defaultEnabled: false,
+        defaultEnabled: true,
         minColumns: 28,
         // 整屏对应物 = /home 的工作区主页（分屏时 /home 也走本面板）。
         capabilities: { scroll: true, fullscreen: true },
         component: WorkspacePanel,
     }, 'builtin');
+    panelStore.register({
+        id: 'btw',
+        titleKey: 'panel-title-btw',
+        icon: '?',
+        order: 22,
+        source: 'builtin',
+        mountPolicy: 'enabled',
+        defaultEnabled: true,
+        minColumns: 28,
+        // 整屏对应物 = ⤢ 的 BtwThreadScene（Esc 返回侧栏，不清 thread/draft）。
+        capabilities: { scroll: true, sendToChat: true, fullscreen: true },
+        component: BtwPanelAdapter,
+    }, 'builtin');
     panelStore.register({
         id: 'companion',
         titleKey: 'panel-title-companion',
@@ -222,8 +263,7 @@ export function registerBuiltinPanels() {
         order: 40,
         source: 'builtin',
         mountPolicy: 'enabled',
-        // 默认不启用（在 dsh-tui.sidePanel.panels 里显式加入才出现）。
-        defaultEnabled: false,
+        defaultEnabled: true,
         component: CompanionPanel,
     }, 'builtin');
 }

package/lib/types/components/sidePanel/companion/CompanionPanel.d.ts

@@ -1,50 +1,8 @@
 /**
- * CompanionPanel（设计分文档 §4 + v2.1 + 2026-10 沉底/互动/气泡改造）：
- *
- *   信号 ─▶ mood.ts 的派生 + 平滑层（防闪烁五规则）─▶ 显示语义
- *         ─▶ deepy 动画键（20 个全接上）─▶ 半块渲染（42×15）
- *
- * 布局（沉底）：宠物锚定在面板最底部（贴着 SidePanelColumn 底部 hint 行
- * 上方），腾出的上方空间放一个克制的状态区：心情 + 会话/工具统计行、
- * 「当前动作」行（kit 自带中文 title，不走 i18n）、互动提示行。
- * 宽度分三档：<44 列紧凑（不画皮肤，只留紧凑行）；连紧凑形态都摆不下
- * （< PANEL_MIN_COLUMNS，分栏几何的列宽下限）只留一条居中的「好挤呀，
- * 暂时躲起来了」标语（companion-cramped，{{name}}=皮肤 title；皮肤无关，
- * 判定在面板层）。
- *
- * 互动（鼠标）：
- * - 点击宠物左半/右半 → poke-left / poke-right（ClickEvent.localCol），
- *   保留爱心 pass（whale 回退皮肤的 pose.heart）；
- * - TICKLE_WINDOW_MS 内 ≥3 次点击 → tickle，窗口结束回平滑情绪；
- * - 按住拖动（onDragStart/Move/End）→ drag 动画 + **真拖动**：本体跟着
- *   指针在面板内容区内移动（clamp 在面板盒内，可以窜到状态区文字上面
- *   ——调皮是特性），松手后 PET_REBOUND_MS 内插值弹回底部 home。位移是
- *   面板层状态（两套皮肤共用），皮肤输出不动：水平=行内定宽 spacer
- *   （左 spacer + 宠物 + 右 spacer 恒等于面板宽，§16.6 列宽不变式天然
- *   成立），垂直=定高 home 槽行内负 marginTop（溢出可见）——刻意不用
- *   position:absolute：图像版皮肤的可见性门与渲染路径要求宠物留在流内；
- * - 指针进面板（near/左/右）→ idle-look（东张西望）；碰到宠物本体 →
- *   idle-spout（开心喷水）；睡眠中被碰到 → waking（官方 trigger）。
- * 鼠标契约：点击/拖拽 stopImmediatePropagation，hover 离开面板即复原。
- *
- * 通知气泡：channel.notifications（最新在最后）的新条目由宠物用圆角对话
- * 气泡说出来（面板内的**加一层**表达；输入框上方的 toast 照旧，不动）。
- * 颜色配反应动画：error→error、success→happy、warning→notification、
- * 无色→idle-look。visible=false 期间清空队列，切回来不弹旧账。
- *
- * 活动自述气泡：working 回合里聊天区 ⏵ 工作行（ActivityLine）的那句
- * 模型自述，由头顶气泡**逐字同步转述**（同一数据源 runtimeCtx.activity
- * 的 line 字段，不自行派生；判定条件与 Chat 相同：working 且 line 非空
- * 且 phase≠idle）。派生值、随渲染实时换词，无进出场可重触发；瞬态气泡
- * （通知/戳一戳）有效期内盖过它，到期仍在 working 则回落。回合结束
- * （working=false）即收起——庆祝动画走 mood 层，与此无关。拖动会话
- * （含回弹）期间两层气泡都抑制，落定后恢复（气泡不跟宠物走：孤零零
- * 留在 home 上方出戏，选抑制）。
- *
- * 时钟：visible=false 零订阅（useAnimationFrame 传 null）+ 零自有定时器；
- * 可见时由 160ms（睡眠 1000ms）的本地 tick 驱动动画帧与气泡/互动过期——
- * PanelHost 内 useAnimationFrame 因视口测量问题不订阅（见
- * verify-companion-panel.tsx 文件头的既有 finding），本地 tick 是等价替代。
+ * CompanionPanel derives mood, interaction animations and bubbles from the
+ * channel state. The companion stays at the bottom while status and activity
+ * occupy the space above it. A local visible-only tick advances frames and
+ * expires temporary reactions; dragging keeps the skin in normal document flow.
  */
 import React from 'react';
 import type { PanelProps } from '../types.js';

package/lib/types/components/sidePanel/companion/CompanionPanel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CompanionPanel.d.ts","sourceRoot":"","sources":["../../../../../src/components/sidePanel/companion/CompanionPanel.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,OAAO,KAAK,MAAM,OAAO,CAAA;AAazB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AA6I7C,wBAAgB,cAAc,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,UAAU,GAAG,KAAK,CAAC,SAAS,CA8f/F;AAED,eAAO,MAAM,sBAAsB,QAAe,CAAA"}
+{"version":3,"file":"CompanionPanel.d.ts","sourceRoot":"","sources":["../../../../../src/components/sidePanel/companion/CompanionPanel.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,MAAM,OAAO,CAAA;AAazB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAgJ7C,wBAAgB,cAAc,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,UAAU,GAAG,KAAK,CAAC,SAAS,CAigB/F;AAED,eAAO,MAAM,sBAAsB,QAAe,CAAA"}