dsh-sidenote 0.1.0

package/src/client/sidechat/model.ts

@@ -0,0 +1,331 @@
+/**
+ * 侧边聊天的纯逻辑层：Tab 编号标题、meta 序列化/解析容错、状态树遍历、
+ * 会话快照 → 消息流折叠、面板相位判定。全部无副作用，单测直接覆盖。
+ *
+ * 数据源事实（权威注释）：
+ * - SidebarState 真实形态是 splits/bottomSplits 两棵 split/leaf 树
+ *   （dsh-better-sidebar src/client/state.ts），leaf.tabs 持有 SidebarTab。
+ * - ConversationSnapshot.nodes 是 ConversationNode 联合（kind 判别），
+ *   partial/runningCalls 承载在途流式输出（dsh-client-runtime
+ *   lib/types/client/sessions/conversation.d.ts）。
+ */
+import type { ConversationSnapshot, Context, SidebarTab } from '../../context-types.ts'
+import { t } from '../locales.ts'
+
+/** Tab 类型 id（better-sidebar 注册表键；带包前缀防冲突）。 */
+export const SIDE_TAB_TYPE = 'dsh-sidenote:side'
+
+
+
+// ── Tab id 与标题 ────────────────────────────────────────────────────────────
+
+/** 多实例 Tab id：`side:<uuid>`（terminal/browser 的 createTab 铸 id 先例）。 */
+export function mintSideTabId(): string {
+  return `side:${crypto.randomUUID()}`
+}
+
+/**
+ * 标题编号：首个「侧边」；并存时新 Tab「侧边 N」（N = 既有最大编号 + 1，
+ * 从标题解析）——关掉「侧边」再新建不会重名复用「侧边 2」。
+ * @param existingTitles - 创建时刻同会话侧边聊天 Tab 的标题集。
+ */
+export function sideTabTitle(existingTitles: readonly string[]): string {
+  const base = t('tabBaseTitle')
+  let max = 0
+  for (const title of existingTitles) {
+    // 双语兼容：语言切换后旧标题是另一种语言，两种都认（编号连续性不丢）。
+    const match = /^(?:Side|侧边)(?: (\d+))?$/.exec(title)
+    if (match !== null) max = Math.max(max, match[1] === undefined ? 1 : Number(match[1]))
+  }
+  return max <= 0 ? base : `${base} ${max + 1}`
+}
+
+// ── Tab meta（注册表首选寄存处；随布局持久化） ───────────────────────────────
+
+/** 侧边聊天寄存在 SidebarTab.meta 上的插件自有 JSON。 */
+export interface SideChatMeta {
+  /** fork 出的子会话 id；缺省 = 尚未 fork（刚创建）。 */
+  childId?: string
+  /** fork 来源主会话 id（面板归属校验用；面板天然落在其 sidebar 状态里）。 */
+  parentSessionId?: string
+  /** 桥接（WI-03 划选提问）写入的待注入草稿；面板应用后清除。 */
+  pendingDraft?: string
+}
+
+/**
+ * 容错解析 tab.meta：布局持久化里的 meta 来自上一版本的自己，字段缺失或
+ * 类型漂移一律降级为缺省，绝不抛错（刷新恢复路径不许崩）。
+ */
+export function parseSideChatMeta(meta: unknown): SideChatMeta {
+  if (typeof meta !== 'object' || meta === null) return {}
+  const raw = meta as Record<string, unknown>
+  const out: SideChatMeta = {}
+  if (typeof raw.childId === 'string' && raw.childId !== '') out.childId = raw.childId
+  if (typeof raw.parentSessionId === 'string' && raw.parentSessionId !== '') out.parentSessionId = raw.parentSessionId
+  if (typeof raw.pendingDraft === 'string' && raw.pendingDraft !== '') out.pendingDraft = raw.pendingDraft
+  return out
+}
+
+/** 清除 meta.pendingDraft（其余字段原样保留）。 */
+export function clearPendingDraft(meta: SideChatMeta): SideChatMeta {
+  const { pendingDraft: _dropped, ...rest } = meta
+  return rest
+}
+
+// ── 侧栏状态树遍历（容错：布局 JSON 漂移时不抛错） ───────────────────────────
+
+function isTab(value: unknown): value is SidebarTab {
+  if (typeof value !== 'object' || value === null) return false
+  const tab = value as { id?: unknown; type?: unknown }
+  return typeof tab.id === 'string' && typeof tab.type === 'string'
+}
+
+function walkTree(node: unknown, into: SidebarTab[]): void {
+  if (typeof node !== 'object' || node === null) return
+  const n = node as { kind?: unknown; tabs?: unknown; children?: unknown }
+  if (n.kind === 'leaf') {
+    if (Array.isArray(n.tabs)) for (const tab of n.tabs) if (isTab(tab)) into.push(tab)
+    return
+  }
+  if (Array.isArray(n.children)) for (const child of n.children) walkTree(child, into)
+}
+
+/** 枚举侧栏状态（splits + bottomSplits 两棵树）里的全部 Tab。 */
+export function collectTabs(state: unknown): SidebarTab[] {
+  if (typeof state !== 'object' || state === null) return []
+  const s = state as { splits?: unknown; bottomSplits?: unknown }
+  const into: SidebarTab[] = []
+  walkTree(s.splits, into)
+  walkTree(s.bottomSplits, into)
+  return into
+}
+
+/** 枚举当前并存的侧边聊天 Tab（树顺序 = 打开顺序的近似）。 */
+export function collectSideTabs(state: unknown): SidebarTab[] {
+  return collectTabs(state).filter(tab => tab.type === SIDE_TAB_TYPE)
+}
+
+/** 并存数（createTab 编号标题的输入）。 */
+export function countSideTabs(state: unknown): number {
+  return collectSideTabs(state).length
+}
+
+// ── fork 准入 ────────────────────────────────────────────────────────────────
+
+/**
+ * blank 着陆页会话没有已完成 turn，fork 必败（host 返回 fork-unavailable）
+ * ——+ 菜单与 /side 命令的 available 用它禁用入口；面板内错误态兜底。
+ * 摘要求知（列表未就绪）时放行，交给 fork 错误态。
+ */
+export function canForkFrom(ctx: Context, sessionId: string): boolean {
+  try {
+    const summary = ctx.sessions.list.getSnapshot().byId?.[sessionId]
+    return summary?.blank !== true
+  } catch {
+    return true
+  }
+}
+
+// ── 面板相位 ─────────────────────────────────────────────────────────────────
+
+/**
+ * 面板相位：
+ * - forking：无 childId，fork 编排进行中（或等待 effect 起跑）；
+ * - fork-error：fork/归档失败（blank 会话无已完成 turn 等）；
+ * - loading：有 childId，列表未就绪或 binding 尚未可解析；
+ * - missing：列表就绪后子会话不在列（会话已不存在）；
+ * - chat：binding 解析成功，正常聊天。
+ */
+export type PanelPhase = 'forking' | 'fork-error' | 'loading' | 'missing' | 'chat'
+
+export function phaseOf(input: {
+  childId: string | undefined
+  forkError: string | null
+  bound: boolean
+  listPhase: 'pending' | 'ready' | undefined
+  listed: boolean
+}): PanelPhase {
+  if (input.childId === undefined) return input.forkError === null ? 'forking' : 'fork-error'
+  if (input.bound) return 'chat'
+  if (input.listPhase === 'ready' && !input.listed) return 'missing'
+  return 'loading'
+}
+
+// ── 草稿拼接 ─────────────────────────────────────────────────────────────────
+
+/** 注入草稿的拼接规则：空草稿直接落文本，否则换行追加（引文+问题的自然形态）。 */
+export function appendDraftText(draft: string, text: string): string {
+  return draft.trim() === '' ? text : `${draft}\n${text}`
+}
+
+// ── 会话快照 → 消息流折叠 ────────────────────────────────────────────────────
+
+/** 面板渲染用的消息视图（自绘；工具卡片等复杂节点降级为简洁块）。 */
+export interface ChatMessage {
+  /** React key（节点 seq / 在途 callId 派生，稳定）。 */
+  key: string
+  role: 'user' | 'assistant' | 'tool' | 'notice' | 'error'
+  /** markdown 正文（assistant）或纯文本（其他）。 */
+  text: string
+  /** assistant 的思考内容（折叠渲染）；缺省 = 无。 */
+  reasoning?: string
+  /** tool 角色的工具名。 */
+  toolName?: string
+  /** tool 角色的失败标记。 */
+  isError?: boolean
+  /** 流式中（partial / runningCalls）。 */
+  streaming?: boolean
+  /** 被打断冻结的 assistant 输出（渲染「已停止」标记）。 */
+  interrupted?: boolean
+}
+
+/** 工具结果正文截断上限（面板是窄栏，超长输出不撑爆 DOM）。 */
+export const TOOL_TEXT_LIMIT = 4000
+
+export function truncateText(text: string, max: number): string {
+  return text.length <= max ? text : `${text.slice(0, max)}…`
+}
+
+interface LooseBlock {
+  type?: unknown
+  kind?: unknown
+  text?: unknown
+  name?: unknown
+}
+
+/** ContentBlock[] → 纯文本：text 块拼接；image 块降级占位；其余忽略。 */
+export function contentTextOf(content: unknown): string {
+  if (!Array.isArray(content)) return ''
+  const parts: string[] = []
+  for (const block of content) {
+    if (typeof block !== 'object' || block === null) continue
+    const b = block as LooseBlock
+    if (b.type === 'text' && typeof b.text === 'string') parts.push(b.text)
+    else if (b.type === 'image') parts.push('[图片]')
+  }
+  return parts.join('\n')
+}
+
+function seqKey(prefix: string, node: Record<string, unknown>): string {
+  return `${prefix}:${typeof node.seq === 'number' ? node.seq : '?'}`
+}
+
+function assistantParts(blocks: unknown): { text: string; reasoning: string; hasToolCall: boolean } {
+  const texts: string[] = []
+  const reasonings: string[] = []
+  let hasToolCall = false
+  if (Array.isArray(blocks)) {
+    for (const block of blocks) {
+      if (typeof block !== 'object' || block === null) continue
+      const b = block as LooseBlock
+      if (b.kind === 'text' && typeof b.text === 'string') texts.push(b.text)
+      else if (b.kind === 'reasoning' && typeof b.text === 'string') reasonings.push(b.text)
+      else if (b.kind === 'tool-call') hasToolCall = true
+    }
+  }
+  return { text: texts.join('\n\n'), reasoning: reasonings.join('\n\n'), hasToolCall }
+}
+
+/**
+ * 单个 ConversationNode → ChatMessage；返回 null = 面板不渲染
+ * （context 注入、未知面事件、已取消的重试等对读者无信息的节点）。
+ */
+export function nodeToMessage(node: unknown): ChatMessage | null {
+  if (typeof node !== 'object' || node === null) return null
+  const n = node as Record<string, unknown>
+  switch (n.kind) {
+    case 'user':
+      return { key: seqKey('u', n), role: 'user', text: contentTextOf(n.content) }
+    case 'steering':
+      return { key: seqKey('s', n), role: 'user', text: contentTextOf(n.content) }
+    case 'assistant': {
+      const { text, reasoning, hasToolCall } = assistantParts(n.blocks)
+      // 纯工具调用头的 assistant 节点不渲染（tool-result 节点承载工具卡片）。
+      if (text === '' && reasoning === '' && hasToolCall) return null
+      return {
+        key: seqKey('a', n),
+        role: 'assistant',
+        text,
+        ...(reasoning !== '' ? { reasoning } : {}),
+        ...(n.interrupted === true ? { interrupted: true } : {}),
+      }
+    }
+    case 'tool-result': {
+      const call = n.call as { name?: unknown } | null
+      const toolName = typeof call?.name === 'string'
+        ? call.name
+        : typeof n.callId === 'string' ? n.callId : '工具'
+      return {
+        key: seqKey('t', n),
+        role: 'tool',
+        toolName,
+        text: truncateText(contentTextOf(n.content), TOOL_TEXT_LIMIT),
+        ...(n.isError === true ? { isError: true } : {}),
+      }
+    }
+    case 'turn-error':
+      return { key: seqKey('e', n), role: 'error', text: typeof n.message === 'string' ? n.message : '未知错误' }
+    case 'model-retry': {
+      if (n.retryState === 'cancelled') return null
+      return {
+        key: seqKey('r', n),
+        role: 'notice',
+        text: n.retryState === 'started' ? '模型请求失败，正在自动重试…' : '模型请求失败，等待自动重试…',
+      }
+    }
+    case 'turn-max-tokens':
+      return { key: seqKey('m', n), role: 'notice', text: '输出达到长度上限，本轮回复已截断。' }
+    case 'command': {
+      const name = typeof n.name === 'string' && n.name !== '' ? `/${n.name}` : '/命令'
+      const args = typeof n.args === 'string' ? n.args : ''
+      return { key: seqKey('c', n), role: 'notice', text: `执行命令 ${name}${args}` }
+    }
+    case 'compaction':
+      return { key: seqKey('k', n), role: 'notice', text: '已压缩更早的对话上下文。' }
+    default:
+      // context（注入）/ unknown（未识面事件）：MVP 不渲染。
+      return null
+  }
+}
+
+/**
+ * ConversationSnapshot → 渲染消息列表：终态节点 + 在途工具调用 + 流式部分。
+ * 快照缺省（未绑定）时为空列表。
+ */
+export function transcriptOf(snapshot: ConversationSnapshot | undefined | null): ChatMessage[] {
+  if (snapshot === undefined || snapshot === null) return []
+  const out: ChatMessage[] = []
+  for (const node of snapshot.nodes ?? []) {
+    const message = nodeToMessage(node)
+    if (message !== null) out.push(message)
+  }
+  // 在途工具调用（tool/call 已见、tool/result 未至）。
+  if (Array.isArray(snapshot.runningCalls)) {
+    for (const call of snapshot.runningCalls) {
+      if (typeof call !== 'object' || call === null) continue
+      const c = call as { callId?: unknown; name?: unknown }
+      out.push({
+        key: `rc:${typeof c.callId === 'string' ? c.callId : '?'}`,
+        role: 'tool',
+        toolName: typeof c.name === 'string' ? c.name : '工具',
+        text: '',
+        streaming: true,
+      })
+    }
+  }
+  // 流式中的 assistant 部分输出。
+  const partial = snapshot.partial as { blocks?: unknown } | null | undefined
+  if (partial !== undefined && partial !== null) {
+    const { text, reasoning, hasToolCall } = assistantParts(partial.blocks)
+    if (text !== '' || reasoning !== '' || !hasToolCall) {
+      out.push({
+        key: 'partial',
+        role: 'assistant',
+        text,
+        ...(reasoning !== '' ? { reasoning } : {}),
+        streaming: true,
+      })
+    }
+  }
+  return out
+}

