yryd/dafy-whale-theme

dafy-whale-theme（蓝色大肥鱼主题）

DeepSeek Harness web 前端的整站主题插件：海洋蓝配色、游动鱼群、上升气泡、输入框上方「每日鱼语」、左上角品牌替换。

一句话安装

帮我去 https://www.npmjs.com/package/dafy-whale-theme 安装大肥鱼插件

把这句话发给你的 DeepSeek Harness，它会自动完成全部安装；完成后按它提示重启 dsh web 并刷新浏览器（F5）即可。

官方安装（唯一通路）

需要 pnpm。本包在 package.json 中声明了 dsh.bundle，随包携带自己的组合层 cordis.patch.yml，因此官方 CLI 一条命令完成安装并自动挂载：

dsh plugin --profile web add dafy-whale-theme

升级与卸载同样走官方通路：

dsh plugin --profile web update dafy-whale-theme   # 升级
dsh plugin --profile web remove dafy-whale-theme   # 卸载

patch 层只在下次启动时生效：重启 dsh web 后刷新页面（web 组合禁用了 HMR，不会热加载）。

兼容性

package.json 里声明了：

"peerDependencies": { "@deepseek-ai/dsh": ">=0.1.7-rc.1 <0.1.8" }

DSH 会在安装与启动时据此检查运行时版本。版本不符时它会明确拦截并提示需要版本豁免，而不是让插件安静地不工作——这一点很重要，因为 0.1.7 之前 DSH 的配置 API 有过一次破坏性变更（settingsScope → configForms）。

仅支持 web 端（dsh.client.platform: "web"）。

特性

• 可视化设置面板：设置 → 海洋主题，32 项可调，改动即时生效（见下）
• 海洋蓝亮/暗双主题配色，DeepSeek 蓝品牌色，主色可自定义
• 全屏氛围：海面光晕、上升气泡、来回游动的鱼群（侧边栏可开关）
• 输入框上方滚动「每日鱼语」，语录可自定义
• 左上角品牌：官方鲸鱼图标 + 「蓝色大肥鱼」字标，三段可独立开关
• 窄侧栏自适应，无 UI 裁切

设置面板

装好并重启后，进入 设置 → 海洋主题，共 7 组 32 项，改动即时生效（无需重启、无需点保存）：

配色只改主色即可：其余 10 个设计 token 由主色色相平移派生，亮/暗两套同步变化；错误/成功/警告等语义状态色保持不变。

配置保存在 DSH 用户设置文档的 dafy-whale 命名空间下，随 DSH 的设置一起管理。

开发

本包是 TypeScript 项目。lib/ 是构建产物（不入库，发布时由 CI 构建）。

npm install --include=dev   # ⚠️ 见下方说明
npm run build               # tsc 宿主 + tsc 客户端 + wrap → lib/
npm run typecheck           # 仅类型检查
npm run check               # DSH 插件契约校验 + schema 对齐校验
npm test                    # 构建 + 全部测试

⚠️ NODE_ENV=production 陷阱：该环境变量存在时，npm install 默认不安装 devDependencies，表现为只打印 up to date, audited 1 package 而什么都不装。 请显式加 --include=dev（CI 里也已这么写）。

改动后必须 npm run build；装上插件后还须重启 dsh web 才能看到客户端改动 （web 组合禁用 HMR，F5 无效）。

素材与许可

代码采用 MIT 许可（见 LICENSE）。图片素材来自社区仓库，均为 MIT 许可、随包分发，逐文件来源见 NOTICE。