前言¶
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 用表格归纳了机制，核心如下：
| 位置 | 做法 | 效果 |
|---|---|---|
| 侧边栏左上角图标 | slot 遮蔽（sidebar.brand.mark，priority: -1） |
覆盖官方品牌 mark，官方 bundle 仍启用 |
| 新会话首页的鱼 | slot 遮蔽（conversation.hero.brand.mark） |
替换首页 hero 品牌图 |
| 「思考中」左侧小图标 | 注入 CSS，命中 [data-chat-running] 与 [class*="_runningIcon"] |
隐藏官方 APNG/SVG 后重画；默认内置蓝底小米饭小碗，可单独换图、放大 |
| 浏览器标签页图标 | 注入 <link rel="icon"> |
追加，不删官方链接 |
| 中文「深度求索中」及带计时的长文案 | 改写 chat 命名空间 zh 字典 |
仅 zh；英文仍为官方 Deep diving |
| 侧边栏 / 首页图标大小 | mark 组件乘以设置倍数，并放宽侧边栏对图标的裁剪 | 默认 1.8× |
| 思考中图标大小 | 官方约 14px 盒子乘以设置倍数 | 默认 1×，与上面图标互不影响 |
未改动：侧边栏「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，以应用内是否生效为准。
插件设置¶
入口二选一，配置相同：
- 侧边栏 →「插件」→ 本插件 →
whale-girl→ 配置（key：dsh-plugin-whale-girl#whale-girl）； - 侧边栏 →「设置」→ 鲸鱼娘主题。
五个字段（icon / runningIcon / runningText / iconScale / runningScale）互不影响：
| 栏 | 设置 | 说明 |
|---|---|---|
| 图标 | 图标 | 侧边栏、新会话首页、标签页；「选择图片…」选本地图，纯色底自动抠图，居中裁切缩到 256px 后以 data URI 存入；「恢复内置」清空覆盖 |
| 图标 | 图标大小 | 滑块 0.2×–3×，步进 0.2×，默认 1.8× |
| 思考中 | 思考中图标 | 与主图标独立；64px 原色存储；默认内置蓝底小米饭 |
| 思考中 | 思考中文案 | 默认「努力干饭中」；留空用默认；计时会长文案带「，用时 X秒 ···」 |
| 思考中 | 图标大小 | 同量程滑块，默认 1×（约官方 14px） |
写入经 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，在「鲸鱼娘主题」或插件配置页完成日常调整。
