ASCII 鲸鱼 · DeepSeek Harness

让鲸群游过留白，让思绪慢慢浮出水面。

新对话展开时，蓝色鲸群从字符之间游来。细小的鱼群随水流散开，尾迹缓缓隐去；输入框像一片磨砂玻璃，轻轻托住尚未写下的话。

English · npm · Releases

安装

在 DeepSeek Harness 的插件管理中添加 npm 包 dsh-ascii-whales，完成后重启相应实例。

Web CLI 用户也可使用：

dsh plugin --profile web add dsh-ascii-whales

将 web 换成目标 Web profile。Desktop 请通过客户端插件管理安装。

插件默认启用，配置入口为 设置 → ASCII 鲸鱼。

一片海，两种光

动画铺在整个空白聊天主区域，位于标题与输入框后方。它保留原项目的 ASCII 字符色块、身体弯曲、鱼群游动与扩散尾迹；鲸鱼以不同大小游过，默认主色为 DeepSeek 蓝 #4d6bfe。

浅色像日光下的水面，深色像夜里的海。毛玻璃使用中性白／深灰透明层，没有额外的蓝色 tint；经过后方的鲸鱼会自然透出模糊的颜色。开始已有对话后，装饰自动退场。

选中的颜色落在鲸鱼身体的中间调，阴影稍深，高光稍亮。两种主题沿用同一套鱼身配色，让你的那一抹蓝，在日夜之间都留得住。

调一调你的海

使用 DSH 官方的设置页、按钮、输入框与开关。颜色区提供可视化色块及系统选色器，选色后即时生效。

也可以让汉字入海：设置 → ASCII 鲸鱼 → 字符风格 → 汉字。吻部落“吻”，眼睛落“目”，背部落“背”，胸鳍与背鳍落“鳍”，尾鳍落“尾”；其余鲸身由水、海、潮、鲸等字铺开，小鱼化作鱼字旁的游字。字随身体弯曲转向，汉字栅格更宽，也能用“字符栅格”继续调节。

英文默认内置 Geist Mono 600，与原项目演示一致；汉字默认内置 思源宋体。两套字体用于动画，随插件离线加载。切换“字体 → 本机自定义”，可分别填写已安装的中英文字体名称，例如 Consolas、方正屏显雅宋简体。

点击 扫描本机字体，允许浏览器访问字体后，即可从下拉菜单中选择，也可直接输入字体名称。

设置	默认	范围 / 作用
显示鲸鱼	开	控制整个背景与配套玻璃
字符风格	ASCII	ASCII / 汉字；即时切换并保存
字体	内置默认	内置默认 / 本机自定义；中英文字体名称分别保存
鲸鱼颜色	DeepSeek 蓝	可视化选色器；同步鱼群、尾迹配色
鲸鱼数量	3	1–20
鲸鱼大小	1 倍	0.1–10 倍，保留个体大小差异
游动速度	1 倍	0.1–10 倍
动画透明度	1	0–1；1 为完全不透明
字符栅格	1 倍	0.1–10 倍；越大越有颗粒感
底纹网格透明度	0.05	0–1；0 隐藏底纹
小鱼数量	170	0–1000；0 隐藏小鱼
尾迹强度	1	0–10；0 隐藏扩散尾迹
毛玻璃输入框	开	独立开关
玻璃模糊	14 px	0–64 px
玻璃不透明度	0.45	0–1；越高越不透

大小、栅格、速度、尾迹在 1 以下以 0.05 为步长，从 1 起以 0.1 为步长；跨界为 0.95 ↔ 1 ↔ 1.1，也可直接输入数值。

默认三条鲸鱼的相对大小为 100%、70%、84%。ASCII 小鱼以短横字符呈现，汉字模式使用鱼、鲤、鲭、鲱，尺寸随字符栅格一起变化。

恢复默认 使用 DSH 官方主按钮，随深浅主题切换，可一键回到最初的蓝色海面。偏好保存在当前浏览器。动画遵循系统“减少动态效果”设置，并在后台标签页暂停。

查看设置截图

从哪里游来

基于 stackedlol/ascii-sharks 的源码改造。原作者完成了鱼群模拟、柔性身体、字符栅格与光影渲染；本项目在其基础上加入鲸鱼形态、DSH 集成、主题适配与可调参数。

固定的上游版本、改动范围与署名见 THIRD_PARTY_NOTICES.md。毛玻璃实现参考了 dsh-glass-theme 与 dsh-skin-glass 的相关思路。

开发与验证

npm ci --legacy-peer-deps
npm run check
npm pack

动画与字体随插件一起打包，可离线加载。

测试与 GIF 录制见 开发文档，测试结果见 验证记录。