文字蓝鲸

让你写下的文字，变成在 DeepSeek Harness 对话页巡游的鲸鱼。

简体中文 · English

下载安装包 · 安装 · 设置 · 本地预览 · 更新日志

感谢 ascii-sharks，最初的画面灵感来自这个项目。

从海面正上方看，五种鲸鱼用文字和字格组成身体，缓缓摆尾、转向、滑行。鱼身可以使用你自己的文字，也可以按明暗填入 ASCII 字符。鲸体在本地绘制，无需图片素材或外部服务。

_{纯字符与彩色字格、自定义文字与 ASCII，可以自由组合。}

安装

1. 从 Releases 下载 local-dsh-ascii-ocean-*.tgz 安装包。
2. 在 DSH 插件管理器中安装该文件。
3. 打开 插件 → 文字蓝鲸，调整选项后点击 保存。

目前发布的安装包为 v0.10.0。下方功能说明与截图以该版本为准。

能做什么

• 用中文、英文或 emoji 组成鲸鱼。留空时使用「探索未至之境」。
• 在蓝鲸、座头鲸、抹香鲸、长须鲸、弓头鲸之间选择，也可以让它们混合巡游。
• 用纯字符呈现轻淡轮廓，或加上彩色字格，显示背部、侧身与鳍尾的明暗。
• 调整数量、体长、速度、浓度和配色。改变体长不会改变游速与摆尾节奏。
• 保存设置后更新鲸群状态，切换模型时继续巡游。
• 跟随深浅主题与系统偏好。减少动态效果时显示静态姿态，页面隐藏时暂停，装饰层不拦截鼠标操作。

画面与阅读

磨砂阅读区让正文背后的鲸影变得柔和。深浅主题使用各自的玻璃材质。

浅色主题	深色主题

输入框可以保留模糊鲸影，也可以让鲸鱼绕开它。

输入框毛玻璃与鱼群避让输入框互斥，开启其中一项会关闭另一项。正文阅读区的毛玻璃可以独立调整。

这里的截图来自独立预览或仿真环境。真实 DSH 桌面窗口中的最终观感与验证边界见 SOURCE-NOTES.md。

设置

拖动滑杆时，设置页的静态样例会更新；点击 保存 后，草稿才应用到对话背景。恢复默认值修改草稿，重新载入已保存值丢弃未保存的调整。

鱼身文字支持中文、英文、emoji 和组合字形，空白会被忽略。输入上限为 40 个 UTF-16 代码单元，部分 emoji 会占用多个单位。切换到 ASCII 不会改写已保存的自定义文字。

桌面版自动跟随左侧栏宽度；在普通浏览器中，可用 浏览器左侧留白 调整鲸群的可见区域。

本地预览

下载或克隆仓库后，用浏览器打开 whale-preview.html。页面使用插件的正式渲染器，不需要启动服务器。

预览包含四种渲染组合和实时鲸群，可以切换鲸类、鱼身文字、大小、速度、玻璃与深浅主题。页面底部的模拟输入框用于比较毛玻璃和避让效果。

开发

npm install
npm run build
node preview.mjs
npm run check
npm test
node build.mjs --check
npm pack --ignore-scripts

文档与参考

• 更新日志：版本历史与升级变化。
• 实现与验证记录：实现细节、问题根因与验证边界。
• ASCII 渲染研究：字格与字符密度的机制核对。
• 鲸类造型参考：五种鲸类的俯视照片依据。
• 历史截图：早期版本的视觉记录。

真实参考照片、本地验证证据与第三方参考仓库不随项目发布，目录规则见 .gitignore。