dsh-long-plugins 2.2.1 → 2.2.2

package/client/client.js

@@ -3053,7 +3053,7 @@ window.__ModuleLoader__.load({
         backdrop-filter: none;
         -webkit-backdrop-filter: none;
       }
-      /* 左栏顶部「新会话」按钮：去掉白/黑实底与边框，透出背景图；文字跟侧边栏一致(白+描边) */
+      /* 左栏顶部「新会话」按钮：去掉白/黑实底与边框，透出背景图；文字颜色交由下方统一的侧边栏/顶栏可读文字规则决定 */
       html[data-dsh-glass="on"] #root [class*="newSession"] {
         background-color: transparent !important;
         background-image: none !important;
@@ -3062,9 +3062,9 @@ window.__ModuleLoader__.load({
         box-shadow: none !important;
         backdrop-filter: none !important;
         -webkit-backdrop-filter: none !important;
-        color: #ffffff !important;
-        text-shadow: 0 1px 3px rgba(0,0,0,.85);
       }
+      /* 左栏/顶栏文字可读性改用 JS 处理(见 glassPlugin.apply 的 applyChromeText)，
+         只作用于主界面左栏/顶栏、并跳过设置/弹窗/浮层，避免波及设置面板 */
       /* 左栏内部根 / 底部容器也用透明（这些是 DSH 当前版本哈希类名；背景图要透到左栏与底部） */
       html[data-dsh-glass="on"] #root [class*="hHd-Xa_root"],
       html[data-dsh-glass="on"] #root [class*="FJxK0a_root"] {
@@ -3109,7 +3109,7 @@ window.__ModuleLoader__.load({
         -webkit-backdrop-filter: none !important;
       }
       /* 输入框盒子(uV2eYG_card)：实底(浅色=白/深色=深)并在背景图之上，文字随主题，保证可读。
-         加 #root 提高优先级，压过 DSH 自身把 card 背景设透明的规则 */
+         加 #root 提高优先级，压过 DSH 自身把 card 背景设透明的规则(与 v2.2.1 一致) */
       html[data-dsh-glass="on"] #root [class*="uV2eYG_card"],
       html[data-dsh-glass="on"] [class*="uV2eYG_card"] {
         position: relative !important;
@@ -3125,6 +3125,33 @@ window.__ModuleLoader__.load({
         html[data-dsh-glass="on"] #root [class*="uV2eYG_card"],
         html[data-dsh-glass="on"] [class*="uV2eYG_card"] { background: #1c2530 !important; color: #f5f7fa !important; }
       }
+      /* 会话语流"耗时统计"(turn-tail: 12:38/用时/首token/tok/s)：白字+深投影，避免淡字叠在背景图上看不见 */
+      html[data-dsh-glass="on"] [class*="osXY9a_root"],
+      html[data-dsh-glass="on"] [class*="osXY9a_root"] span,
+      html[data-dsh-glass="on"] [class*="p-xYUq_timeEnd"],
+      html[data-dsh-glass="on"] [class*="p-xYUq_"] span {
+        color: #ffffff !important;
+        text-shadow: 0 1px 1px rgba(0,0,0,.5);
+      }
+      /* DSH 弹窗/浮层(提问/确认/重命名等)：给不透明底+主题文字, 杜绝透明与会话内容重叠 */
+      html[data-dsh-glass="on"] [class*="Radix"] [class*="Content"],
+      html[data-dsh-glass="on"] [class*="DialogContent"],
+      html[data-dsh-glass="on"] [class*="ModalContent"],
+      html[data-dsh-glass="on"] [class*="overlay"] [class*="content"],
+      html[data-dsh-glass="on"] [class*="_content"][class*="dialog"] {
+        background-color: var(--dsw-specific-input-major, #e8edf3) !important;
+        color: var(--dsw-alias-label-primary) !important;
+        backdrop-filter: blur(8px) !important;
+        -webkit-backdrop-filter: blur(8px) !important;
+      }
+      /* DSH 提问/弹窗卡(M8wy4a_card 等)：不透明底+原生文字, 避免透明重叠、白字 */
+      html[data-dsh-glass="on"] [class*="M8wy4a_card"],
+      html[data-dsh-glass="on"] [data-chain-overlay-fallback] [class*="card"] {
+        background-color: var(--dsw-specific-input-major, #e8edf3) !important;
+        color: var(--dsw-alias-label-primary) !important;
+        backdrop-filter: blur(8px) !important;
+        -webkit-backdrop-filter: blur(8px) !important;
+      }
       /* 轮次/历史提问预览：默认隐藏（点开才显示），并去掉头部底色，避免底部露出白条 */
       .dsh-turn-preview:not(.open){display:none !important;}
       .dsh-turn-preview-head{background:transparent !important;}
@@ -3148,17 +3175,21 @@ window.__ModuleLoader__.load({
       html[data-dsh-glass="on"][data-dsh-theme="light"] #root [class*="QWLzLg_title"] {
         color: #2f3d4a !important;
       }
-      /* 输入框下方状态/统计行(余额+步数/时长/速度等)都在 composer.dock 这个稳定 data 槽里：
-         混淆类名会变, 改用 data 属性锁定, 按主题给高对比色+描边, 保证在背景图上可读 */
-      html[data-dsh-glass="on"][data-dsh-theme="light"] [data-slot-conversation="conversation.composer.dock"],
-      html[data-dsh-glass="on"][data-dsh-theme="light"] [data-slot-conversation="conversation.composer.dock"] * {
-        color: #243240 !important;
-        text-shadow: 0 1px 2px rgba(255,255,255,.5);
-      }
-      html[data-dsh-glass="on"][data-dsh-theme="dark"] [data-slot-conversation="conversation.composer.dock"],
-      html[data-dsh-glass="on"][data-dsh-theme="dark"] [data-slot-conversation="conversation.composer.dock"] * {
-        color: #e8edf3 !important;
-        text-shadow: 0 1px 2px rgba(0,0,0,.6);
+      /* 输入框下方状态/统计行(余额+步数/时长/速度等)都在 composer.dock 槽里：
+         背景是会变的背景图, 单色难保证可读；给整块加半透明深色衬底+亮字, 任意背景都可读。
+         槽位属性可能是 data-slot-conversation 或 data-slot(两种都锁) */
+      html[data-dsh-glass="on"] [data-slot-conversation="conversation.composer.dock"],
+      html[data-dsh-glass="on"] [data-slot="conversation.composer.dock"] {
+        background-color: rgba(12,20,30,.55) !important;
+        border-radius: 8px !important;
+        padding: 1px 10px !important;
+        backdrop-filter: blur(2px);
+        -webkit-backdrop-filter: blur(2px);
+      }
+      html[data-dsh-glass="on"] [data-slot-conversation="conversation.composer.dock"] *,
+      html[data-dsh-glass="on"] [data-slot="conversation.composer.dock"] * {
+        color: #f0f4f9 !important;
+        text-shadow: 0 1px 1px rgba(0,0,0,.5);
       }
       /* 会话区所有内容元素背景透明化：去掉"反底色"小块衬底，统一融入磨砂卡片 */
       html[data-dsh-glass="on"] #root [class*="wSkVaW_scrollBody"] *:not([class*="button"]):not([class*="bubble"]):not([class*="_menu"]) {
@@ -3509,6 +3540,7 @@ window.__ModuleLoader__.load({
               const bgHex = hasColor ? tb.color : defBg
               const alpha = (tb && typeof tb.opacity === 'number' && Number.isFinite(tb.opacity)) ? Math.min(1, Math.max(0, tb.opacity)) : 1
               const bg = `rgba(${hexToRgb(bgHex)},${alpha})`
+              // 背景/文字同步：按背景底色亮度决定文字色(亮底=深字/暗底=浅字)，确保可读；与 v2.2.1 一致
               const fg = relLum(bgHex) > 0.5 ? '#1a2332' : '#f5f7fa'
               inputCard.style.setProperty('background-color', bg, 'important')
               inputCard.style.setProperty('color', fg, 'important')
@@ -3517,6 +3549,157 @@ window.__ModuleLoader__.load({
                 el.style.setProperty('color', fg, 'important')
               })
             }
+            // 主界面左栏/顶栏可见文字：白字+单层轻投影(Windows 桌面图标风格, 不加粗)。
+            // 显式跳过设置/弹窗/浮层(modal/overlay/dialog/settings/panel/drawer/Radix/menu), 避免波及设置面板/弹出菜单。
+            const SKIP_SEL = ':is([class*="settings"],[class*="Dialog"],[class*="dialog"],[class*="modal"],[class*="overlay"],[class*="_panel"],[class*="panel"],[class*="drawer"],[class*="Radix"],[class*="_menu"],[class*="brand"],[data-chain-overlay-fallback],[class*="M8wy4a_"])'
+            const isInSkip = (el) => { let p = el; while (p && p !== document.documentElement) { if (p.matches && p.matches(SKIP_SEL)) return true; p = p.parentElement } return false }
+            const applyChromeText = () => {
+              if (!c.enabled) return
+              // 只处理主界面左栏/顶栏内带文字的元素；跳过图标/纯容器。
+              // 文字检测放宽：button/a/span/li/p/标题等直接算，纯 div 容器需自身带文本才算，
+              // 这样底部「设置/已归档」等包在子元素里的按钮也能命中。
+              const roots = [...document.querySelectorAll('#root [class*="sidebarCol"],#root [class*="wSkVaW_header"]')]
+              roots.forEach((root) => {
+                if (isInSkip(root)) return
+                root.querySelectorAll('div,span,button,a,label,p,li,h1,h2,h3,h4').forEach((el) => {
+                  if (isInSkip(el)) return
+                  const tag = el.tagName
+                  const hasText = el.textContent && el.textContent.trim()
+                  if (!hasText) return
+                  const ownText = Array.from(el.childNodes).some((n) => n.nodeType === 3 && n.textContent.trim())
+                  const textLike = /^(BUTTON|A|SPAN|LABEL|LI|P|H1|H2|H3|H4)$/.test(tag)
+                  if (!textLike && !ownText) return
+                  // 跳过有盒子背景的元素(badge/徽章/药丸等, 如 deepseek 的 HARNESS 徽章)：
+                  // 这类文字颜色应随其盒子背景走主题, 不强制白字(否则白底徽章+白字不可见)
+                  const bgbg = getComputedStyle(el).backgroundColor
+                  if (bgbg && bgbg !== 'rgba(0, 0, 0, 0)' && bgbg !== 'transparent') return
+                  el.style.setProperty('color', '#ffffff', 'important')
+                  el.style.setProperty('text-shadow', '0 1px 1px rgba(0,0,0,.5)')
+                })
+                // 图标也变白(随 currentColor)，用于工作区文件夹等单色图标；保留显式品牌色
+                root.querySelectorAll('svg, [class*="icon"], [class*="Icon"]').forEach((el) => {
+                  if (isInSkip(el)) return
+                  el.style.setProperty('color', '#ffffff', 'important')
+                  el.querySelectorAll('path,use,rect,circle,line,polyline,ellipse').forEach((p) => {
+                    const f = (p.getAttribute('fill') || '').toLowerCase()
+                    if (f && f !== 'none' && f !== 'currentcolor') return
+                    p.style.setProperty('fill', 'currentColor', 'important')
+                    const s = (p.getAttribute('stroke') || '').toLowerCase()
+                    if (s && s !== 'none' && s !== 'currentcolor') return
+                    p.style.setProperty('stroke', 'currentColor', 'important')
+                  })
+                })
+              })
+            }
+            // 会话区内容（尤其 AI 过程内容：Bash/Think 标签、思考、工具输出等浅色灰字）
+            // 在透明背景图上看不清；用同侧边栏「白字+深投影」处理，跳过有盒子背景的元素(用户气泡/代码块衬底等)。
+            const applySessionText = () => {
+              if (!c.enabled) return
+              const scroll = document.querySelector('#root [class*="wSkVaW_scrollBody"]')
+              if (!scroll) return
+              scroll.querySelectorAll('div,span,p,li,pre,code,button,a,label,h1,h2,h3,h4').forEach((el) => {
+                if (isInSkip(el)) return
+                const hasText = el.textContent && el.textContent.trim()
+                if (!hasText) return
+                const ownText = Array.from(el.childNodes).some((n) => n.nodeType === 3 && n.textContent.trim())
+                const textLike = /^(BUTTON|A|SPAN|LABEL|LI|P|H1|H2|H3|H4|PRE|CODE)$/.test(el.tagName)
+                if (!textLike && !ownText) return
+                const bgbg = getComputedStyle(el).backgroundColor
+                if (bgbg && bgbg !== 'rgba(0, 0, 0, 0)' && bgbg !== 'transparent') return
+                el.style.setProperty('color', '#ffffff', 'important')
+                el.style.setProperty('text-shadow', '0 1px 1px rgba(0,0,0,.5)')
+              })
+              // 在白字底上, 给过程内容配色区分, Error 用红色。
+              // 文字常在标签的子元素里(白字已把它设白), 故连同文本子元素一起上色。
+              const paint = (el, color) => {
+                if (!el) return
+                const set = (d) => { if (d.textContent && d.textContent.trim()) d.style.setProperty('color', color, 'important') }
+                set(el)
+                el.querySelectorAll('span,div,p,li,a').forEach(set)
+              }
+              // 错误/失败单行文本 → 红(只判短行、以 Error/错误/失败/异常 开头, 避免整段误标红)
+              const isErrText = (d) => {
+                const t = (d.textContent || '').trim()
+                if (!t || t.length > 120) return false
+                return /^(error|错误|失败|异常|fail)\b/i.test(t) || /^(error|错误|失败|异常)\s*[:：]/i.test(t) || /^File not found/i.test(t)
+              }
+              scroll.querySelectorAll('div,span,p,li,pre,code').forEach((el) => {
+                if (!isErrText(el)) return
+                const ownText = Array.from(el.childNodes).some((n) => n.nodeType === 3 && n.textContent.trim())
+                if (ownText) el.style.setProperty('color', '#ff6b6b', 'important')
+              })
+              // 工具名标签(o3BgMG_title)：按工具类型配色(Bash/Shell=绿, Read=蓝, Edit=橙, Write=紫, 默认蓝)
+              const toolColor = (text) => {
+                const t = (text || '').toLowerCase()
+                if (/bash|shell|zsh|terminal|powershell|cmd|sh\b/i.test(t)) return '#5ec26b'
+                if (/edit|modify/i.test(t)) return '#f0a860'
+                if (/write|create/i.test(t)) return '#c9a0ff'
+                return '#8ccfff'
+              }
+              scroll.querySelectorAll('[class*="o3BgMG_title"],[class*="CY-8Ka_title"]').forEach((title) => {
+                paint(title, toolColor(title.textContent))
+                // 从标签向上找最近一个"含链接/代码/更多文本"的容器作为工具行，找不到就用父级
+                let box = title.parentElement
+                for (let i = 0; i < 4 && box; i++) {
+                  if (box.querySelector && box.querySelector('a, code, [class*="desc"], [class*="path"], [class*="cmd"], [class*="arg"]')) break
+                  box = box.parentElement
+                }
+                if (!box) box = title.parentElement
+                box.querySelectorAll('div,span,a,p,li,pre,code').forEach((el) => {
+                  if (el === title || el.querySelector('[class*="o3BgMG_title"]')) return
+                  const ownText = Array.from(el.childNodes).some((n) => n.nodeType === 3 && n.textContent.trim())
+                  if (!ownText || isErrText(el)) return
+                  paint(el, '#6fb89a')
+                })
+              })
+              // 工具输出/路径(o3BgMG_summary)：成功 → 水绿；errorSummary 保持红
+              scroll.querySelectorAll('[class*="o3BgMG_summary"]').forEach((el) => {
+                if (/errorSummary/i.test(String(el.className))) return
+                paint(el, '#6fb89a')
+              })
+              // 路径/文件链接(o3BgMG_fileLink) → 水绿(与白字标签区分)
+              scroll.querySelectorAll('[class*="o3BgMG_fileLink"]').forEach((el) => paint(el, '#6fb89a'))
+              // 思考正文(think 容器) → 暖琥珀；再覆盖 Think 标签为琥珀。
+              // 全文档查找，不受 scrollBody 位置/加载时序影响(仍跳过设置/菜单/浮层)
+              const paintThinkBody = (root) => {
+                if (!root) return
+                root.querySelectorAll('div,span,p,li').forEach((el) => {
+                  const ownText = Array.from(el.childNodes).some((n) => n.nodeType === 3 && n.textContent.trim())
+                  if (ownText && !isErrText(el) && !isInSkip(el)) paint(el, '#e6c583')
+                })
+              }
+              const thinkRoots = [...document.querySelectorAll('[class*="QWLzLg_root"]')].filter((r) => !isInSkip(r))
+              thinkRoots.forEach(paintThinkBody)
+              document.querySelectorAll('[class*="QWLzLg_title"]').forEach((el) => {
+                if (!isInSkip(el)) paint(el, '#f2c566')
+              })
+              // 会话区工具调用等图标：改为白色清晰显示(单色图标随 currentColor 变白, 保留品牌色)
+              scroll.querySelectorAll('svg, [class*="icon"], [class*="Icon"]').forEach((el) => {
+                if (isInSkip(el)) return
+                el.style.setProperty('color', '#ffffff', 'important')
+                el.querySelectorAll('path,use,rect,circle,line,polyline,ellipse').forEach((p) => {
+                  const f = (p.getAttribute('fill') || '').toLowerCase()
+                  if (f && f !== 'none' && f !== 'currentcolor') return
+                  p.style.setProperty('fill', 'currentColor', 'important')
+                  const s = (p.getAttribute('stroke') || '').toLowerCase()
+                  if (s && s !== 'none' && s !== 'currentcolor') return
+                  p.style.setProperty('stroke', 'currentColor', 'important')
+                })
+              })
+            }
+            // DSH 提问/弹窗卡(M8wy4a_card 等)：内联强制不透明底+原生文字色, 压过 DSH 重渲染/透明与白字
+            const fixDialogs = () => {
+              if (!c.enabled) return
+              const dark = dshDark()
+              const bg = (getComputedStyle(document.documentElement).getPropertyValue('--dsw-specific-input-major') || '').trim() || '#e8edf3'
+              const fg = dark ? '#f2f6fa' : '#1a2332'
+              // 只匹配提问/弹窗卡(M8wy4a_card)，避免误匹配输入框 uV2eYG_card(含"card")导致 blur 重影
+              document.querySelectorAll('[class*="M8wy4a_card"]').forEach((el) => {
+                el.style.setProperty('background-color', bg, 'important')
+                el.style.setProperty('color', fg, 'important')
+                el.style.setProperty('backdrop-filter', 'blur(8px)')
+              })
+            }
             // 主题相关的东西统一重算：背景罩 + 输入框。切主题时由 observer/mq 触发。
             // 写入前先断开观察器，写完再重连，避免自触发造成死循环。
             const applyTheme = () => {
@@ -3529,6 +3712,9 @@ window.__ModuleLoader__.load({
                 const v = `rgba(${hexToRgb(bt.color)},${bt.mask})`
                 root.style.setProperty('--dsh-glass-bg-zone', v)
                 applyInputCard()
+                applyChromeText()
+                applySessionText()
+                fixDialogs()
               } finally {
                 if (obs) obs.observe(document.documentElement, { attributes: true, attributeFilter: ['style', 'class'] })
               }
@@ -3563,6 +3749,30 @@ window.__ModuleLoader__.load({
             // 记录当前主题应用函数，供唯一观察器/mq 调用
             window.__dshGlassApplyTheme = applyTheme
             centerScroll()
+            // 侧边栏/顶栏 DOM 变化(会话列表更新等)时重算左栏/顶栏文字，防抖 120ms
+            let chromeTimer = null
+            const chromeRoots = [...document.querySelectorAll('#root [class*="sidebarCol"],#root [class*="wSkVaW_header"]')]
+            const chromeObs = new MutationObserver(() => { if (chromeTimer) clearTimeout(chromeTimer); chromeTimer = setTimeout(applyChromeText, 120) })
+            chromeRoots.forEach((r) => chromeObs.observe(r, { childList: true, subtree: true, characterData: true }))
+            // 输入框卡片(uV2eYG_card/root)可能在启动后才挂载(会话/输入区加载晚)，
+            // 启动那一刻 applyInputCard 常找不到框 → 需刷新才生效。监听新增卡片节点时重算，防抖 100ms。
+            let cardTimer = null
+            const hasInputNode = (node) => (node.querySelector && (node.querySelector('[class*="uV2eYG_card"]') || node.querySelector('[class*="uV2eYG_root"]'))) || (node.matches && (node.matches('[class*="uV2eYG_card"]') || node.matches('[class*="uV2eYG_root"]')))
+            const cardObs = new MutationObserver((muts) => {
+              let hit = false
+              for (const m of muts) { for (const node of m.addedNodes) { if (node && node.nodeType === 1 && hasInputNode(node)) { hit = true; break } } if (hit) break }
+              if (hit) { if (cardTimer) clearTimeout(cardTimer); cardTimer = setTimeout(() => applyTheme(), 100) }
+            })
+            cardObs.observe(document.body, { childList: true, subtree: true })
+            // 会话区内容随流式更新会持续变，重算会话区文字(防抖 150ms, 只监听新增/移除节点)
+            let sessionTimer = null
+            const inScroll = (node) => { let p = node; while (p && p !== document.documentElement) { if (p.matches && p.matches('[class*="wSkVaW_scrollBody"]')) return true; p = p.parentElement } return false }
+            const sessionObs = new MutationObserver((muts) => {
+              let hit = false
+              for (const m of muts) { for (const node of m.addedNodes) { if (node.nodeType === 1 && inScroll(node)) { hit = true; break } } if (hit) break }
+              if (hit) { if (sessionTimer) clearTimeout(sessionTimer); sessionTimer = setTimeout(() => { applySessionText(); fixDialogs() }, 150) }
+            })
+            sessionObs.observe(document.body, { childList: true, subtree: true })
           }
           return () => {
             window.__dshGlassApply = undefined
@@ -3571,6 +3781,12 @@ window.__ModuleLoader__.load({
             if (window.__dshGlassStyleObs) { window.__dshGlassStyleObs.disconnect(); window.__dshGlassStyleObs = null }
             if (themeMq) themeMq.removeEventListener('change', themeMqHandler)
             window.__dshGlassApplyTheme = undefined
+            if (chromeObs) chromeObs.disconnect()
+            if (chromeTimer) clearTimeout(chromeTimer)
+            if (cardObs) cardObs.disconnect()
+            if (cardTimer) clearTimeout(cardTimer)
+            if (sessionObs) sessionObs.disconnect()
+            if (sessionTimer) clearTimeout(sessionTimer)
           }
         }, 'dsh-long-plugins: glass applier')
         ctx.slots.inject('settings.section', () => ctx.slots.register({ name: 'settings.section', id: 'glass-ui', order: 40, label: 'RA-Span' }, GlassSettingsSection))

package/dsh.plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-long-plugins",
   "description": "Merged DSH web plugins: upload manager (drag-and-drop attach any file to the message), workspace output files, skill docs, account balance, Markdown-to-Word (md2docx), and polished file preview (Word & PowerPoint real preview with zoom/pan, rendered Markdown), plus an auto-repair install for DSH core patches (reverse-proxy WebSocket heartbeat, upgrade relink). | 一个插件整合 DSH Web 的常用增强：上传管理（拖放上传：拖任意文件到会话框直接附加）、工作区「输出文件」面板、技能文档浏览、账户余额显示、Markdown 转 Word（md2docx）、Word/PowerPoint 真实预览（可缩放、翻页）；并自带修复安装，自动重连 DSH 核心补丁（反代 WebSocket 心跳、升级重连）。",
-  "version": "2.2.1",
+  "version": "2.2.2",
   "entry": {
     "name": "dsh-long-plugins",
     "inject": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-long-plugins",
-  "version": "2.2.1",
+  "version": "2.2.2",
   "description": "Merged DSH web plugins: upload manager (drag-and-drop attach any file to the message), workspace output files, skill docs, account balance, Markdown-to-Word (md2docx), and polished file preview (Word & PowerPoint real preview with zoom/pan, rendered Markdown), plus an auto-repair install for DSH core patches (reverse-proxy WebSocket heartbeat, upgrade relink). | 一个插件整合 DSH Web 的常用增强：上传管理（拖放上传：拖任意文件到会话框直接附加）、工作区「输出文件」面板、技能文档浏览、账户余额显示、Markdown 转 Word（md2docx）、Word/PowerPoint 真实预览（可缩放、翻页）；并自带修复安装，自动重连 DSH 核心补丁（反代 WebSocket 心跳、升级重连）。",
   "type": "module",
   "license": "MIT",

package/skill/dsh-upgrade/SKILL.md

@@ -73,6 +73,34 @@ cd "$DSH_HOME/profiles/web" && pnpm install
 4. 提问/审批窗口：弹出一个问题，等 60s+ 不再自己消失（心跳补丁生效）。
 5. 插件设置面板「上传文件」「输出文件」「技能文档」都在。
 6. `grep -q WEBSOCKET_HEARTBEAT_MS <核心解压路径>/dsh-client-connection/lib/index.js` → 心跳在位。
+7. **RA-Span 玻璃观感**：左栏/顶栏文字图标、会话区过程内容配色、输入框、提问卡、耗时统计等是否仍正常（见下文"RA-Span 升级后需重新校准"）。
+
+## RA-Span（统一桌面/玻璃）升级后需重新校准 ⚠️
+
+dsh-long-plugins 的「RA-Span（统一桌面/玻璃）」**大量依赖 DSH 内部混淆类名**（`o3BgMG_*`/`CY-8Ka_*`/`QWLzLg_*`/`M8wy4a_*`/`uV2eYG_*`/`wSkVaW_*`/`osXY9a_*`/`p-xYUq_*` 等）与 DSH 内部 DOM 结构。DSH 升级重打包后**这些类名前缀会变**，导致插件里靠类名压样式的规则/JS **静默失效**（不报错，只是观感/配色不对）。
+
+升级流程会**同步插件代码（逻辑保住）**，但**不会自动重抓新的类名**，所以升级后必须**人工复核**玻璃观感。
+
+### 升级后重点复核 + 处理
+1. 浏览器强刷（Ctrl/Cmd+Shift+R）。
+2. 逐项看 RA-Span 是否仍正常：
+   - 左栏/顶栏文字与图标（白字+深影、品牌区不被白化）
+   - 会话区过程内容配色（Bash 绿 / Read 蓝 / Edit 橙 / Write 紫 / Think 琥珀、错误红、工具输出水绿）
+   - 状态/统计行余额（走 `data-slot-conversation="composer.dock"` 的相对稳）
+   - 输入框（无重影、背景/文字随主题、可调色）
+   - 「新会话」按钮去白底
+3. 若某项观感/配色不对 → **新类名变了**。让用户在对应元素「右键 → 检查」，把高亮元素及父级的 class 发我，把 `client/client.js` 里对应的 `[class*="..."]` 前缀更新成新类名（只改选择器，不动逻辑）。
+4. 稳定项无需动：用 `data-slot-*` 的（状态栏）、注入 `<head>` 的 CSS、`data-dsh-theme` 属性。
+
+### 各依赖类名的功能清单（升级后最可能失效）
+| 功能 | 依赖类名 | 失效表现 |
+|---|---|---|
+| 工具名配色(Bash/Read/Edit/Write) | `o3BgMG_title` / `CY-8Ka_title` | 标签不变色 |
+| Think 配色 | `QWLzLg_*` | Think 不琥珀 |
+| 提问/弹窗不透明 | `M8wy4a_card` | 弹窗透明重叠 |
+| 输入框 | `uV2eYG_*` | 重影/背景不随主题 |
+| 耗时统计 | `osXY9a_*` / `p-xYUq_*` | 统计字淡/重影 |
+| 左栏「新会话」 | `newSession` | 白底回来 |
 
 ## 硬性安全边界（必须遵守）
 - **不主动 push / 打 tag / 发 Release**；需要发布版本时停下用 ask_user_question 等确认。
@@ -86,4 +114,5 @@ cd "$DSH_HOME/profiles/web" && pnpm install
 | 升级后设置页"未暴露命名空间" | 补丁2 被覆盖 | 重跑 apply-dsh-patches.sh |
 | 升级后提问窗口自己消失 | 心跳补丁(补丁3)被覆盖 | 重跑 apply-dsh-patches.sh 或装插件补丁脚本 |
 | 升级后插件不显示 | 插件安装副本未同步 | 步骤 5 `pnpm install` |
+| 升级后 RA-Span 观感/配色不对（输入框重影、标签不变色、弹窗透明、统计字淡等） | DSH 混淆类名变了 | 见 RA-Span 校准节：强刷 + 逐项检查，让用户右键给出新类名，更新 `client/client.js` 对应选择器 |
 | 按钮全没了/界面异常 | 浏览器缓存了旧前端 | 强刷 Ctrl/Cmd+Shift+R |