dsh-codinput 0.3.9 → 0.4.0

package/src/client/components/UserMessageMarkdown.tsx

@@ -3,10 +3,12 @@
  * 遮蔽条目（prefs.userMarkdown 开启时挂载，关闭即卸载还座官方）。
  *
  * 官方 UserStyleBubble 复刻：右对齐气泡（附件行 + 气泡 + 引用摘要行 + 操作行），
- * 气泡文本在官方纯文本排版之上按 Markdown 渲染（marked gfm+breaks + DOMPurify，
- * 与编辑器预览同一管线），Markdown 样式逐条移植官方 MarkdownText.module.css。
- * @/ 引用 chip、/技能 chip、复制钮、时间戳、点开文件/技能等行为逐值对齐官方
- * projectUserText（dsh-client-ui-primitives，MIT，见 LICENSE 归属段）。
+ * 气泡文本按 Markdown 渲染。v0.6 起渲染统一走 `src/client/markdown/`（与编辑器
+ * 预览同一函数 `renderMarkdown`，输出逐字节一致）；会话引用占位 span
+ * （data-dci-wire）在下面的装饰期换成官方引用 chip。Markdown 样式逐条移植官方
+ * MarkdownText.module.css。@/ 引用 chip、/技能 chip、复制钮、时间戳、点开文件/
+ * 技能等行为逐值对齐官方 projectUserText（dsh-client-ui-primitives，MIT，见
+ * LICENSE 归属段）。
  *
  * 挂载面（v0.3.7 取证，宿主 0.2.x web）：chat.view 的 flowItem 渲染点
  * `renderSlot("conversation.chat.node", owner, { entryKey: routedNode.kind })`，
@@ -15,18 +17,35 @@
  * 发送瞬间的本地回显（PendingSubmissionBubble）不经本槽位，保持官方纯文本，
  * 落库后即换 Markdown 形态。
  *
+ * 宿主代际（0.2.0 → 0.2.2）：0.2.2 的 user 节点视图改由「Factory + 键控座」
+ * 组合渲染，官方 UserContent（conversation.chat.user.content）只负责附件行 /
+ * 文本 / 额外块 / 引用摘要。本组件保留 Markdown 文本接管，但把**附件行**整段
+ * 委托给该 Factory（content.text 置空 → 官方只出附件行）：图片经
+ * conversation.chat.user.images → MessageImages 得到官方缩略图与点击大图灯箱。
+ * 旧 0.2.0 宿主没有该 Factory，FactoryOutlet 会渲染 options.fallback，回落到
+ * 该宿主专有的 renderMessageImages 座位；再没有则保留文件卡降级（不静默丢内容）。
+ * 两条附带约束：question-reply 来源的消息让位官方 question-reply 卡片；原始
+ * HTML 一律按文本转义（data-dci-wire 只能由本文件的 md 扩展产生）。
+ *
  * 已知边界（刻意不做）：KaTeX 数学公式、Shiki 代码高亮与 CodeBlock 语言横幅、
  * 链接分类图标不渲染（官方 MarkdownText 的完整面超出自含范围）；未知内容块
  * 出极简 JSON 块（官方 JsonBlock 的降级形态）。
  */
 
-import { Fragment, memo, useCallback, useEffect, useMemo, useRef, useState } from 'react';
-import { Marked, type MarkedExtension } from 'marked';
-import * as DOMPurifyModule from 'dompurify';
+import { Fragment, memo, useCallback, useEffect, useMemo, useRef, useState, type ReactNode } from 'react';
 import type { SlotRegisterOptions } from '../host-types';
 import { diagError } from '../diag';
+import { loadPrefs, subscribePrefs } from '../prefs';
 import { bindForeign, t, useT, type TranslateParams } from '../i18n';
+import {
+  activateMarkdown,
+  copyTextToClipboard,
+  handleMarkdownClick,
+  renderMarkdown,
+  type MarkdownImageTarget,
+} from '../markdown';
 import { FileGlyph, fileExtension, fileSizeText } from './AttachmentRail';
+import { ImageLightbox } from './ImageLightbox';
 
 /* ---------- 注册 ---------- */
 
@@ -63,12 +82,32 @@ interface UserMessageData {
   referenceLabels?: readonly string[];
   skillNames?: readonly string[];
   time?: unknown;
+  /** 官方 messageDefinition 落在 user/steering 节点上的消息源（鸭子切面）。 */
+  source?: unknown;
 }
 
