DeepSeek Harness 插件

yryd/dafy-whale-theme

Star 数 ★ 0 下载量(近 30 天) 3,219 分类 主题与外观 收录于 2026-10-08 npm dafy-whale-theme

海洋蓝主题:游动鱼群、上升气泡、输入框上方的「每日鱼语」,以及左上角品牌区替换;「设置 → 海洋主题」提供 7 组 32 项可调(品牌文字与字号、徽章、主色、水印、鱼群、语录、整体缩放),改动即时生效无需刷新,并带二次确认的一键恢复默认。

安装

# npm 包(预构建)

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

# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)

dsh plugin --profile web add github:yryd/dafy-whale-theme

装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。

README

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。

内容来自项目 README(GitHub)↗

链接

同类插件

查看整个分类 →

社区评论

评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。