package/src/client/sidechat/open.ts

@@ -0,0 +1,66 @@
+/**
+ * 「新建或聚焦一个侧边聊天 Tab」的共享编排：桥接（WI-03 划选提问
+ * askInSideChat）与 /side 斜杠命令共用。
+ *
+ * 聚焦策略：同一主会话并存多个时聚焦最后一个（最近打开的）。
+ * 草稿注入：目标 Tab 已 fork 且 input 机器可达 → 直接写机器草稿；
+ * 否则写 meta.pendingDraft 移交面板（面板在 composer 就绪后应用并清除）。
+ */
+import type { Context, SidebarTab } from '../../context-types.ts'
+import {
+  SIDE_TAB_TYPE,
+  appendDraftText,
+  collectSideTabs,
+  collectTabs,
+  parseSideChatMeta,
+} from './model.ts'
+import { readInputDraft, resolveSessionInput } from './composer.ts'
+
+/** 从最新快照读一个 Tab（meta 合并写入前的读取面；布局即注册表）。 */
+export function readTab(ctx: Context, tabId: string): SidebarTab | undefined {
+  return collectTabs(ctx.betterSidebar.getSnapshot().state).find(tab => tab.id === tabId)
+}
+
+/**
+ * 为 sessionId 新建或聚焦一个侧边聊天 Tab；draftText 给出时写入其草稿。
+ * @returns false = 未能打开（调用方保持自己的流程）。
+ */
+export function openOrFocusSideChat(ctx: Context, sessionId: string, draftText?: string): boolean {
+  try {
+    const snapshot = ctx.betterSidebar.getSnapshot()
+    // 侧边聊天活在主会话自己的侧栏状态里；目标会话不在屏上时不越权开 Tab。
+    if (snapshot.sessionId !== sessionId || snapshot.state === undefined) return false
+    const existing = collectSideTabs(snapshot.state)
+
+    if (existing.length > 0) {
+      const target = existing[existing.length - 1]!
+      if (draftText !== undefined && draftText !== '') {
+        const meta = parseSideChatMeta(target.meta)
+        const input = meta.childId === undefined ? null : resolveSessionInput(ctx, meta.childId)
+        if (input !== null) {
+          input.setDraft(appendDraftText(readInputDraft(input), draftText))
+        } else {
+          ctx.betterSidebar.updateTab(target.id, {
+            meta: { ...meta, pendingDraft: appendDraftText(meta.pendingDraft ?? '', draftText) },
+          })
+        }
+      }
+      ctx.betterSidebar.activateTab(target.id, { sessionId })
+      return true
+    }
+
+    // 新建：openTab 走 createTab 铸造（seed.meta 会被忽略），所以先记下既有
+    // id 集，openTab 同步落状态后找出新 Tab，再把 pendingDraft 写进它的 meta。
+    const before = new Set(collectTabs(snapshot.state).map(tab => tab.id))
+    ctx.betterSidebar.openTab({ type: SIDE_TAB_TYPE }, { sessionId })
+    const created = collectSideTabs(ctx.betterSidebar.getSnapshot().state).find(tab => !before.has(tab.id))
+    if (created === undefined) return false
+    if (draftText !== undefined && draftText !== '') {
+      ctx.betterSidebar.updateTab(created.id, { meta: { pendingDraft: draftText } })
+    }
+    return true
+  } catch (error) {
+    console.warn('[dsh-sidenote] 打开侧边聊天失败:', error)
+    return false
+  }
+}

