dsh-smooth-stream 0.6.0 → 0.7.0

package/src/client/debugRuntime.ts

@@ -30,12 +30,46 @@ export interface DebugMetrics {
   followRevealScale: number
   followFollowing: boolean
   followConstrained: boolean
+  /**
+   * Terminal-follow phase. `terminal-drain` (producer stopped, reveal queue
+   * still owes text) and `host-cascade` (host swapping status / collapsing
+   * Think / mounting the tail) need OPPOSITE corrections, so they must be
+   * distinguishable in the panel rather than inferred from `followActive`.
+   */
+  followTerminalPhase: FollowTerminalPhase
+  /** Physical owned bottom margin currently written into the DOM. */
+  followRunwayPx: number
+  /** Budget the terminal phase may spend, capped by the runway. */
+  followTerminalBudgetPx: number
+  /** `runwayPx - visibleReserve`: the term that turns into visible motion. */
+  followBaselineShiftPx: number
+  /** Screen-space reading-anchor delta this frame (null when unmeasurable). */
+  followAnchorDeltaPx: number | null
+  /** Reveal characters the smoother still owes after the producer stopped. */
+  followRemainingRevealChars: number
   scrollTop: number | null
   scrollHeight: number | null
   clientHeight: number | null
   lastUpdatedMs: number | null
 }
 
