dsh-ui-whale

@dsh-external/dsh-ui-whale

DSH Web UI 的常驻像素鲸鱼伙伴插件：会话标题栏（标题行右侧）常驻一只小鲸鱼，随会话快照实时反应——零核心改动。 演示 Demo

各动作 GIF： 完整视频：docs/dsh-ui-whale-demo.mp4 你的 DSH 版本决定装哪个插件版本（装错会崩：常见症状 useConversation is not a function） - DSH 0.1.2-alpha.1 ~ 0.2.1-alpha.1：装新版（下方默认命令；各 DSH 版本对应的插件 tag 见版本对应表） - 更旧的 DSH（0.1.1-rc.2 及以前）：无可用版本 安装 安装方式（v0.3.27 起自动挂载）：本包自 v0.3.27 起自带 cordis.patch.yml 并声明 dsh.bundle.patch——dsh plugin --profile web add 安装后自动注册 profile 层并挂载，不再需要手写 insert 配置行（固定旧 tag 的部署仍需）。GUI 注意：插件页「添加插件」只接受注册表包名或本地目录路径；name@github:owner/repo#tag 是 pnpm 别名规格（CLI 专用），粘进 GUI 会报 ERR_PNPM_INVALID_PACKAGE_NAME——GUI 请克隆后用本地目录路径，或等 npm 发布后用包名。

配置行（$DSH_HOME/profiles/web/cordis.patch.yml，热重载，无需重启）： 安装提示：pnpm 11 首次安装可能拦截 node-pty 等构建脚本——在 ~/.dsh/profiles/web 下执行 pnpm approve-builds --all 放行后重跑安装命令；装完硬刷新浏览器（Ctrl/Cmd+Shift+R）。 提示词安装（让 DSH 自己装）

把下面这段提示词发给任意一个 DSH 会话，模型会替你完成安装： 帮我安装 dsh-ui-whale 插件（DSH 会话标题栏像素鲸鱼伙伴），步骤： 1. 执行 dsh plugin --profile web add '@dsh-external/dsh-ui-whale@github:lhh010/dsh-ui-whale#v0.3.18'（首次可能被 pnpm 11 拦截 node-pty 构建脚本而失败） 2. 在 ~/.dsh/profiles/web 下执行 pnpm approve-builds --all（放行构建脚本） 3. 再执行一次第 1 步的安装命令 4. 完成后提醒我硬刷新浏览器（Ctrl/Cmd+Shift+R） 遇到报错先查 https://github.com/lhh010/dsh-ui-whale README 的常见问题/已知限制。 智能版本门控更新提示 / DSH-gated update chip

更新浮标会结合当前运行的 DSH 版本（宿主端从 dsh 安装清单读取）与仓库根的 compatibility.json（版本→支持的 DSH 列表，精确匹配）判定提示形态： 最新版支持当前 DSH → 正常「新版本 vX 可用，点击更新」； 最新版需要更高 DSH、但存在支持当前 DSH 的中间新版 → 提示更新到中间版，并注明「另有 vX 需更高 DSH」； 最新版需要更高 DSH、且当前 DSH 无任何可用新版 → 琥珀色信息条：「新版本 vX 支持更高 DSH 版本，当前 DSH vY 暂不可用」，不提供直接升级。

兼容数据拉取失败或无该版本条目时，自动回退为旧的普通升级提示（离线安全）。发版时需同步维护 compatibility.json（与版本表/变更记录同一步骤新增一行）。 版本对应 / Version compatibility 版本对应 / Version compatibility

构建产物随 DSH 快照版本更新，安装时按快照选择对应版本： 兼容性说明：上表构建均基于 snapshot0806 开发，同时兼容 snapshot0807（snapshots/20260807T130646Z）、snapshot0808（snapshots/20260808T121140Z）、snapshot0809（snapshots/20260809T140917Z）、snapshot0810（snapshots/20260810T155924Z）、snapshot0811（snapshots/20260811T152241Z）与最终快照 snapshot0812（snapshots/20260812T172954Z-final）——0807~0812 用户直接安装默认版本（v0.3.8）即可（0811 与 0812 实机 boot 验证通过，见下）。 npm 发版兼容：兼容 DSH npm 发版 @deepseek-ai/dsh@0.1.1-rc.1（v0.3.4 实机 boot 验证通过：dsh --profile web 启动后 boot 清单包含 @dsh-external/dsh-ui-whale，/plugins/@dsh-external/dsh-ui-whale/client.js 返回 200；conversation.session.header.actions 槽位与 locale/invariants 服务在 0.1.1-rc.1 上保持不变），同时兼容 @deepseek-ai/dsh@0.0.1-rc.5（dist-tag next，即最终快照 snapshot0812 的 npm 发版；npm exec -p @deepseek-ai/dsh@0.0.1-rc.5 -- dsh --profile web --port 可访问指定版本并启动，lib 生产模式），同时保持兼容 @deepseek-ai/dsh@0.0.1-rc.2（snapshot0811 的 npm 发版）。实测（npm rc.5 基线）：dsh web 启动后 window.DSH_BOOT 清单包含 @dsh-external/dsh-ui-whale（inject: dsh-client-locale/dsh-client-runtime/dsh-client-ui-conversation），/plugins/@dsh-external/dsh-ui-whale/client.js 返回 200；src 对 rc.5 基线构建产物 typecheck 全绿（本插件已把 cordis 类型导入