@meiyukichan/dsh-sandore 0.1.0-rc.6

package/packages/client/chat/attachment/MessageImage.tsx

@@ -0,0 +1,136 @@
+/**
+ * MessageImage：抄自 DSH `packages/client/ui-attachment/src/MessageImage.tsx`。
+ * 历史消息图片的紧凑渲染（可重试加载 + 点击打开原图预览；单图按 long-edge 240px 定界，
+ * 多图渲染为 64px 方块瓦片）。attachment 类型经本地结构复刻（dsh-attachment 非依赖），
+ * labels 面收窄为 sandore 命名空间，其余逐字保留。
+ * @module @deepseek-ai/dsh-client-ui-sandore/src/client/chat/attachment/MessageImage
+ */
+import { useCallback, useEffect, useMemo, useState } from 'react'
+import type { ReactNode } from 'react'
+import { ImageLightbox } from './ImageLightbox.tsx'
+import type { ImageLightboxLabels } from './ImageLightbox.tsx'
+import type { SandoreImageAttachmentRef } from './image-attachment.ts'
+import css from './MessageImage.module.css'
+
+/** Loads a session-authorized durable image URL. */
+export type ImageLoader = (attachment: SandoreImageAttachmentRef) => Promise<string>
+
+/** 历史图片组渲染器（对齐 DSH slots.ts 的 `RenderMessageImages`，attachment 面本地复刻）。 */
+export type SandoreRenderMessageImages = (owner: {
+  /** Consecutive image blocks rendered as one gallery. */
+  images: readonly { readonly attachment: SandoreImageAttachmentRef }[]
+  /** Message-side alignment. */
+  align: 'start' | 'end'
+}) => ReactNode
+
+/** Message-image strings the owner resolves from its own locale namespace. */
+export interface MessageImageLabels {
+  /** Fallback display name for an unnamed image. */
+  image: string
+  /** Thumbnail tooltip inviting the original-image preview. */
+  open: string
+  /** Accessible thumbnail label; receives the image's display name. */
+  openNamed: (label: string) => string
+  /** Loading placeholder shown until bytes resolve. */
+  loading: string
+  /** Retry-control label shown when the load fails. */
+  loadFailed: string
+  /** Lightbox strings forwarded to the opened preview. */
+  lightbox: ImageLightboxLabels
+}
+
+/** Display box for a lone image (DeepSeek Chat rule): long edge 240px with
+ * the rendered aspect ratio clamped to [0.25, 4] — the overflow is cropped by
+ * `object-fit: cover` — and never upscaled past the image's natural size. The
+ * crop anchor keeps the top of very tall images and the left of very wide
+ * ones, where the informative content usually starts. */
+function singleFit(attachment: SandoreImageAttachmentRef): { width: number; height: number; objectPosition: string } {
+  const natural = attachment.width / attachment.height
+  const ratio = Math.min(4, Math.max(0.25, natural))
+  const box = ratio >= 1 ? { width: 240, height: 240 / ratio } : { width: 240 * ratio, height: 240 }
+  const scale = Math.min(1, attachment.width / box.width, attachment.height / box.height)
+  return {
+    width: Math.max(1, Math.round(box.width * scale)),
+    height: Math.max(1, Math.round(box.height * scale)),
+    objectPosition: natural < 0.25 ? 'center top' : natural > 4 ? 'left center' : 'center',
+  }
+}
+
+/**
+ * Compact history renderer with retryable loading and click-to-open original
+ * preview. A lone image renders at its `singleFit` size; an image among
+ * several renders as a fixed 64px square tile.
+ *
+ * @param props.attachment - the durable image reference to load and bound.
+ * @param props.load - session-authorized URL loader.
+ * @param props.variant - `single` for a message's lone image, `tile` otherwise.
+ * @param props.labels - resolved strings (tooltip, loading, retry, lightbox).
+ * @returns the bounded thumbnail button, or the retry control on failure.
+ */
+export function MessageImage({ attachment, load, variant, labels }: {
+  attachment: SandoreImageAttachmentRef
+  load: ImageLoader
+  variant: 'single' | 'tile'
+  labels: MessageImageLabels
+}) {
+  const [src, setSrc] = useState<string | null>(null)
+  const [error, setError] = useState(false)
+  const [open, setOpen] = useState(false)
+  // Retry re-arms the one load effect below, so every attempt — first load or
+  // retry — runs under the same liveness guard and the same reset.
+  const [attempt, setAttempt] = useState(0)
+  const request = useCallback(() => { setAttempt(a => a + 1) }, [])
+  const close = useCallback(() => { setOpen(false) }, [])
+  const fit = useMemo(
+    () => (variant === 'single' ? singleFit(attachment) : undefined),
+    [attachment, variant],
+  )
+
+  useEffect(() => {
+    let live = true
+    setError(false)
+    setSrc(null)
+    void load(attachment).then((url) => { if (live) setSrc(url) }).catch(() => { if (live) setError(true) })
+    return () => { live = false }
+  }, [attachment, load, attempt])
+
+  const label = attachment.name ?? labels.image
+  if (error) return <button type="button" className={css.error} data-variant={variant} onClick={request}>{labels.loadFailed}</button>
+  return (
+    <>
+      <button
+        type="button"
+        className={css.frame}
+        data-variant={variant}
+        style={fit === undefined ? undefined : { width: fit.width, height: fit.height }}
+        title={labels.open}
+        aria-label={labels.openNamed(label)}
+        onClick={() => { if (src !== null) setOpen(true) }}
+      >
+        {src === null
+          ? <span className={css.loading}>{labels.loading}</span>
+          : <img src={src} alt={label} style={fit === undefined ? undefined : { objectPosition: fit.objectPosition }} />}
+      </button>
+      {open && src !== null && <ImageLightbox src={src} alt={label} labels={labels.lightbox} onClose={close} />}
+    </>
+  )
+}
+
+/** Wrapping image group shared by user and assistant history: a lone image
+ * renders large, several render as 64px square tiles (DeepSeek Chat rule). */
+export function ImageGallery({ images, load, align, labels }: {
+  images: readonly { attachment: SandoreImageAttachmentRef }[]
+  load: ImageLoader
+  align: 'start' | 'end'
+  labels: MessageImageLabels
+}) {
+  if (images.length === 0) return null
+  const variant = images.length === 1 ? 'single' : 'tile'
+  return (
+    <div className={css.gallery} data-align={align}>
+      {images.map((image, index) => (
+        <MessageImage key={`${image.attachment.attachmentId}:${index}`} {...image} load={load} variant={variant} labels={labels} />
+      ))}
+    </div>
+  )
+}

