前言¶

在 DeepSeek Harness（DSH）里配合壁纸或皮肤插件使用时，常见做法是调「气泡不透明度」「玻璃透明度」让会话区更易读。但官方会话界面里，带 ..._bubble 样式的气泡只属于你发送的消息；助手回复是一段没有背景的正文，直接压在壁纸上。深色壁纸下，助手文字容易和背景糊在一起，皮肤侧的参数也管不到这一块。

dsh-assistant-bubble（维护者 yutianliang，社区分类：趣味换装）专门补这一块：给助手回复加一层自己的气泡底，可选液态玻璃材质，并让工具条、过程行、统计行等周边元素用同一套参数同步。仓库在 GitHub 上 MIT 许可，当前 package 版本为 1.3.0。

这是什么¶

一句话：DSH Web 端 UI 插件，通过客户端注入为助手消息及相关 UI 锚点绘制可调底色（含液态玻璃），并在设置里提供独立分区「助手回复气泡」。

背景动机来自 README：使用皮肤插件从 wallpaper 导入深色壁纸时，AI 回复无背景导致无法阅读；插件由社区协作完成，README 也提到气泡间距存在小问题，对观感可能有轻微影响。

核心功能¶

下面按 README 已写明的能力归纳，不超出资料范围。

助手回复与材质¶

• 助手回复气泡：圆角、可调底色；可开关液态玻璃（白釉高光、模糊、厚玻璃折射、落地阴影）。玻璃配方对齐社区插件 dsh-plugin-wallpaper-engine 的玻璃面思路。
• 周边信息同步：工具条（复制 / 点赞 / 分享 / 用量 / 时间）、过程折叠行、过程分组头（运行中）、思考触发条、会话统计行、上下文占用环、运行行等，与助手气泡共用材质与参数，设置里滑块一动一起变。
• 只给有内容的元素画底：锚点会先判断是否有可见文字（≥2 字）或可见按钮 / 图标，空壳不画底，避免出现只有底色没有文字的空白气泡。
• 工作步骤展示：工具调用行（如「运行命令」「网页获取」）与「思考」行也有气泡；折叠时为紧凑小胶囊，展开时保持宿主原本的大横条。
• 操作条常驻：取消宿主「非最后一条需悬停才显示」的门控。
• 宽度跟随内容：气泡不拉满整行。
• 宽表格：宿主原先把宽表格按滚动容器整屏出血，插件改为在气泡内横向滚动。
• 无障碍：系统开启「减少透明度」时自动去掉模糊与白釉。

非会话页面¶

皮肤把 AppFrame 背景令牌弄透明后，「插件」「自动化任务」「技能中心」「上下文洞察」等独立页面文字也会直接压在壁纸上。插件用一条通用规则给注册到主内容槽的页面（含第三方）铺底，并排除会话槽，聊天区仍保持「气泡浮在壁纸上」。设置 → 助手回复气泡 → 最下方可折叠分组可单独开关并调浓度。

实现上的挂载范围（便于理解行为）¶

样式挂在宿主 DOM 语义属性与 CSS Module 类名后缀上，例如助手正文、工具条、过程行、思考行、统计行、运行行、宽表格等（完整选择器见仓库 README「挂在哪些锚点上」表）。宿主大版本更新后最坏情况是样式静默失效，README 写明不会报错、不牵连其它插件。

思考面板展开时，插件会把粘性标题行的实心底色改为同色半透明并保留吸顶，避免展开后出现一条实心黑带。

安装与启用¶

最省事的方式：在 dsh-market（插件市场）搜索 Assistant bubble 或作者 yutianliang，点安装。

也可从 GitHub 安装最新 main：

# 从 GitHub 安装（最新 main）
dsh plugin --profile web add github:yutianliang/dsh-assistant-bubble

官方桌面端：侧边栏 插件 → 添加插件 → 填写 github:yutianliang/dsh-assistant-bubble。

本地开发改代码时可用 link:，例如 dsh plugin --profile web add link:E:\path\to\dsh-assistant-bubble（路径按本机实际目录填写）。

卸载：

dsh plugin --profile web remove dsh-assistant-bubble

插件在 package.json 中声明 dsh.client.platform 为 web、immediately: true，客户端半区不声明 dsh.client.inject，模块无条件加载；slots / locale 服务运行时注入，拿不到时仅丢失设置页。未声明 engines / peerDependencies，安装与启用不会被版本检查拦下。

典型用法与设置¶

安装后打开 设置 →「助手回复气泡」，共 10 个控件。参数写入浏览器本地 localStorage["dsh-assistant-bubble:settings"]，清缓存会恢复默认。

样式参数通过写在 body 上的 CSS 变量生效，例如 --dab-solid-alpha、--dab-glass-alpha、--dab-glass-color、--dab-blur、--dab-sheen。

典型工作流：先装好插件并启用 Web profile → 若已用壁纸 / 皮肤，在「助手回复气泡」里先开液态玻璃，再按壁纸明暗微调「玻璃底色浓度」「雾化」「白釉强度」；若仍嫌助手区过透，可关液态玻璃，改用「气泡不透明度」。需要插件页、技能中心等列表可读时，保持「非会话页面底色」开启并调「页面底色浓度」。

适用场景与注意¶

适合谁

• 使用 dsh-plugin-wallpaper-engine 或同类皮肤 / 壁纸，且主要在 Web 端会话的用户。
• 希望助手回复、工具条、过程行、统计信息在壁纸上保持同一套玻璃或实心气泡风格的人。

安装前建议

• 插件以当前 DSH 进程权限在浏览器端运行，安装前宜浏览仓库源码与 MIT 许可证，确认接受其 DOM 注入与本地存储行为。
• 兼容性依赖宿主 DOM 结构；升级 DSH 后若「像没装」，多半是选择器与类名未对齐，需关注仓库 Issue 或更新插件版本。
• README 已说明气泡间距有小问题，属已知观感取舍，非配置错误。

DSH 生态强调「一切皆插件」；SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系，市场安装与 GitHub 安装均为社区分发路径。

结尾¶

dsh-assistant-bubble 解决的是助手回复在壁纸下无背景、皮肤参数管不到的问题，并把会话周边 UI 和非会话页面可读性一并纳入同一套设置。目录页：https://www.skillhub.cn/plugins/yutianliang/dsh-assistant-bubble；源码与完整说明：https://github.com/yutianliang/dsh-assistant-bubble。实现细节与踩坑见仓库 docs/DEVELOPMENT.md。