dsh-chat-focus
dsh web 对话界面插件：折叠运行时信息 + 聊天气泡 + 可配置设置（聊天层插件，骑在宿主 @deepseek-ai/dsh-client-ui-conversation 引擎上，替换宿主 ui-chat 气泡行）
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-chat-focus@0.4.0Chat Focus 以 dsh-chat-focus 发布，当前版本为 0.4.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
dsh web 对话界面插件：将文本回复之前的连续运行时信息（工具调用、思考、重试等）收纳进可展开的折叠框，文本回复以聊天气泡呈现，设置面板可配置。独立仓库分发，宿主源码零改动（以 bundle 补丁层停用宿主 ui-chat 气泡行，聊天层注册进宿主 ui-conversation 引擎与会话框架）。
0.4.0（2026-09-09）：半透明气泡（底纹整层不透明度 + 毛玻璃）、气泡皮肤制作器（用自己的图片/GIF/APNG/PNG 序列帧/视频做气泡背景，静态图走九宫格切片、动态素材走整层/精灵动画/视频图层），设置页重组为左侧标签栏 + 右侧固定预览五页。设计文档见 docs/design/（2026-09-09 气泡皮肤增量系列）。
0.3.0（2026-09-03）：按宿主 0.1.2-alpha.5 契约完成路线 B 迁移——fork 收敛为聊天层插件，骑在宿主
ui-conversation引擎与会话框架之上，替换宿主ui-chat气泡行；fork 专属特性（折叠/分组/气泡皮肤/设置页）全部回归。迁移记录见 docs/experience/migration-20260903-host-0.1.2-alpha.5-route-B.md。
focusKeepVisible 语义为「保持展开的最近回复数」——最近 N 个聊天气泡对应的运行时信息默认展开，这 N 个之前的旧运行时信息全部折叠；流式中尚未有回复的活动也保持可见url() 包装保证生效steps() 步进动画）或直接使用视频（静音循环 <video> 图层，保留原画质与时长，仅在气泡进入视口时解码、离开视口自动暂停）~/.dsh/chat-focus/skins/，经宿主 /api 鉴权路由提供（视频支持 Range 请求），跨浏览器可用| 对话界面：折叠运行时信息 + 聊天气泡 | 设置面板：上下分栏 + 固定实时预览 |
|---|---|
| 对话界面 | 设置面板 |
统一使用宿主官方插件管理命令 dsh plugin --profile <name> <pnpm args...>（pnpm 转发 + 自动把声明 dsh.bundle 的依赖加入 dsh.profile.bundles 层列表）。本项目不提供、也不需要任何包装脚本。
从 npm 安装（推荐）：
dsh plugin --profile web add dsh-chat-focus
本地开发方式（官方命令直装本地目录）：
pnpm run bundle # 先构建 lib/client.js
dsh plugin --profile web add "link:E:\dsh-chat-focus" # 官方命令，自动加入 bundle 层
# 重启 dsh web
bundle 的 patch 层（cordis.patch.yml）由 loader 自动应用：宿主 ui-chat 气泡行被禁用，chat-focus 行挂载 fork 并注册进宿主 ui-conversation 引擎的 chat 视图目标；其他宿主插件（ui-tool、ui-plan、ui-commands 等）注册进同名槽位，功能不变。
注意：安装之后需要重启dsh
只使用官方命令：
dsh plugin --profile web remove dsh-chat-focus # 移除依赖 + bundle 层，重启后宿主 ui-chat 行自动恢复
官方命令之后的两处可选手动清理（均为惰性残留，不影响运行；是否清理自行决定）：
# 1) 仅 link: 方式安装才会留下的 node_modules 目录链接（加载器不会读取）：
Remove-Item C:\Users\super\.dsh\profiles\web\node_modules\dsh-chat-focus -Force -Recurse
# 2) settings.yaml 中 ui-chat: 命名空间的 focus* 自定义字段（fork 的 schema 提供这些键；
# 保留它，重装后气泡自定义原样恢复）——按需手动删除对应行
自制皮肤素材（~/.dsh/chat-focus/）独立于插件，卸载后仍保留；确认不再需要时手动删除整个目录即可。
浏览器端 localStorage dsh.chat-focus.fold.*（服务端任何工具都触达不到）：在 dsh 页面 F12 Console 执行
Object.keys(localStorage).filter(k=>k.startsWith('dsh.chat-focus.')).forEach(k=>localStorage.removeItem(k))，或直接清除 dsh 站点数据。会话记录零污染（插件仅 UI 渲染，不写 session log）。
已知冲突：切换皮肤后宿主启动报错 failed to parse overlay .../cordis.patch.yml: YAMLException: end of the stream or a document separator is expected。
原因：profile 启动补丁模板自带一个 [] 占位；皮肤管理（dsh-client-ui-skin-center）把皮肤行追加到占位之后——YAML flow 序列后面不能跟顶层行，解析失败。皮肤管理器本身对"无占位的补丁文件"完全正常（与 dsh-chat-focus 无关，任何 profile 都会触发）。
修复（一次性，幂等；不修改第三方包，升级 web-ui-all 不受影响）：
node scripts/patch-skin-center.mjs # 默认 web profile
node scripts/patch-skin-center.mjs --profile web
脚本移除 profile 补丁文件里的 [] 占位（自动备份 .bak）。修改后需重启 dsh web——之后皮肤切换写入的都是合法 YAML，皮肤功能正常。
入口：右上角 设置 → 对话显示。面板为左标签栏 + 右侧固定预览：左侧五个标签（基础 / 折叠 / 气泡外观 / 皮肤 / 高级），中间表单可滚动，右侧实时预览常驻；窗口较窄时导航转为横向、预览可通过右上角按钮折叠。
~/.dsh/chat-focus/skins/（index.json + <id>.bin），经宿主 /api/chat-focus/skin-asset 鉴权路由提供（支持 Range 请求，视频可 seek/循环），带版本戳长缓存；宿主未提供 connection 服务时皮肤库置为不可用，静态背景图片仍可正常使用~/.dsh/chat-focus/skins/设置字段（命名空间 ui-chat，扩展 schema；宿主 api-proxy 白名单已放行）：
| 字段 | 类型 | 默认 | 说明 |
|---|---|---|---|
| focusEnabled | boolean | true | 总开关；关闭后对话按原始顺序显示 |
| focusBubbles | boolean | true | 聊天气泡 |
| focusKeepVisible | number(0-10) | 1 | 保持展开的最近回复数 N |
| focusDefaultOpen | boolean | false | 折叠框默认展开 |
| focusSummary | boolean | true | 折叠框摘要（计数+工具名） |
| focusStrategy | keep-recent/threshold/always | keep-recent | 折叠策略（最近 N 回复展开 / 阈值折叠 / 全部折叠） |
| focusBubbleStyle | default/compact | default | 气泡密度 |
| focusReasoning | boolean | true | 纯思考步骤纳入运行时组折叠 |
| focusBubbleBg / Border / Radius / MaxWidth / BgImage / BgSize | string | '' / cover | 助手气泡自定义（背景色/边框色/圆角/最大宽度/背景图/适配模式） |
| focusBubbleTextColor / Font / FontSize / Padding | string | '' | 助手气泡文字自定义（颜色/字体/字号/内边距） |
| focusBubbleGradientFrom / GradientTo / GradientAngle | string | '' / '' / '135' | 助手气泡渐变（起始/结束颜色、角度） |
| focusBubbleBackdropOpacity | number(0-100) | 100 | 助手气泡底纹整层不透明度 |
| focusBubbleBackdropBlur | '' / 4px / 10px / 18px | '' | 助手气泡毛玻璃 |
| focusBubbleSkin | string | '' | 助手气泡皮肤 id（'' = 自定义） |
| focusBubblePreset | string | '' | 气泡配色模板 id |
| focusUserBubble*（Bg / Border / Radius / MaxWidth / BgImage / BgSize / TextColor / Font / FontSize / Padding / Gradient* / BackdropOpacity / BackdropBlur / Skin / Preset） | string / number | '' / 100 / cover | 用户气泡自定义（与助手同构） |
皮肤库不走设置文件：素材与元数据存于 ~/.dsh/chat-focus/skins/，设置里只保留皮肤 id。
pnpm install # 宿主仓库（0.1.2-alpha.5 基线）作为跨仓库 workspace 成员提供 @deepseek-ai/* 依赖
pnpm run typecheck # tsc --noEmit（类型契约来自宿主 lib/types 构建产物）
pnpm run bundle # tsdown：lib/index.js（node 半区）+ lib/client.js（浏览器 bundle）
pnpm test # 分组引擎 + 皮肤几何/嗅探/校验 + 宿主资产库集成（tsx，无需 vitest）
开发环境说明：
pnpm-workspace.yaml将../deepseek-harness/packages/*/*与../deepseek-harness/vendor/*列为 workspace 成员（精确 0.1.2-alpha.5 契约）。若 pnpm 因跨目录 workspace 未生成 node_modules，按node scripts/setup-junctions.mjs手工链接构建依赖。不要在本仓库运行会改写宿主 node_modules 的 pnpm 命令。
| 宿主版本 | fork 版本 | 说明 |
|---|---|---|
| 0.1.2-alpha.5 | 0.4.0 | 半透明气泡 + 气泡皮肤制作器 + 设置页左标签栏重组（宿主契约未变，纯增量） |
| rc.5（2026-08-16 基线） | 0.2.0 | v0.2 基线（折叠策略全模式、背景图上传/裁剪/适配、折叠框虚拟化） |
| 0.1.2-alpha.5（2026-09-02） | 0.3.0 | 路线 B 迁移：宿主删除 dsh-client-runtime，fork 收敛为聊天层（骑 ui-conversation 引擎行、替换 ui-chat 气泡行）；引擎符号改走 dsh-client-store 种子词，事件谓词改走 dsh-session/surface，折叠盒移除估算行高虚拟化 |
| 0.1.1-rc.2 | 0.2.5 | 适配 attachment 插件化（ImageGallery 等原子不再从平台模块表导出）：用户气泡改走与助手同构的 ChatBubble 统一管线；消息图片/输入区附件改经 conversation.message.images / conversation.input.attachments 槽位；移植 referenceLabels 引用投影与新参考 chip 样式 |
宿主升级后按以下流程适配：
docs/design/ui-design-20260816-dsh-chat-focus-模块1-基底复制域.md §2.3 槽位契约保持表（21 槽位 + conversation 服务 + 节点数据模型）；tsconfig.json 的 paths（lib/types 入口可能变化）；pnpm run typecheck && pnpm run bundle，并在宿主环境做 test:gui 同构冒烟；宿主处于 pre-release（契约随时可漂移）——若适配成本超出维护能力，备选方案（视图附加型，零手术纯插件行）见 docs/design/solution-design-20260816-dsh-chat-focus-备选方案-视图附加型.md。
border-image 播放动画~/.dsh/chat-focus/MIT。fork 自 @deepseek-ai/dsh-client-ui-conversation（MIT），保留上游版权声明。