前言¶
在 DeepSeek Harness（DSH）里，对话会同时出现助手消息和用户消息。dsh-whale-font 是一个 DSH web 插件，它把对话中的主语人称「我 / 你 / I / me」显示成 DeepSeek 蓝鲸图标，用来标示每句话的说话者。
它只在显示层做替换，不修改消息数据，不影响模型读取与记忆，也不作用于输入框。
这是什么¶
dsh-whale-font 由 kxSenlin 维护，许可证为 MIT。
它用于 DSH 对话界面，将以下内容显示为鲸鱼图标：
- 助手消息中的「我」
- 用户消息中的「你」
- 助手消息中默认的英文独立单词
I/me
插件由字体层和 DOM 层组成，两层均可独立开关。
核心功能¶
下面介绍它已核实的替换能力和边界：
- 助手消息中的「我」显示为鲸鱼图标。
- 用户消息中的「你」显示为鲸鱼图标。
- 助手消息中默认的英文独立单词
I/me显示为鲸鱼图标。 - 支持为助手消息和用户消息分别配置自定义替换词。
- 自定义替换词目前统一替换为鲸鱼图标，不支持任意文字替换。
- 中文「我 / 你」通过自定义彩色字体渲染，不修改 DOM、无闪烁、实时生效。
- 英文
I/me通过 DOM 层单词边界匹配；自定义中文词按子串匹配。 - 引号、括号与代码块内的内容一律不替换。
- 复制消息时，「我 / 你 / I / me」及自定义替换词会还原为原字符，不产生空字符或图片。
- 鲸鱼图形主体为蓝色，内部细节在深浅色模式下均为白色。
- 插件同时识别新旧两版 DSH web 的消息行结构，并可通过设置页调整对话区域 CSS 选择器。
- 「括号内同样不替换」默认开启，可在设置中关闭。
安装与启用¶
前置要求：已安装 DeepSeek Harness，且 dsh 命令可用。
1、执行安装命令：
dsh plugin --profile web add github:kxSenlin/dsh-whale-font
这条命令会把 dsh-whale-font 安装到当前 web profile。
2、安装完成后，重启 DSH 服务，并在浏览器中强制刷新。
3、确认插件已安装：
dsh plugin --profile web list
升级时重复执行同一条 add 命令：
dsh plugin --profile web add github:kxSenlin/dsh-whale-font
离线安装可先下载仓库到本地，然后在仓库目录下执行：
dsh plugin --profile web add ./dsh-whale-font
安装完成后同样需要重启 DSH 服务，并在浏览器中强制刷新。
典型用法¶
1、打开 DSH 的「设置 → 文字替换」标签页。
2、启用鲸鱼图标。
3、根据助手消息和用户消息分别配置自定义替换词。
4、如果 DSH 改版导致消息行结构变化，可在同一设置页调整对话区域 CSS 选择器。
设置保存在浏览器本地 localStorage，刷新页面后仍生效。
如果只想调整鲸鱼大小或位置，可编辑：
tune/whale-config.json
然后运行：
python tune/adjust_whale.py
调参脚本需要 fonttools；日常安装与使用插件无需安装 fonttools。
适用场景与注意¶
适合在 DSH web 对话界面中，用图形化方式快速区分「助手说的我」和「用户对你说的话」。它适合做显示层增强，不适合用来修改消息内容、改写输入框内容，或做任意文字替换。
注意：
- 插件以当前
dsh进程权限运行，安装前应检查源码与许可证。 - 需要浏览器支持 COLR 彩色字体：Chrome 71+ / Firefox / Safari 16.4+。
- 自定义替换词目前统一替换为鲸鱼图标，不支持任意文字替换。
- 引号、括号与代码块内的内容一律不替换。
- 「括号内同样不替换」默认开启，可在设置中关闭。
- 插件仅在显示层替换，不修改消息数据、不影响模型读取与记忆，也不作用于输入框。
结尾¶
dsh-whale-font 的核心价值是：在不改变 DSH 对话数据和模型输入的前提下，把「我 / 你 / I / me」显示成蓝鲸图标，让说话者更清楚。
GitHub 仓库：
https://github.com/kxSenlin/dsh-whale-font.git
卸载插件：
dsh plugin --profile web remove dsh-whale-font
