dsh-codinput 0.1.1 → 0.3.0

package/src/client/icons.tsx

@@ -27,18 +27,24 @@ function svg(paths: JSX.Element, size: number | undefined, className: string | u
   );
 }
 
-/** 品牌：lucide file-code-corner。 */
+/**
+ * 品牌图形：DSH-Codinput 机型标（代码括号 + 航迹斜杠 + 纸飞机）。
+ * 大尺寸原稿见 assets/icon.svg / icon-white.svg；这里是 24 栅格的
+ * 小尺寸简化——发卡弯并线、钩脚并入单笔括号，斜杠上收让出机鼻。
+ */
+const BRAND_MARK = (
+  <>
+    <path d="M6.8 5.8 2.9 11l4 4.4" />
+    <path d="M17.2 5.8 21.1 11l-3.9 4.4" />
+    <path d="M10.7 9.5 12.5 3.9" />
+    <path d="M16.6 9.4 6.9 14l2.9 1.3.1 2.5q.1.8.7.3l1-2.3 2.2 1.4Z" />
+    <path d="M9.8 15.3 16.6 9.4" />
+  </>
+);
+
+/** 品牌：DSH-Codinput 机型标（悬浮小球 / 侧栏唤回球）。 */
 export function IconBrand({ size, className }: IconProps): JSX.Element {
-  return svg(
-    <>
-      <path d="M4 12.15V4a2 2 0 0 1 2-2h8a2.4 2.4 0 0 1 1.706.706l3.588 3.588A2.4 2.4 0 0 1 20 8v12a2 2 0 0 1-2 2h-3.35" />
-      <path d="M14 2v5a1 1 0 0 0 1 1h5" />
-      <path d="m5 16-3 3 3 3" />
-      <path d="m9 22 3-3-3-3" />
-    </>,
-    size,
-    className,
-  );
+  return svg(BRAND_MARK, size, className);
 }
 
 export function IconEdit({ size, className }: IconProps): JSX.Element {
@@ -167,7 +173,7 @@ export function IconPlusOfficial({ size }: { size?: number }): JSX.Element {
   );
 }
 
