dsh-codinput 0.1.1 → 0.2.0

package/src/client/components/StatsRow.tsx

@@ -4,15 +4,15 @@
  * 点外关闭。 */
 
 import { useEffect, useRef, useState } from 'react';
-import { useSessionStats, formatTokens, type SessionStats } from '../stats';
+import { useSessionStats, formatTokens, formatTokensPerSecond, formatCacheHitPercent, formatDuration, type SessionStats } from '../stats';
 import type { UseProjection } from '../host-types';
 import { t } from '../i18n';
 
 export interface StatsRowProps {
   useProjection: UseProjection | undefined;
   sessionId: string | undefined;
-  /** chat 树解析的轮次计时（模型用时 / TTFT）。 */
-  chatTimings?: { modelMs?: number; ttftMs?: number };
+  /** chat legacy 节点数组（sessionStats 投影缺席时按官方 deriveStats 派生）。 */
+  chatNodes?: unknown;
 }
 
 /** 官方仪表盘 glyph（弧 + 指针 + 中点，stroke 1.25）。 */
@@ -67,17 +67,44 @@ function StatPanel(props: {
   );
 }
 
+/** 官方 exactCount：千分位分组 + " tok"。 */
+function exactCount(value: number | undefined): string {
+  const digits = String(value ?? 0);
+  const groups: string[] = [];
+  for (let end = digits.length; end > 0; end -= 3) groups.unshift(digits.slice(Math.max(0, end - 3), end));
+  return `${groups.join(',')} tok`;
+}
+
+/** 官方 TimePill：轮/步 + · tok/s（decodeMs>0 才出），面板 = 模型/工具用时、TTFT 均值、TPS。 */
 function Pill(props: { stats: SessionStats; open: boolean; onToggle(): void }): JSX.Element {
   const { stats, open, onToggle } = props;
-  const roundsPart =
-    stats.turns !== undefined && stats.steps !== undefined
-      ? t('stats.turns', { turns: stats.turns, steps: stats.steps })
-      : stats.turns !== undefined
-        ? t('stats.turns', { turns: stats.turns, steps: 0 })
-        : t('stats.turns', { turns: 0, steps: 0 });
-  const speedPart = stats.tokensPerSecond !== undefined ? `${Math.round(stats.tokensPerSecond)} tok/s` : null;
-  const modelSec = stats.modelMs !== undefined ? stats.modelMs / 1000 : null;
-  const ttftSec = stats.ttftMs !== undefined ? stats.ttftMs / 1000 : null;
+  const roundsPart = t('stats.turns', { turns: stats.turns ?? 0, steps: stats.steps ?? 0 });
+  const tps =
+    (stats.decodeMs ?? 0) > 0 ? formatTokensPerSecond((stats.decodeTokens ?? 0) / ((stats.decodeMs ?? 1) / 1000)) : null;
+  const hasTimings =
+    (stats.llmMs ?? 0) > 0 || (stats.toolMs ?? 0) > 0 || (stats.ttftSteps ?? 0) > 0 || (stats.decodeMs ?? 0) > 0;
+  const label = (
+    <span className="dci-stat-label">
+      {roundsPart}
+      {tps !== null ? (
+        <>
+          <span className="dci-stat-sep" aria-hidden="true">·</span>
+          {t('stats.tps', { tps })}
+        </>
+      ) : null}
+    </span>
+  );
+  // 官方：无任何计时数据时胶囊不可点（无面板可看）。
+  if (!hasTimings) {
+    return (
+      <span className="dci-stat-anchor">
+        <span className="dci-stat-pill">
+          <GaugeIcon />
+          {label}
+        </span>
+      </span>
+    );
+  }
   return (
     <span className="dci-stat-anchor">
       <button
@@ -85,27 +112,26 @@ function Pill(props: { stats: SessionStats; open: boolean; onToggle(): void }):
         className="dci-stat-pill"
         aria-haspopup="dialog"
         aria-expanded={open}
+        aria-label={tps !== null ? `${roundsPart} · ${t('stats.tps', { tps })}` : roundsPart}
         onClick={onToggle}
       >
         <GaugeIcon />
-        <span className="dci-stat-label">
-          {roundsPart}
-          {speedPart !== null ? (
-            <>
-              <span className="dci-stat-sep" aria-hidden="true">·</span>
-              {speedPart}
-            </>
-          ) : null}
-        </span>
+        {label}
       </button>
       {open ? (
         <StatPanel
           label={t("stats.session")}
           icon={<GaugeIcon />}
           rows={[
-            [t('stats.modelTime'), modelSec !== null ? `${modelSec.toFixed(1)}s` : '—'],
-            [t('stats.ttft'), ttftSec !== null ? `${ttftSec.toFixed(1)}s` : '—'],
-            [t('stats.tpsLabel'), speedPart ?? '—'],
+            [t('stats.modelTime'), (stats.llmMs ?? 0) > 0 ? formatDuration(stats.llmMs!) : '—'],
+            [t('stats.toolTime'), (stats.toolMs ?? 0) > 0 ? formatDuration(stats.toolMs!) : '—'],
+            [t('stats.ttft'), (stats.ttftSteps ?? 0) > 0 ? formatDuration(stats.ttftMs! / stats.ttftSteps!) : '—'],
+            [
+              t('stats.tpsLabel'),
+              (stats.decodeMs ?? 0) > 0
+                ? t('stats.tps', { tps: formatTokensPerSecond((stats.decodeTokens ?? 0) / ((stats.decodeMs ?? 1) / 1000)) })
+                : '—',
+            ],
           ]}
         />
       ) : null}
@@ -113,10 +139,17 @@ function Pill(props: { stats: SessionStats; open: boolean; onToggle(): void }):
   );
 }
 
