前言¶

DeepSeek Harness（DSH）把界面能力拆成可挂载的客户端插件。新建会话页（hero 相位）往往是空白背景或静态装饰，对长期开着的开发者来说缺少一点「在场感」，又不宜在已有会话列表上叠动效——那会抬高阅读成本。下面介绍社区插件 dsh-ascii-sharks：只在新建会话页挂一片字符画海洋，鱼群会躲、虎鲸会追，明暗主题与透明度可调，离屏或切标签页时停止动画。

这是什么¶

dsh-ascii-sharks 由维护者 OGHong 发布，在 SkillHub 插件目录 归类为「趣味换装」。它把 stackedlol/ascii-sharks 的引擎移植并重写为 DSH 客户端插件：接入宿主生命周期、明暗主题、整体透明度，并新增虎鲸外形与相关行为。运行时无额外 npm 依赖；授权为 MIT（引擎与 DSH 接线部分版权说明见仓库 LICENSE 与 NOTICE.md）。仓库要求 Node >= 22.6、dsh >= 0.2.0-rc.2（README 徽章标注 DSH 0.2.1-rc.2）；当前包版本 0.1.0。

核心功能¶

出现时机与性能¶

海洋仅在新建会话页挂载；会话激活后卸载背景动画，避免干扰正文。动画循环在离屏、切标签页不可见时暂停；尊重 prefers-reduced-motion（只画一帧）；设备像素比封顶 2；固定 1/60 步长，每帧最多补 4 帧。

行为与视觉¶

• 鱼群：boids（分离/对齐/聚合）与 Couzin 分区，带 127° 盲区；恐慌沿群传递，边缘受惊可引发整群炸开。鼠标指针可配置为驱鱼（设置项「鼠标驱鱼」）。
• 虎鲸/鲨鱼：20 节点脊髓 + follow-the-leader，转弯半径随速度变化，饥饿累积、捕食后下降，偏好落单目标。默认 3 头在不同深度巡游（可调 1–5）；游速相对上游有下调（README 中给出巡航与鱼群倍率说明）。
• 九种外形、零位图素材：默认 orca，另有 classic、hammerhead、greathammer、tiger、zebra、mako、thresher、nurse。外形由数学函数光栅化为字符格；「整群种类」支持 随机（每头独立抽取，回到新建会话页时重新抽；存储的是「开启随机」，不是某次抽到的结果）。
• 半透明与主题：默认透明度 0.6，设置可调 0.1–1（README 亦写默认整体透明度 0.72，以安装后设置页为准）。透明度作用在 canvas 合成层。暗色主题为亮块挖暗字，亮色主题为淡灰底压深字，切换主题当场换色。
• canvas 位置：挂在会话列内、z-index: -1，不占用 shell.overlay，避免盖住内容。

设置入口¶

安装后：

• 新建会话页背景即为 ASCII 海洋。
• 设置 左侧导航出现 「ASCII 海洋」 页：运行状态、透明度、浓淡、数量（1–5）、整群种类（含随机）、鼠标驱鱼。
• 设置 → 通用设置 中有快捷开关（透明度、浓淡、物种、鼠标驱鱼）。

README 说明：侧栏「插件」页只列 DSH 官方 bundle，第三方客户端插件不在该名单；本插件以 「ASCII 海洋」 设置页为主要命名入口。

偏好保存在浏览器 localStorage（键 dsh-ascii-sharks:v1），不写入 Host 设置文档。

安装与启用¶

在插件仓库根目录执行（命令以 README 为准，勿凭插件名拼接 dsh plugin add）：

sh scripts/install.sh            # 默认接进 desktop profile
sh scripts/install.sh --profile=web

然后重启 DeepSeek Harness（宿主启动时扫描插件清单）。

摘除：

sh scripts/install.sh --uninstall

典型用法¶

1. 按上文安装并重启 DSH，打开无活跃会话的新建页，确认背景中有鱼群与虎鲸游动。
2. 进入 设置 → ASCII 海洋，调整透明度、浓淡、虎鲸数量与种类；开启「随机」后多次离开并回到新建页，观察每头外形独立重抽。
3. 在 设置 → 通用设置 用快捷开关做日常开关与常用项，无需每次进专用页。
4. 开发调试（可选）：克隆仓库后 npm install，npm run verify 做类型检查与构建；npm run preview 生成 preview/harness.js，用 preview/index.html 模拟 shell，preview/lab.html 查看外形并排，preview/parity.html 与上游同条件对比。

适用场景与注意¶

适合：希望在 DSH 新建会话页增加轻量 ASCII 动效、又需要主题自适应与可关可控的开发者；对 boids / 简单人工生命演示感兴趣、愿意本地安装第三方客户端插件的用户。

注意：

• 插件以当前 DSH 进程及浏览器上下文运行；安装前请阅读 GitHub 源码 与 MIT 许可，自行评估信任边界。
• 社区目录 SkillHub 与 DeepSeek / 幻方无官方从属关系；DSH 生态强调「一切皆插件」，本文介绍的是社区维护的趣味换装类扩展。
• 引擎归属与改动清单见 README「来源」一节；分发编译产物时需保留 lib/client.js 顶部版权 banner。

结尾¶

dsh-ascii-sharks 把上游 ASCII 鲨鱼引擎接到 DSH 新建会话 hero 相位：真会逃的鱼、真会追的虎鲸、主题与透明度可配，且不在有会话时抢视觉注意力。目录页：https://www.skillhub.cn/plugins/OGHong/dsh-ascii-sharks；仓库：https://github.com/OGHong/dsh-ascii-sharks。