package/packages/client/chat/attachment/image-attachment.ts

@@ -0,0 +1,98 @@
+/**
+ * image-attachment：沙盒面板的本地图片附件面。
+ *
+ * DSH 的 `ImageAttachmentRef` 定义在 `@deepseek-ai/dsh-attachment`（runtime 的
+ * `ISession.readAttachment` 返回它），sandore 面板不声明该依赖，故按
+ * `packages/attachment/attachment/src/types.ts` 的字段结构本地复刻（仅类型，无行为）。
+ * `resolveImage` 抄自 DSH `ui-conversation/src/client/service.ts` 的
+ * `ConversationController.resolveImage`：经 `session.readAttachment` 取回字节，构建
+ * blob URL（不可用时退化为 data URL），按 session+attachmentId 缓存。
+ * @module @deepseek-ai/dsh-client-ui-sandore/src/client/chat/attachment/image-attachment
+ */
+import type { SessionFace, SessionId } from '@deepseek-ai/dsh-client-runtime/client'
+
+/** Raster image formats accepted by the version-one attachment path. */
+export type SandoreImageMediaType = 'image/png' | 'image/jpeg' | 'image/webp' | 'image/gif'
+
+/** Durable, serializable metadata for one immutable image object（dsh-attachment 的 ImageAttachmentRef 结构复刻）。 */
+export interface SandoreImageAttachmentRef {
+  /** Opaque storage identifier; never a filesystem path or bearer URL. */
+  attachmentId: string
+  /** Media type verified from the stored bytes. */
+  mediaType: SandoreImageMediaType
+  /** Exact encoded byte length. */
+  bytes: number
+  /** Intrinsic encoded width in pixels. */
+  width: number
+  /** Intrinsic encoded height in pixels. */
+  height: number
+  /** Optional display name stripped of local path information. */
+  name?: string
+}
+
+function bytesToBase64(bytes: Uint8Array): string {
+  let binary = ''
+  const chunk = 0x8000
+  for (let i = 0; i < bytes.length; i += chunk) {
+    binary += String.fromCharCode(...bytes.subarray(i, i + chunk))
+  }
+  return btoa(binary)
+}
+
+interface PendingImage {
+  readonly generation: number
+  readonly pending: Promise<string>
+}
+
+/**
+ * 构建一个会话授权的历史图片 URL 加载器（`(attachment) => Promise<string>`）。
+ * 行为与 DSH `ConversationController.resolveImage` 一致：按 session+attachmentId 缓存，
+ * 取回字节后优先 blob URL（`URL.createObjectURL` 不可用时退化为 base64 data URL）。
+ * 调用方应在卸载时 `dispose()` 释放创建的 blob URL。
+ * @param session - 所属会话面（readAttachment 授权源）。
+ * @returns `{ load, dispose }`：load 为加载器；dispose 释放缓存与已创建 URL。
+ */
+export function createImageLoader(session: SessionFace): {
+  load(attachment: SandoreImageAttachmentRef): Promise<string>
+  dispose(): void
+} {
+  const sessionId = session.sessionId as SessionId
+  const generation = 0
+  const imageUrls = new Map<string, PendingImage>()
+  const createdImageUrls = new Set<string>()
+  const revokePreview = (url: string): void => {
+    createdImageUrls.delete(url)
+    if (typeof URL.revokeObjectURL === 'function') URL.revokeObjectURL(url)
+  }
+  return {
+    load(attachment: SandoreImageAttachmentRef): Promise<string> {
+      const key = `${sessionId}:${attachment.attachmentId}`
+      const cached = imageUrls.get(key)
+      if (cached !== undefined) return cached.pending
+      // readAttachment 的参数为 runtime 的 branded AttachmentId（dsh-api-remotes）；
+      // 本地结构复刻的 attachmentId 为 string，经参数类型转换（值本身不变）。
+      const attachmentId = attachment.attachmentId as unknown as Parameters<SessionFace['readAttachment']>[0]
+      const pending = session.readAttachment(attachmentId)
+        .then((result) => {
+          if (!result.ok) throw new Error(`${result.error.code}: ${result.error.message}`)
+          if (typeof URL.createObjectURL !== 'function') {
+            return `data:${attachment.mediaType};base64,${bytesToBase64(Uint8Array.from(result.value.data))}`
+          }
+          const bytes = Uint8Array.from(result.value.data)
+          const url = URL.createObjectURL(new Blob([bytes.buffer], { type: attachment.mediaType }))
+          createdImageUrls.add(url)
+          return url
+        })
+        .catch((error: unknown) => {
+          if (imageUrls.get(key)?.generation === generation) imageUrls.delete(key)
+          throw error
+        })
+      imageUrls.set(key, { generation, pending })
+      return pending
+    },
+    dispose(): void {
+      imageUrls.clear()
+      for (const url of [...createdImageUrls]) revokePreview(url)
+    },
+  }
+}

