dsh-ascii-whales

ASCII 鲸鱼 · DeepSeek Harness

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

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

[English](README.en.md) · [npm](https://www.npmjs.com/package/dsh-ascii-whales) · [Releases](https://github.com/Chael-Chael/dsh-ascii-whales/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；经过后方的鲸鱼会自然透出模糊的颜色。默认在已有对话中也显示鲸鱼；关闭 设置 → ASCII 鲸鱼 → 聊天中显示鲸鱼 可恢复只在空白新对话页显示。

聊天时，开启 背景毛玻璃 会在鲸鱼与消息之间加入半透明底色、三层渐变与背景模糊，分别适配深浅主题。雾面层不接收鼠标事件，文字、代码和控件本身不模糊，也不改变固定菜单的定位。背景与输入框毛玻璃分开开关，各自的模糊与不透明度就在开关下方调节；不支持背景模糊的浏览器使用更不透明的底色。关闭“显示海洋”会同时关闭所有场景；“聊天中显示鲸鱼”独立保存，并随“恢复默认”重置为开启。

选中的颜色落在鲸鱼身体的中间调，暗面压深、亮面提亮，保留逐格光照层次与身体立体感。两种主题沿用同一套鱼身配色，让你的那一抹蓝，在日夜之间都留得住。

调一调你的海

新增 字符风格 → Kanji：改编自 MIT 许可的 [ascii-kanji-sharks](https://github.com/michikusa404/ascii-kanji-sharks)，使用鲸鱼形态，使用 stackedlol/ascii-sharks 的游动与鱼群模拟，保留 Kanji 上游按笔画密度生成的明暗与捕食文字效果。沿用数量、大小、速度、颜色、网格、尾迹和字体设置；字符栅格最低为 4 px（达到下限后不再缩小）。Kanji（日文汉字）使用“中文字体名称”；英文字体设置仅作用于 ASCII。字体离线内置，原有 ASCII／汉字鲸鱼仍可选。

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

也可以让汉字入海：设置 → ASCII 鲸鱼 → 字符风格 → 汉字。吻部落“吻”，眼睛落“目”，背部落“背”，胸鳍与背鳍落“鳍”，尾鳍落“尾”；其余鲸身由水、海、潮、鲸等字铺开，小鱼化作鱼字旁的游字。字随身体弯曲转向。三种样式按近似相同的字符格面积校准颗粒感：ASCII 保留窄格，汉字与 Kanji 使用方格，采用固定 CSS 像素尺寸，不随窗口宽度变化。1× 时 ASCII 为 8×12 px，汉字与 Kanji 为 10×10 px；仍可用“字符栅格”调节。

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

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

| 设置 | 默认 | 范围 / 作用 |

| --- | --- | --- |

| 显示海洋 | 开 | 控制整个背景与配套玻璃 |

| 聊天中显示鲸鱼 | 开 | 在对话消息后继续显示；关闭后只在空白新对话页显示 |

| 鲸鱼种类 | 座头鲸 | 座头鲸 / 虎鲸；三种字符风格均可切换并保存 |

| 字符风格 | ASCII | ASCII / 汉字 / Kanji；即时切换并保存 |

| 字体 | 内置默认 | 内置默认 / 本机自定义；中英文字体名称分别保存 |

| 眼睛底色 | 跟随主色 | 控制眼睛位置的背景方块；默认沿用身体底色，可选黑色／白色，字符自动使用对比色。Kanji 默认透明，选黑／白后增加眼睛底色块 |

| 彩色闪烁 | 关 | ASCII / 汉字：关闭使用主色深浅，开启恢复原版七色字符点缀；不改变身体主色。Kanji 使用自身闪光效果，此开关不适用 |

| 海洋颜色 | DeepSeek 蓝 | 可视化选色器；同步鱼群、尾迹配色 |

| 鲸鱼数量 | 3 | 1–20 |

| 鲸鱼大小 | 1.2 倍 | 0.1–10 倍，保留个体大小差异 |

| 游动速度 | 0.65 倍 | 0.1–10 倍 |

| 身体摆动幅度 | 0.8 倍 | 0–3 倍；0 关闭身体波动，仍会沿转弯路径弯身 |

| 转弯灵活度 | 0.7 倍 | 0.1–3 倍；越高越容易弯身掉头 |

| 摆尾频率 | 0.8 倍 | 0.1–5 倍；独立于游动速度 |

| 动画透明度 | 1 | 0–1；1 为完全不透明 |

| 字符栅格 | 1 倍 | 0.1–10 倍；越大越有颗粒感 |

| 底纹网格透明度 | 0.05 | 0–1；0 隐藏底纹 |

| 小鱼数量 | 170 | 0–1000；0 隐藏小鱼 |

| 尾迹强度 | 1 | 0–10；0 隐藏扩散尾迹 |

| 背景毛玻璃 | 开 | 聊天中鲸鱼与消息之间的雾面 |

| 背景模糊 | 19 px | 0–64 px |

| 背景不透明度 | 0.45 | 0–1；越高越不透 |

| 输入框毛玻璃 | 开 | 输入框后方的玻璃 |

| 输入框模糊 | 14 px | 0–64 px |

| 输入框不透明度 | 0.45 | 0–1；越高越不透 |

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

座头鲸保留长胸鳍和宽尾叶；虎鲸采用更宽的圆钝头部、短圆胸鳍，以及独立于眼睛底色的白色眼斑与侧腹斑。两种鲸鱼都保留自选主色，虎鲸白斑固定为浅白色。

三种样式均接入鲸鱼种类、显示开关、数量、大小、速度、透明度、字符栅格、网格透明度、小鱼数量、尾迹强度、颜色、字体及毛玻璃的开关／模糊／不透明度。颜色作用于身体、小鱼和尾迹；眼睛背景方块默认沿用身体底色，可单独选择黑色或白色；Kanji 的闪光与拟声文字保留主题强调色。

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

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

查看设置截图

从哪里游来

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

Kanji样式改编自 [michikusa404](https://github.com/michikusa404) 创作的 [ascii-kanji-sharks · 漢字の海](https://github.com/michikusa404/ascii-kanji-sharks)（MIT License，Copyright © 2026 michikusa404）。汉字笔画密度明暗与文字特效源于该项目；本项目将形态改为鲸鱼，并负责 DSH 接入、透明背景、可调参数与离线字体适配。完整许可保留在 [vendor/ascii-kanji-sharks/LICENSE](vendor/ascii-kanji-sharks/LICENSE)。

感谢 michikusa404 将汉字化作海洋，也感谢 stackedlol 创作的字符鱼群与动画实现。感谢两位原作者公开源码，让这片海能够游进 DeepSeek Harness。