+export type FollowTerminalPhase = 'live' | 'terminal-drain' | 'host-cascade' | 'natural'
+
+/**
+ * Allocation-free read of the newest stream metric. The follower polls this
+ * every frame to learn whether the producer has stopped while reveal work
+ * remains, and `getSnapshot()` would allocate a fresh state object per frame
+ * just to answer one boolean.
+ */
+export function readNewestStreamMetric(): { producerComplete: boolean; backlog: number } | null {
+  let newest: StreamMetric | undefined
+  for (const candidate of streamMetrics.values()) {
+    if (newest === undefined || candidate.updatedAt > newest.updatedAt) newest = candidate
+  }
+  if (newest === undefined) return null
+  return { producerComplete: newest.producerComplete, backlog: newest.backlog }
+}
+
 export interface DebugRuntimeState {
   available: boolean
   enabled: boolean
@@ -70,6 +104,12 @@ interface StreamMetric {
   targetChars: number
   displayedChars: number
   active: boolean
+  /**
+   * The producer (model stream) has stopped even if the reveal queue still owes
+   * characters. The follower needs exactly this bit to tell a `terminal-drain`
+   * from live streaming, and it cannot be derived from `backlog > 0` alone.
+   */
+  producerComplete: boolean
   updatedAt: number
 }
 
@@ -85,6 +125,12 @@ interface FollowMetric {
   scrollHeight: number
   clientHeight: number
   active: boolean
+  terminalPhase: FollowTerminalPhase
+  runwayPx: number
+  terminalBudgetPx: number
+  baselineShiftPx: number
+  readingAnchorDeltaPx: number | null
+  remainingRevealChars: number
   updatedAt: number
 }
 
@@ -105,6 +151,12 @@ const EMPTY_METRICS: DebugMetrics = {
   followRevealScale: 1,
   followFollowing: false,
   followConstrained: false,
+  followTerminalPhase: 'live',
+  followRunwayPx: 0,
+  followTerminalBudgetPx: 0,
+  followBaselineShiftPx: 0,
+  followAnchorDeltaPx: null,
+  followRemainingRevealChars: 0,
   scrollTop: null,
   scrollHeight: null,
   clientHeight: null,
@@ -181,6 +233,12 @@ function currentMetrics(timestamp: number): DebugMetrics {
     followRevealScale: follow?.revealScale ?? 1,
     followFollowing: follow?.following ?? false,
     followConstrained: follow?.constrained ?? false,
+    followTerminalPhase: follow?.terminalPhase ?? 'live',
+    followRunwayPx: follow?.runwayPx ?? 0,
+    followTerminalBudgetPx: follow?.terminalBudgetPx ?? 0,
+    followBaselineShiftPx: follow?.baselineShiftPx ?? 0,
+    followAnchorDeltaPx: follow?.readingAnchorDeltaPx ?? null,
+    followRemainingRevealChars: follow?.remainingRevealChars ?? 0,
     scrollTop: follow?.scrollTop ?? null,
     scrollHeight: follow?.scrollHeight ?? null,
     clientHeight: follow?.clientHeight ?? null,

package/src/client/harnessIcons.ts

@@ -0,0 +1,27 @@
+import type { ComponentType } from 'react'
+import * as primitives from '@deepseek-ai/dsh-client-ui-primitives'
+
+type IconProps = { className?: string | undefined; size?: number | undefined }
+type IconExports = Record<string, ComponentType<IconProps> | undefined>
+
+// Harness renamed size-suffixed icon exports to weight-suffixed names. Resolve
+// at runtime so this plugin bundle works with both the older published
+// primitive package used for development and current Harness module tables.
+const icons = primitives as unknown as IconExports
+
+function resolveIcon(currentName: string, legacyName: string): ComponentType<IconProps> {
+  const icon = icons[currentName] ?? icons[legacyName]
+  if (icon === undefined) {
+    throw new Error(`dsh-smooth-stream: Harness icon export is missing (${currentName}, ${legacyName})`)
+  }
+  return icon
+}
+
+export const IconChevronDown = resolveIcon('IconChevronDownOutlineRegular', 'IconChevronDownOutline14')
+export const IconClose = resolveIcon('IconCloseOutlineRegular', 'IconCloseOutline16')
+export const IconCode = resolveIcon('IconCodeOutlineRegular', 'IconCodeOutline16')
+export const IconCopy = resolveIcon('IconCopyOutlineRegular', 'IconCopyOutline16')
+export const IconQuestion = resolveIcon('IconQuestionOutlineRegular', 'IconQuestionOutline14')
+export const IconRefresh = resolveIcon('IconRefreshOutlineRegular', 'IconRefreshOutline14')
+export const IconRefreshSmall = resolveIcon('IconRefreshOutlineRegular', 'IconRefreshOutline16')
+export const IconThink = resolveIcon('IconThinkOutlineRegular', 'IconThinkOutline14')

package/src/client/index.ts

@@ -13,7 +13,7 @@ import { SmoothStreamCardController } from './smooth-stream-card-controller.ts'
 import { createSmoothStreamSettingsApi } from './smooth-stream-settings-api.ts'
 import { DebugPanel } from './DebugPanel.tsx'
 import { debugRuntime } from './debugRuntime.ts'
-import { NS as SETTINGS_NS, en, zh } from './locales.ts'
+import { NS as SETTINGS_NS, CHAT_NS, en, zh, chatEn, chatZh } from './locales.ts'
 import { DEFAULT_STREAM_CONFIG, STREAM_BOOT_GLOBAL, type StreamConfig } from '../config.ts'
 import { DEFAULT_STREAM_SETTINGS, STREAM_SETTINGS_NS, type StreamSettings } from '../settings.ts'
 
@@ -37,8 +37,34 @@ const STREAM_PRESETS: readonly string[] = ['realtime', 'balanced', 'silky']
  * generic follow boundary. This is deliberately keyed by the owner that
  * provides the renderer, not by individual tool names, so new Context,
  * Command, and Tool rows are covered automatically.
+ *
+ * Host chrome and controllers are excluded on a different rule: `turn-process`
+ * (the completed-turn process summary control) and `turn-tail` (the turn usage
+ * footer) are not Agent output. The Host renders them as bare controls and
+ * flips their visibility itself, so wrapping them has three measured costs and
+ * no benefit:
+ *
+ * 1. The wrapper element defeats ChatView's `.flowItem:empty { display: none }`
+ *    rule. A `turn-process` renderer returns null whenever the Host's fold is
+ *    unavailable (e.g. `processWindowReady === false`), and that null render is
+ *    exactly what the `:empty` rule exists to erase; with a wrapper the row
+ *    stays in flow and still consumes the 16px column gap, painting an empty
+ *    band where the fold control should be.
+ * 2. The summary label (`N tool calls · M messages`) is not streamed model
+ *    text, so pushing it through the character-reveal engine is wrong by
+ *    construction.
+ * 3. The row would inherit the generic entrance animation (opacity + clip-path)
+ *    on a row the Host may mount and hide inside a single commit.
  */
-const SKIP_WRAP = new Set(['assistant-step', 'user', 'steering', 'command-input'])
+const SKIP_WRAP = new Set([
+  'assistant-step',
+  'user',
+  'steering',
+  'command-input',
+  'turn-process',
+  'turn-tail',
+  'tool-call',
+])
 
 /** React function/class or an exotic component such as memo/forwardRef/lazy. */
 function isWrappableComponent(value: unknown): value is ComponentType<FollowWrapProps> {
@@ -157,8 +183,10 @@ class SettingsCell {
       pending === this.pending
       && next.enabled === this.value.enabled
       && next.controlScroll === this.value.controlScroll
+      && next.preset === this.value.preset
       && next.motionPreference === this.value.motionPreference
       && next.thinkAutoExpand === this.value.thinkAutoExpand
+      && next.logarithmicFade === this.value.logarithmicFade
       && next.debugEnabled === this.value.debugEnabled
       && next.debugTuning === this.value.debugTuning
     ) return
@@ -172,6 +200,16 @@ class SettingsCell {
     return !this.pending && this.value.enabled
   }
 
+  /**
+   * True only once an attached settings service has produced its loaded values.
+   * Until then — and when no settings service is composed at all — `value` is
+   * still the shared client default, so callers that must not let that default
+   * shadow the install-time config have to ask before trusting it.
+   */
+  ready(): boolean {
+    return this.card?.getSnapshot().status === 'ready'
+  }
+
   readonly getSnapshot = (): StreamSettings => this.value
 
   readonly subscribe = (listener: () => void): () => void => {
@@ -200,6 +238,55 @@ export function apply(ctx: ClientContext): void {
     () => settings.getSnapshot().controlScroll,
   )
 
+  /**
+   * Layered `t` for the assistant renderer.
+   *
+   * The renderer's keys have no single owner: `conversation` owns the
+   * `image.*` family in every Harness version, `chat` (0.1.5+) owns
+   * `message.think`, and three `message.*` keys MOVED from `conversation` to
+   * `chat` between the version this package pins and the current one. Binding
+   * the slot to either namespace alone degrades a real slice of the UI to raw
+   * keys, which is the defect this replaces.
+   *
+   * The order is deliberate: `conversation` first, so the pinned Harness keeps
+   * resolving the keys it still owns there; then `chat` for what moved or is
+   * new; then this plugin's own namespace for keys no Harness version
+   * provides. A namespace that is not registered returns its key unchanged
+   * (`LocaleRuntime.bind` does not throw), so an older Harness without `chat`
+   * falls straight through.
+   *
+   * The reference is built once and held stable: the seat feeds a memoized
+   * renderer, and a fresh identity per render would defeat that memoization.
+   * Until the locale service arrives the seat's own binding stays in use.
+   */
+  let assistantT: AssistantProps['t'] | undefined
+
+  // Locale routing belongs to the renderer lifecycle, not to the optional
+  // Connection-backed settings card. Keeping this injection independent means
+  // a deployment can stream localized replies without Connection, and a
+  // transient disconnect cannot dispose the renderer's fallback dictionary.
+  ctx.inject(['locale'], (localeCtx) => {
+    localeCtx.effect(
+      () => localeCtx.locale.register(CHAT_NS, { zh: chatZh, en: chatEn }),
+      'dsh-smooth-stream: conversation fallback dictionary',
+    )
+    const conversationT = localeCtx.locale.bind('conversation')
+    const chatT = localeCtx.locale.bind('chat') as (key: string, params?: Record<string, unknown>) => string
+    const fallbackT = localeCtx.locale.bind(CHAT_NS) as (key: string, params?: Record<string, unknown>) => string
+    const merged = (key: string, params?: Record<string, unknown>): string => {
+      const primary = (conversationT as (k: string, p?: unknown) => string)(key, params)
+      if (primary !== key) return primary
+      const secondary = chatT(key, params)
+      if (secondary !== key) return secondary
+      return fallbackT(key, params)
+    }
+    const bound = merged as unknown as AssistantProps['t']
+    assistantT = bound
+    return () => {
+      if (assistantT === bound) assistantT = undefined
+    }
+  })
+
   // The card talks to the plugin-owned loopback RPC, so the core settings
   // namespace allowlist cannot make it disappear. The stream still applies
   // with defaults when the optional Settings UI or Connection is absent.
@@ -264,18 +351,30 @@ export function apply(ctx: ClientContext): void {
     )
     return createElement(TypewriterAssistantNodeView, {
       ...props,
+      // Override the seat's single-namespace binding with the layered lookup
+      // described above. Falls back to the seat's own binding only if the
+      // locale service never arrived (renderer then receives the prop it
+      // already had).
+      ...(assistantT === undefined ? {} : { t: assistantT }),
       mode: config.mode,
-      preset: config.preset,
+      // Loaded settings hold the resolved preset (user layer over the install
+      // config), so they own the prop. Without them — no settings service, a
+      // failed load, or the frames before the first read lands — the shared
+      // client default is NOT an authority on the installed preset; the boot
+      // config is.
+      preset: settings.ready() ? preferences.preset ?? config.preset : config.preset,
       revealCharsPerSec: config.revealCharsPerSec,
       scrollSpeedPxPerSec: config.scrollSpeedPxPerSec,
       maxScrollSpeedPxPerSec: config.maxScrollSpeedPxPerSec,
       thinkAutoExpand: preferences.thinkAutoExpand,
+      logarithmicFade: preferences.logarithmicFade,
       controlScroll: preferences.controlScroll,
       motionPreference: preferences.motionPreference,
     })
   }
   ctx.slots.inject('conversation.chat.node', () => {
     let releaseTakeover: (() => void) | undefined
+    let usedSwap = false
 
     const syncTakeover = (): void => {
       if (!settings.takeoverEnabled()) {
@@ -285,24 +384,67 @@ export function apply(ctx: ClientContext): void {
       }
       if (releaseTakeover !== undefined) return
       const unwrap = wrapAgentChatRows(ctx, useControlScroll)
-      const unshadow = ctx.slots.register({
-        name: 'conversation.chat.node',
-        key: 'assistant-step',
-        priority: -100,
-        locale: 'conversation',
-        registrant: 'dsh-smooth-stream',
-      }, configured)
+      // dsh 0.2.x renders every keyed entry of `conversation.chat.node` as
+      // its own seat, so a lower-priority registration no longer shadows the
+      // built-in assistant row — the same assistant step then renders twice
+      // (built-in + takeover), duplicating every reasoning block in the
+      // transcript. Swap the built-in entry's component in place instead,
+      // exactly like the other keyed rows below; this keeps the original
+      // children, locale, and inject seats on every kernel generation. The
+      // shadow registration survives only as a fallback for compositions
+      // that declare no built-in assistant row to swap.
+      const builtin = ctx.slots.entries('conversation.chat.node').find(
+        entry => entry.options.key === 'assistant-step'
+          // The pinned SlotOptions type predates `registrant`; every current
+          // runtime carries it (see the register spread in the slots package).
+          && (entry.options as { registrant?: string }).registrant !== 'dsh-smooth-stream'
+          && entry.component !== configured,
+      )
+      let unshadow: () => void
+      if (builtin !== undefined && isWrappableComponent(builtin.component)) {
+        usedSwap = true
+        const inner = builtin.component as ComponentType<FollowWrapProps>
+        builtin.component = configured
+        unshadow = () => {
+          if (builtin.component === configured) builtin.component = inner
+        }
+      } else {
+        unshadow = ctx.slots.register({
+          name: 'conversation.chat.node',
+          key: 'assistant-step',
+          priority: -100,
+          // `conversation` (not `chat`): it is the namespace the pinned Harness
+          // actually registers, so it is the one whose keys must keep resolving.
+          // The layered `t` handed to the renderer covers what this namespace
+          // does not own. A namespace the composition does not declare would
+          // degrade every `t()` call to its raw key.
+          locale: 'conversation',
+          registrant: 'dsh-smooth-stream',
+        }, configured)
+      }
       releaseTakeover = () => {
-        // Stop observing slot changes before the shadow entry is removed.
+        // Stop observing slot changes before the takeover is removed.
         unwrap()
         unshadow()
       }
     }
 
+    // If the shadow fallback was taken because the built-in assistant row
+    // had not registered yet, re-take through the in-place swap as soon as
+    // it appears, so 0.2.x never renders the row twice.
+    const offSlotChange = ctx.on('slots/changed', (key: string) => {
+      if (key !== 'conversation.chat.node' || usedSwap || releaseTakeover === undefined) return
+      if (!settings.takeoverEnabled()) return
+      releaseTakeover()
+      releaseTakeover = undefined
+      syncTakeover()
+    })
+
     const unsubscribe = settings.subscribe(syncTakeover)
     syncTakeover()
     return () => {
       unsubscribe()
+      offSlotChange()
       releaseTakeover?.()
     }
   })

package/src/client/locales.ts

@@ -3,16 +3,65 @@
 /** Dictionary namespace owned by this plugin's settings card. */
 export const NS = 'settings.smoothStream'
 
+/**
+ * Namespace owning the conversation keys THIS PLUGIN must be able to render
+ * but the Harness does not always provide.
+ *
+ * The plugin consumes keys from two Harness namespaces, and which one owns a
+ * given key is not stable across Harness versions:
+ *
+ * - `conversation` (`dsh-client-ui-conversation`) owns the `image.*` family in
+ *   every version, and also owned `message.stopped`, `message.unknownBlock`
+ *   and `json.truncated` before those moved to `chat`.
+ * - `chat` (`dsh-client-ui-chat`, present from 0.1.5 on) owns `message.think`
+ *   and now owns the three keys above. It does not exist at all in rc.6, the
+ *   version this package still pins in devDependencies.
+ *
+ * Neither namespace alone can serve every key this plugin renders, so
+ * `index.ts` layers them. This plugin-owned namespace is the final layer; it
+ * exists because a plugin may NOT register into `chat` or `conversation` —
+ * `LocaleRuntime.register` throws when the (namespace, locale) pair already
+ * has an owner, and the Harness owns both.
+ */
+export const CHAT_NS = 'smoothStream.chat'
+
+/**
+ * Keys the plugin resolves through {@link CHAT_NS}. Only keys with no
+ * dependable Harness owner belong here; anything the Harness already provides
+ * must keep coming from the Harness so a language pack can override it.
+ */
+export type SmoothStreamChatKey = 'message.think' | 'image.serviceUnavailable'
+
+/** English fallback for {@link SmoothStreamChatKey}. */
+export const chatEn: Record<SmoothStreamChatKey, string> = {
+  'message.think': 'Think',
+  // Removed from the Harness dictionaries in 0.1.5 (rc.6 had it under
+  // `conversation`), and the plugin interpolates it into a thrown Error, so
+  // the raw key must never reach a reader.
+  'image.serviceUnavailable': 'Image service unavailable',
+}
+
+/** Simplified Chinese fallback for {@link SmoothStreamChatKey}. */
+export const chatZh: Record<SmoothStreamChatKey, string> = {
+  'message.think': '思考',
+  'image.serviceUnavailable': '图片服务不可用',
+}
+
 /** Locale keys the card renders. */
 export type SmoothStreamLocaleKey =
   | 'title' | 'description'
   | 'enabled' | 'enabledHint'
   | 'controlScroll' | 'controlScrollHint'
+  | 'preset' | 'presetHint'
+  | 'presetRealtime' | 'presetRealtimeHint'
+  | 'presetBalanced' | 'presetBalancedHint'
+  | 'presetSilky' | 'presetSilkyHint'
   | 'motionPreference' | 'motionPreferenceHint'
   | 'motionAuto' | 'motionAutoHint'
   | 'motionForceSmooth' | 'motionForceSmoothHint'
   | 'motionForceReduced' | 'motionForceReducedHint'
   | 'thinkAutoExpand' | 'thinkAutoExpandHint'
+  | 'logarithmicFade' | 'logarithmicFadeHint'
   | 'debugEnabled' | 'debugEnabledHint' | 'debugUnavailable'
   | 'debugPanelTitle' | 'debugPanelToggle' | 'debugPanelClose' | 'debugGuide'
   | 'debugLive' | 'debugIdle' | 'debugUnsaved'
@@ -21,6 +70,8 @@ export type SmoothStreamLocaleKey =
   | 'debugFps' | 'debugFrameTime' | 'debugBacklog' | 'debugRevealSpeed' | 'debugProgress'
   | 'debugFollowState' | 'debugFollowing' | 'debugReleased'
   | 'debugLag' | 'debugVelocity' | 'debugReserve' | 'debugCapacity' | 'debugAppliedScale'
+  | 'debugTerminalPhase' | 'debugOwnedRunway' | 'debugTerminalBudget' | 'debugBaselineShift'
+  | 'debugAnchorDelta' | 'debugPhaseLive' | 'debugPhaseDrain' | 'debugPhaseCascade' | 'debugPhaseNatural'
   | 'debugRevealMultiplier' | 'debugQueuePressure' | 'debugMaxReveal'
   | 'debugSpringStiffness' | 'debugSpringDamping' | 'debugSpringMass'
   | 'debugRunway' | 'debugReserveResponse' | 'debugBackpressureMin'
@@ -41,6 +92,14 @@ export const en: Record<SmoothStreamLocaleKey, string> = {
   enabledHint: 'Let this plugin render and follow streaming replies. Turn off to use the built-in Harness renderer.',
   controlScroll: 'Take over scrolling',
   controlScrollHint: 'On by default; smooth-stream writes the conversation scroll position. Turn off to leave bottom-follow to Harness.',
+  preset: 'Pacing preset',
+  presetHint: 'Smoothing cadence profile for text reveal and glide.',
+  presetRealtime: 'Realtime',
+  presetRealtimeHint: 'Aggressive cadence, low latency, tracks output closely.',
+  presetBalanced: 'Balanced',
+  presetBalancedHint: 'Default balance between pace and visual rhythm.',
+  presetSilky: 'Silky',
+  presetSilkyHint: 'Higher backlog buffer, gentle EMA damping, maximum fluidity.',
   motionPreference: 'Motion',
   motionPreferenceHint: 'How streaming responds to the system reduce-motion setting.',
   motionAuto: 'Follow system',
@@ -50,6 +109,8 @@ export const en: Record<SmoothStreamLocaleKey, string> = {
   motionForceReduced: 'Always raw',
   motionForceReducedHint: 'Render raw text even when the system allows motion.',
   thinkAutoExpand: 'Auto-expand thinking',
+  logarithmicFade: 'Logarithmic fade',
+  logarithmicFadeHint: 'Fade new answer and expanded thinking text into view. Follows the motion preference.',
   thinkAutoExpandHint: 'Open the thinking block while it streams. Turn off to keep it collapsed.',
   debugEnabled: 'Show render diagnostics',
   debugEnabledHint: 'Show live streaming and scroll metrics on the right side of the chat. Tune values there, then save them here.',
@@ -82,6 +143,15 @@ export const en: Record<SmoothStreamLocaleKey, string> = {
   debugReserve: 'Reserve',
   debugCapacity: 'Capacity',
   debugAppliedScale: 'Applied scale',
+  debugTerminalPhase: 'Terminal phase',
+  debugOwnedRunway: 'Owned runway',
+  debugTerminalBudget: 'Terminal budget',
+  debugBaselineShift: 'Baseline shift',
+  debugAnchorDelta: 'Anchor Δ',
+  debugPhaseLive: 'live',
+  debugPhaseDrain: 'terminal-drain',
+  debugPhaseCascade: 'host-cascade',
+  debugPhaseNatural: 'natural',
   debugRevealMultiplier: 'Reveal multiplier',
   debugQueuePressure: 'Queue pressure',
   debugMaxReveal: 'Maximum reveal',
@@ -129,6 +199,14 @@ export const zh: Record<SmoothStreamLocaleKey, string> = {
   enabledHint: '由本插件渲染并跟随流式回复；关闭后使用 Harness 内置渲染。',
   controlScroll: '接管滚动',
   controlScrollHint: '默认开启，由丝滑流式写入会话滚动位置；关闭后贴底滚动交给 Harness。',
+  preset: '手感预设',
+  presetHint: '文字吐字节奏与视口跟随阻尼风格。',
+  presetRealtime: '激进快速 (realtime)',
+  presetRealtimeHint: '缓冲低、流速快，紧跟模型生成。',
+  presetBalanced: '均衡自然 (balanced)',
+  presetBalancedHint: '官方默认，平衡流速与节奏感。',
+  presetSilky: '极致丝滑 (silky)',
+  presetSilkyHint: '字符积压缓冲加大、阻尼更高、EMA 平滑度更好，视觉呼吸感最强。',
   motionPreference: '动效偏好',
   motionPreferenceHint: '流式渲染如何响应系统的「减少动态效果」设置。',
   motionAuto: '跟随系统',
@@ -138,6 +216,8 @@ export const zh: Record<SmoothStreamLocaleKey, string> = {
   motionForceReduced: '始终原始',
   motionForceReducedHint: '即使系统允许动效，也直接呈现原始文本。',
   thinkAutoExpand: '自动展开思考',
+  logarithmicFade: '对数淡入',
+  logarithmicFadeHint: '让回答正文和展开的思考文字由淡变实，遵循动效偏好。',
   thinkAutoExpandHint: '思考块在流式时自动展开；关闭后保持折叠，可手动展开。',
   debugEnabled: '显示渲染调试面板',
   debugEnabledHint: '在聊天右侧显示流式渲染和滚动的实时参数，可在面板中调节并在这里保存。',
@@ -170,6 +250,15 @@ export const zh: Record<SmoothStreamLocaleKey, string> = {
   debugReserve: '预留空间',
   debugCapacity: '安全容量',
   debugAppliedScale: '实际倍率',
+  debugTerminalPhase: '收尾阶段',
+  debugOwnedRunway: '实体留白',
+  debugTerminalBudget: '收尾预算',
+  debugBaselineShift: '基线位移',
+  debugAnchorDelta: '锚点位移',
+  debugPhaseLive: '流式中',
+  debugPhaseDrain: '收尾排空',
+  debugPhaseCascade: '宿主交接',
+  debugPhaseNatural: '自然态',
   debugRevealMultiplier: '揭示倍率',
   debugQueuePressure: '队列压力',
   debugMaxReveal: '最大揭示速度',
@@ -212,5 +301,6 @@ export const zh: Record<SmoothStreamLocaleKey, string> = {
 declare module '@deepseek-ai/dsh-client-ui-slots' {
   interface LocaleNamespaceMap {
     'settings.smoothStream': SmoothStreamLocaleKey
+    'smoothStream.chat': SmoothStreamChatKey
   }
 }

package/src/client/smooth-stream-card-controller.ts

@@ -7,6 +7,7 @@ import {
   type StreamDebugTuning,
   type StreamMotionPreference,
   type StreamSettings,
+  type StreamSmoothingPreset,
 } from '../settings.ts'
 import type {
   StreamDebugSettingsView,
@@ -24,8 +25,10 @@ export interface SmoothStreamCardState {
   failed: boolean
   enabled: boolean
   controlScroll: boolean
+  preset: StreamSmoothingPreset
   motionPreference: StreamMotionPreference
   thinkAutoExpand: boolean
+  logarithmicFade: boolean
   debugEnabled: boolean
   debugTuning: StreamDebugTuning
   debugAvailable: boolean
@@ -54,7 +57,7 @@ export class SmoothStreamCardController {
   private readonly store = createSnapshotStore<SmoothStreamCardState>(this.projection())
   private loaded: StreamSettingsView | undefined
   private loadedDebug: StreamDebugSettingsView | undefined
-  private stagedBase: Pick<StreamSettings, 'enabled' | 'controlScroll' | 'motionPreference' | 'thinkAutoExpand'> | undefined
+  private stagedBase: Pick<StreamSettings, 'enabled' | 'controlScroll' | 'preset' | 'motionPreference' | 'thinkAutoExpand' | 'logarithmicFade'> | undefined
   private stagedDebug: Pick<StreamSettings, 'debugEnabled' | 'debugTuning'> | undefined
   private saving = false
   private failed = false
@@ -92,13 +95,15 @@ export class SmoothStreamCardController {
       hooks: { smoothStreamCard: this.store },
       edit: (patch) => {
         if (this.saving) return
-        if (patch.enabled !== undefined || patch.controlScroll !== undefined || patch.motionPreference !== undefined || patch.thinkAutoExpand !== undefined) {
+        if (patch.enabled !== undefined || patch.controlScroll !== undefined || patch.preset !== undefined || patch.motionPreference !== undefined || patch.thinkAutoExpand !== undefined || patch.logarithmicFade !== undefined) {
           this.stagedBase = {
             ...this.baseValues(),
             ...(patch.enabled === undefined ? {} : { enabled: patch.enabled }),
             ...(patch.controlScroll === undefined ? {} : { controlScroll: patch.controlScroll }),
+            ...(patch.preset === undefined ? {} : { preset: patch.preset }),
             ...(patch.motionPreference === undefined ? {} : { motionPreference: patch.motionPreference }),
             ...(patch.thinkAutoExpand === undefined ? {} : { thinkAutoExpand: patch.thinkAutoExpand }),
+            ...(patch.logarithmicFade === undefined ? {} : { logarithmicFade: patch.logarithmicFade }),
           }
         }
         if (this.loadedDebug !== undefined && (patch.debugEnabled !== undefined || patch.debugTuning !== undefined)) {
@@ -143,12 +148,14 @@ export class SmoothStreamCardController {
     }
   }
 
-  private baseValues(): Pick<StreamSettings, 'enabled' | 'controlScroll' | 'motionPreference' | 'thinkAutoExpand'> {
+  private baseValues(): Pick<StreamSettings, 'enabled' | 'controlScroll' | 'preset' | 'motionPreference' | 'thinkAutoExpand' | 'logarithmicFade'> {
     return this.stagedBase ?? {
       enabled: this.loaded?.enabled ?? DEFAULT_STREAM_SETTINGS.enabled,
       controlScroll: this.loaded?.controlScroll ?? DEFAULT_STREAM_SETTINGS.controlScroll,
+      preset: this.loaded?.preset ?? DEFAULT_STREAM_SETTINGS.preset,
       motionPreference: this.loaded?.motionPreference ?? DEFAULT_STREAM_SETTINGS.motionPreference,
       thinkAutoExpand: this.loaded?.thinkAutoExpand ?? DEFAULT_STREAM_SETTINGS.thinkAutoExpand,
+      logarithmicFade: this.loaded?.logarithmicFade ?? DEFAULT_STREAM_SETTINGS.logarithmicFade,
     }
   }
 

package/src/client/smooth-stream-settings-api.ts

@@ -24,12 +24,14 @@ function settingsView(value: unknown): StreamSettingsView {
     || typeof data.writable !== 'boolean'
     || typeof data.enabled !== 'boolean'
     || typeof data.controlScroll !== 'boolean'
+    || (data.preset !== undefined && !['realtime', 'balanced', 'silky'].includes(data.preset as string))
     || !['auto', 'force-smooth', 'force-reduced'].includes(data.motionPreference as string)
     || typeof data.thinkAutoExpand !== 'boolean'
+    || (data.logarithmicFade !== undefined && typeof data.logarithmicFade !== 'boolean')
     || typeof data.canUpgrade !== 'boolean') {
     throw new Error('dsh-smooth-stream: malformed settings response')
   }
-  return data as unknown as StreamSettingsView
+  return { ...data, preset: (data.preset ?? 'balanced') as StreamSettingsView['preset'], logarithmicFade: data.logarithmicFade ?? true } as unknown as StreamSettingsView
 }
 
 function upgradeView(value: unknown): StreamUpgradeView {
@@ -69,7 +71,7 @@ function accepted(result: Awaited<ReturnType<ConnectionHandle['rpc']['call']>>):
 /** Narrow client contract consumed by the staged settings-card controller. */
 export interface SmoothStreamSettingsApi {
   read(): Promise<StreamSettingsView>
-  write(settings: Pick<StreamSettings, 'enabled' | 'controlScroll' | 'motionPreference' | 'thinkAutoExpand'> & Partial<Pick<StreamSettings, 'debugEnabled' | 'debugTuning'>>): Promise<StreamSettingsView>
+  write(settings: Pick<StreamSettings, 'enabled' | 'controlScroll' | 'motionPreference' | 'thinkAutoExpand' | 'logarithmicFade'> & Partial<Pick<StreamSettings, 'debugEnabled' | 'debugTuning'>>): Promise<StreamSettingsView>
   readDebug(): Promise<StreamDebugSettingsView>
   writeDebug(settings: Pick<StreamSettings, 'debugEnabled' | 'debugTuning'>): Promise<StreamDebugSettingsView>
   upgrade(): Promise<StreamUpgradeView>
@@ -81,15 +83,17 @@ export function createSmoothStreamSettingsApi(connection: ConnectionHandle): Smo
     async read(): Promise<StreamSettingsView> {
       return settingsView(accepted(await connection.rpc.call(STREAM_SETTINGS_RPC_CHANNEL, STREAM_SETTINGS_RPC.read, {})))
     },
-    async write(settings: Pick<StreamSettings, 'enabled' | 'controlScroll' | 'motionPreference' | 'thinkAutoExpand'> & Partial<Pick<StreamSettings, 'debugEnabled' | 'debugTuning'>>): Promise<StreamSettingsView> {
+    async write(settings: Pick<StreamSettings, 'enabled' | 'controlScroll' | 'preset' | 'motionPreference' | 'thinkAutoExpand' | 'logarithmicFade'> & Partial<Pick<StreamSettings, 'debugEnabled' | 'debugTuning'>>): Promise<StreamSettingsView> {
       return settingsView(accepted(await connection.rpc.call(
         STREAM_SETTINGS_RPC_CHANNEL,
         STREAM_SETTINGS_RPC.write,
         {
           enabled: settings.enabled,
           controlScroll: settings.controlScroll,
+          preset: settings.preset,
           motionPreference: settings.motionPreference,
           thinkAutoExpand: settings.thinkAutoExpand,
+          logarithmicFade: settings.logarithmicFade,
           ...(settings.debugEnabled === undefined || settings.debugTuning === undefined
             ? {}
             : { debugEnabled: settings.debugEnabled, debugTuning: settings.debugTuning }),