package/packages/client/chat/attachment/image-labels.ts

@@ -0,0 +1,34 @@
+/**
+ * image-labels：抄自 DSH `packages/client/ui-attachment/src/client/labels.ts`（消息图片
+ * 部分；drop/rail 标签不属于聊天面板）。把 sandore 命名空间的 image.* 键解析为
+ * MessageImage/ImageLightbox 的标签面。逐字保留逻辑。
+ * @module @deepseek-ai/dsh-client-ui-sandore/src/client/chat/attachment/image-labels
+ */
+import type { TranslateNS } from '@deepseek-ai/dsh-client-ui-slots'
+import type { ImageLightboxLabels } from './ImageLightbox.tsx'
+import type { MessageImageLabels } from './MessageImage.tsx'
+
+/**
+ * Resolve original-image lightbox strings from the sandore namespace.
+ * @param t - sandore namespace translator.
+ * @returns translated lightbox labels.
+ */
+export function lightboxLabels(t: TranslateNS<'sandore'>): ImageLightboxLabels {
+  return { dialog: t('image.preview'), close: t('image.closePreview') }
+}
+
+/**
+ * Resolve historical message-image strings from the sandore namespace.
+ * @param t - sandore namespace translator.
+ * @returns translated message-image labels.
+ */
+export function messageImageLabels(t: TranslateNS<'sandore'>): MessageImageLabels {
+  return {
+    image: t('image.label'),
+    open: t('image.openOriginal'),
+    openNamed: label => t('image.openOriginalLabel', { label }),
+    loading: t('image.loading'),
+    loadFailed: t('image.loadFailed'),
+    lightbox: lightboxLabels(t),
+  }
+}

