dsh-config-manager 0.1.76 → 0.1.78

package/src/client/chat/chat-entry-view.ts

@@ -191,6 +191,56 @@ export type ChatEntryAttachment =
   | { kind: 'image'; image: ChatEntryImage }
   | { kind: 'file'; file: ChatEntryFile }
 
+/* ------------------------------------------------------------ 宿主 content factory（0.2.1+ 委托路径） */
+
+/**
+ * 宿主 `conversation.chat.user.content`（Factory 位）的名字。
+ *
+ * 0.2.1-alpha.3 起用户气泡的正文/附件/引用**整体换轨**到这条 factory：图片位
+ * `conversation.chat.user.images` 是它的 children（single/session），旧的 `conversation.message.images`
+ * 与节点 props 上的 `renderMessageImages` 同时删除（本机解包 0.2.1-rc.2 实测：后者 0 次出现）。
+ * 因此「接管 user 之后自己复刻气泡」这条路在 0.2.1 上拿不到图片位（issue #92）——正确做法是把正文
+ * **委托回宿主自己的 content factory**，图片由 ui-attachment 在该 factory 的渲染上下文里 renderSlot。
+ *
+ * 老宿主（≤0.2.0）没有这条 factory：`FactoryOutlet` 在定义缺失时回落调用方给的 `options.fallback`
+ * ⇒ 渲染层把**自绘气泡**当 fallback 传进去，0.1.x/0.2.0 的路径逐字不变（一个版本双栈兼容）。
+ */
+export const CHAT_USER_CONTENT_FACTORY = 'conversation.chat.user.content'
+
+/**
+ * 宿主 content factory 的附件项（逐字保留宿主 content 里的原始 attachment 载荷）。
+ *
+ * 形状逐字取自宿主 `contentParts`：`{ type:'image', image:{ attachment } }` /
+ * `{ type:'file', file: block.attachment }` —— `file` 那一支是我们的 ChatEntryFile **拼不回来**的
+ * `FileAttachmentRef`，所以必须原样留一份。
+ */
+export type HostUserContentAttachment =
+  | { type: 'image'; image: { attachment: unknown } }
+  | { type: 'file'; file: unknown }
+
+/** 传给宿主 content factory 的正文载荷（= 宿主 UserStyleBubble 的 `prepared`）。 */
+export interface HostUserContentData {
+  /** 拼接后的**原文**（未投影；宿主 content factory 内部自己投影会话引用/技能 chip）。 */
+  text: string
+  attachments: HostUserContentAttachment[]
+  /** 未知 / rest 块（宿主交给 JsonBlock，**必须**原样带过去）。 */
+  extraBlocks: unknown[]
+  /** 仅当节点 data 真的带了该字段时出现（宿主用「字段是否存在」区分「没带」与「空」）。 */
+  referenceLabels?: string[]
+}
+
+/** 传给宿主 content factory 的文本投影事实（= 宿主 UserStyleBubble 的 `facts`）。 */
+export interface HostUserContentFacts {
+  sessionLabels?: string[]
+  skillNames?: string[]
+}
+
+/** 一次 `renderFactorySlot(CHAT_USER_CONTENT_FACTORY, …)` 的入参（`loadImage`/`interactive` 由渲染层补）。 */
+export interface HostUserContentInput {
+  content: HostUserContentData
+  facts: HostUserContentFacts
+}
+
 export interface ChatEntryBubbleView {
   /** 文本块拼接结果（宿主 `texts.join('')`，逐字保留换行与空白；会话引用的线格式已投影成 label）。 */
   text: string
@@ -201,6 +251,12 @@ export interface ChatEntryBubbleView {
   rawText: string
   /** **有序附件列表**：渲染层必须按这个顺序输出（宿主不区分「先图片后文件」）。 */
   attachments: ChatEntryAttachment[]
+  /**
+   * **宿主形状**的有序附件列表（0.2.1+ 委托路径专用）：与 `attachments` 同一趟走查、同一顺序，
+   * 但保留宿主 content 里的**原始 attachment 载荷**（我们的 ChatEntryFile 只留了三个展示字段，
+   * 拼不回宿主 `FileAttachmentRef`）。逐字对齐宿主 `contentParts` 的 `attachments.push`。
+   */
+  hostAttachments: HostUserContentAttachment[]
   /** 图片附件（= `attachments` 里的 image 项，顺序一致；用于计数与「无渲染位」提示）。 */
   images: ChatEntryImage[]
   /** 文件附件（= `attachments` 里的 file 项，顺序一致）。 */
@@ -414,14 +470,15 @@ export function fileSizeTextOf(bytes: number | null): string | null {
 export function buildChatEntryBubble(content: unknown): ChatEntryBubbleView {
   if (typeof content === 'string') {
     const text = projectChatEntryText(content)
-    return { text, rawText: content, attachments: [], images: [], files: [], raw: [], showBubble: text !== '' }
+    return { text, rawText: content, attachments: [], hostAttachments: [], images: [], files: [], raw: [], showBubble: text !== '' }
   }
   if (!Array.isArray(content)) {
-    return { text: '', rawText: '', attachments: [], images: [], files: [], raw: content === null || content === undefined ? [] : [{ id: '0', payload: content }], showBubble: content !== null && content !== undefined }
+    return { text: '', rawText: '', attachments: [], hostAttachments: [], images: [], files: [], raw: content === null || content === undefined ? [] : [{ id: '0', payload: content }], showBubble: content !== null && content !== undefined }
   }
   const texts: string[] = []
   const rawTexts: string[] = []
   const attachments: ChatEntryAttachment[] = []
+  const hostAttachments: HostUserContentAttachment[] = []
   const raw: ChatEntryRawBlock[] = []
   content.forEach((block, index) => {
     const record = asRecord(block)
@@ -435,6 +492,8 @@ export function buildChatEntryBubble(content: unknown): ChatEntryBubbleView {
     }
     if (type === 'image' && record?.['attachment'] !== undefined) {
       attachments.push({ kind: 'image', image: { attachment: record['attachment'] } })
+      // 同一趟走查里并出宿主形状的那一份（同一顺序、原始载荷）—— 见 HostUserContentAttachment
+      hostAttachments.push({ type: 'image', image: { attachment: record['attachment'] } })
       return
     }
     if (type === 'file' && record?.['attachment'] !== undefined) {
@@ -449,6 +508,7 @@ export function buildChatEntryBubble(content: unknown): ChatEntryBubbleView {
           bytes: typeof bytes === 'number' && Number.isFinite(bytes) ? bytes : null,
         },
       })
+      hostAttachments.push({ type: 'file', file: record['attachment'] })
       return
     }
     raw.push({ id: String(index), payload: block })
@@ -458,7 +518,34 @@ export function buildChatEntryBubble(content: unknown): ChatEntryBubbleView {
   // images / files 是 attachments 的**派生视图**（不独立积累，避免两处真相与顺序漂移）
   const images = attachments.flatMap((item) => (item.kind === 'image' ? [item.image] : []))
   const files = attachments.flatMap((item) => (item.kind === 'file' ? [item.file] : []))
-  return { text, rawText, attachments, images, files, raw, showBubble: text !== '' || raw.length > 0 }
+  return { text, rawText, attachments, hostAttachments, images, files, raw, showBubble: text !== '' || raw.length > 0 }
+}
+
+/**
+ * 节点 data + 气泡视图 → 宿主 content factory 的入参（0.2.1+ 委托路径的**唯一**组装点）。
+ *
+ * 逐字对齐宿主 `UserStyleBubble` 的 `prepared` / `facts` 两段 useMemo：
+ *  · `content.text` = 未投影的文本拼接（宿主 factory 自己把它交给 `conversation.user.text` 投影成 chip）；
+ *  · `content.attachments` = 宿主形状的有序附件（同一趟走查产出）；
+ *  · `content.extraBlocks` = rest 块原样；
+ *  · `referenceLabels` / `sessionLabels` / `skillNames` **只在节点真的带了该字段时出现** ——
+ *    宿主用「字段是否存在」区分「没带」与「空数组」，我们传 `[]` 会改变它的分支。
+ *
+ * 本函数不抛（读不到就按「没带」处理），与 buildChatEntryBubble 同一条纪律。
+ */
+export function buildHostUserContentInput(data: ChatEntryNodeDataView, bubble: ChatEntryBubbleView): HostUserContentInput {
+  const content: HostUserContentData = {
+    text: bubble.rawText,
+    attachments: bubble.hostAttachments,
+    extraBlocks: bubble.raw.map((block) => block.payload),
+  }
+  const facts: HostUserContentFacts = {}
+  if (data.referenceLabels !== null) {
+    content.referenceLabels = data.referenceLabels
+    facts.sessionLabels = data.referenceLabels
+  }
+  if (data.skillNames !== null) facts.skillNames = data.skillNames
+  return { content, facts }
 }
 
 /** 渲染计划的一项：图片带 owner 载荷，文件带名称/扩展名/体积文本。 */
@@ -631,19 +718,26 @@ export interface ChatEntryView {
    */
   referenceLabels: string[]
   skillNames: string[]
+  /**
+   * 宿主 content factory 的入参（0.2.1+ 委托路径）。**始终**算好：新宿主用它委托，老宿主把它
+   * 闲置（那条 factory 不存在 ⇒ 渲染层走自绘气泡 fallback），两条路径都不需要再读一次节点。
+   */
+  hostContent: HostUserContentInput
 }
 
 /** 节点 → 整视图模型（读不到一律回安全值；本函数不抛）。 */
 export function buildChatEntryView(node: unknown): ChatEntryView {
   const data = readChatEntryNodeData(node)
   const turn = chatNodeTurn(node)
+  const bubble = buildChatEntryBubble(data.content)
   return {
     turnNumber: turn?.turn ?? null,
     turnStatus: turn?.status ?? null,
-    bubble: buildChatEntryBubble(data.content),
+    bubble,
     clock: formatChatEntryClock(data.time),
     referenceLabels: data.referenceLabels ?? [],
     skillNames: data.skillNames ?? [],
+    hostContent: buildHostUserContentInput(data, bubble),
   }
 }
 

package/src/client/chat/chat-node-registration.ts

@@ -8,6 +8,11 @@
  * 2026-10-12（用户要求「聊天内回退入口只有每条用户消息」）：旧的「整回合」档连同它的偏好模块
  * （`chat-entry-pref` / `chat-entry-mount`）与回合尾入口（`conversation.chat.turnTail`）一并删除 ——
  * 入口恒为每条用户消息气泡里的那一颗，于是这里不再有偏好门，也不再需要「切档时重新评估」的订阅。
+ *
+ * 2026-10-17（用户要求）：开关**关闭时不得再接管用户消息气泡**。原实现是「登记常驻、只收起按钮」——
+ * 功能关掉之后那条气泡仍由我们代画（即使正文已委托宿主 factory，外层壳与动作行仍是我们的）。
+ * 现在登记本身随开关出现 / 撤销（`registerChatNodeEntryWhenEnabled`）：关掉即让出 user cell，
+ * 宿主 `UserMessageNodeView` 原样接管回来。
  */
 import {
   CHAT_NODE_SLOT,
@@ -96,3 +101,69 @@ export function registerChatNodeEntry(options: {
     return () => {}
   }
 }
+
+/**
+ * 开关驱动的登记闸门：**只在功能开启时才接管 user cell**。
+ *
+ * 为什么不是「常驻登记 + 组件里隐藏按钮」：接管 = priority -1 遮蔽宿主 `UserMessageNodeView`，
+ * 只要登记还在，那条气泡（含外层壳与动作行）就由我们画 —— 用户 2026-10-17 明确要求关闭后
+ * **完全不要接管**，气泡交回宿主原生渲染。反过来，开关打开时**必须**有登记，否则入口无处可放
+ * （该 key 没有 children 表，见 `chat-slots.ts`）。
+ *
+ * 纯逻辑（开关读写与订阅都从外面注进来），便于在 node:test 下逐条断言：
+ *  · 关闭 → 一次注册都不发生；
+ *  · 开关转开 → 登记一次（重复通知幂等）；
+ *  · 开关转关 → **立刻撤销登记**（cell 回到宿主 priority 0）；
+ *  · 装配卸载 → 解绑订阅 + 撤销登记，不留悬挂注册。
+ *
+ * @returns 卸载函数（调用点 = `ctx.slots.inject` 的回调返回值）。
+ */
+export interface ChatNodeEntryGateOptions {
+  /** 槽位探测面（同 {@link registerChatNodeEntry}；探测只在真正注册那一次发生）。 */
+  probe: ChatNodeSlotProbe | undefined | null
+  /** 真正的注册调用（调用点包 `ctx.slots.register`，保持编译期校验）。 */
+  register: () => () => void
+  /** 功能此刻是否开启（`rollbackEnabled` 的进程内信号）。 */
+  isEnabled: () => boolean
+  /** 订阅开关变化（返回解绑函数）。 */
+  subscribe: (listener: () => void) => () => void
+  /** 诊断回调（缺省 `console.warn`；单测注入以免污染输出）。 */
+  warn?: (message: string) => void
+}
+
+export function registerChatNodeEntryWhenEnabled(options: ChatNodeEntryGateOptions): () => void {
+  /** 当前登记的解绑函数；null = 现在没有登记（= 宿主渲染器在渲染那条 cell）。 */
+  let disposeEntry: (() => void) | null = null
+
+  const sync = (): void => {
+    if (options.isEnabled() === true) {
+      if (disposeEntry === null) {
+        disposeEntry = registerChatNodeEntry({
+          probe: options.probe,
+          register: options.register,
+          ...(options.warn === undefined ? {} : { warn: options.warn }),
+        })
+      }
+      return
+    }
+    if (disposeEntry !== null) {
+      const dispose = disposeEntry
+      disposeEntry = null
+      dispose()
+    }
+  }
+
+  const unsubscribe = options.subscribe(sync)
+  // 订阅**先建后读**：读到与订阅之间没有窗口，开关恰在此刻翻转也不会漏（多跑一次 sync 是幂等的）。
+  sync()
+
+  return () => {
+    unsubscribe()
+    if (disposeEntry !== null) {
+      const dispose = disposeEntry
+      disposeEntry = null
+      dispose()
+    }
+  }
+}
+

package/src/client/chat/chat-slots.ts

@@ -9,19 +9,25 @@
  *
  * ## 镜像来源（**逐条核过真机 app.asar，不是猜的**）
  *
- * 槽位声明 = `packages/client/ui-chat/src/client/contract/slots.ts`（整包只声明 8 个槽位：
- * conversation.chat.node / conversation.message.images / conversation.chat.commandview /
- * conversation.chat.turnTail / conversation.chat.assistant-actions / conversation.view /
- * conversation.composer.dock / conversation.approval.detail）。
+ * 槽位声明 = `packages/client/ui-chat/src/client/contract/slots.ts`。
  *
  * ### `conversation.chat.node`（本插件**接管**其 `user` key）
  *
  *   kind: 'keyed' · scope: 'session'
- *   ownerProps: { groupPart?, cwd, openFile, openSkill, inspectCall, forkAt, loadImage,
- *                 renderMessageImages, fileMentions, turnProcess, node }
  *   registerOptions: key(必填) / priority(可选，= cell 遮蔽秩，升序、最低者渲染)
  *   replaceRisk: **有**（这是 keyed 遮蔽位：priority -1 会顶掉 shipped 的 UserMessageNodeView）
  *
+ * ownerProps **在 0.2.1-alpha.3 换过一代**（本机解包 `@deepseek-ai/dsh-client-ui-chat` 的
+ * `lib/client.js` + `lib/types/.../slots.d.ts` 实测，2026-10-17，issue #92）：
+ *
+ *   ≤0.2.0 ：{ groupPart?, cwd, openFile, openSkill, inspectCall, forkAt, loadImage,
+ *              renderMessageImages, fileMentions, turnProcess, node }
+ *   ≥0.2.1 ：{ groupPart?, cwd, openFile, inspectCall, forkAt, loadImage, fileMentions, node }
+ *              —— **删掉 `renderMessageImages` 与 `openSkill`**；图片位不再由 ui-chat 直接声明，
+ *              而是 `conversation.chat.user.content` factory 的 children
+ *              （`conversation.chat.user.images`, single/session）⇒ 想拿到图片**必须**委托那条 factory
+ *              （实现与判据见 `ChatEntryView.tsx` / `CHAT_USER_CONTENT_FACTORY`）。
+ *
  * 关键事实（决定了本功能只能走这条路，见 T1 output 的证据段）：
  *  · 宿主对 `{ name:'conversation.chat.node', key:'user' }` **没有声明 children 表**
  *    （对比 turn-tail 节点声明了 turnTail + assistant-actions 两个 list 子位）
@@ -84,14 +90,26 @@ declare module '@deepseek-ai/dsh-client-ui-slots' {
            */
           node: unknown
           /**
-           * 图片渲染位（宿主 `conversation.message.images` 的 renderSlot 绑定）——
-           * **必须**用它渲染图片（ui-chat 的私有实现不可导入）。
+           * 图片渲染位（**≤0.2.0** 宿主：`conversation.message.images` 的 renderSlot 绑定）——
+           * 必须用它渲染图片（ui-chat 的私有实现不可导入）。
+           *
+           * **0.2.1-alpha.3 起宿主整行删掉了它**（issue #92：新契约改由
+           * `conversation.chat.user.content` factory 的 `conversation.chat.user.images` 子位承载）
+           * ⇒ 镜像里跟着改成**可选**：渲染层据「它在不在」决定走旧的自绘图片位，还是委托 content factory。
+           */
+          renderMessageImages?: (owner: unknown) => unknown
+          /**
+           * 宿主授权过的图片加载器（0.2.1 起节点渲染器 props 上的稳定席位；转发给 content factory）。
+           * 老宿主上拿不到它（那时 loadImage 被封在 renderMessageImages 的闭包里）。
            */
-          renderMessageImages: (owner: unknown) => unknown
+          loadImage?: unknown
           /** 宿主提供的文件打开器（本插件不消费，保持契约完整）。 */
-          openFile: (path: string) => void
-          /** 宿主提供的 skill 打开器（同上）。 */
-          openSkill: (name: string) => void
+          openFile?: (path: string) => void
+          /**
+           * 宿主提供的 skill 打开器（同上）。0.2.1 起该席位从 ChatNodeOwnerProps 消失
+           * （与 renderMessageImages 同一批）⇒ 同样改成可选。
+           */
+          openSkill?: (name: string) => void
         }
       }
       owner: {