package/src/client/sidechat/sidechat.module.css

@@ -0,0 +1,230 @@
+/*
+ * 侧边聊天面板样式。颜色全部消费 DSH 设计平台的 --dsw-alias-* 令牌
+ * （声明在 <body> 与 body[data-ds-dark-theme] 上），跟随皮肤系统，
+ * 不做任何每皮肤适配、不写死颜色。
+ */
+.root {
+  display: flex;
+  flex-direction: column;
+  height: 100%;
+  color: var(--dsw-alias-label-primary);
+  font-size: 13px;
+}
+
+/* 消息流（可滚动区）。 */
+.body {
+  flex: 1;
+  overflow-y: auto;
+  padding: 12px 10px;
+  display: flex;
+  flex-direction: column;
+}
+
+.transcript {
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+}
+
+/* ── 空状态 / 整屏状态 ── */
+.empty,
+.stateScreen {
+  flex: 1;
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  justify-content: center;
+  gap: 8px;
+  text-align: center;
+  padding: 24px 16px;
+}
+
+.emptyIcon {
+  color: var(--dsw-alias-label-tertiary);
+}
+
+.emptyTitle {
+  font-size: 14px;
+  font-weight: 600;
+  color: var(--dsw-alias-label-primary);
+}
+
+.emptyText {
+  font-size: 12px;
+  line-height: 1.6;
+  color: var(--dsw-alias-label-tertiary);
+  max-width: 240px;
+}
+
+.stateDetail {
+  font-size: 12px;
+  line-height: 1.6;
+  color: var(--dsw-alias-state-error-primary);
+  max-width: 260px;
+  word-break: break-word;
+}
+
+/* ── 消息行 ── */
+.userRow {
+  display: flex;
+  justify-content: flex-end;
+}
+
+.userBubble {
+  max-width: 88%;
+  background: var(--dsw-alias-button-info-fill);
+  color: #fff;
+  border-radius: 12px 12px 2px 12px;
+  padding: 8px 12px;
+  white-space: pre-wrap;
+  word-break: break-word;
+}
+
+.assistantRow {
+  display: flex;
+  justify-content: flex-start;
+}
+
+.assistantBody {
+  max-width: 100%;
+  font-size: 13px;
+  line-height: 1.6;
+  word-break: break-word;
+}
+
+.reasoning {
+  margin-bottom: 6px;
+  border-left: 3px solid var(--dsw-alias-border-l2);
+  padding-left: 8px;
+  color: var(--dsw-alias-label-tertiary);
+  font-size: 12px;
+}
+
+.reasoning > summary {
+  cursor: pointer;
+  user-select: none;
+}
+
+.reasoningBody {
+  margin-top: 4px;
+  white-space: pre-wrap;
+  word-break: break-word;
+}
+
+.streamingHint {
+  color: var(--dsw-alias-label-dimmed);
+}
+
+/* 工具卡片（简洁自绘块：头部 = 工具名 + 状态徽标，正文 = 截断文本）。 */
+.toolCard {
+  border: 1px solid var(--dsw-alias-border-l2);
+  background: var(--dsw-alias-bg-layer-2);
+  border-radius: 8px;
+  overflow: hidden;
+}
+
+.toolHead {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  padding: 5px 10px;
+  background: var(--dsw-alias-bg-layer-3);
+  font-size: 12px;
+  color: var(--dsw-alias-label-secondary);
+}
+
+.toolError {
+  color: var(--dsw-alias-state-error-primary);
+}
+
+.toolRunning {
+  color: var(--dsw-alias-label-tertiary);
+}
+
+.toolBody {
+  padding: 8px 10px;
+  font-size: 12px;
+  color: var(--dsw-alias-label-tertiary);
+  white-space: pre-wrap;
+  word-break: break-word;
+  max-height: 160px;
+  overflow-y: auto;
+}
+
+.errorRow {
+  color: var(--dsw-alias-state-error-primary);
+  font-size: 12px;
+  padding: 4px 2px;
+  white-space: pre-wrap;
+}
+
+.noticeRow {
+  color: var(--dsw-alias-label-dimmed);
+  font-size: 12px;
+  text-align: center;
+  padding: 2px 0;
+}
+
+/* ── composer ── */
+.composer {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+  padding: 8px 10px;
+  border-top: 1px solid var(--dsw-alias-border-l2);
+}
+
+.input {
+  width: 100%;
+  min-height: 40px;
+  max-height: 160px;
+  resize: vertical;
+  background: var(--dsw-alias-bg-layer-2);
+  border: 1px solid var(--dsw-alias-border-l2);
+  border-radius: 8px;
+  color: var(--dsw-alias-label-primary);
+  padding: 8px 10px;
+  font: inherit;
+  box-sizing: border-box;
+}
+
+.input:focus {
+  outline: none;
+  border-color: var(--dsw-alias-state-business-primary);
+}
+
+.composerFoot {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 8px;
+}
+
+.modelLabel {
+  font-size: 12px;
+  color: var(--dsw-alias-label-dimmed);
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.sendButton,
+.stopButton {
+  appearance: none;
+  display: inline-flex;
+  align-items: center;
+  gap: 4px;
+  border: 1px solid var(--dsw-alias-state-business-primary);
+  background: var(--dsw-alias-button-info-fill);
+  color: #fff;
+  font-size: 13px;
+  padding: 6px 12px;
+  border-radius: 8px;
+  cursor: pointer;
+  flex: none;
+}
+
+.sendButton:disabled {
+  opacity: 0.55;
+  cursor: default;
+}