package/packages/client/chat/message-chrome.ts

@@ -0,0 +1,96 @@
+/**
+ * message-chrome：抄自 DSH `packages/client/ui-conversation/src/client/chat/message-chrome.ts`。
+ * 用户/agent 消息 IconActions 行共用的时间标签辅助（本地日历日、运行时长、时钟）。
+ * 仅把 locale 面从 conversation 命名空间收窄为 sandore 命名空间（key 集抄进
+ * sandore 字典），逻辑逐字保留。
+ * @module @deepseek-ai/dsh-client-ui-sandore/src/client/chat/message-chrome
+ */
+import type { TranslateNS } from '@deepseek-ai/dsh-client-ui-slots'
+
+function pad2(n: number): string {
+  return String(n).padStart(2, '0')
+}
+
+/**
+ * Local calendar-day epoch (ms at local midnight) for an instant.
+ * @param ms - Unix epoch ms.
+ * @returns Midnight of that local calendar day.
+ */
+export function startOfLocalDay(ms: number): number {
+  const d = new Date(ms)
+  d.setHours(0, 0, 0, 0)
+  return d.getTime()
+}
+
+/**
+ * Delay until the next local midnight after `ms` (at least 1ms).
+ * @param ms - Unix epoch ms.
+ * @returns Milliseconds until the following local midnight.
+ */
+export function msUntilNextLocalMidnight(ms: number): number {
+  const next = new Date(ms)
+  next.setHours(24, 0, 0, 0)
+  return Math.max(next.getTime() - ms, 1)
+}
+
+/**
+ * Localized elapsed-time label shared by running and settled turn chrome.
+ * @param ms - Elapsed duration in milliseconds (negatives clamp to zero).
+ * @param t - Translate seat supplying the duration templates.
+ * @returns Display string in whole seconds.
+ */
+export function formatRunDuration(ms: number, t: TranslateNS<'sandore'>): string {
+  const total = Math.max(0, Math.floor(ms / 1000))
+  const minutes = Math.floor(total / 60)
+  const seconds = total % 60
+  return minutes > 0
+    ? t('duration.minutes', { minutes, seconds: String(seconds).padStart(2, '0') })
+    : t('duration.seconds', { seconds })
+}
+
+/**
+ * Sub-turn latency figure: one decimal under ten seconds, whole seconds
+ * beyond. Unit-less so the locale template owns the second suffix.
+ * @param ms - Latency in milliseconds (negatives clamp to zero).
+ * @returns Display number in seconds without unit.
+ */
+export function formatLatencySeconds(ms: number): string {
+  const s = Math.max(0, ms) / 1000
+  return s < 10 ? String(Math.round(s * 10) / 10) : String(Math.round(s))
+}
+
+/**
+ * Decode-throughput figure: whole tokens from ten up, one decimal below.
+ * @param tps - Tokens per second.
+ * @returns Display number without unit.
+ */
+export function formatTokensPerSecond(tps: number): string {
+  const clamped = Math.max(0, tps)
+  return clamped >= 10 ? String(Math.round(clamped)) : String(Math.round(clamped * 10) / 10)
+}
+
+/**
+ * Compact local timestamp for message IconActions. Same calendar day →
+ * `HH:mm`; earlier this year → the `clock.md` date template + clock; other
+ * years → the `clock.ymd` template + clock. Pure: the date templates arrive
+ * through the caller's locale seat.
+ * @param time - Unix epoch ms from the source session event.
+ * @param t - translate seat supplying the `clock.md` / `clock.ymd` templates.
+ * @param now - Reference instant for the day/year cut (defaults to wall clock).
+ * @returns Date-aware clock string (24-hour, zero-padded time).
+ */
+export function formatMessageClock(time: number, t: TranslateNS<'sandore'>, now: number = Date.now()): string {
+  const d = new Date(time)
+  const n = new Date(now)
+  const clock = `${pad2(d.getHours())}:${pad2(d.getMinutes())}`
+  if (
+    d.getFullYear() === n.getFullYear()
+    && d.getMonth() === n.getMonth()
+    && d.getDate() === n.getDate()
+  ) {
+    return clock
+  }
+  const params = { y: d.getFullYear(), m: d.getMonth() + 1, d: d.getDate() }
+  const md = d.getFullYear() === n.getFullYear() ? t('clock.md', params) : t('clock.ymd', params)
+  return `${md} ${clock}`
+}