-/** 官方 IconPaperclipOutline16（附件按钮；官方为 fill 路径自带描边轮廓，不得再叠 stroke）。 */
+/** 官方 IconPaperclipOutline16（slash 添加·文件 补位条目的 glyph；官方为 fill 路径自带描边轮廓）。 */
 export function IconPaperclipOfficial({ size }: { size?: number }): JSX.Element {
   return (
     <svg width={size ?? 14} height={size ?? 14} viewBox="0 0 16 16" fill="none" aria-hidden="true">
@@ -272,25 +278,25 @@ export function IconChevronOfficial({ size }: { size?: number }): JSX.Element {
 }
 
 /**
- * /codinput 命令图标（宿主命令菜单 glyph：文档+代码括号，fill
- * currentColor，与 primitives Icon*Outline16 同构——接受 size，命令
+ * /codinput 命令图标（宿主命令菜单 glyph：品牌机型标，stroke
+ * currentColor，与 primitives Icon*Outline16 同尺度——接受 size，命令
  * 菜单里按官方语义渲染为 <icon size={16}/>）。
  */
 export function IconCodinputCommand16({ size = 16, className }: { size?: number; className?: string }): JSX.Element {
   return (
-    <svg width={size} height={size} viewBox="0 0 24 24" fill="none" className={className} aria-hidden="true">
-      <path
-        fillRule="evenodd"
-        clipRule="evenodd"
-        d="M12.25 2.83422C11.7896 2.75598 11.162 2.75005 10.0298 2.75005C8.11311 2.75005 6.75075 2.75163 5.71785 2.88987C4.70596 3.0253 4.12453 3.27933 3.7019 3.70195C3.27869 4.12516 3.02502 4.70481 2.88976 5.7109C2.75159 6.73856 2.75 8.09323 2.75 10.0001V14.0001C2.75 15.9069 2.75159 17.2615 2.88976 18.2892C3.02502 19.2953 3.27869 19.8749 3.7019 20.2981C4.12511 20.7214 4.70476 20.975 5.71085 21.1103C6.73851 21.2485 8.09318 21.2501 10 21.2501H14C15.9068 21.2501 17.2615 21.2485 18.2892 21.1103C19.2952 20.975 19.8749 20.7214 20.2981 20.2981C20.7213 19.8749 20.975 19.2953 21.1102 18.2892C21.2484 17.2615 21.25 15.9069 21.25 14.0001V13.5629C21.25 12.0269 21.2392 11.2988 21.0762 10.7501H17.9463C16.8135 10.7501 15.8877 10.7501 15.1569 10.6518C14.3929 10.5491 13.7306 10.3268 13.2019 9.79815C12.6732 9.26945 12.4509 8.60712 12.3482 7.84317C12.25 7.1123 12.25 6.18657 12.25 5.05374V2.83422ZM13.75 3.6095V5.00005C13.75 6.19976 13.7516 7.0241 13.8348 7.64329C13.9152 8.24091 14.059 8.53395 14.2626 8.73749C14.4661 8.94103 14.7591 9.08486 15.3568 9.16521C15.976 9.24846 16.8003 9.25005 18 9.25005H20.0195C19.723 8.9625 19.3432 8.61797 18.85 8.17407L14.8912 4.61117C14.4058 4.17433 14.0446 3.85187 13.75 3.6095ZM10.1755 1.25002C11.5601 1.24965 12.4546 1.24942 13.2779 1.56535C14.1012 1.88129 14.7632 2.47735 15.7873 3.39955C15.8226 3.43139 15.8584 3.46361 15.8947 3.49623L19.8534 7.05912C19.8956 7.09705 19.9372 7.1345 19.9783 7.17149C21.162 8.23614 21.9274 8.92458 22.3391 9.84902C22.7508 10.7734 22.7505 11.8029 22.75 13.3949C22.75 13.4502 22.75 13.5062 22.75 13.5629V14.0565C22.75 15.8942 22.75 17.3499 22.5969 18.4891C22.4392 19.6615 22.1071 20.6104 21.3588 21.3588C20.6104 22.1072 19.6614 22.4393 18.489 22.5969C17.3498 22.7501 15.8942 22.7501 14.0564 22.7501H9.94359C8.10583 22.7501 6.65019 22.7501 5.51098 22.5969C4.33856 22.4393 3.38961 22.1072 2.64124 21.3588C1.89288 20.6104 1.56076 19.6615 1.40314 18.4891C1.24997 17.3499 1.24998 15.8942 1.25 14.0565V9.94363C1.24998 8.10587 1.24997 6.65024 1.40314 5.51103C1.56076 4.33861 1.89288 3.38966 2.64124 2.64129C3.39019 1.89235 4.34232 1.56059 5.51887 1.40313C6.66283 1.25002 8.1257 1.25003 9.97352 1.25005L10.0298 1.25005C10.0789 1.25005 10.1275 1.25004 10.1755 1.25002Z"
-        fill="currentColor"
-      />
-      <path
-        fillRule="evenodd"
-        clipRule="evenodd"
-        d="M10.2633 13.2978C10.6512 13.4432 10.8477 13.8756 10.7022 14.2634L9.20225 18.2634C9.05681 18.6512 8.6245 18.8477 8.23666 18.7023C7.84882 18.5569 7.65231 18.1245 7.79775 17.7367L9.29775 13.7367C9.44319 13.3489 9.8755 13.1524 10.2633 13.2978ZM7.53033 13.4697C7.82322 13.7626 7.82322 14.2375 7.53033 14.5304L7.06066 15L7.53033 15.4697C7.82322 15.7626 7.82322 16.2375 7.53033 16.5304C7.23744 16.8233 6.76256 16.8233 6.46967 16.5304L5.46967 15.5304C5.17678 15.2375 5.17678 14.7626 5.46967 14.4697L6.46967 13.4697C6.76256 13.1768 7.23744 13.1768 7.53033 13.4697ZM10.9697 15.4697C11.2626 15.1768 11.7374 15.1768 12.0303 15.4697L13.0303 16.4697C13.3232 16.7626 13.3232 17.2375 13.0303 17.5304L12.0303 18.5304C11.7374 18.8233 11.2626 18.8233 10.9697 18.5304C10.6768 18.2375 10.6768 17.7626 10.9697 17.4697L11.4393 17L10.9697 16.5304C10.6768 16.2375 10.6768 15.7626 10.9697 15.4697Z"
-        fill="currentColor"
-      />
+    <svg
+      width={size}
+      height={size}
+      viewBox="0 0 24 24"
+      fill="none"
+      stroke="currentColor"
+      strokeWidth={2}
+      strokeLinecap="round"
+      strokeLinejoin="round"
+      className={className}
+      aria-hidden="true"
+    >
+      {BRAND_MARK}
     </svg>
   );
 }

package/src/client/services.ts

@@ -10,11 +10,13 @@ import type {
   ModelDirectoriesFace,
   SessionsFace,
   SidebarRightFace,
+  SlotsService,
 } from './host-types';
 import { diagError, runGuarded } from './diag';
 import { installI18n } from './i18n';
 
 export interface ServiceStash {
+  slots?: SlotsService;
   conversation?: ConversationFace;
   sessions?: SessionsFace;
   commandUi?: CommandUiFace;
@@ -33,8 +35,11 @@ export function installServices(ctx: ClientContext): void {
   });
 
   // sessions / commandUi：被消费服务自身的 static inject 链由宿主装配。
+  // slots 一并取入 stash：语音按钮要检视 conversation.input.activity 槽位
+  // 条目（见 components/VoiceActivity）。
   runGuarded('stash.services', () => {
     ctx.inject(['slots', 'sessions', 'commandUi'], (scope: Record<string, unknown>) => {
+      stash.slots = scope['slots'] as SlotsService;
       stash.sessions = scope['sessions'] as SessionsFace;
       stash.commandUi = scope['commandUi'] as CommandUiFace;
     });

package/src/client/sidebar.tsx

@@ -6,13 +6,17 @@
  *
  * 唯一输入组件约定：body **挂载**期间经 sideinput 总线声明承载本会话
  * 输入（形态 = side），主输入遮蔽条目随之隐藏——收起侧栏不让位（可见性
- * 只用于判断「需不需要右上角小球唤出」）。标签关闭（body 卸载）后撤销
- * 声明，主输入原样恢复。
+ * 只用于判断「需不需要右上角小球唤出」）。声明以 prefs.enabled 为前提：
+ * 侧边模式下 /codinput 关闭接管即撤销声明、主输入回到官方输入框，标签
+ * 内只出提示；重新开启自动恢复。标签关闭（body 卸载）后撤销声明，主输入
+ * 原样恢复。
  */
 
 import { useEffect, useRef, useState } from 'react';
 import type { SessionStandard, SidebarTabInfo, SlotRegisterOptions } from './host-types';
-import { claimSidebarInput, useSidebarCarryOwner, type SidebarCarry } from './sideinput';
+import { claimSidebarInput, subscribeSidebarTabClose, useSidebarCarryOwner, type SidebarCarry } from './sideinput';
+import { loadPrefs, savePrefs, subscribePrefs } from './prefs';
+import { diagError, diagWindow } from './diag';
 import { CodinputSurface } from './components/CodinputSurface';
 import { t, useT } from './i18n';
 
@@ -26,6 +30,10 @@ export function sidebarTabDefinition(): Record<string, unknown> {
     kind: SIDEBAR_TAB_KIND,
     priority: 'extension',
     title: () => 'Codinput',
+    // 非激活也保持 body 挂载（官方浏览器标签同款开关）：承载声明挂在 body
+    // 生命周期上，若切到同栏其他标签（如工作区文件）body 被 dockkit 卸载，
+    // 声明随之消失、主输入回来——「标签存在即唯一输入入口」就不成立了。
+    keepMounted: true,
     guide: [
       {
         order: 0,
@@ -55,19 +63,62 @@ export function sidebarBodyRegistration(): { options: SlotRegisterOptions; compo
  * useTabInfo 内部订阅 dockkit store，展开/激活/浮动变化都会重渲染。
  */
 export function SidebarCodinputBody(props: SessionStandard & { useTabInfo?: () => SidebarTabInfo }): JSX.Element {
-  const { sessionId, useInput, inputActions, useProjection, useTabInfo } = props;
+  const { sessionId, useInput, inputActions, useProjection, useSession, useTabInfo } = props;
   const state = useInput((s) => s);
+  // 会话运行中：侧栏形态的主按钮同样变停止（官方同款）。
+  const running = useSession ? useSession((s: unknown) => (s as { running?: boolean } | undefined)?.running) === true : false;
   useT();
   // 注入 hook 的有无逐渲染稳定（渲染器 useMemo 绑定），条件调用合规。
   const info = useTabInfo ? useTabInfo() : undefined;
   const visible = info?.tab.visible === true;
   const expanded = info?.sidebar.expanded === true;
 
-  // 承载声明挂在 body 生命周期上（挂载即承载，与可见性无关）；可见性与
-  // 侧栏展开态随后续渲染实时上报（小球据此判断「已收起」）。
+  // /codinput 从侧栏退出 → 命令侧广播关闭请求，这里经 tab 域动作面的
+  // actions.close() 关掉自己的标签。关闭即卸载 body、撤销承载，主输入按
+  // 退出后的 prefs 恢复官方输入框。
+  const closeSelf = info?.tab.actions?.close;
+  const closeRef = useRef(closeSelf);
+  closeRef.current = closeSelf;
+  // 诊断：tabId/关闭面是否可得（宿主形状漂移时链路断在哪一目了然）。
+  useEffect(() => {
+    const shell = diagWindow().__dshCodinputShell;
+    shell['sidebar.tabId'] = info?.tab.id ?? 'none';
+    shell['sidebar.closeFace'] = closeSelf ? 'yes' : 'none';
+  }, [info, closeSelf]);
+  useEffect(() => {
+    return subscribeSidebarTabClose((requested) => {
+      if (requested !== sessionId || !closeRef.current) return;
+      try {
+        closeRef.current();
+      } catch (error) {
+        diagError('sidebar.closeTab', error);
+      }
+    });
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [sessionId]);
+
+  // 接管开关是承载的前提：侧边模式下输入 /codinput（或设置里关闭）要能
+  // 退回官方输入框——body 撤销承载声明（主输入位随之恢复），标签里只出
+  // 提示；重新开启后自动恢复侧栏形态。
+  const [enabled, setEnabled] = useState(() => loadPrefs().enabled);
+  useEffect(() => subscribePrefs(() => setEnabled(loadPrefs().enabled)), []);
+  // 打开标签即启用：body 挂载（首次激活/重载后激活/关掉重开）时若接管
+  // 未开，直接开启——用户点开这个标签就是要用它。body 在 keepMounted 下
+  // 常驻，/codinput 退出后不会重挂，不会把退出顶回去。
+  const bootRef = useRef(false);
+  useEffect(() => {
+    if (bootRef.current) return;
+    bootRef.current = true;
+    if (!loadPrefs().enabled) savePrefs({ enabled: true });
+  }, []);
+
+  // 承载声明挂在 body 生命周期上（挂载即承载，与可见性无关），但以
+  // enabled 为前提；可见性与侧栏展开态随后续渲染实时上报（小球据此
+  // 判断「已收起」）。
   const carryRef = useRef<SidebarCarry | null>(null);
   const [token, setToken] = useState(0);
   useEffect(() => {
+    if (!enabled) return;
     const carry = claimSidebarInput(sessionId, { visible, expanded });
     carryRef.current = carry;
     setToken(carry.token);
@@ -76,7 +127,7 @@ export function SidebarCodinputBody(props: SessionStandard & { useTabInfo?: () =
       carry.release();
     };
     // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, [sessionId]);
+  }, [sessionId, enabled]);
   useEffect(() => {
     carryRef.current?.set({ visible, expanded });
   }, [visible, expanded]);
@@ -84,6 +135,13 @@ export function SidebarCodinputBody(props: SessionStandard & { useTabInfo?: () =
   // 同一会话被复制出第二个 Codinput 标签（分栏）时，只有最早声明的 body
   // 渲染编辑面——输入入口唯一，另一个 body 出提示而不是第二个编辑器。
   const owner = useSidebarCarryOwner(sessionId, token);
+  if (!enabled) {
+    return (
+      <div className="dci-side-notice" role="note">
+        {t('side.disabled')}
+      </div>
+    );
+  }
   if (!owner) {
     return (
       <div className="dci-side-notice" role="note">
@@ -107,6 +165,7 @@ export function SidebarCodinputBody(props: SessionStandard & { useTabInfo?: () =
         state={state}
         actions={inputActions}
         useProjection={useProjection}
+        running={running}
         side={true}
       />
     </div>

package/src/client/sideinput.ts

@@ -21,7 +21,7 @@ export interface SidebarCarryState {
 }
 
 export interface SidebarCarry {
-  /** 本次承载的令牌（同会话多 body 时，最早的持令牌者渲染编辑面）。 */
+  /** 本次承载的令牌（同会话多 body 时，可见者优先、同可见最早者渲染编辑面）。 */
   readonly token: number;
   /** 可见性/展开态变化时更新（同一 body 生命周期内）。 */
   set(state: SidebarCarryState): void;
@@ -53,11 +53,12 @@ function recompute(): void {
   for (const [token, claim] of claims) {
     const prev = next.get(claim.sessionId);
     // 同一会话多 body（分栏里复制出第二个 Codinput 标签）时取「最可见」的一份，
-    // 编辑面归属最早声明者（owner），其余 body 只出提示，杜绝双编辑面。
+    // 编辑面归属可见者（owner 随 visible 走——否则编辑面会留在看不见的标签里，
+    // 正在看的标签只剩提示），同可见时归最早声明者，杜绝双编辑面。
     if (!prev) {
       next.set(claim.sessionId, { visible: claim.visible, expanded: claim.expanded, owner: token });
     } else if (!prev.visible && claim.visible) {
-      next.set(claim.sessionId, { ...prev, visible: true, expanded: claim.expanded });
+      next.set(claim.sessionId, { visible: true, expanded: claim.expanded, owner: token });
     }
   }
   if (sameSnapshot(next)) return;
@@ -93,6 +94,11 @@ export function isSidebarInputCarried(sessionId: string | undefined): boolean {
   return sessionId !== undefined && snapshot.has(sessionId);
 }
 
+/** 当前被侧栏承载的会话 id 列表（/codinput 退出时广播关闭标签用）。 */
+export function carriedSessionIds(): string[] {
+  return [...snapshot.keys()];
+}
+
 /** 任一会话被侧栏承载（主遮蔽条目需保持挂载以执行隐藏）。 */
 export function isAnySidebarInputCarried(): boolean {
   return snapshot.size > 0;
@@ -105,14 +111,30 @@ export function sidebarCarryState(sessionId: string | undefined): SidebarCarrySt
 
 /**
  * 编辑面归属：同会话被多个 body 承载（分栏里复制出第二个 Codinput 标签）时，
- * 只有最早声明者渲染编辑面。`token === 0`（尚未声明）一律返回 true——避免
- * 首帧把还没拿到令牌的自己判成非归属者。
+ * 可见者优先，同可见归最早声明者。`token === 0`（尚未声明）一律返回 true——
+ * 避免首帧把还没拿到令牌的自己判成非归属者。
  */
 export function isSidebarCarryOwner(sessionId: string | undefined, token: number): boolean {
   if (token === 0 || sessionId === undefined) return true;
   return snapshot.get(sessionId)?.owner === token;
 }
 
+
+/** 标签关闭请求总线：/codinput 从侧栏退出时，命令侧请求 body 关掉自己的标签。 */
+const tabCloseListeners = new Set<(sessionId: string) => void>();
+
+/** 请求关闭某会话的侧栏 Codinput 标签（无 body 在听时无害）。 */
+export function requestSidebarTabClose(sessionId: string): void {
+  for (const fn of tabCloseListeners) fn(sessionId);
+}
+
+export function subscribeSidebarTabClose(fn: (sessionId: string) => void): () => void {
+  tabCloseListeners.add(fn);
+  return () => {
+    tabCloseListeners.delete(fn);
+  };
+}
+
 /** 归属订阅（body 用）：令牌变化、其他 body 挂载/卸载都会重渲染。 */
 export function useSidebarCarryOwner(sessionId: string | undefined, token: number): boolean {
   const [owner, setOwner] = useState(() => isSidebarCarryOwner(sessionId, token));
@@ -150,12 +172,16 @@ export function useSidebarInputCarried(sessionId: string | undefined): boolean {
 
 /**
  * 侧栏承载态订阅（小球用）：`carried` = 本会话输入在侧栏里，
- * `collapsed` = 侧栏已收起（承载但不可见 → 输入入口需要小球唤出）。
+ * `collapsed` = 输入面不可见（承载但侧栏已收起 → 输入入口需要小球唤出）。
+ * 浮动面板 visible=true——输入就在眼前，即使侧栏恰好收起也不出球。
  */
 export function useSidebarCarry(sessionId: string | undefined): { carried: boolean; collapsed: boolean } {
   const read = (): { carried: boolean; collapsed: boolean } => {
     const state = sidebarCarryState(sessionId);
-    return { carried: state !== undefined, collapsed: state !== undefined && state.expanded === false };
+    return {
+      carried: state !== undefined,
+      collapsed: state !== undefined && state.expanded === false && state.visible === false,
+    };
   };
   const [value, setValue] = useState(read);
   useEffect(() => {

package/src/client/stats.ts

@@ -1,8 +1,8 @@
 /**
- * 数据行数据源（卡片下方）：会话统计投影探测 + 归一化。
- * 官方投影键（实测确认）：tokenUsage（cacheRead/cacheWrite/output/
- * uncachedInput）、contextPressure（contextWindow/pressureTokens/
- * projectedTokens）；轮/步按别名键探测。tok/s 为输出令牌的实时采样速率。
+ * 数据行数据源（卡片下方）：逐值复刻官方 StatsPills 的取数与计算——
+ * `sessionStats` 投影优先（turns/steps/llm/tool/ttft/decode 全量），缺席时
+ * 从 chat legacy 节点按官方 deriveStats 派生；tok/s = decodeTokens ÷
+ * decodeMs（会话级持久值，非流式采样），缓存命中/用量分桶同官方公式。
  * 注意：useProjection 是真实 hook，键探测必须是固定次数的顶层调用。
  */
 
@@ -19,18 +19,24 @@ const PROJECTION_KEYS = [
 export interface SessionStats {
   turns?: number;
   steps?: number;
-  /** 实时输出速率（tok/s），运行期间采样更新，空闲时保留最后一次。 */
+  /** 输出速度（tok/s）= decodeTokens ÷ (decodeMs/1000)；decodeMs>0 才有。 */
   tokensPerSecond?: number;
   totalTokens?: number;
-  cacheHitPct?: number;
+  /** 官方 formatCacheHitPercent 文本（"88"/"99.9"/"100"）。 */
+  cacheHitText?: string;
   /** 上下文占用百分比（projectedTokens ?? pressureTokens，除以 contextWindow）。 */
   contextPct?: number;
-  /** 会话统计面板：模型用时（流式活跃累计毫秒）与首 token 延迟。 */
-  modelMs?: number;
+  /** 会话统计面板：模型用时 / 工具调用用时 / TTFT 均值（官方格式化）。 */
+  llmMs?: number;
+  toolMs?: number;
   ttftMs?: number;
-  /** Token 用量面板：原始分段。 */
+  ttftSteps?: number;
+  decodeMs?: number;
+  decodeTokens?: number;
+  /** Token 用量面板：原始分桶。 */
   uncachedInputTokens?: number;
   cacheReadTokens?: number;
+  cacheWriteTokens?: number;
   outputTokens?: number;
 }
 
@@ -47,6 +53,18 @@ interface ContextPressure {
   projectedTokens?: number;
 }
 
+/** 官方 sessionStats 投影/deriveStats 的输出形状。 */
+interface ChatStats {
+  turns?: number;
+  steps?: number;
+  llmMs?: number;
+  toolMs?: number;
+  ttftMs?: number;
+  ttftSteps?: number;
+  decodeMs?: number;
+  decodeTokens?: number;
+}
+
 function num(value: unknown): number | undefined {
   return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
 }
@@ -74,47 +92,105 @@ function readContextPressure(raw: unknown): ContextPressure | undefined {
   return cp.contextWindow !== undefined && cp.pressureTokens !== undefined ? cp : undefined;
 }
 
-function readTurnsSteps(raw: unknown): { turns?: number; steps?: number } {
-  if (!raw || typeof raw !== 'object') return {};
+function readSessionStats(raw: unknown): ChatStats | undefined {
+  if (!raw || typeof raw !== 'object') return undefined;
   const r = raw as Record<string, unknown>;
-  const turns = num(r['turns']) ?? num(r['turnCount']);
-  const steps = num(r['steps']) ?? num(r['stepCount']);
-  return { turns, steps };
+  const stats: ChatStats = {
+    turns: num(r['turns']),
+    steps: num(r['steps']),
+    llmMs: num(r['llmMs']),
+    toolMs: num(r['toolMs']),
+    ttftMs: num(r['ttftMs']),
+    ttftSteps: num(r['ttftSteps']),
+    decodeMs: num(r['decodeMs']),
+    decodeTokens: num(r['decodeTokens']),
+  };
+  return Object.values(stats).some((v) => v !== undefined) ? stats : undefined;
 }
 
-/** 实时速率与用时采样：模块级（按 sessionId 记录上次输出令牌数与时刻）。 */
-const rateSamples = new Map<string, { tokens: number; time: number; rate?: number; modelMs: number }>();
-
-export function sampleTokensPerSecond(
-  sessionId: string | undefined,
-  outputTokens: number | undefined,
-): { rate?: number; modelMs?: number; ttftMs?: number } {
-  if (!sessionId || outputTokens === undefined) return {};
-  const now = Date.now();
-  const last = rateSamples.get(sessionId);
-  let rate: number | undefined = last?.rate;
-  let modelMs = last?.modelMs ?? 0;
-  let ttftMs: number | undefined;
-  if (!last) {
-    // 首个样本：无从计算速率；当前值即初始输出。
-    rateSamples.set(sessionId, { tokens: outputTokens, time: now, modelMs: 0 });
-    return {};
+/**
+ * 官方 deriveStats 逐行复刻：assistant 节点计轮/步并带 timing（stepStartTime
+ * →firstTokenTime→completedTime）与 usage.outputTokens；tool-result 以
+ * callTime 起算工具用时。
+ */
+export function deriveChatStats(nodes: unknown): ChatStats | undefined {
+  if (!Array.isArray(nodes)) return undefined;
+  const turns = new Set<unknown>();
+  let steps = 0;
+  let llmMs = 0;
+  let toolMs = 0;
+  let ttftMs = 0;
+  let ttftSteps = 0;
+  let decodeMs = 0;
+  let decodeTokens = 0;
+  for (const raw of nodes) {
+    if (!raw || typeof raw !== 'object') continue;
+    const node = raw as Record<string, unknown>;
+    if (node['kind'] === 'tool-result') {
+      const callTime = num(node['callTime']);
+      const time = num(node['time']);
+      if (callTime !== undefined && time !== undefined) toolMs += Math.max(0, time - callTime);
+      continue;
+    }
+    if (node['kind'] !== 'assistant') continue;
+    turns.add(node['turn']);
+    steps += 1;
+    const timing = node['timing'] as Record<string, unknown> | undefined;
+    const stepStartTime = num(timing?.['stepStartTime']);
+    const firstTokenTime = num(timing?.['firstTokenTime']);
+    const completedTime = num(timing?.['completedTime']);
+    if (stepStartTime !== undefined && completedTime !== undefined) {
+      llmMs += Math.max(0, completedTime - stepStartTime);
+    }
+    if (stepStartTime !== undefined && firstTokenTime !== undefined) {
+      ttftMs += Math.max(0, firstTokenTime - stepStartTime);
+      ttftSteps += 1;
+    }
+    if (firstTokenTime !== undefined && completedTime !== undefined) {
+      decodeMs += Math.max(0, completedTime - firstTokenTime);
+    }
+    const usage = node['usage'] as Record<string, unknown> | undefined;
+    const out = num(usage?.['outputTokens']);
+    if (out !== undefined && out >= 0) decodeTokens += out;
   }
-  const dt = now - last.time;
-  if (outputTokens > last.tokens && dt > 0) {
-    rate = ((outputTokens - last.tokens) / dt) * 1000;
-    modelMs += dt;
-    // 空闲较久后恢复增长：这段等待近似 TTFT。
-    if (dt > 600) ttftMs = dt;
+  if (nodes.length === 0) return undefined;
+  return { turns: turns.size, steps, llmMs, toolMs, ttftMs, ttftSteps, decodeMs, decodeTokens };
+}
+
+/** 官方 formatTokensPerSecond：≥10 取整，<10 保留 1 位小数。 */
+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);
+}
+
+/**
+ * 官方 formatCacheHitPercent 语义：整除 100 → "100"；整数舍入 <100 → 整数；
+ * 否则递增小数位直到舍入仍 <100（99.9 / 99.99 …）。
+ */
+export function formatCacheHitPercent(cacheReadTokens: number, promptTokens: number): string | null {
+  if (promptTokens <= 0) return null;
+  if (cacheReadTokens >= promptTokens) return '100';
+  for (let places = 0; places < 20; places++) {
+    const factor = 10 ** places;
+    const rounded = Math.round((cacheReadTokens / promptTokens) * 100 * factor) / factor;
+    if (rounded < 100) return places === 0 ? String(rounded) : rounded.toFixed(places);
   }
-  rateSamples.set(sessionId, { tokens: outputTokens, time: now, rate, modelMs });
-  return { rate, modelMs, ttftMs };
+  return '99.99';
+}
+
+/** 官方 formatDuration：<60s 一位小数秒，否则 分+秒。 */
+export function formatDuration(ms: number): string {
+  const s = ms / 1000;
+  if (s < 60) return `${Math.round(s * 10) / 10}s`;
+  const whole = Math.round(s);
+  return `${Math.floor(whole / 60)}分${whole % 60}秒`;
 }
 
 /** 每个键一个固定位置的 hook 调用——跨渲染的调用次数与顺序恒定。 */
 export function useSessionStats(
   useProjection: UseProjection | undefined,
   sessionId: string | undefined,
+  chatNodes: unknown,
 ): SessionStats | null {
   const k0 = useProjection ? useProjection(PROJECTION_KEYS[0]) : undefined;
   const k1 = useProjection ? useProjection(PROJECTION_KEYS[1]) : undefined;
@@ -124,14 +200,25 @@ export function useSessionStats(
 
   const usage = readTokenUsage(k0);
   const pressure = readContextPressure(k1);
-  const { turns, steps } = readTurnsSteps(k2) ?? {};
-  const alt = readTurnsSteps(k3) ?? {};
-  const alt2 = readTurnsSteps(k4) ?? {};
+  // 官方：sessionStats 投影优先，缺席从 chat legacy 节点派生。
+  const chat = readSessionStats(k4) ?? deriveChatStats(chatNodes) ?? readTurnsSteps(k2, k3);
 
   const stats: SessionStats = {};
-  if (turns !== undefined || steps !== undefined) Object.assign(stats, { turns, steps });
-  else if (alt.turns !== undefined || alt.steps !== undefined) Object.assign(stats, alt);
-  else if (alt2.turns !== undefined || alt2.steps !== undefined) Object.assign(stats, alt2);
+  if (chat) {
+    if (chat.turns !== undefined || chat.steps !== undefined) {
+      stats.turns = chat.turns;
+      stats.steps = chat.steps;
+    }
+    if (chat.llmMs !== undefined) stats.llmMs = chat.llmMs;
+    if (chat.toolMs !== undefined) stats.toolMs = chat.toolMs;
+    if (chat.ttftMs !== undefined) stats.ttftMs = chat.ttftMs;
+    if (chat.ttftSteps !== undefined) stats.ttftSteps = chat.ttftSteps;
+    if (chat.decodeMs !== undefined) stats.decodeMs = chat.decodeMs;
+    if (chat.decodeTokens !== undefined) stats.decodeTokens = chat.decodeTokens;
+    if ((chat.decodeMs ?? 0) > 0) {
+      stats.tokensPerSecond = (chat.decodeTokens ?? 0) / (chat.decodeMs! / 1000);
+    }
+  }
   if (usage) {
     const total =
       (usage.cacheReadTokens ?? 0) +
@@ -142,14 +229,15 @@ export function useSessionStats(
       stats.totalTokens = total;
       stats.uncachedInputTokens = usage.uncachedInputTokens;
       stats.cacheReadTokens = usage.cacheReadTokens;
+      stats.cacheWriteTokens = usage.cacheWriteTokens;
       stats.outputTokens = usage.outputTokens;
     }
+    // 官方：分母 = 三段输入桶（缓存读+写+未缓存输入）。
     const inputTotal = (usage.cacheReadTokens ?? 0) + (usage.cacheWriteTokens ?? 0) + (usage.uncachedInputTokens ?? 0);
-    if (inputTotal > 0) stats.cacheHitPct = ((usage.cacheReadTokens ?? 0) / inputTotal) * 100;
-    const sample = sampleTokensPerSecond(sessionId, usage.outputTokens);
-    if (sample.rate !== undefined && sample.rate > 0) stats.tokensPerSecond = sample.rate;
-    if (sample.modelMs !== undefined && sample.modelMs > 0) stats.modelMs = sample.modelMs;
-    if (sample.ttftMs !== undefined && sample.ttftMs > 0) stats.ttftMs = sample.ttftMs;
+    if (inputTotal > 0) {
+      const text = formatCacheHitPercent(usage.cacheReadTokens ?? 0, inputTotal);
+      if (text !== null) stats.cacheHitText = text;
+    }
   }
   const window_ = pressure?.contextWindow;
   // 官方 contextOccupancy：优先 projectedTokens。
@@ -157,11 +245,26 @@ export function useSessionStats(
   if (window_ !== undefined && window_ > 0 && used !== undefined) {
     stats.contextPct = (used / window_) * 100;
   }
+  void sessionId;
   return Object.keys(stats).length > 0 ? stats : null;
 }
 
+function readTurnsSteps(k2: unknown, k3: unknown): ChatStats | undefined {
+  const pick = (raw: unknown): ChatStats | undefined => {
+    if (!raw || typeof raw !== 'object') return undefined;
+    const r = raw as Record<string, unknown>;
+    const turns = num(r['turns']) ?? num(r['turnCount']);
+    const steps = num(r['steps']) ?? num(r['stepCount']);
+    return turns !== undefined || steps !== undefined ? { turns, steps } : undefined;
+  };
+  return pick(k2) ?? pick(k3);
+}
+
+/** 官方 formatTokens：<1e3 原值，否则 K/M（≥100 取整、<100 一位小数）。 */
 export function formatTokens(tokens: number): string {
-  if (tokens >= 1_000_000) return `${(tokens / 1_000_000).toFixed(tokens % 1_000_000 === 0 ? 0 : 1)}M tok`;
-  if (tokens >= 1_000) return `${(tokens / 1_000).toFixed(tokens % 1_000 === 0 ? 0 : 1)}K tok`;
-  return `${tokens} tok`;
+  const scaled = (candidate: number): string =>
+    candidate >= 100 ? String(Math.round(candidate)) : String(Math.round(candidate * 10) / 10);
+  if (tokens < 1e3) return `${tokens} tok`;
+  if (tokens < 1e6) return `${scaled(tokens / 1e3)}K tok`;
+  return `${scaled(tokens / 1e6)}M tok`;
 }