ASCII 鲨鱼水族箱 cgc1965565186-lab/dsh-ascii-sharks

dsh-ascii-sharks

在 DeepSeek Harness 桌面端界面留白里游泳的 ASCII 鲨鱼与鱼群。

给 DeepSeek Harness 桌面端界面加一片氛围感 ASCII 海洋：四条鲨鱼和小鱼群在对话周围的空白沟槽里漂游，从聊天界面后方穿过，你点击水面时它们会泛起涟漪。

;'
%%'
.t;. .oooo
S;:S% %8S8.
;:tt%t '.. XX%%S
t' ''XSSS8SSX%XX8#. %XSX%
:;' ;.''X8%8XX%%S%%S%SStt%tSX8S#X8't%ttt.
::%' ''8XXXSSt%Stttttt%8@%%@%8@8%Sttt%%%%SSSSS%tt.
'SXXtt%t%%%S%:;StS%ttSS%tSXSt88@@%8%@8%tStS%%X%SS%%S%;;t
.@##88#@...'@@@@#@8@88X88#XXXSX8SX88SX8%SS%S%%S88St%t%%%.
%;%t :. '.'##@###@X#888XX##8@@@#.X%XS%.
.%t ;%%%#@@##@@@. SXS%%
t. .%;%%%. %%XXS
'%t:t .SXSS'
'::. ooooo
.S'
.

功能

- 水池就是界面留白：已有对话时，留白是左右两条竖向水道；新建会话时，标题上方和输入框下方的整宽空白也会变成水域，和左右水道连成一圈，鲨鱼可以横穿整个留白。
- 自由随机巡游：4 种鲨鱼（classic / hammerhead / mako / nurse），每 2.2–5.5 秒随机换向，4–9 秒换一次「心情」（转向决心、横向摆动、巡航速度），软边界让连通水域之间可以自由穿行，不会反复画同一段弧。
- 点击泛起 ASCII 涟漪：左键点水面，三圈同心、2 个字符厚的波纹向外扩散 2 秒，中心爆出水珠，附近鱼群受惊炸开，并留下青蓝色尾迹光点。
- 点击穿透：画布是 pointer-events: none，水花监听是 passive + capture，点水面不会挡住下面任何按钮、输入框或文本选择，只会起涟漪。
- 不覆盖 UI：侧边栏、对话正文、输入框、右栏、弹窗都不会被鲨鱼压住；鲨鱼游到对话栏后面会被裁切，视觉上就是从后面穿过去。
- 主题自适应：深色用深水色，浅色反相墨水色；prefers-reduced-motion 下只画一帧静止画面。
- 不瞬移：布局变化不会重新播种，同一批鱼和鲨鱼会继续游进新水域。

安装

需要 DeepSeek Harness Desktop（desktop profile）。

1. 克隆本仓库。
2. 在 Harness 的插件管理器里选择 Install bundle，指向本仓库的 ascii-sharks-plugin/ 目录；或让智能体调用 plugin_manager install_bundle。
3. Host 行会立即激活，Client 模块图会通过插件事件流热更新。若你的 Harness 版本只在启动时组合模块图，重启一次 DSH Desktop（会话会保留）。

关闭：设置 → 插件 → 关掉 ASCII 鲨鱼 / ASCII Sharks；卸载：移除 @local/ascii-ocean bundle。

踩坑记录：ascii-sharks-plugin/package.json 的 exports 必须包含 "./package.json": "./package.json"。Desktop 的 Host 进程没有 Node internals，Harness 扫描客户端插件清单时走
require.resolve('<包名>/package.json') 的回退路径；缺少这个导出会被
静默跳过——插件显示已启用，但页面上什么都不会出现。

目录

| 路径 | 说明 |
| ascii-sharks-plugin/ | 可直接安装的 bundle（package.json、cordis.patch.yml、Host 半、构建好的 client.js、locale、icon） |
| ascii-sharks-src/ | 构建源码：纯 JS 的海洋/鲨鱼/渲染模块、Harness 入口、build.mjs |
| ascii-sharks-plugin/README.md | 插件本身的详细设计说明 |

构建

client.js 是单个自包含的 Client 产物（Harness 模块加载器格式）。修改源码后：

cd ascii-sharks-src
node build.mjs
node --check ../ascii-sharks-plugin/client.js

world.js / renderer.js 由上游 TypeScript 用 node:module.stripTypeScriptTypes 转成纯 JS 后再打补丁；engine.js 和 entry.js 是为 Harness 新写的胶水层。
build.mjs 会从 ../ascii-sharks-plugin/package.json 读取包名作为模块 id。

来源与许可

水下模拟移植自 stackedlol/ascii-sharks （TypeScript 源）。上游仓库没有 LICENSE 文件，因此移植过来的模拟代码不附带额外许可；Harness 集成部分（插件清单、水域测量、主题适配、涟漪渲染、入口/引擎）是为本项目新写的。详见 NOTICE.md。