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，不会热加载）。

兼容性

DSH 版本	状态
0.1.7-rc.2	✅ 当前版本，已实测
0.1.7-rc.1 / 0.1.7	✅ 声明兼容（同属 0.1.7 系列）
0.1.6-alpha.1 及更早	❌ 不支持 —— 2.1.0 起改用 DSH 0.1.7 的新配置 API

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 项，改动即时生效（无需重启、无需点保存）：

分组	可调项
品牌区	鲸鱼图标开关/大小、品牌文字开关/内容/字号、徽章开关/文字
配色	亮色主色、暗色主色（整套色阶自动派生）
背景与氛围	海面光晕开关/强度、背景水印开关/透明度/素材
鱼群	总开关、数量、游动速度、透明度、大小、大鲸鱼开关、小鱼素材、气泡开关/数量/速度
每日鱼语	开关、切换间隔、语录列表（每行一条）、表情开关
界面	侧栏开关文字、整体缩放
重置	一键恢复全部 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 里也已这么写）。

路径	说明
src/config.ts	共享配置模型：DEFAULTS / normalizeConfig / deriveTokens / buildFish
src/index.ts	宿主半：注册 dafy-whale settings 命名空间 + /dafy-assets 素材路由
src/client.tsx	客户端半：插槽组件 + 「设置 → 海洋主题」面板
src/logo-path.ts	官方鲸鱼轮廓 path（从改造前代码提取，勿手改）
scripts/wrap-client.mjs	把 tsc 的 CJS 产物打包成 DSH 的 ModuleLoader 形态
scripts/check-*.mjs	契约护栏（见 npm run check）
test/	node:test，零测试框架依赖

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

素材与许可

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