前言¶
DeepSeek Harness（DSH）的插件系统支持将任何脚本注入到对话页中。文字蓝鲸是一个把文字和字格渲染成俯视鲸鱼背景的插件，五种鲸类从海面正上方巡游，身体由你输入的文字或 ASCII 字符组成。鲸体在本地绘制，不需要图片素材或外部服务。
能力概览¶
文字蓝鲸在 DSH 插件系统中属于「趣味换装」分类。维护者为 jryang1997，在 GitHub 上获得 2 个星标。
从海面正上方看，鲸鱼的身体由文字和字格组成，缓缓摆尾、转向、滑行。鱼身可以使用你自己的文字，也可以按明暗填入 ASCII 字符。鲸体在本地绘制，不需要图片素材或外部服务。
安装与启用¶
在 DSH Web 中可通过命令行安装：
dsh plugin --profile web add github:jryang1997/dsh-ascii-whales
也可以在桌面端或插件管理器中安装安装包：
- 从 Releases 下载
local-dsh-ascii-ocean-*.tgz安装包。 - 在 DSH 插件管理器中安装该文件。
- 打开 插件 → 文字蓝鲸，调整选项后点击 保存。
目前发布的安装包为 v0.14.0。
鲸类与渲染样式¶
支持五种鲸类：蓝鲸、座头鲸、抹香鲸、长须鲸、弓头鲸。可以单独选择一种，也可以让它们混合巡游。
渲染样式有两种：
- 纯字符：用文字呈现轻淡轮廓
- 彩色字格：在背部、侧身与鳍尾填充彩色字格，显示明暗
填充内容有两种：
- 自定义文字：用中文、英文或 emoji 组成鲸鱼
- ASCII 字符：按明暗填入 ASCII 字符
留空时使用「探索未至之境」作为默认文字。
运动与下潜¶
鲸鱼在本地绘制，会缓慢摆尾、转向、滑行。游动和滑行会沿航迹留下逐渐展开、消散的 ASCII 尾流，用力拍尾时仍有少量碎水。
鲸会各自下潜再浮上来。吻端先入水，尾鳍抬起后拍一下。水下仍沿原航线游，只是看不见。浮出时鼻端先回来。不是整群一起，也没有单独开关。
海面效果¶
本地 0.14.0 加入海面风纹与慢移云影，两个开关独立控制。鲸鱼从四边穿屏，提前避开另一侧的障碍。
「海上落雨」可独立开关，雨量从 0 到 1 调整。雨丝随海面风向缓慢偏转，落点带出细小水花和逐渐展开的涟漪。关雨后自然收尾，关闭海面风纹后逐渐回到直雨。雨水纹与鲸鱼尾流分别控制。
与阅读区域的交互¶
文字边缘效果可选微光、柔和模糊或毛玻璃，默认毛玻璃。微光让文字附近的鲸鱼隐去；模糊和毛玻璃保留半透明鲸影，鲸身经过正文时仍然连贯。滚动阅读时鲸群暂时隐去，停下后从原位恢复，避免柔边拖影。
内容卡片、输入框和右侧边栏各自使用磨砂材质，右侧栏的鲸影更淡、模糊更重；深浅主题分别配色。
输入框可以保留模糊鲸影，也可以让鲸鱼绕开它。内容框毛玻璃与鱼群避让输入框互斥，开启其中一项会关闭另一项。文字保护不受这两个开关影响。
设置选项¶
左侧栏的「插件」下方常驻「文字蓝鲸」入口，点击即可打开预览与设置。拖动滑杆时，设置页的静态样例会更新；点击 保存 后，草稿才应用到对话背景。
数值选项¶
| 数值选项 | 范围 | 默认值 |
|---|---|---|
| 鲸鱼数量 | 1–8 | 3 |
| 游动速度 | 0.3–2 | 0.65 |
| 背景浓度 | 0.04–0.9 | 0.6 |
| 字符大小 | 4–16 | 11 |
| 鲸鱼大小 | 0.55–1.55 | 1 |
| 玻璃强度 | 0–1 | 0.55 |
| 雨量 | 0–1 | 0.45 |
| 浏览器左侧留白 | 0–500 px | 280 px |
样式选项¶
| 样式选项 | 可选内容 |
|---|---|
| 鲸鱼种类 | 混合鲸群、蓝鲸、座头鲸、抹香鲸、长须鲸、弓头鲸 |
| 渲染样式 | 纯字符、彩色字格 |
| 填充内容 | 自定义文字、ASCII 字符 |
| 鲸鱼配色 | 深海蓝、晴空蓝、靛蓝、每条随机配色 |
| 其他开关 | 显示蓝鲸、跟随任务状态、减淡阅读区域 |
选择「每条随机配色」后，每头鲸鱼从八种色系中随机分得一种，鲸体内部仍保留明暗。同一片海里的颜色不会随绘制或保存设置重新抽取；改数量、文字、鲸类和大小也会接续原色。
跟随任务状态¶
「跟随任务状态」默认开启。第一头对应当前会话，其余按身份绑定子代理、其他活跃会话与当前会话可见的后台任务。
| 实际状态 | 鲸鱼表现 |
|---|---|
| 会话、子代理或后台任务运行中 | 更有力地巡游，划水更持续，显示 ··· |
| 空闲或本轮停止 | 慢速滑行，子代理停止不会被当成任务成功 |
| 等待回答、审批或计划审阅 | 平滑回到水面，慢游并显示 ! 和任务名称，等待期间不再下潜 |
| 已观察到的后台任务完成 / 失败 | 显示 ✓ / × 与任务名称，继续播放六秒后消失 |
鲸鱼不足时，第一头汇总额外活跃任务的数量，并显示其中最紧急的提醒。关闭联动后恢复装饰游动。此功能只读取 DSH 已发布的状态，不回答问题、不批准操作，也不读取后台输出。
本地预览¶
下载或克隆仓库后，用浏览器打开 preview/whale-preview.html。页面使用插件的正式渲染器，不需要启动服务器。
预览包含四种渲染组合和实时鲸群，可以切换鲸类、鱼身文字、大小、速度、玻璃与深浅主题。页面底部的模拟输入框用于比较毛玻璃和避让效果。
适用场景与注意¶
文字蓝鲸适合希望在对话页中增加装饰性背景的开发者。它以 ASCII 渲染为主，对阅读体验的影响可控。注意插件以当前 DSH 进程权限运行，安装前应检查源码与许可证。
结尾¶
文字蓝鲸通过 Canvas 在本地绘制鲸鱼，配合毛玻璃效果与尾流动画，为 DSH 对话页增加了一种轻量级的装饰层。通过全滑块设置与任务状态联动，它既能作为静态背景，也能反映会话与后台任务的状态。
插件目录页：https://www.skillhub.cn/plugins/jryang1997/dsh-ascii-whales
GitHub：https://github.com/jryang1997/dsh-ascii-whales