package/packages/client/chat/reference/ReferenceIcon.tsx

@@ -0,0 +1,40 @@
+/**
+ * ReferenceIcon：抄自 DSH `packages/client/ui-conversation/src/client/reference/ReferenceIcon.tsx`。
+ * 用户气泡内联引用（@会话/@文件/@文件夹）域字形。逐字保留。
+ * @module @deepseek-ai/dsh-client-ui-sandore/src/client/chat/reference/ReferenceIcon
+ */
+import type { ReactNode } from 'react'
+import {
+  IconBrowseOutline16, IconFolderClose16,
+} from '@deepseek-ai/dsh-client-ui-primitives'
+
+/** Reference domains with distinct composer and transcript glyphs. */
+export type ReferenceIconKind = 'session' | 'file' | 'folder'
+
+/** Props shared by inline reference glyphs. */
+export interface ReferenceIconProps {
+  kind: ReferenceIconKind
+  size?: number
+  className?: string | undefined
+}
+
+/**
+ * Render the icon that identifies one inline reference domain.
+ * @param props - Reference kind, optional size, and optional CSS class.
+ * @returns The corresponding current-color SVG glyph.
+ */
+export function ReferenceIcon({ kind, size = 16, className }: ReferenceIconProps): ReactNode {
+  switch (kind) {
+    case 'session':
+      return (
+        <svg width={size} height={size} className={className} viewBox="0 0 16 16" fill="none" aria-hidden>
+          <path
+            d="M8 0.597656C3.91296 0.597656 0.599716 3.91103 0.599609 7.99805C0.599609 9.13171 0.854567 10.2079 1.31152 11.1699L1.59277 11.7607L2.77441 11.1992L2.49414 10.6084L2.36035 10.3076C2.06865 9.59612 1.90723 8.81645 1.90723 7.99805C1.90733 4.63362 4.63554 1.90625 8 1.90625C11.3644 1.90635 14.0917 4.63368 14.0918 7.99805C14.0918 11.3625 11.3644 14.0907 8 14.0908C7.311 14.0908 6.80642 14.0414 6.35938 13.918C5.919 13.7963 5.50105 13.5929 5.00098 13.2441C4.26805 12.7329 3.21756 12.5526 2.35156 13.0996L2.33789 13.1084L2.32422 13.1182L1.74805 13.5234L2.18164 14.8184L3.05957 14.2002C3.37505 14.0068 3.84248 14.0319 4.25195 14.3174C4.84447 14.7307 5.39718 15.009 6.01172 15.1787C6.61963 15.3465 7.25579 15.3984 8 15.3984C12.087 15.3983 15.4004 12.0851 15.4004 7.99805C15.4003 3.9111 12.087 0.59776 8 0.597656ZM4.56836 8.50977V9.80371H8.12402V8.50977H4.56836ZM4.56836 7.30078H11.4619V6.00684H4.56836V7.30078Z"
+            fill="currentColor"
+          />
+        </svg>
+      )
+    case 'file': return <IconBrowseOutline16 size={size} className={className} />
+    case 'folder': return <IconFolderClose16 size={size} className={className} />
+  }
+}

package/packages/client/chat/turn-assistant.ts