+/** 0.2.0 宿主座位：官方 MessageImages（缩略图 + 灯箱）的便携 prop 形态。 */
+type RenderMessageImages = (args: { images: readonly unknown[]; align: string; compact?: boolean }) => ReactNode;
+
+/** 0.2.2 宿主座位：键控条目 kit 固定下发的 Factory 渲染器（boundRenderFactorySlot）。 */
+type RenderFactorySlot = (
+  name: string,
+  props: Record<string, unknown>,
+  options?: { fallback?: ReactNode },
+) => ReactNode;
+
 export interface UserMessageMarkdownProps {
-  node?: { data?: UserMessageData } | undefined;
-  /** 官方 renderMessageImages 座位 prop（图片缩略/灯箱全官方）。 */
-  renderMessageImages?: ((args: { images: readonly unknown[]; align: string; compact?: boolean }) => React.ReactNode) | undefined;
+  node?: { kind?: string; data?: UserMessageData } | undefined;
+  /** 0.2.0 宿主：图片缩略/灯箱官方座位（0.2.2 已移除此 prop，改走 Factory）。 */
+  renderMessageImages?: RenderMessageImages | undefined;
+  /**
+   * 0.2.2 宿主：官方 UserMessageNodeView 同座下发的 Factory seat。附件行委托
+   * conversation.chat.user.content；旧宿主没有该 Factory 时 FactoryOutlet 会渲染
+   * options.fallback（本组件传入旧座位/文件卡链路，不静默丢内容）。
+   */
+  renderFactorySlot?: RenderFactorySlot | undefined;
+  /** 0.2.2 用户节点 owner props 直传的授权图片加载器（官方同座）。 */
+  loadImage?: unknown;
   openFile?: ((path: string) => void) | undefined;
   openSkill?: ((name: string) => void) | undefined;
 }
@@ -97,69 +136,10 @@ function contentParts(content: readonly unknown[] | undefined): ContentParts {
   return parts;
 }
 
-/* ---------- Markdown 管线（marked + DOMPurify，与编辑器预览同源） ---------- */
-
-/** dompurify 的导出形状随打包条件漂移：默认导出与命名空间都兼容。 */
-const DOMPurify = ((DOMPurifyModule as unknown as { default?: unknown }).default ??
-  DOMPurifyModule) as unknown as { sanitize(html: string, options?: Record<string, unknown>): string };
-
-/** 用户消息是「不可信 Markdown」面：marked 会原样透传原始 HTML，官方 MarkdownText 则是
- * mdast→React 逐节点渲染且链接/图片只放行 http(s)/mailto。这里用 DOMPurify 白名单收敛到
- * Markdown 产出面——禁 style/form/控件/媒体等原始 HTML（<style> 一旦进 DOM 会全局生效），
- * URI 只留 http(s)/mailto，行内 style 一律去掉。 */
-const SANITIZE_OPTIONS = {
-  ALLOWED_TAGS: [
-    'p', 'br', 'strong', 'em', 'del', 'code', 'pre', 'blockquote', 'ul', 'ol', 'li', 'a', 'img',
-    'h1', 'h2', 'h3', 'h4', 'h5', 'h6', 'hr', 'table', 'thead', 'tbody', 'tr', 'th', 'td', 'input', 'span',
-  ],
-  ALLOWED_ATTR: [
-    'href', 'src', 'alt', 'title', 'target', 'rel', 'type', 'checked', 'disabled', 'start',
-    'colspan', 'rowspan', 'align', 'data-dci-wire',
-  ],
-  ALLOWED_URI_REGEXP: /^(?:https?:|mailto:)/i,
-  FORBID_ATTR: ['style'],
-};
-
-function escapeHtml(text: string): string {
-  return text.replace(
-    /[&<>"']/g,
-    (c) => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;', "'": '&#39;' })[c] as string,
-  );
-}
+/* ---------- Markdown 管线 ---------- */
 
-/** 会话引用的落库线格式：@[标签](dsh-session:…)（官方 SESSION_WIRE_RE）。 */
-const SESSION_WIRE_SRC = /^@\[([^\]\n]+)\]\(dsh-session:[^)\s]+\)/;
-
-/** marked 扩展：线格式不进通用链接解析（DOMPurify 会剥掉 dsh-session: href），
- * 渲染成带 data 的占位 span，装饰期换成会话 chip。 */
-const sessionWireExtension: NonNullable<MarkedExtension['extensions']>[number] = {
-  name: 'dshSessionWire',
-  level: 'inline',
-  start(src: string): number | undefined {
-    const i = src.indexOf('@[');
-    return i < 0 ? undefined : i;
-  },
-  tokenizer(src: string) {
-    const m = SESSION_WIRE_SRC.exec(src);
-    if (!m) return undefined;
-    return { type: 'dshSessionWire', raw: m[0], label: m[1] } as never;
-  },
-  renderer(token) {
-    const label = String((token as { label?: unknown }).label ?? '');
-    return `<span data-dci-wire="${escapeHtml(label)}">${escapeHtml(label)}</span>`;
-  },
-};
-
-const mdParser = new Marked({ gfm: true, breaks: true, extensions: [sessionWireExtension] });
-
-function renderMarkdown(text: string): string {
-  try {
-    return DOMPurify.sanitize(mdParser.parse(text) as string, SANITIZE_OPTIONS);
-  } catch (error) {
-    diagError('umsg.markdown', error);
-    return `<p>${escapeHtml(text).replace(/\n/g, '<br>')}</p>`;
-  }
-}
+/* 统一管线在 src/client/markdown/：renderMarkdown 产出 sanitized HTML；会话引用线格式
+   @[...](dsh-session:…) 的占位 span 由管线扩展产生，下面的装饰期把占位换成官方引用 chip。*/
 
 /* ---------- 引用 chip（官方 projectUserText 逐值复刻） ---------- */
 
