前言¶

DeepSeek Harness（DSH）桌面端界面里，侧边栏品牌区、新会话首页和「思考中」状态都有固定的视觉元素。若只想换图标、调大小，而不动 app.asar、也不希望每次应用升级后手工重打补丁，通常需要找一种走 Cordis 插件链、写入 profile 的方案。

下面介绍社区插件 dsh-plugin-whale-girl（维护者 aigisx，MIT 许可证，当前版本 V0.3.0）。它在应用内把默认鲸鱼相关视觉换成「鲸鱼娘」主题素材，并把中文「深度求索中」改为可配置的文案（默认「努力干饭中」）；图标与「思考中」小图标的大小可在插件设置里分别调节。分类上属于社区目录中的「趣味换装」。

这是什么¶

dsh-plugin-whale-girl 是一个第三方 DSH bundle + client plugin 双面包：安装进 profile 后，官方 app.asar 一行都不改，应用升级后改动仍保留。

一句话定位：修改 DeepSeek Harness 应用内的图标，并调整尺寸大小（与 GitHub 仓库 简介一致）。

改了哪些位置¶

README 用表格归纳了机制，核心如下：

未改动：侧边栏「DeepSeek Harness」字标、英文文案、任务栏/托盘/欢迎页，以及 app.asar 内任何文件。

安装与启用¶

安装前请自行阅读仓库源码与 MIT 许可证；插件随当前 DSH 进程权限运行，只安装你信任的来源。

命令行（link 依赖）¶

在 PowerShell 中执行（路径按本机 DeepSeek Harness 与插件目录替换）：

& "<DeepSeek Harness>\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add "<本目录的绝对路径>"

命令会把包装成 link: 依赖、写入 profile 的 dsh.profile.bundles 并启用；改源码后重启即可，不必重装。

应用内添加¶

侧边栏 →「插件」→「添加插件」，填写本目录的绝对路径。

安装后注意¶

本包自带 cordis.patch.yml，内容为向 bundles 插入 whale-girl 一行；Loader 会自动处理。不要在 profiles/<名称>/cordis.patch.yml 里再手写同 id 的 insert，否则会出现两行 whale-girl，设置可能无法写入（报错：Configuration for "whale-girl" is overridden by a home patch or command-line overlay）。V0.3.0 起 node 半边会在启动时把重复行记入日志。

安装后重启 DeepSeek Harness 生效。

快速自检（桌面走 HTTP 插件路由时）：

Invoke-WebRequest -Uri 'http://127.0.0.1:19387/plugins/dsh-plugin-whale-girl/client.js' -UseBasicParsing |
    Select-Object StatusCode, @{n='len';e={$_.Content.Length}}

返回 200 表示宿主已纳入启动图；若走 dsh-app:// 通道返回 404，以应用内是否生效为准。

插件设置¶

入口二选一，配置相同：

1. 侧边栏 →「插件」→ 本插件 → whale-girl → 配置（key：dsh-plugin-whale-girl#whale-girl）；
2. 侧边栏 →「设置」→ 鲸鱼娘主题。

五个字段（icon / runningIcon / runningText / iconScale / runningScale）互不影响：

写入经 ctx.configForms.get("whale-girl") 落到 profile 的 cordis.patch.yml，多窗口会同步。图片在浏览器端抠图缩放，不写临时文件。

换内置素材（开发者）¶

把图片放进 assets/ 后重新构建客户端：

node tools/build-client.mjs

支持 .svg / .png / .webp。icon.* 为必需；另有 icon-dark.*、icon-small.*、hero.*、running.*、favicon.* 等可选文件名，缺省按 README 表格回落。

白底插画可用附带脚本处理后再构建：

python tools\prepare-artwork.py "路径\原图.png" --erase 1180,1420,1536,1536

更换默认「思考中」内置图：

python tools\prepare-thinking.py assets\你的图.png --preview ..\_whale-girl-work\preview.png
node tools\build-client.mjs

构建产物 lib/client.js 约 240 KB；发布前仓库提供 npm run check（host-check + selftest）。

卸载与回滚¶

README 提供「卸载 / 回滚」章节：从 profile 移除 bundle 依赖并去掉重复的 patch 行即可恢复官方视觉；具体步骤以仓库文档为准。

适用场景与注意¶

适合：希望在 DSH 桌面端做轻量品牌化或趣味主题、且接受只改 Web 客户端 UI、不动 asar 的用户。

注意：

• 插件为社区作品，目录站点（如 SkillHub 插件页）与 DeepSeek / 幻方无官方从属关系；DSH 生态理念是「一切皆插件」，安装前核对来源与许可证。
• peer 依赖为 @deepseek-ai/cordis ~4.0.4、@deepseek-ai/schemastery ~3.18.4，需与当前 Harness 版本匹配。
• 重复手写 cordis.patch.yml 的 insert 会导致配置无法保存，安装时务必只保留包自带那一行逻辑。

结尾¶

dsh-plugin-whale-girl 通过 Cordis slot 与客户端 CSS、locale 补丁，在不动 app.asar 的前提下替换应用内多处图标与中文思考文案，并用两套独立滑块调节显示倍数。若你要在 DSH 里做同类「趣味换装」，可按上文安装命令接入 profile，在「鲸鱼娘主题」或插件配置页完成日常调整。

• 社区目录：https://www.skillhub.cn/plugins/aigisx/dsh-plugin-whale-girl
• 源码与完整说明：https://github.com/aigisx/dsh-plugin-whale-girl