@@ -0,0 +1,15 @@
+/**
+ * turn-assistant：抄自 DSH `packages/client/ui-conversation/src/client/chat/turn-assistant.ts`。
+ * 收集一个 Assistant 生命周期中的可见散文（turn-tail 复制按钮取文本用）。逐字保留。
+ * @module @deepseek-ai/dsh-client-ui-sandore/src/client/chat/turn-assistant
+ */
+import type { AssistantBlock } from '@deepseek-ai/dsh-client-runtime/client'
+
+/**
+ * Collect visible prose from one Assistant lifecycle.
+ * @param blocks - Assistant content blocks.
+ * @returns concatenated text blocks.
+ */
+export function assistantText(blocks: readonly AssistantBlock[]): string {
+  return blocks.flatMap(block => block.kind === 'text' ? [block.text] : []).join('')
+}

package/packages/client/chat/turn-metrics.ts

@@ -0,0 +1,102 @@
+/**
+ * turn-metrics：抄自 DSH `packages/client/ui-conversation/src/client/chat/turn-metrics.ts`。
+ * 已结算 turn 尾部（tail）与 StatsLine 共用的延迟/吞吐折叠。逐字保留。
+ * @module @deepseek-ai/dsh-client-ui-sandore/src/client/chat/turn-metrics
+ */
+// Latency/throughput folds shared by the settled turn footer and StatsLine.
+
+import type { AssistantMessageNode, ConversationNode } from '@deepseek-ai/dsh-client-runtime/client'
+
+/** Latency and decode-throughput readings for one turn's footer. */
+export interface TurnMetrics {
+  /** First-step TTFT in ms; absent when that step carries no recorded timing. */
+  ttftMs?: number
+  /** Decode throughput over steps carrying both timing and provider usage. */
+  tokensPerSecond?: number
+}
+
+/** One assistant step's derivable latency facts; null marks an unrecorded part. */
+export interface StepReading {
+  /** step/start → first token delta, in ms. */
+  ttftMs: number | null
+  /** First token delta → final message, in ms. */
+  decodeMs: number | null
+  /** Provider-reported completion tokens. */
+  outputTokens: number | null
+}
+
+interface UsageLike {
+  outputTokens?: number
+}
+
+type AssistantNode = AssistantMessageNode
+
+function usageOutputTokens(usage: unknown): number | null {
+  if (typeof usage !== 'object' || usage === null) return null
+  const value = (usage as UsageLike).outputTokens
+  return typeof value === 'number' && Number.isFinite(value) && value >= 0 ? value : null
+}
+
+/**
+ * Read one assistant node's TTFT, decode wall time, and output tokens.
+ * @param node - A settled assistant node.
+ * @returns Per-part readings with `null` for unrecorded values.
+ */
+export function assistantStepReading(node: AssistantNode): StepReading {
+  const timing = node.timing
+  const ttftMs = timing !== undefined && timing.stepStartTime !== null && timing.firstTokenTime !== null
+    ? Math.max(0, timing.firstTokenTime - timing.stepStartTime)
+    : null
+  const decodeMs = timing !== undefined && timing.firstTokenTime !== null
+    ? Math.max(0, timing.completedTime - timing.firstTokenTime)
+    : null
+  return { ttftMs, decodeMs, outputTokens: usageOutputTokens(node.usage) }
+}
+
+interface TurnFold {
+  firstStep: number
+  firstStepTtftMs: number | null
+  decodeMs: number
+  outputTokens: number
+  sampled: boolean
+}
+
+/**
+ * Fold assistant nodes into per-turn footer metrics.
+ *
+ * TTFT is the turn's lowest-step request-dispatch-to-first-token reading, so
+ * it is only meaningful when the turn's start is inside
+ * the loaded window (the caller gates on `turnTimings`, which shares that
+ * window). Throughput divides summed output tokens by summed decode wall time,
+ * counting only steps that carry both.
+ * @param nodes - Snapshot nodes of the loaded window.
+ * @returns Turn number → available metrics; turns with none are absent.
+ */
+export function deriveTurnMetrics(nodes: readonly ConversationNode[]): Map<number, TurnMetrics> {
+  const folds = new Map<number, TurnFold>()
+  for (const node of nodes) {
+    if (node.kind !== 'assistant') continue
+    const reading = assistantStepReading(node)
+    let fold = folds.get(node.turn)
+    if (fold === undefined) {
+      fold = { firstStep: node.step, firstStepTtftMs: reading.ttftMs, decodeMs: 0, outputTokens: 0, sampled: false }
+      folds.set(node.turn, fold)
+    } else if (node.step < fold.firstStep) {
+      fold.firstStep = node.step
+      fold.firstStepTtftMs = reading.ttftMs
+    }
+    if (reading.decodeMs !== null && reading.outputTokens !== null) {
+      fold.decodeMs += reading.decodeMs
+      fold.outputTokens += reading.outputTokens
+      fold.sampled = true
+    }
+  }
+  const metrics = new Map<number, TurnMetrics>()
+  for (const [turn, fold] of folds) {
+    const entry: TurnMetrics = {}
+    if (fold.firstStepTtftMs !== null) entry.ttftMs = fold.firstStepTtftMs
+    if (fold.sampled && fold.decodeMs > 0) entry.tokensPerSecond = fold.outputTokens / (fold.decodeMs / 1000)
+    if (entry.ttftMs !== undefined || entry.tokensPerSecond !== undefined) metrics.set(turn, entry)
+  }
+  return metrics
+}