+/** 官方 UsagePill：总量 · 缓存命中（缓存命中用官方百分比精度规则）。 */
 function TokenPill(props: { stats: SessionStats; open: boolean; onToggle(): void }): JSX.Element | null {
   const { stats, open, onToggle } = props;
   if (stats.totalTokens === undefined) return null;
-  const comma = (n: number): string => Math.round(n).toLocaleString('en-US');
+  const total = stats.totalTokens;
+  const cacheHitText =
+    stats.cacheHitText ??
+    formatCacheHitPercent(
+      stats.cacheReadTokens ?? 0,
+      (stats.cacheReadTokens ?? 0) + (stats.cacheWriteTokens ?? 0) + (stats.uncachedInputTokens ?? 0),
+    );
   return (
     <span className="dci-stat-anchor">
       <button
@@ -124,15 +157,20 @@ function TokenPill(props: { stats: SessionStats; open: boolean; onToggle(): void
         className="dci-stat-pill"
         aria-haspopup="dialog"
         aria-expanded={open}
+        aria-label={
+          cacheHitText !== null
+            ? `${formatTokens(total)} · ${t('stats.cacheHit', { percent: cacheHitText })}`
+            : formatTokens(total)
+        }
         onClick={onToggle}
       >
         <DatabaseIcon />
         <span className="dci-stat-label">
-          {formatTokens(stats.totalTokens)}
-          {stats.cacheHitPct !== undefined ? (
+          {formatTokens(total)}
+          {cacheHitText !== null ? (
             <>
               <span className="dci-stat-sep" aria-hidden="true">·</span>
-              缓存命中 {Math.round(stats.cacheHitPct)}%
+              {t('stats.cacheHit', { percent: cacheHitText })}
             </>
           ) : null}
         </span>
@@ -141,12 +179,15 @@ function TokenPill(props: { stats: SessionStats; open: boolean; onToggle(): void
         <StatPanel
           label={t("stats.usage")}
           icon={<DatabaseIcon />}
-          titleValue={`${comma(stats.totalTokens)} tok`}
+          titleValue={exactCount(total)}
           rows={[
-            [t('stats.cacheHitLabel'), stats.cacheHitPct !== undefined ? `${Math.round(stats.cacheHitPct)}%` : '—'],
-            [t('stats.uncached'), `${comma(stats.uncachedInputTokens ?? 0)} tok`],
-            [t('stats.cacheRead'), `${comma(stats.cacheReadTokens ?? 0)} tok`],
-            [t('stats.output'), `${comma(stats.outputTokens ?? 0)} tok`],
+            [t('stats.cacheHitLabel'), cacheHitText !== null ? `${cacheHitText}%` : '—'],
+            [t('stats.uncached'), exactCount(stats.uncachedInputTokens)],
+            [t('stats.cacheRead'), exactCount(stats.cacheReadTokens)],
+            ...(stats.cacheWriteTokens
+              ? [[t('stats.cacheWrite'), exactCount(stats.cacheWriteTokens)] as [string, string]]
+              : []),
+            [t('stats.output'), exactCount(stats.outputTokens)],
           ]}
         />
       ) : null}
@@ -155,18 +196,10 @@ function TokenPill(props: { stats: SessionStats; open: boolean; onToggle(): void
 }
 
 export function StatsRow(props: StatsRowProps): JSX.Element | null {
-  const { useProjection, sessionId, chatTimings } = props;
+  const { useProjection, sessionId, chatNodes } = props;
   const [open, setOpen] = useState<'rounds' | 'tokens' | null>(null);
   const rootRef = useRef<HTMLDivElement | null>(null);
-  const sampled = useSessionStats(useProjection, sessionId);
-  // chat 树计时优先（历史会话也有值），采样值兜底。
-  const stats = sampled
-    ? {
-        ...sampled,
-        ...(chatTimings?.modelMs !== undefined ? { modelMs: chatTimings.modelMs } : {}),
-        ...(chatTimings?.ttftMs !== undefined ? { ttftMs: chatTimings.ttftMs } : {}),
-      }
-    : sampled;
+  const stats = useSessionStats(useProjection, sessionId, chatNodes);
 
   // 点外面关闭（面板内/胶囊上不关）。
   useEffect(() => {

package/src/client/components/Toolbar.tsx

@@ -1,21 +1,18 @@
 /**
  * 工具行：结构与样式逐条对齐官方 InputBar 工具行——
- * 左侧 .dci-tools：指令（plus）、添加附件（paperclip）、权限（shield 触发器）；
+ * 左侧 .dci-tools：指令（plus）、权限（shield 触发器）；
  * 右侧 .dci-trailing：模型与思考强度（触发器）、发送（.primary 圆钮）。
  * 按钮沿用官方 keepFocus 语义（mousedown 不夺走编辑器焦点）。
+ * 附件无独立按钮（官方已并入 slash「添加 · 文件」），粘贴/拖拽路径保留。
  * 0.1.7-rc.2 起官方上下文小圈不再在工具行（挪进卡片下方 dock 行，见 StatsRow）。
  */
 
-import { useRef } from 'react';
 import type { DraftAttachmentId, InputActions, InputState, InputTriggerController, UseProjection } from '../host-types';
 import { openCommandMenu } from '../triggers';
-import { stash } from '../services';
-import { addFilesToDraft } from '../attachments';
 import { t, useT } from '../i18n';
-import { IconPaperclipOfficial, IconPlusOfficial, IconSendOfficial } from '../icons';
+import { IconPlusOfficial, IconSendOfficial, IconStopOfficial } from '../icons';
 import { ModelMenu } from './ModelMenu';
 import { PermissionMenu } from './PermissionMenu';
-import { useSnapshot } from './useSnapshot';
 
 export interface ToolbarProps {
   sessionId: string | undefined;
@@ -31,6 +28,10 @@ export interface ToolbarProps {
   /** 主发送手势（与编辑器发送键同一策略）。 */
   onSend(): void;
   sendDisabled?: boolean;
+  /** 会话运行中且草稿空（官方 primaryStops）：主按钮变停止。 */
+  primaryStops?: boolean;
+  /** 停止生成（官方 stop：conversation.cancel）。 */
+  onStop?(): void;
 }
 
 /** 官方 keepFocus：mousedown 阻止默认，避免编辑器失焦。 */
@@ -41,7 +42,6 @@ function keepFocus(event: React.MouseEvent): void {
 export function Toolbar(props: ToolbarProps): JSX.Element {
   const { sessionId, state, actions, triggers, caretRef, useProjection, disabled, onNotify } = props;
   useT();
-  const fileRef = useRef<HTMLInputElement | null>(null);
 
   const attachments: readonly DraftAttachmentId[] = state?.attachmentIds ?? [];
 
@@ -50,10 +50,6 @@ export function Toolbar(props: ToolbarProps): JSX.Element {
     openCommandMenu(triggers, undefined, caretRef.current ?? 0);
   };
 
-  const onAttach = (files: FileList | null): void => {
-    addFilesToDraft(sessionId, actions, files, onNotify);
-  };
-
   return (
     <div className="dci-row">
       <div className="dci-tools">
@@ -69,26 +65,6 @@ export function Toolbar(props: ToolbarProps): JSX.Element {
         >
           <IconPlusOfficial size={14} />
         </button>
-        <button
-          type="button"
-          className="dci-add"
-          aria-label={t("tool.attach")}
-          title={t("tool.attach")}
-          onMouseDown={keepFocus}
-          onClick={() => fileRef.current?.click()}
-        >
-          <IconPaperclipOfficial size={14} />
-        </button>
-        <input
-          ref={fileRef}
-          type="file"
-          multiple
-          hidden
-          onChange={(e) => {
-            onAttach(e.target.files);
-            e.target.value = '';
-          }}
-        />
         <PermissionMenu
           sessionId={sessionId}
           actions={actions}
@@ -106,13 +82,13 @@ export function Toolbar(props: ToolbarProps): JSX.Element {
         <button
           type="button"
           className="dci-send"
-          aria-label={t("tool.send")}
-          title={t("tool.send")}
-          disabled={props.sendDisabled}
+          aria-label={props.primaryStops ? t('tool.stop') : t('tool.send')}
+          title={props.primaryStops ? t('tool.stop') : t('tool.send')}
+          disabled={props.primaryStops ? !props.onStop : props.sendDisabled}
           onMouseDown={keepFocus}
-          onClick={() => props.onSend()}
+          onClick={() => (props.primaryStops ? props.onStop?.() : props.onSend())}
         >
-          <IconSendOfficial size={16} />
+          {props.primaryStops ? <IconStopOfficial size={16} /> : <IconSendOfficial size={16} />}
         </button>
       </div>
     </div>

package/src/client/host-types.ts

@@ -324,5 +324,10 @@ export interface SettingsSectionProps {
  */
 export interface SidebarTabInfo {
   readonly sidebar: { readonly expanded: boolean; readonly fullscreen: boolean };
-  readonly tab: { readonly visible: boolean };
+  readonly tab: {
+    readonly visible: boolean;
+    readonly id?: string;
+    /** tab 域动作面（occurrence held）：close() 关闭本标签。 */
+    readonly actions?: { readonly close?: () => void };
+  };
 }

package/src/client/i18n.ts

@@ -27,7 +27,6 @@ const ZH: Dict = {
   'editor.placeholder': '描述你想要构建的内容，/ 调用指令，@ 文件或对话',
   'preview.empty': '暂无可预览内容',
   'tool.command': '指令（/）',
-  'tool.attach': '添加附件',
   'tool.send': '发送',
   'tool.model': '选择模型，当前 {name}',
   'tool.modelPlain': '选择模型',
@@ -47,6 +46,7 @@ const ZH: Dict = {
   'stats.turns': '{turns} 轮 {steps} 步',
   'stats.tps': '{tps} tok/s',
   'stats.modelTime': '模型用时',
+  'stats.toolTime': '工具调用用时',
   'stats.ttft': '首 token 平均（TTFT）',
   'stats.tpsLabel': '输出速度（TPS）',
   'stats.totalTokens': '{tokens} tok',
@@ -110,6 +110,13 @@ const ZH: Dict = {
   'ball.title': '展开 Codinput',
   'side.notice': '本会话的输入面已在另一个分栏中打开（输入入口唯一）。',
   'side.guideDesc': '代码编辑器风格的输入面板；开启期间主输入框由本面板接管（共用同一台输入机）',
+  'side.disabled': 'Codinput 接管已关闭：主输入在原输入位（官方输入框）。输入 /codinput 或到 设置 → Codinput 重新开启。',
+  'tool.attach': '文件',
+  'tool.stop': '停止',
+  'image.preview': '原图预览',
+  'image.closePreview': '关闭原图预览',
+  'image.openOriginal': '查看原图',
+  'image.openOriginalLabel': '{name}，点击查看原图',
   'cmd.enter': '进入 Codinput 输入接管',
   'cmd.exit': '退出 Codinput，恢复官方输入框',
 };
@@ -124,7 +131,6 @@ const EN: Dict = {
   'editor.placeholder': 'Describe what you want to build — / for commands, @ for files or chats',
   'preview.empty': 'Nothing to preview',
   'tool.command': 'Commands (/)',
-  'tool.attach': 'Add attachment',
   'tool.send': 'Send',
   'tool.model': 'Select model, current {name}',
   'tool.modelPlain': 'Select model',
@@ -144,6 +150,7 @@ const EN: Dict = {
   'stats.turns': '{turns} turns · {steps} steps',
   'stats.tps': '{tps} tok/s',
   'stats.modelTime': 'Model time',
+  'stats.toolTime': 'Tool call time',
   'stats.ttft': 'Avg first token (TTFT)',
   'stats.tpsLabel': 'Output speed (TPS)',
   'stats.totalTokens': '{tokens} tok',
@@ -207,6 +214,13 @@ const EN: Dict = {
   'ball.title': 'Open Codinput',
   'side.notice': "This session's input panel is already open in another split pane (only one input surface exists).",
   'side.guideDesc': 'Code-editor style input panel. While enabled it takes over the composer (sharing the same input machine).',
+  'side.disabled': 'Codinput takeover is off: the composer is back at its original place (official input). Type /codinput or open Settings → Codinput to re-enable.',
+  'tool.attach': 'File',
+  'tool.stop': 'Stop',
+  'image.preview': 'Original image preview',
+  'image.closePreview': 'Close original image preview',
+  'image.openOriginal': 'View original',
+  'image.openOriginalLabel': '{name}, click to view the original',
   'cmd.enter': 'Enable the Codinput composer takeover',
   'cmd.exit': 'Disable Codinput and restore the official composer',
 };

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/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>