文字蓝鲸

用鲸群跟随 DeepSeek Harness 的任务，分清运行、等待与已观察到的后台结果。

简体中文 · English

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

鲸群会跟随当前会话、子代理与可见后台任务。运行看 ···，需要你回答、审批或审阅计划时看 !。只有插件先看到后台任务运行，再看到完成或失败，才显示 ✓ 或 ×。空闲不等于成功。

_{模拟夹具，非已安装 DSH 录屏。正式 client.js，浅色主题，系统减少动态效果；四帧依次展示状态，构建与检查为不同任务。构建身份、静态帧和复跑方式见演示来源与验收记录。真实已安装 DSH 状态录屏尚未取得，#3 的该项验收仍未通过。}

标记	含义
···	会话、子代理或后台任务运行中；后台任务停止处理中仍算运行
!	等待你回答、审批或审阅计划
无结果标记	已知空闲或本轮停止，鲸鱼慢速滑行；不表示成功
✓	先观察到运行的后台任务随后完成
×	先观察到运行的后台任务随后失败
状态不可用或尚未确定	必要宿主能力缺失，或当前会话、后台列表尚不明确；保留装饰，不推断空闲或结果

取消、停止、断开和任务消失都不自动变成成功或失败。首次读取的历史结果不弹出。首次开启时的图例不抢焦点，明确关闭后记住已看过；设置中可随时重开。文字摘要提供任务名称和状态，鲸数不足时仍可查询其余任务。关闭 跟随任务状态 即恢复装饰游动。鲸群不替代宿主任务记录，也不代你回答或审批。

先从 场景预设 选择默认、雨天、极简或夜航，再按需展开 高级设置。场景只改配置草稿和预览，点击 保存 才应用到正式背景。用 重新载入已保存值 放弃草稿。详见设置。

资源档位独立于场景。省资源档减少持续调度、内部推进与绘制，并保持任务提示的独立时钟。2026-10-31 在合并 1.0.0 后的构建上做的 45 样本受控 headless Chrome 比较中，省资源档观察到较低 CPU；关闭插件占用最低。下表为隔离 Chrome 整棵进程树的单核等效 CPU 中位数（%，每格 n = 5），含夹具与 CDP 开销，不是插件独占占用。

模拟场景	关闭	标准档	省资源档
静置	0.093	46.106	23.581
追加文本	0.886	48.898	25.158
滚动	7.129	51.163	27.883

16 个逻辑处理器下，单核等效值除以 16 才是整机归一化百分比。范围、实际工作量和独立诊断见完整资源报告。实际 DSH 资源收益、GPU 利用率和能耗仍未测，不能据此推算续航或通用加速。复跑方式见三条件测量，验收范围见本地报告状态。

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

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

_{桌面窗口里的 DeepSeek Harness 首页。鲸鱼在方格海面上巡游，这是实际运行的画面。}

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

安装

在 DSH Web 中可通过命令行安装：

dsh plugin --profile web add github:jryang1997/dsh-ascii-whales

也可以在桌面端或插件管理器中安装安装包：

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

目前发布的安装包为 v1.0.0，完整变化见更新日志。本页动图统一使用白色主题并隐藏侧栏：巡游与落雨是真实 DSH 页面录屏；下潜、拍尾与任务状态用同一套渲染器单独渲染单条鲸鱼，便于看清动作，鲸鱼为「纯字符 + 自定义文字 + 每条随机配色」。任务状态动图仍是本地集成源码的模拟素材，不代表 v1.0.0 已发布这些交互。

能做什么

• 用中文、英文或 emoji 组成鲸鱼。留空时使用「探索未至之境」。
• 在蓝鲸、座头鲸、抹香鲸、长须鲸、弓头鲸之间选择，也可以让它们混合巡游。
• 用纯字符呈现轻淡轮廓，或加上彩色字格，显示背部、侧身与鳍尾的明暗。
• 整片海面铺着与字格同源的浅色方格，鲸体的字格落在同一套格线上；「海面方格」可单独关闭，默认开启。
• 调整数量、体长、速度、浓度和配色。改变体长不会改变游速与摆尾节奏。
• 保存设置后更新鲸群状态，切换模型时继续巡游。
• 本地 0.14.0 加入海面风纹与慢移云影，两个开关独立控制；鲸鱼从四边穿屏，提前避开另一侧的障碍。实现与来源见 海面风云研究。
• 「海上落雨」可独立开关，雨量从 0 到 1 调整。雨丝随海面风向缓慢偏转，落点带出细小水花和逐渐展开的涟漪。关雨后自然收尾，关闭海面风纹后逐渐回到直雨；雨水纹与鲸鱼尾流分别控制。
• 游动和滑行会沿航迹留下逐渐展开、消散的 ASCII 尾流，用力拍尾时仍有少量碎水。设置中的「游动尾流与水花」可统一开关，水纹会让开阅读区。
• 鲸会各自下潜再浮上来。吻端先入水，尾鳍抬起后拍一下。水下仍沿原航线游，只是看不见。浮出时鼻端先回来。不是整群一起，也没有单独开关。详见更新日志。
• 跟随深浅主题与系统偏好。减少动态效果时显示静态姿态，页面隐藏时暂停，装饰层不拦截鼠标操作。

动作

_{一条鲸单独渲染的下潜：尾鳍先抬起、最后消失，水下沿原航线继续游，过几秒鼻端先回来。}

_{一条鲸单独渲染的摆尾：两片尾叶上下拍动，身后水纹逐渐展开。鲸鱼使用纯字符与自定义文字。}

海上落雨

_{真实 DSH 浅色页面，隐藏侧栏：雨丝随风向缓慢偏转，落到海面时带出碎水和短暂涟漪。}

「海上落雨」默认关闭，雨量从 0 到 1，默认 0.45。雨丝跟随缓慢变化的海面风场，前后层长短与速度不同；关掉海面风纹后会慢慢回到直雨。雨滴落点带出碎水与扩散断纹，和鲸鱼游动尾流是两个独立开关。降雨沿用阅读区、媒体与毛玻璃保护；页面隐藏、暂停或系统要求减少动态时不继续推进。

听写联动

_{早期版本的真实 DSH 页面录屏，展示听写联动流程。本次全体转向与实时振幅修正尚未重录。}

需要另装 dsh-hold-to-dictate（按住说话）插件。设置里的「听写联动」默认开启，也可单独关闭；只装文字蓝鲸时这个开关不产生任何效果。录音期间每一头鲸鱼都会转向输入框，并缓慢靠近；空间拥挤时也不会遗漏个体，而是在输入框周围等待空间。海面以输入框为声源上下起伏，实时声音越响，振动的振幅越大；没有声音时逐渐恢复平静。转写结束（done）后鲸群散开。系统要求减少动态时不聚集、不推进声浪。

设计取舍与边界见 听写聚集研究；跨插件契约见对应仓库的 ADR。

画面与阅读

「文字边缘效果」可选关闭、微光、柔和模糊或毛玻璃，默认毛玻璃。关闭后不对文字附近的鲸鱼额外处理；微光让文字附近的鲸鱼隐去；模糊和毛玻璃保留半透明鲸影，鲸身经过正文时仍然连贯。这个选项独立于「内容框毛玻璃」。设置页顶部为实时大预览，首层提供场景、鱼身文字、任务跟随和图例入口；外观、鲸群、阅读、海面与布局细项位于默认折叠的高级设置中，开关、分段按钮和数值滑块各司其职。滚动阅读时鲸群照常巡游，文字遮罩跟随文字的新位置刷新。内容卡片、输入框和右侧边栏各自使用磨砂材质，右侧栏的鲸影更淡、模糊更重；深浅主题分别配色。海面方格铺在鲸群与云影之下，和鲸身共用同一套阅读保护，随「背景浓度」一起变淡，也能用「海面方格」单独关闭。

滚动时暂停渲染在「高级设置」里，默认关闭。开启后滚动一开始就暂退装饰层并暂停仿真，手停下约 140 毫秒后按新位置测量一次再淡入恢复，适合觉得柔边遮罩跟不上移动文字的情况。

浅色主题	深色主题

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

选项	效果	默认
内容框毛玻璃	内容卡片、输入框和右侧栏显示模糊鲸影，文字区域保持清晰	开启
鱼群避让输入框	鲸鱼把输入框当作障碍，绕开后继续巡游	关闭

内容框毛玻璃与鱼群避让输入框互斥，开启其中一项会关闭另一项。文字边缘效果由自己的选项独立控制，也可以单独关闭。

查看输入框避让效果

比较三档鲸鱼大小

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

设置

设置页跟随 DSH 的界面语言，内置简体中文与 English 两套文案。

左侧栏的「插件」下方常驻「文字蓝鲸」入口，点击即可打开预览与设置。也可从 插件 → 文字蓝鲸 进入同一设置页。

先在 场景预设 中选择默认、雨天、极简或夜航。预设一次更新鲸数、游速、浓度、配色与海面效果，保留鱼身文字、鲸类、渲染样式、大小、阅读保护、任务跟随和布局偏好。默认场景只恢复这组参数，与 恢复全部默认值 不同。手动改动场景拥有的参数后，组合不再匹配时显示自定义。

选择场景或调整控件只改变配置草稿和预览。点击 保存 才应用到正式背景；失败或版本冲突会保留草稿，不自动覆盖。重新载入已保存值放弃未保存的调整。旧配置保留已有有效值，不自动套预设。首层有 查看任务状态图例，图例默认隐藏，点击后展开，可再关闭。高级设置默认折叠，原有配置仍全部可访问。

数值选项	范围	默认值
鲸鱼数量	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 已发布的状态，不回答问题、不批准操作，也不读取后台输出。首次打开时已有的历史任务结果不会弹出提示。

_{一条鲸单独渲染的状态提示：巡游中 ···，等待审批 !，任务完成 ✓，失败 ×；任务名称来自 DSH。}

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

桌面版自动跟随左侧栏宽度；在普通浏览器中，可用 浏览器左侧留白 调整鲸群的可见区域。滚动时暂停渲染 同属高级设置，默认关闭。

查看设置页

模拟夹具使用正式设置组件，非已安装 DSH 截图。选项区内部滚动，预览和保存区保留在视口内。来源与构建身份见演示记录。

本地预览

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

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

开发

src/             实现源码
tests/           测试与 helpers/ 适配器
scripts/         构建与预览生成入口（验证工具由 devDependency 提供）
preview/         独立预览入口与生成页面
docs/research/   研究与设计记录
docs/images/     截图和动图

根目录保留插件公开入口 index.js、DSH 客户端产物 client.js、安装配置及项目说明。历史截图仍在 docs/archive/。

构建、检查与打包

使用 .node-version 指定的 Node，以及 package.json 中固定的 pnpm 版本。在项目根目录运行：

pnpm install --frozen-lockfile
pnpm verify

修改浏览器源码后，先用 pnpm build 和 pnpm preview 更新两个生成产物，再运行 pnpm verify。验证只检查、不重建，过期产物会直接失败。测试发现覆盖根目录与 src/、tests/、scripts/、preview/ 的 *.test.js／*.test.mjs，排除隐藏目录与 node_modules/；不会扫描仓库中的临时备份、参考项目或 worktree 副本。GitHub Actions 在 Windows 与 Linux 执行同一验证入口。

验证、打包与审查共用开发依赖 @jryang1997/dsh-plugin-kit（v1.0.0 固定 tag，dshPluginKit 配置在 package.json）：pnpm check 跑清单、locale、README、版本与语法检查，pnpm test 发现并运行测试，pnpm verify 依次检查静态项、生成物、发布包、截图清单和测试。pnpm --silent review:snapshot --base <ref> 输出包含新增文件的 JSON 审查清单；pnpm --silent agent:probe 探测当前命令进程能否读取入口文件。派单前的原生工具读取预检、审查范围与浏览器证据要求见 工程说明。

发布包只包含运行文件、locale/、图标、README/CHANGELOG 与 docs/images/、docs/research/；tests/、scripts/、preview/、.node-version 等开发路径由打包检查拒绝。kit 以 v1.0.0 tag 的 GitHub tarball 固定引用；本机 git 访问 GitHub 受限，因此不用 git+https 说明符。

打包使用 pnpm --config.ignore-scripts=true pack。

pnpm build 运行 build.mjs，从 browser-entry.js 生成 client.js；pnpm preview 运行 preview.mjs，从 preview-client.js 生成 独立预览页。两个入口共用 browser-build.mjs 和开发依赖 esbuild，自动解析依赖并隔离文件作用域；正式插件运行不依赖 esbuild。两种产物都支持 --check 检查是否与源码一致。包名为 @local/dsh-ascii-ocean，Host 行 id 为 ascii-whale-background。

文件	职责
species.js	五种鲸类的体型与动作参数
model.js	表面、投影、字格覆盖与配置指纹
motion.js	巡游、转向、滑行与输入框避让
rig.js	身体转向与上下尾拍
shading.js	背部隆起与水深字色
surface.js	字符选择、色表与字格绘制
glass.js	阅读区与输入框的面板几何及材质
engine.js	Canvas 绘制与原地更新
reading-layout.js	真实对话与演示卡片共用的玻璃、遮罩和避让规则
activity.js	DSH 状态读取、任务身份绑定、后台订阅与状态徽记
dictation.js	听写状态桥、聚集带与槽位几何、呼吸与缓动
voice-sea.js	声音驱动的海面声浪场与绘制
rain.js	随风雨丝、雨量过渡与落点水纹
sea-grid.js	铺满海面的字格方格、主题墨色与设备像素对齐
simulation.js	鲸群状态接续、尺寸变化以及动作与海面效果的推进顺序
config-editor.js	草稿互斥、校验、差量保存和版本冲突处理
browser-build.mjs	两种浏览器产物的依赖组装与一致性检查
settings.js	DSH 原生设置页

文档与参考

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

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