@@ -391,9 +371,11 @@ function decorateMarkdownRoot(root: HTMLElement | null, actionsRef: React.Mutabl
   if (!root) return;
   try {
     // 官方 sanitizeUrl 只放行 http(s)/mailto：其余链接（含 DOMPurify 已剥掉 href 的残链）
-    // 没有可点面，拆回纯文本；http(s) 统一新开页。
+    // 没有可点面，拆回纯文本；http(s) 统一新开页。页内锚点（#…）是统一管线的
+    // 脚注上标/回跳，必须保留可点。
     for (const anchor of Array.from(root.querySelectorAll('a'))) {
       const href = anchor.getAttribute('href') ?? '';
+      if (href.startsWith('#')) continue;
       if (/^https?:/i.test(href)) {
         anchor.setAttribute('target', '_blank');
         anchor.setAttribute('rel', 'noreferrer noopener');
@@ -486,27 +468,6 @@ function messageClock(time: unknown, now = Date.now()): string {
   return `${officialText(d.getFullYear() === n.getFullYear() ? 'clock.md' : 'clock.ymd', d.getFullYear() === n.getFullYear() ? 'umsg.clock.md' : 'umsg.clock.ymd', params)} ${clock}`;
 }
 
-async function writeClipboard(text: string): Promise<boolean> {
-  try {
-    await navigator.clipboard.writeText(text);
-    return true;
-  } catch {
-    try {
-      const area = document.createElement('textarea');
-      area.value = text;
-      area.style.position = 'fixed';
-      area.style.opacity = '0';
-      document.body.appendChild(area);
-      area.select();
-      const ok = document.execCommand('copy');
-      area.remove();
-      return ok;
-    } catch {
-      return false;
-    }
-  }
-}
-
 /* ---------- 图标（官方 MessageIconActions glyph 逐字路径） ---------- */
 
 function CopyGlyph(): JSX.Element {
@@ -568,8 +529,38 @@ function MessageImageFallback({ image }: { image: { attachment: unknown } }): JS
   );
 }
 
+/**
+ * 附件行回退：0.2.2 主路径由官方 content Factory 渲染（见 view），只有旧宿主的
+ * FactoryOutlet fallback 才会走到这里——0.2.0 宿主用其 renderMessageImages 座位
+ * （官方缩略图 + 灯箱），再缺则保留文件卡降级，保证内容不静默丢失。
+ */
+function AttachmentRowFallback({
+  attachments,
+  renderMessageImages,
+}: {
+  attachments: ContentParts['attachments'];
+  renderMessageImages?: RenderMessageImages | undefined;
+}): JSX.Element {
+  const compact = attachments.length > 1;
+  return (
+    <div className="dci-umsg-attrow" data-message-attachments="true">
+      {attachments.map((att, index) =>
+        att.type === 'image' ? (
+          <Fragment key={`image:${index}`}>
+            {renderMessageImages
+              ? renderMessageImages({ images: [att.image], align: 'end', compact })
+              : <MessageImageFallback image={att.image} />}
+          </Fragment>
+        ) : (
+          <MessageFileCard key={`file:${index}`} file={att.file} />
+        ),
+      )}
+    </div>
+  );
+}
+
 function UserMessageMarkdownView(props: UserMessageMarkdownProps): JSX.Element | null {
-  const { node, renderMessageImages, openFile, openSkill } = props;
+  const { node, renderMessageImages, renderFactorySlot, loadImage, openFile, openSkill } = props;
   // 订阅宿主 locale 快照：语言切换时复制钮/引用摘要等文案即时刷新（其它组件同款）。
   useT();
   const data = (node?.data ?? {}) as UserMessageData;
@@ -577,17 +568,37 @@ function UserMessageMarkdownView(props: UserMessageMarkdownProps): JSX.Element |
   const referenceLabels = useMemo(() => (Array.isArray(data.referenceLabels) ? data.referenceLabels : []), [data.referenceLabels]);
   const skillNames = useMemo(() => (Array.isArray(data.skillNames) ? data.skillNames : []), [data.skillNames]);
   const { text, attachments, rest } = useMemo(() => contentParts(content), [content]);
-  const compactImages = attachments.length > 1;
   const showBubble = text !== '' || rest.length > 0;
+  // 官方 UserStyleBubble 的 facts 形状（0.2.2）：引用标签/技能名随 content 传给
+  // 官方 content Factory；text 为空时它不渲染文本，facts 只为同构保留。
+  const factoryFacts = useMemo(
+    () => ({
+      ...(referenceLabels.length > 0 ? { sessionLabels: referenceLabels } : {}),
+      ...(skillNames.length > 0 ? { skillNames } : {}),
+    }),
+    [referenceLabels, skillNames],
+  );
+  const sourceKind = (data.source as { kind?: unknown } | null | undefined)?.kind;
 
-  const html = useMemo(() => (text === '' ? '' : renderMarkdown(text)), [text]);
+  /** Markdown 正文等宽连字（prefs.markdownMono）：即时跟随设置变化。 */
+  const [markdownMono, setMarkdownMono] = useState<boolean>(() => loadPrefs().markdownMono);
+  useEffect(() => subscribePrefs(() => setMarkdownMono(loadPrefs().markdownMono)), []);
+
+  const html = useMemo(() => (text === '' ? '' : renderMarkdown(text, { surface: 'user-message' })), [text]);
   const bodyRef = useRef<HTMLDivElement | null>(null);
+  /** Markdown 内 http(s) 图片点击后的大图（用户消息里的 Markdown 图片与预览一致走灯箱）。 */
+  const [lightbox, setLightbox] = useState<MarkdownImageTarget | null>(null);
+  const onMarkdownClick = useCallback((event: React.MouseEvent<HTMLDivElement>): void => {
+    handleMarkdownClick(event, { onImage: setLightbox });
+  }, []);
   const actionsRef = useRef<ChipActions>({ openFile, openSkill, skillNames, referenceLabels });
   actionsRef.current = { openFile, openSkill, skillNames, referenceLabels };
   // 引用标签 / 技能名单后到（投影刷新）时重跑装饰，补齐 @引用与 /技能 chip。
   useEffect(() => {
     decorateMarkdownRoot(bodyRef.current, actionsRef);
   }, [html, referenceLabels, skillNames]);
+  // 扩展渲染 扩展（代码高亮 / KaTeX / Mermaid）的 DOM 激活口；本批未注册扩展时是 no-op。
+  useEffect(() => activateMarkdown(bodyRef.current, 'user-message'), [html]);
 
   const [copied, setCopied] = useState(false);
   const copyTimer = useRef<number | null>(null);
@@ -600,7 +611,7 @@ function UserMessageMarkdownView(props: UserMessageMarkdownProps): JSX.Element |
   );
   const onCopy = useCallback(() => {
     if (copied || text === '') return;
-    void writeClipboard(text).then((ok) => {
+    void copyTextToClipboard(text).then((ok) => {
       if (!ok) return;
       setCopied(true);
       if (copyTimer.current !== null) window.clearTimeout(copyTimer.current);
@@ -611,32 +622,56 @@ function UserMessageMarkdownView(props: UserMessageMarkdownProps): JSX.Element |
     });
   }, [copied, text]);
 
+  // 附件行：0.2.2 起整体委托官方 content Factory（text 置空 → 官方只出附件行；
+  // extraBlocks 空、referenceLabels 空数组避免与下方自有引用摘要重复）。图片经
+  // conversation.chat.user.images → MessageImages 走官方缩略图 + 点击大图灯箱。
+  // 旧宿主没有 conversation.chat.user.content Factory 时，FactoryOutlet 渲染
+  // options.fallback：0.2.0 的 renderMessageImages 座位 → 文件卡降级。
+  const attachmentRow =
+    attachments.length === 0 ? null : typeof renderFactorySlot === 'function' ? (
+      renderFactorySlot(
+        'conversation.chat.user.content',
+        {
+          content: { text: '', attachments, extraBlocks: [], referenceLabels: [] },
+          loadImage,
+          facts: factoryFacts,
+          interactive: true,
+        },
+        {
+          fallback: <AttachmentRowFallback attachments={attachments} renderMessageImages={renderMessageImages} />,
+        },
+      )
+    ) : (
+      <AttachmentRowFallback attachments={attachments} renderMessageImages={renderMessageImages} />
+    );
+
+  // 问题 B：问答回复（source.kind === 'user-question-reply'）在官方 0.2.2 由
+  // question-reply 键控卡片（[data-question-reply]，官方 UserMessageBubble）呈现。
+  // 该消息源若再以 user/steering 节点落到本座（历史投影/旧宿主兜底形态），本组件
+  // 再渲染一份就会让同一条问答在消息流里出现两次——这里直接让位官方卡片。
+  if (sourceKind === 'user-question-reply') return null;
+
   if (!showBubble && attachments.length === 0 && referenceLabels.length === 0 && data.time === undefined) {
     // 空消息：不渲染任何东西（避免空操作行突兀）。
     return null;
   }
 
   return (
-    <div className="dci-umsg-row">
+    <div className="dci-umsg-row" data-dci-node={node?.kind} data-dci-src={typeof sourceKind === 'string' ? sourceKind : undefined}>
       <div className="dci-umsg-stack">
-        {attachments.length > 0 && (
-          <div className="dci-umsg-attrow" data-message-attachments="true">
-            {attachments.map((att, index) =>
-              att.type === 'image' ? (
-                <Fragment key={`image:${index}`}>
-                  {renderMessageImages
-                    ? renderMessageImages({ images: [att.image], align: 'end', compact: compactImages })
-                    : <MessageImageFallback image={att.image} />}
-                </Fragment>
-              ) : (
-                <MessageFileCard key={`file:${index}`} file={att.file} />
-              ),
-            )}
-          </div>
-        )}
+        {attachmentRow}
         {showBubble && (
           <div className="dci-umsg-bubble">
-            {text !== '' && <div className="dci-umsg-md" ref={bodyRef} dangerouslySetInnerHTML={{ __html: html }} />}
+            {text !== '' && (
+              <div
+                className="dci-umsg-md dci-md"
+                data-dci-md="user-message"
+                data-mono={markdownMono ? 'true' : undefined}
+                ref={bodyRef}
+                onClick={onMarkdownClick}
+                dangerouslySetInnerHTML={{ __html: html }}
+              />
+            )}
             {rest.map((block, index) => (
               <pre key={index} className="dci-umsg-extra">
                 {officialText('message.extraBlock', 'umsg.extraBlock')}
@@ -667,6 +702,14 @@ function UserMessageMarkdownView(props: UserMessageMarkdownProps): JSX.Element |
             {copied ? <CheckGlyph /> : <CopyGlyph />}
           </button>
         </div>
+        {lightbox ? (
+          <ImageLightbox
+            src={lightbox.src}
+            alt={lightbox.alt}
+            labels={{ dialog: t('image.preview'), close: t('image.closePreview') }}
+            onClose={() => setLightbox(null)}
+          />
+        ) : null}
       </div>
     </div>
   );

package/src/client/components/VoiceActivity.tsx

@@ -9,68 +9,29 @@
  * 渲染。条目出现/消失经 slots.subscribe 响应式跟随（用户开关语音插件即时生效）。
  *
  * props 组装复刻官方 renderer 的合成公式：
- *   {...standard(sessionId/inputActions), ...entry.inject()（其 hooks 子表的
- *   speechReadiness 按 standardHookPropName 变成 useSpeechReadiness 选择器钩子）,
- *   ...ownerProps(locked/onActiveChange), t = locale.bind(entry.locale)}
- * inject 结果按（条目 × 会话）缓存——官方 renderer 同款缓存轴，避免每次渲染
- * 重建对象让钩子身份漂移。宿主未就绪（slots 无检视面 / inject 不可调 /
- * locale 缺席）一律不渲染，绝不半组装。
+ *   {...standard(sessionId/inputActions), ...entry.inject()（hooks 子表的每个
+ *   快照 store 按 standardHookPropName 折成 use<Name> 选择器钩子）,
+ *   ...t = locale.bind(entry.locale), ...ownerProps(locked/onActiveChange)}
+ * 折叠走 slotEntry.entryInjectProps（= 官方 bindInjectSources 的插件侧复刻，
+ * 按条目 × 会话缓存 inject 面、按 store 身份缓存钩子）——**不能只折已知钩子**：
+ * 0.2.2 的 voice-input inject 返回
+ *   { openSettings, hooks: { speechReadiness, microphoneDevice, pluginNavigation },
+ *     selectMicrophone, createRecording, transcribe, ... }
+ * 而 VoiceInput 组件会调用 useSpeechReadiness / useMicrophoneDevice /
+ * usePluginNavigation 三个钩子；旧实现只绑了 speechReadiness，另外两个未定义
+ * 直接抛错，被 EntryBoundary 静默吞掉 → 麦克风整体不渲染（0.2.2 回归根因）。
+ * 通用折叠后旧宿主（hooks 表只有 speechReadiness 的旧条目）同样成立。
+ *
+ * 宿主未就绪（slots 无检视面 / inject 不可调 / locale 缺席）一律不渲染，
+ * 绝不半组装；条目崩溃仍由 EntryBoundary 隔离（只丢本座位）。
  */
 
-import { createElement, useMemo, useSyncExternalStore } from 'react';
-import type { HostObservable, SlotEntryLike } from '../host-types';
-import { diagError } from '../diag';
-import { EntryBoundary, firstComponentEntry, translatorFor, useSlotEntries } from './slotEntry';
+import { createElement, useMemo } from 'react';
+import { EntryBoundary, entryInjectProps, firstComponentEntry, translatorFor, useSlotEntries } from './slotEntry';
 
 const ACTIVITY_SLOT = 'conversation.input.activity';
 const VOICE_NS_FALLBACK = 'voice-input';
 
-type ReadinessSelector = (value: unknown) => unknown;
-type ReadinessHook = (selector: ReadinessSelector) => unknown;
-
-/** observableHook 同款缓存轴：钩子身份按 readiness store 稳定，不逐渲染重订。 */
-const readinessHookCache = new WeakMap<object, ReadinessHook>();
-/** 官方 renderer 的 inject 缓存轴：条目 × 会话绑定。 */
-const injectCache = new WeakMap<object, Map<string, Record<string, unknown> | null>>();
-
-/** 调条目 inject 工厂取 props 面（session 槽位以 sessionId 调用，官方同参）。 */
-function resolveInjected(entry: SlotEntryLike, sessionId: string): Record<string, unknown> | null {
-  if (typeof entry.inject !== 'function') return null;
-  let perSession = injectCache.get(entry);
-  if (!perSession) {
-    perSession = new Map();
-    injectCache.set(entry, perSession);
-  }
-  if (!perSession.has(sessionId)) {
-    let face: Record<string, unknown> | null = null;
-    try {
-      face = (entry.inject as (key: string) => Record<string, unknown>)(sessionId) ?? null;
-    } catch (error) {
-      diagError('voice.inject', error);
-      face = null;
-    }
-    perSession.set(sessionId, face);
-  }
-  return perSession.get(sessionId) ?? null;
-}
-
-/** hooks.speechReadiness（快照 store）→ use<Name> 选择器钩子（observableHook 同款）。 */
-function readinessHookFor(source: unknown): ReadinessHook | null {
-  const face = source as HostObservable<unknown> | undefined;
-  if (!face || typeof face.subscribe !== 'function' || typeof face.getSnapshot !== 'function') return null;
-  let hook = readinessHookCache.get(face);
-  if (!hook) {
-    hook = (selector: ReadinessSelector): unknown =>
-      useSyncExternalStore(
-        (fn: () => void) => face.subscribe(fn) ?? (() => {}),
-        () => selector(face.getSnapshot()),
-        () => selector(face.getSnapshot()),
-      );
-    readinessHookCache.set(face, hook);
-  }
-  return hook;
-}
-
 export interface VoiceActivityProps {
   sessionId: string | undefined;
   /** 官方输入机动作面（bar 槽位 standard props 里的 inputActions 原样透传）。 */
@@ -88,28 +49,28 @@ export function VoiceActivity(props: VoiceActivityProps): JSX.Element | null {
   // single 槽位赢家 = 优先级最低者 = entries 首个（register 即按优先级排序）。
   const entry = useMemo(() => firstComponentEntry(entries), [entries]);
 
+  // inject 面：通用 hooks→use<Name> 折叠加其余字段原样（entryInjectProps 自带
+  // 条目 × 会话缓存与失败标记，这里不再自建缓存）。
   const injected = useMemo(
-    () => (entry && sessionId ? resolveInjected(entry, sessionId) : null),
+    () => (entry && sessionId ? entryInjectProps(entry, sessionId) : null),
     [entry, sessionId],
   );
   const translator = useMemo(() => (entry ? translatorFor(entry, VOICE_NS_FALLBACK) : null), [entry]);
-  const readinessSource = (injected?.['hooks'] as { speechReadiness?: unknown } | undefined)?.speechReadiness;
-  const useReadiness = useMemo(() => readinessHookFor(readinessSource), [readinessSource]);
 
-  if (!entry || !sessionId || !injected || !translator || !useReadiness) return null;
+  if (!entry || !sessionId || !injected || !translator) return null;
 
-  // hooks 子表已折成 use* 钩子（bindInjectSources 同款），其余 props 原样下传。
-  const { hooks: _hooks, ...actions } = injected;
-  void _hooks;
-  return createElement(EntryBoundary, {
-    children: createElement(entry.component as React.ComponentType<Record<string, unknown>>, {
+  // 官方 renderEntry 展开顺序：standard kit → inject 面 → 条目词典 t → owner props。
+  // owner props 最后展开（与官方一致：条目 inject 不得覆盖 locked/onActiveChange）。
+  return createElement(
+    EntryBoundary,
+    null,
+    createElement(entry.component as React.ComponentType<Record<string, unknown>>, {
       sessionId,
       inputActions,
+      ...injected,
+      t: translator,
       locked,
       onActiveChange,
-      ...actions,
-      useSpeechReadiness: useReadiness,
-      t: translator,
     }),
-  });
+  );
 }

package/src/client/components/slotEntry.tsx

@@ -56,6 +56,43 @@ const RENDERABLE_OBJECT_TYPES: readonly symbol[] = [
   Symbol.for('react.lazy'),
 ];
 
+/**
+ * 槽位声明态（官方 SlotCore 检视面可区分的三种事实）：
+ * - `declared`：槽位键已声明（entries 返回数组，哪怕为空 = 已声明无占用者）；
+ * - `undeclared`：槽位键未声明（entries 抛错）——旧宿主没有该子槽位；
+ * - `unknown`：检视面本身缺席（更老的宿主没有 entries 方法）或读值异常。
+ *
+ * 与 `useSlotEntries`（无条目一律归一成空数组）分开：permission/plan 这类
+ * **新槽位**要求「已声明但无人占用 → 按官方留空」，而「宿主未声明 → 回退
+ * 自绘控件」，两者不能混。getSnapshot 返回字符串常量，快照身份按值稳定。
+ */
+export type SlotDeclaration = 'declared' | 'undeclared' | 'unknown';
+
+export function useSlotDeclaration(key: string): SlotDeclaration {
+  const slots = stash.slots;
+  const subscribe = useCallback(
+    (fn: () => void) => {
+      if (typeof slots?.subscribe !== 'function') return () => {};
+      try {
+        return slots.subscribe(key, fn) ?? (() => {});
+      } catch {
+        return () => {};
+      }
+    },
+    [slots, key],
+  );
+  const getSnapshot = useCallback((): SlotDeclaration => {
+    if (!slots || typeof slots.entries !== 'function') return 'unknown';
+    try {
+      slots.entries(key);
+      return 'declared';
+    } catch {
+      return 'undeclared';
+    }
+  }, [slots, key]);
+  return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+}
+
 /** 组件位是否为 React 可渲染类型（函数组件 / memo / forwardRef / lazy 包装）。 */
 export function isRenderableComponent(value: unknown): boolean {
   if (typeof value === 'function') return true;

package/src/client/host-types.ts

@@ -46,8 +46,10 @@ export interface SlotsService {
   inject(slotName: string, factory: () => Generator<unknown> | (() => unknown)): void;
   /**
    * 槽位检视面（0.2.x 起的 SlotCore 公开方法，鸭子探测）：entries 返回条目
-   * 快照（引用在变更之间稳定，可作 uSES getSnapshot 源；未声明槽返回稳定
-   * 空数组）；subscribe 订阅该槽条目变更。
+   * 快照（引用在变更之间稳定，可作 uSES getSnapshot 源）。**抛错 = 该槽位
+   * 未声明**（旧宿主，或本宿主尚未声明该子槽位）；返回空数组 = 已声明但
+   * 当前无占用者——两者语义不同，见 slotEntry.useSlotDeclaration。
+   * subscribe 订阅该槽条目变更（未声明键可能同样抛错）。
    */
   entries?(key: string): readonly unknown[];
   subscribe?(key: string, fn: () => void): () => void;
@@ -75,7 +77,13 @@ export interface SlotEntryLike {
 // ---------- input machine ----------
 
 export type DraftAttachmentId = string;
-export type InputPhase = 'plain' | 'adjudicating' | 'claimed' | 'submitting';
+/**
+ * 输入机提交阶段（官方 0.2.2 contract/input.d.ts 逐值）：
+ * `adjudicating`（`/` 行命令裁决中）、`submitting`（已 claim 的命令执行中）、
+ * `sending`（普通消息等待 Host 接收；0.2.2 新增）。三者都是 busy：
+ * 编辑器/附件只读，发送主按钮不可重复提交。
+ */
+export type InputPhase = 'plain' | 'adjudicating' | 'claimed' | 'submitting' | 'sending';
 
 export interface InputState {
   readonly draft: string;

package/src/client/hotkey.ts

@@ -6,6 +6,44 @@
 
 const MODIFIERS = new Set(['ctrl', 'alt', 'shift', 'meta', 'mod']);
 
+/** 规范化输出时修饰键的固定顺序（与 comboFromEvent 一致）。 */
+const MODIFIER_ORDER = ['ctrl', 'alt', 'shift', 'meta'] as const;
+
+/** 命名键（enter/escape/arrowup/f12…）：字母开头、字母数字组成。 */
+const NAMED_KEY = /^[a-z][a-z0-9]{0,15}$/;
+
+/** 主键 token 是否可解析：单字符（非空白/加号）或命名键。 */
+function isKeyToken(token: string): boolean {
+  return token.length === 1 ? /[^\s+]/.test(token) : NAMED_KEY.test(token);
+}
+
+/**
+ * 存储的组合串是否基本合法：非空字符串，恰好一个可解析主键，无空/重复
+ * token；`mod` 不与 ctrl/meta 混用（否则 matchEvent 语义有歧义）。
+ */
+export function isValidHotkey(value: unknown): value is string {
+  if (typeof value !== 'string') return false;
+  if (value.length === 0 || value.length > 64) return false;
+  const tokens = value.toLowerCase().split('+');
+  if (tokens.some((token) => token.length === 0)) return false;
+  const unique = new Set(tokens);
+  if (unique.size !== tokens.length) return false;
+  const keys = tokens.filter((token) => !MODIFIERS.has(token));
+  if (keys.length !== 1 || keys[0] === undefined || !isKeyToken(keys[0])) return false;
+  return !(unique.has('mod') && (unique.has('ctrl') || unique.has('meta')));
+}
+
+/**
+ * 组合串规范化：小写 + 修饰键固定顺序（ctrl+alt+shift+meta，mod 收尾）+ 主键。
+ * 调用方应先用 isValidHotkey 校验；非法输入按原 token 尽力拼接。
+ */
+export function normalizeHotkey(combo: string): string {
+  const tokens = combo.toLowerCase().split('+').filter(Boolean);
+  const modifiers = MODIFIER_ORDER.filter((token) => tokens.includes(token));
+  const key = tokens.find((token) => !MODIFIERS.has(token));
+  return [...modifiers, ...(tokens.includes('mod') ? ['mod'] : []), ...(key === undefined ? [] : [key])].join('+');
+}
+
 /** 事件 → 规范化组合串（如 "ctrl+shift+enter"）；纯修饰键按下返回 null。 */
 export function comboFromEvent(event: KeyboardEvent): string | null {
   const raw = event.key;