dsh-chat-embed 0.6.3 → 0.6.5

package/README.md

@@ -179,20 +179,28 @@ node tools/shell-patch/patch-asar.cjs --help                     # 查看参数
 
 ### 补丁状态与自检（0.6.0 起）
 
-设置菜单里的「跨重启保持登录」有四种状态，**只有未开启时才出现风险提示与操作按钮**：
+设置菜单里的「跨重启保持登录」有四种状态，**风险提示与「复制补丁说明」只在未生效时出现**：
 
-| 状态 | 含义 | 菜单里提供 |
+| 状态 | 含义 | 菜单里额外提供 |
 | --- | --- | --- |
-| 已开启（`persist:` 分区） | 补丁生效，重启后仍登录 | —（已是最优） |
-| 未开启（内存分区） | 从没打过补丁 | 风险提示 + 复制补丁说明 + 检查补丁配置 |
+| 已开启（`persist:` 分区） | 补丁生效，重启后仍登录 | —（已是最优，只留「检查补丁配置」） |
+| 未开启（内存分区） | 从没打过补丁 | 风险提示 + 复制补丁说明 |
 | **已失效**（升级覆盖） | **打过补丁，但桌面壳升级覆盖了 `app.asar`** | 同上；这一状态专门告诉你"该重打了" |
 | 尚未检测 | 还没打开过聊天页 | 同上 |
 
-「检查补丁配置」调用 Host 侧只读探针（`GET /dsh-chat-embed/patch-check`），报告安装目录、`app.asar` 是否可写、是否已打补丁、补丁点是否还在（壳版本是否兼容）、备份与待替换文件是否存在、`app.asar` 的大小与内容哈希；报告同时复制到剪贴板，方便直接贴出去。
+「检查补丁配置」是一行**开关样式**的控件，任何状态下都在。打开它不会在菜单里铺开报告——那会把面板撑宽——而是：
 
-**不需要自己装 Node.js**：探针会找出桌面版自带的 Node 运行时（`~/.dsh/dsh-runtimes/*/dependencies/node/`），并把一条完整可复制的命令写进报告——含正确的 Node 路径、补丁脚本路径和 `--resources` 安装目录（自定义/便携安装也能用）。
+1. 读取一次 Host 侧只读探针（见下）；
+2. **打开一个新会话**，把已知事实（安装目录、可写性、补丁点、是否已打补丁、确切命令）预先写进输入框；
+3. 你点「发送」即可。agent 会调用 `dsh_chat_embed_patch_check` 工具核对，然后说明现状和该执行的命令。
 