package/packages/client/chat/use-calendar-day.ts

@@ -0,0 +1,27 @@
+/**
+ * use-calendar-day：抄自 DSH `packages/client/ui-conversation/src/client/chat/use-calendar-day.ts`。
+ * 组件本地日历日 tick：memoized 消息行跨午夜保持稳定 props，IconActions 时钟需要
+ * 一个本地日座，在下一个本地午夜重新触发而不触及框架 hooks。逐字保留。
+ * @module @deepseek-ai/dsh-client-ui-sandore/src/client/chat/use-calendar-day
+ */
+import { useEffect, useState } from 'react'
+import { msUntilNextLocalMidnight, startOfLocalDay } from './message-chrome.ts'
+
+/**
+ * Local calendar-day epoch that advances at each local midnight.
+ * @returns Midnight ms for the current local day; updates after the boundary.
+ */
+export function useCalendarDay(): number {
+  const [day, setDay] = useState(() => startOfLocalDay(Date.now()))
+  useEffect(() => {
+    let timer: ReturnType<typeof setTimeout>
+    const arm = (): void => {
+      const now = Date.now()
+      setDay(startOfLocalDay(now))
+      timer = setTimeout(arm, msUntilNextLocalMidnight(now))
+    }
+    timer = setTimeout(arm, msUntilNextLocalMidnight(Date.now()))
+    return () => { clearTimeout(timer) }
+  }, [])
+  return day
+}

package/packages/client/chat/use-throttled-visual-update.ts

@@ -0,0 +1,44 @@
+/**
+ * use-throttled-visual-update：抄自 DSH `packages/client/ui-conversation/src/client/chat/use-throttled-visual-update.ts`。
+ * 非必需视觉对齐的帧节流调度（ReasoningRow 摘要滚动用）。逐字保留。
+ * @module @deepseek-ai/dsh-client-ui-sandore/src/client/chat/use-throttled-visual-update
+ */
+import { useCallback, useLayoutEffect, useRef } from 'react'
+
+const DEFAULT_INTERVAL_FRAMES = 3
+
+/**
+ * Return a stable scheduler that coalesces visual updates over a frame interval.
+ * @param update - DOM alignment to run after the throttle interval.
+ * @param intervalFrames - frames to wait before applying the latest alignment.
+ * @returns a stable function that schedules the latest update.
+ */
+export function useThrottledVisualUpdate(
+  update: () => void,
+  intervalFrames = DEFAULT_INTERVAL_FRAMES,
+): () => void {
+  const updateRef = useRef(update)
+  updateRef.current = update
+  const pendingFrameRef = useRef<number | null>(null)
+
+  useLayoutEffect(() => () => {
+    if (pendingFrameRef.current === null) return
+    cancelAnimationFrame(pendingFrameRef.current)
+    pendingFrameRef.current = null
+  }, [])
+
+  return useCallback(() => {
+    if (pendingFrameRef.current !== null) return
+    let remainingFrames = intervalFrames
+    const advance = (): void => {
+      remainingFrames -= 1
+      if (remainingFrames > 0) {
+        pendingFrameRef.current = requestAnimationFrame(advance)
+        return
+      }
+      pendingFrameRef.current = null
+      updateRef.current()
+    }
+    pendingFrameRef.current = requestAnimationFrame(advance)
+  }, [intervalFrames])
+}