@dsh-external/dsh-ui-whale

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

演示 Demo

各动作 GIF：

<img src="docs/眨眼.gif" alt="眨眼" width="200"> <img src="docs/摆尾巴.gif" alt="摆尾巴" width="200"> <img src="docs/摆腹鳍.gif" alt="摆腹鳍" width="200">

<img src="docs/喷水花.gif" alt="喷水花" width="200"> <img src="docs/冒爱心.gif" alt="冒爱心" width="200"> <img src="docs/睡觉.gif" alt="睡觉" width="200">

完整视频：docs/dsh-ui-whale-demo.mp4

你的 DSH 版本决定装哪个插件版本（装错会崩：常见症状 useConversation is not a function）

• DSH 0.1.1-rc.2（npm 最新）：装旧版 '@dsh-external/dsh-ui-whale@github:lhh010/dsh-ui-whale#v0.3.4'
• DSH 0.1.2-alpha.1 / alpha.2 / alpha.3 / alpha.4 / alpha.5 / rc.1：装新版（下方默认命令）

安装

# 方式一：git 依赖固定 tag（公开镜像，推荐；也可用 github:lhh010/dsh-ui-whale）
dsh plugin --profile web add '@dsh-external/dsh-ui-whale@github:lhh010/dsh-ui-whale#v0.3.21'

# 方式二：本地 link（开发）
git clone https://github.com/lhh010/dsh-ui-whale.git
cd dsh-ui-whale && pnpm install && pnpm run build
dsh plugin --profile web add link:/path/to/dsh-ui-whale

配置行（$DSH_HOME/profiles/web/cordis.patch.yml，热重载，无需重启）：

- insert:
    - id: dsh-ui-whale
      name: '@dsh-external/dsh-ui-whale'

安装提示：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 快照版本更新，安装时按快照选择对应版本：

…