-Host 侧还注册了只读工具 **`dsh_chat_embed_patch_check`**：可以直接问 agent「我的聊天为什么重启后要重新登录」，它会自己去查这些事实，而不是让你跑命令再贴输出。
+这条路径用的就是 DSH 自己「创建你的插件」入口的同一个 API（`uiWorkspace.startSession`），所以行为与原生一致：已有草稿时追加而不是覆盖。没有 `uiWorkspace` 的宿主会退化成把说明复制到剪贴板。
+
+背后是 Host 侧只读探针 `GET /dsh-chat-embed/patch-check`：安装目录、`app.asar` 是否可写、是否已打补丁、补丁点是否还在（壳版本是否兼容）、备份与待替换文件、大小与内容哈希。
+
+**不需要自己装 Node.js**：探针会找出桌面版自带的 Node 运行时（`~/.dsh/dsh-runtimes/*/dependencies/node/`），并把一条完整可复制的命令写进草稿——含正确的 Node 路径、补丁脚本路径和 `--resources` 安装目录（自定义/便携安装也能用）。
+
+Host 侧还注册了只读工具 **`dsh_chat_embed_patch_check`**：可以直接问 agent「我的聊天为什么重启后要重新登录」，它会自己去查这些事实，而不是让你跑命令再贴输出——上面第 2 步的草稿就是让它这么做的。
 
 补丁做两件事：`persist:` 固定分区（登录落盘）+ `cache:false`（不落 Chromium 缓存）。
 没有补丁也能用，只是每次重启要重新登录。细节与风险见 [已知限制](#已知限制)。
@@ -214,7 +222,7 @@ dsh-chat-embed/
 ├── package.json               # 包名/版本、dsh.bundle.patch、dsh.client、exports/files
 ├── cordis.patch.yml           # 组合补丁：插入 id=chat-embed 的 loader 行
 ├── index.js                   # Host 半侧：补丁探针（HTTP + agent 工具）
-├── client.js                  # Client 半侧（约 3912 行，手写产物）
+├── client.js                  # Client 半侧（约 3985 行，手写产物）
 ├── locale/{en,zh}.json        # 插件管理器显示用 meta
 ├── icon.svg                   # 插件图标（插件管理器显示）
 ├── assets/
@@ -264,7 +272,7 @@ git clone <repo-url> dsh-chat-embed
 cd dsh-chat-embed
 
 # 无需安装依赖；直接跑门禁与测试
-npm run check     # 语法 + 清单 + 显示资源 + 服务注册表 + 81 项测试
+npm run check     # 语法 + 清单 + 显示资源 + 服务注册表 + 85 项测试
 npm test          # 只跑测试
 ```
 
@@ -285,7 +293,7 @@ plugin_manager { "action": "install_bundle", "target": "<本仓库克隆路径>"
 
 ## 已知限制
 
-1. **跨重启登录需要壳补丁**：壳默认给内存分区（`dsh-sidebar-browser-<uuid>`，无 `persist:`，每次启动随机），登录态不落盘。`tools/shell-patch/` 可修；客户端升级会覆盖 `app.asar`，需要重打。
+1. **跨重启登录需要壳补丁**：壳默认给内存分区（`dsh-sidebar-browser-<uuid>`，无 `persist:`，每次启动随机），登录态不落盘。`tools/shell-patch/` 可修；客户端升级会覆盖 `app.asar`，需要重打——菜单里的「检查补丁配置」会告诉你现在是哪种情况、命令是什么。
 2. **左右互斥**：右栏聊天依赖会话视图；中央打开聊天面板时右栏不可用。同一时刻只有一处显示聊天页，切换会重建一次（自动回到上次会话，不用重新登录）。
 3. **中心面板会被切走**：选另一个主面板时中央聊天页随 DOM 卸载，回来要重建；右栏 tab 带 `keepMounted`，切标签/切会话不卸载。
 4. **内存**：每点亮一个标签 = 一个渲染进程；7 个全开会明显吃内存。
@@ -305,7 +313,7 @@ plugin_manager { "action": "install_bundle", "target": "<本仓库克隆路径>"
 | 标签变红（`data-failed`） | 该标签租约或导航失败：点它看状态行 `detail`，再「重新加载」 |
 | 显示「已连接」但页面空白 | 网络或站点风控；「重新加载」或「外开」 |
 | 出现「使用环境异常」 | UA 归一化失效（壳升级后 UA 结构变了），查 `normalizedUserAgent` |
-| 重启后要重新登录 | 未打壳补丁，或补丁被客户端升级覆盖：重跑 `patch-asar.cjs build` |
+| 重启后要重新登录 | 未打壳补丁，或补丁被客户端升级覆盖：菜单「检查补丁配置」→ 发送，让 agent 核对并给出命令 |
 | 磁盘占用变大 | 执行 `清理聊天缓存.cmd`（只删缓存，保留登录）；或确认补丁含 `cache:false` |
 | 标签文字/顺序要改 | 只改 `PROVIDERS`，`npm run check` + 重装 |
 
@@ -315,6 +323,7 @@ plugin_manager { "action": "install_bundle", "target": "<本仓库克隆路径>"
 
 | 版本 | 变化 |
 | --- | --- |
+| `0.6.5` | 设置菜单标题与诊断卡片显示自身版本号；「检查补丁配置」改为一次性开关：不再内联渲染报告，而是打开新会话并把已知事实预填进输入框（借用 DSH「创建你的插件」的 `uiWorkspace.startSession` 用法） |
 | `0.6.3` | 自检报告改为一次性：关闭设置菜单即清除，重新打开不再显示上次的报告 |
 | `0.6.2` | 修复设置菜单被长路径撑宽：菜单加 `max-width`、报告文本 `overflow-wrap:anywhere`、补丁命令单独占一行（便于整条复制） |
 | `0.6.1` | 探针找出桌面版自带的 Node 运行时，自检报告与「复制补丁说明」直接给出可执行命令（含 `--resources`，支持自定义安装目录）；无需用户另装 Node |

package/client.js

@@ -103,7 +103,7 @@ window.__ModuleLoader__.load({
     let openRightTabImpl = () => {}
 
     /** Build identity, surfaced in the panel so a packaged app can be diagnosed. */
-    const BUILD = '0.6.3'
+    const BUILD = '0.6.5'
 
     /** Where a re-applied instance finds the one it must take over from. */
     const INSTANCE_KEY = '__DSH_CHAT_EMBED_INSTANCE__'
@@ -264,9 +264,20 @@ window.__ModuleLoader__.load({
           'Experimental: the patch rewrites the app.asar of the desktop shell and needs write access to its install folder. A shell update replaces it, so the patch has to be applied again.',
         persistCopy: 'Copy the patch instructions',
         persistCheck: 'Check the patch setup',
-        persistCheckRunning: 'Checking…',
-        persistReportCopied: 'Self-check copied',
-        persistReportTitle: 'Shell patch self-check',
+        persistCheckHint: 'Opens a new session and drafts the check for you',
+        patchPromptPlugin: 'Plugin',
+        patchPrompt:
+          'Check the DSH desktop shell patch that keeps the embedded chat logins across restarts, and tell me what to do.\n\nKnown so far:\n{facts}\n\nCall the dsh_chat_embed_patch_check tool to confirm the facts, then:\n1. say in a sentence or two what the situation is;\n2. if the patch is missing or was lost, give me the exact command to run;\n3. do not modify any file.',
+        patchYes: 'yes',
+        patchNo: 'no',
+        patchPresent: 'present',
+        patchMissing: 'missing (shell version mismatch)',
+        patchUnknown: 'unknown',
+        patchWritable: 'writable',
+        patchSiteLabel: 'patch site',
+        patchApplied: 'already patched',
+        patchCommandLabel: 'Patch command:',
+        patchDetail: 'Note',
         copyDiag: 'Copy diagnostics',
         copied: 'Copied',
         copyFailed: 'Copy failed',
@@ -345,9 +356,20 @@ window.__ModuleLoader__.load({
         persistRisk: '实验性功能：补丁会改写桌面壳的 app.asar，需要安装目录的写权限；桌面壳升级会覆盖补丁，需要重新打一次。',
         persistCopy: '复制补丁说明',
         persistCheck: '检查补丁配置',
-        persistCheckRunning: '正在检查…',
-        persistReportCopied: '自检报告已复制',
-        persistReportTitle: '壳补丁自检报告',
+        persistCheckHint: '打开新会话，把检查内容写好，点发送即可',
+        patchPromptPlugin: '插件',
+        patchPrompt:
+          '帮我检查 DSH 桌面版「跨重启保持登录」的补丁状态，并告诉我该做什么。\n\n已知信息：\n{facts}\n\n请先调用 dsh_chat_embed_patch_check 工具核对上面的信息，然后：\n1. 用一两句话说明现在是什么情况；\n2. 如果补丁没打或已失效，给出我可以直接执行的命令；\n3. 不要修改任何文件。',
+        patchYes: '是',
+        patchNo: '否',
+        patchPresent: '存在',
+        patchMissing: '不存在（壳版本不匹配）',
+        patchUnknown: '未知',
+        patchWritable: '可写',
+        patchSiteLabel: '补丁点',
+        patchApplied: '已打补丁',
+        patchCommandLabel: '补丁命令:',
+        patchDetail: '说明',
         copyDiag: '复制诊断信息',
         copied: '已复制',
         copyFailed: '复制失败',
@@ -2472,7 +2494,7 @@ window.__ModuleLoader__.load({
      *
      * @type {{ running: boolean, report: string }}
      */
-    const patchCheck = { running: false, report: '' }
+    const patchCheck = { running: false }
 
     /** One-shot cache of the Host probe, so both actions read the same facts. */
     const patchProbe = { loaded: false, value: undefined }
@@ -2510,69 +2532,77 @@ window.__ModuleLoader__.load({
       return patchProbe.value
     }
 
-    async function runPatchCheck(t) {
-      if (patchCheck.running) return
+    /**
+     * Hand the self-check to a Session instead of rendering it into the menu.
+     *
+     * A report inside the settings menu made the panel unusable: absolute paths
+     * and a full command line stretched it across the surface, and the result was
+     * a one-shot answer kept in panel state. A Session is the right place — the
+     * agent can call the patch-check tool, read the reply and explain it, and the
+     * user confirms by pressing send.
+     *
+     * @param {(key: string) => string} t
+     * @returns {Promise<void>}
+     */
+    async function openPatchCheckSession(t) {
+      const workspace = typeof ctx.get === 'function' ? ctx.get('uiWorkspace') : undefined
+      if (workspace === undefined || workspace === null || typeof workspace.startSession !== 'function') {
+        // No Session service: fall back to the clipboard so the click still does
+        // something useful instead of failing silently.
+        void copyText(patchInstructions(t, patchProbe.value))
+        return
+      }
       patchCheck.running = true
       notify()
-      let report = ''
       try {
-        patchProbe.loaded = false
         const probe = await fetchProbe()
-        report = formatPatchReport(t, probe)
+        const prompt = buildPatchPrompt(t, probe)
+        patchProbe.loaded = false
+        workspace.startSession(undefined, { prompt, whenDraftExists: 'append' })
       } catch (error) {
-        report = formatPatchReport(t, undefined) + '\n' + t('copyFailed') + ': ' + messageOf(error)
+        void copyText(patchInstructions(t, patchProbe.value) + '\n' + t('copyFailed') + ': ' + messageOf(error))
       }
       patchCheck.running = false
-      patchCheck.report = report
       notify()
-      void copyText(report)
     }
 
     /**
+     * The text dropped into the new Session's draft: what is already known, so
+     * the agent starts from facts instead of asking the user to run something.
+     *
      * @param {(key: string) => string} t
      * @param {any} probe
      * @returns {string}
      */
-    function formatPatchReport(t, probe) {
-      const lines = [t('persistReportTitle')]
-      lines.push(t('persistLabel') + ': ' + persistenceText(t, persistenceState()))
-      if (probe === undefined || probe === null) {
-        lines.push(t('persistHint'))
-        return lines.join('\n')
-      }
-      const row = (label, value) => {
-        if (value === undefined || value === null || value === '') return
-        lines.push(label + ': ' + String(value))
-      }
-      row('resources', probe.resources)
-      row('app.asar', probe.asar)
-      row('app.asar.orig', probe.backup === true ? '有' : '无')
-      row('app.asar.new', probe.staged === true ? '有（待替换）' : '无')
-      row('可写', probe.writable === true ? '是' : '否')
-      row('补丁点', probe.patchSite === true ? '存在' : probe.patchSite === false ? '不存在（壳版本不匹配）' : '未知')
-      row('已打补丁', probe.patched === true ? '是' : probe.patched === false ? '否' : '未知')
-      row('node', probe.node)
-      if (probe.nodeBinary === undefined) {
-        lines.push('（没有找到可用的 Node 运行时，需要先安装 Node.js 22 或更新）')
-      }
-      row('说明', probe.detail)
-      // The command is long and path-heavy: give it its own indented block so a
-      // copy takes the command alone and the menu wraps instead of stretching.
-      if (typeof probe.patchCommand === 'string' && probe.patchCommand !== '') {
-        lines.push('')
-        lines.push('补丁命令:')
-        lines.push(probe.patchCommand)
+    function buildPatchPrompt(t, probe) {
+      const facts = []
+      facts.push(t('patchPromptPlugin') + ': dsh-chat-embed ' + BUILD)
+      facts.push(t('persistLabel') + ': ' + persistenceText(t, persistenceState()))
+      if (probe !== undefined && probe !== null) {
+        const row = (label, value) => {
+          if (value === undefined || value === null || value === '') return
+          facts.push(label + ': ' + String(value))
+        }
+        row('resources', probe.resources)
+        row('app.asar', probe.asar)
+        row('app.asar.orig', probe.backup === true ? t('patchYes') : t('patchNo'))
+        row(t('patchWritable'), probe.writable === true ? t('patchYes') : t('patchNo'))
+        row(
+          t('patchSiteLabel'),
+          probe.patchSite === true ? t('patchPresent') : probe.patchSite === false ? t('patchMissing') : t('patchUnknown'),
+        )
+        row(
+          t('patchApplied'),
+          probe.patched === true ? t('patchYes') : probe.patched === false ? t('patchNo') : t('patchUnknown'),
+        )
+        if (typeof probe.patchCommand === 'string' && probe.patchCommand !== '') {
+          facts.push('')
+          facts.push(t('patchCommandLabel'))
+          facts.push(probe.patchCommand)
+        }
+        if (typeof probe.detail === 'string' && probe.detail !== '') facts.push(t('patchDetail') + ': ' + probe.detail)
       }
-      return lines.join('\n')
-    }
-
-    /**
-     * Drop the one-shot self-check answer. Closing the settings menu calls this:
-     * a report belongs to the click that asked for it, not to the panel state.
-     */
-    function resetPatchCheck() {
-      patchCheck.report = ''
-      patchCheck.running = false
+      return fill(t('patchPrompt'), { facts: facts.join('\n') })
     }
 
     /** @returns {{ state: string, detail: string, seats: any[] }} */
@@ -2785,13 +2815,15 @@ window.__ModuleLoader__.load({
       '.dce-guest-layer[data-active="true"]{display:flex}',
       '.dce-guest{display:inline-flex;flex:1 1 auto;width:100%;height:100%;border:0;background:transparent}',
       '.dce-card{position:absolute;inset:0;z-index:2;display:flex;flex-direction:column;gap:10px;box-sizing:border-box;width:auto;max-width:460px;height:max-content;margin:auto;padding:20px 22px;border:1px solid var(--dsw-alias-border-l1,rgba(127,127,127,.24));border-radius:12px;background:var(--dsw-alias-bg-layer-2,#fff);box-shadow:0 12px 32px rgba(0,0,0,.12);font-size:13px}',
-      '.dce-card-title{font-size:14px;font-weight:600}',
+      '.dce-card-title{display:flex;align-items:baseline;gap:8px;font-size:14px;font-weight:600}',
       '.dce-card-body{color:var(--dsw-alias-label-secondary,#5f6368);line-height:1.6}',
       '.dce-card-detail{font-family:var(--ds-font-family-code,ui-monospace,monospace);font-size:11px;color:var(--dsw-alias-label-tertiary,#9aa0a6);word-break:break-all}',
       '.dce-card-actions{display:flex;gap:8px;justify-content:flex-end}',
       '.dce-menu-scrim{position:absolute;inset:0;z-index:5}',
       '.dce-menu{position:absolute;top:34px;right:6px;z-index:6;min-width:196px;max-width:min(420px,calc(100% - 12px));box-sizing:border-box;padding:6px;border:1px solid var(--dsw-alias-border-l1,rgba(127,127,127,.24));border-radius:10px;background:var(--dsw-alias-bg-layer-2,#fff);box-shadow:0 12px 32px rgba(0,0,0,.18);display:flex;flex-direction:column;gap:1px}',
-      '.dce-menu-title{font-size:11px;color:var(--dsw-alias-label-tertiary,#9aa0a6);padding:6px 8px 4px;letter-spacing:.04em}',
+      '.dce-menu-title{display:flex;align-items:baseline;justify-content:space-between;gap:10px;font-size:11px;color:var(--dsw-alias-label-tertiary,#9aa0a6);padding:6px 8px 4px;letter-spacing:.04em}',
+      '.dce-menu-version{flex:0 0 auto;font-size:10.5px;font-family:ui-monospace,SFMono-Regular,Menlo,monospace;letter-spacing:0;opacity:.8}',
+      '.dce-card-version{margin-left:auto;font-size:11px;font-weight:400;font-family:ui-monospace,SFMono-Regular,Menlo,monospace;color:var(--dsw-alias-label-tertiary,#9aa0a6);opacity:.8}',
       '.dce-menu-row{display:flex;align-items:center;justify-content:space-between;gap:14px;padding:5px 8px;border-radius:6px;font-size:13px;color:var(--dsw-alias-label-primary,#1f2329)}',
       '.dce-menu-row:hover{background:var(--dsw-alias-interactive-bg-hover,rgba(127,127,127,.12))}',
       '.dce-menu-label{flex:1 1 auto;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}',
@@ -2799,7 +2831,6 @@ window.__ModuleLoader__.load({
       '.dce-menu-sep{margin:5px 0 3px;border-top:1px solid var(--dsw-alias-border-l1,rgba(127,127,127,.24))}',
       '.dce-menu-note{margin:4px 8px 6px;font-size:11.5px;line-height:1.5;color:var(--dsw-alias-label-tertiary,#9aa0a6);white-space:pre-wrap;overflow-wrap:anywhere;word-break:break-word;max-width:100%;box-sizing:border-box}',
       '.dce-menu-note[data-persist-risk="true"]{color:var(--dsw-alias-label-warning,#c98b16)}',
-      '.dce-menu-note[data-patch-report="true"]{max-height:180px;overflow:auto;font-family:ui-monospace,SFMono-Regular,Menlo,monospace;font-size:11px}',
       '.dce-menu-item{display:flex;align-items:center;justify-content:flex-start;gap:8px;width:100%;box-sizing:border-box;padding:6px 8px;border:0;border-radius:6px;background:transparent;color:inherit;font-size:13px;text-align:left;cursor:pointer}',
       '.dce-menu-item:hover{background:var(--dsw-alias-interactive-bg-hover,rgba(127,127,127,.12))}',
       '.dce-right-title{display:inline-flex;align-items:center;gap:6px;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}',
@@ -3229,7 +3260,6 @@ window.__ModuleLoader__.load({
        */
       const closeMenu = () => {
         setMenuOpen(false)
-        resetPatchCheck()
       }
       const [copyState, setCopyState] = React.useState('')
       const barTimerRef = React.useRef(0)
@@ -3436,7 +3466,12 @@ window.__ModuleLoader__.load({
             ? h(
                 'div',
                 { className: 'dce-menu', role: 'menu' },
-                h('div', { className: 'dce-menu-title' }, t('menuTitle')),
+                h(
+                  'div',
+                  { className: 'dce-menu-title' },
+                  h('span', null, t('menuTitle')),
+                  h('span', { className: 'dce-menu-version', 'data-build': BUILD }, 'v' + BUILD),
+                ),
                 providersInOrder().map((entry) => {
                   const on = isEnabled(entry.id)
                   const lastOne = on && enabledIds.length <= 1
@@ -3488,21 +3523,28 @@ window.__ModuleLoader__.load({
                       h('span', { className: 'dce-menu-label' }, t('persistCopy')),
                     ),
                 h(
-                  'button',
-                  {
-                    type: 'button',
-                    className: 'dce-menu-item',
-                    'data-patch-check': 'true',
-                    disabled: patchCheck.running,
-                    onClick: () => {
-                      void runPatchCheck(t)
+                  'div',
+                  { className: 'dce-menu-row' },
+                  h('span', { className: 'dce-menu-label', title: t('persistCheckHint') }, t('persistCheck')),
+                  h(
+                    'button',
+                    {
+                      type: 'button',
+                      role: 'switch',
+                      className: 'dce-switch',
+                      'data-on': patchCheck.running ? 'true' : 'false',
+                      'aria-checked': patchCheck.running ? 'true' : 'false',
+                      'data-patch-check': 'true',
+                      'aria-label': t('persistCheck'),
+                      title: t('persistCheckHint'),
+                      disabled: patchCheck.running,
+                      onClick: () => {
+                        closeMenu()
+                        void openPatchCheckSession(t)
+                      },
                     },
-                  },
-                  h('span', { className: 'dce-menu-label' }, patchCheck.running ? t('persistCheckRunning') : t('persistCheck')),
+                  ),
                 ),
-                patchCheck.report === ''
-                  ? null
-                  : h('div', { className: 'dce-menu-note', 'data-patch-report': 'true' }, patchCheck.report),
                 h(
                   'button',
                   {
@@ -3599,7 +3641,12 @@ window.__ModuleLoader__.load({
               ? h(
                   'div',
                   { className: 'dce-card', role: 'dialog' },
-                  h('div', { className: 'dce-card-title' }, t('diagTitle')),
+                  h(
+                    'div',
+                    { className: 'dce-card-title' },
+                    h('span', null, t('diagTitle')),
+                    h('span', { className: 'dce-card-version', 'data-build': BUILD }, 'v' + BUILD),
+                  ),
                   h(
                     'div',
                     { className: 'dce-card-detail' },
@@ -3779,10 +3826,9 @@ window.__ModuleLoader__.load({
         patchInstructions,
         fetchProbe,
         patchProbe,
-        formatPatchReport,
-        runPatchCheck,
         patchCheck,
-        resetPatchCheck,
+        openPatchCheckSession,
+        buildPatchPrompt,
         setLogging,
         clearLog,
         readLogEntries,

package/docs/architecture.md

@@ -3,7 +3,7 @@
 本文记录 `client.js` 里每一条**反直觉**的实现决策、支撑它的证据，以及升级桌面壳时必须重新验证的清单。
 
 目标运行环境：**`@deepseek-ai/dsh-desktop 0.2.2-rc.1`（Electron / Chromium）**。
-当前实现：**v0.6.3**（`client.js` 约 3912 行，83 项契约测试）。
+当前实现：**v0.6.5**（`client.js` 约 3985 行，85 项契约测试）。
 
 > **架构一句话**：聊天页直接渲染在**席位的布局盒**里（`.dce-panel.dce-inline`，`width/height:100%`），几何完全交给 CSS；席位只有两个 —— 中央主面板（`main`）和右栏聊天 tab —— 二者互斥，**哪边点哪边接管**，切换时 guest 重建一次并回到上次会话。
 
@@ -331,6 +331,8 @@ Host 半侧另有两条只读通道，专门用来回答"为什么重启后要
 | 通道 | 内容 |
 | --- | --- |
 | `GET /dsh-chat-embed/patch-check` | 安装目录、`app.asar` 是否可写、是否已打补丁、补丁点是否还存在、备份与待替换文件、大小与内容哈希、**可执行的补丁命令**（含自带 Node 运行时路径与 `--resources`） |
+
+客户端拿到探针结果后不再内联渲染，而是通过 `uiWorkspace.startSession(undefined, { prompt, whenDraftExists: 'append' })` 打开一个新会话，把事实与授权边界写进草稿；用户点发送即可。这与 DSH 自身「创建你的插件」入口用的是同一个 API，`whenDraftExists` 的取值语义在 `dsh-client-ui-conversation` 的 `requestDraftInitialization` 里定义（`replace` / `keep` / `append`）。
 | agent 工具 `dsh_chat_embed_patch_check` | 同一份读数，供模型直接查询（只读，无需审批） |
 
 > 读取 `app.asar` 必须走 Electron 的 `original-fs`：被补丁过的 `node:fs` 会把以 `.asar` 结尾的路径当成目录，`readFileSync` 直接 ENOENT。探针优先用 `original-fs`，普通 Node 下回落到 `node:fs`。

package/docs/publishing.md

@@ -5,13 +5,13 @@
 ## 版本与提交约定
 
 - 同时改 `package.json` 的 `version` 与 `client.js` 的 `BUILD`，两者必须一致；
-- 门禁必须绿：`npm run check`（`verify-bundle` + 83 项契约测试）；
+- 门禁必须绿：`npm run check`（`verify-bundle` + 85 项契约测试）；
 - 代码注释/提交信息英文，文档中文。
 
 ## 发版步骤
 
 ```powershell
-npm run check            # 门禁：verify-bundle + 83 项测试（prepublishOnly 也会跑）
+npm run check            # 门禁：verify-bundle + 85 项测试（prepublishOnly 也会跑）
 npm run pack:dist        # 产出 dist\dsh-chat-embed-<版本>.tgz
 gh release create v0.5.0 dist\dsh-chat-embed-0.5.0.tgz --title "v0.5.0" --notes-file dist\release-notes.md
 ```
@@ -31,8 +31,8 @@ Get-FileHash $env:TEMP\check\dsh-chat-embed-0.5.0.tgz -Algorithm SHA256
 | --- | --- |
 | 仓库 | <https://github.com/poluce/dsh-chat-embed> |
 | Release | <https://github.com/poluce/dsh-chat-embed/releases> |
-| 分发包 | `dsh-chat-embed-0.6.3.tgz`（16 个文件，约 70 kB） |
-| npm | `dsh-chat-embed@0.6.3`（<https://www.npmjs.com/package/dsh-chat-embed>，维护者 `poluce_auto`） |
+| 分发包 | `dsh-chat-embed-0.6.5.tgz`（16 个文件，约 70 kB） |
+| npm | `dsh-chat-embed@0.6.5`（<https://www.npmjs.com/package/dsh-chat-embed>，维护者 `poluce_auto`） |
 | 商店图标 | `assets/icon-180.png`（180×180 PNG） |
 | 商店截图 | `assets/screenshots/` + 仓库根 `screenshots.json`（6 张） |
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-chat-embed",
-  "version": "0.6.3",
+  "version": "0.6.5",
   "author": "poluce <fishsummer@126.com>",
   "description": "Multi-tab AI chat embed for the DeepSeek Harness desktop app: DeepSeek, 豆包, ChatGPT, MiniMax, Kimi, Gemini and Grok, each signed in separately.",
   "type": "module",