前言¶
在 DeepSeek Harness（DSH）里长时间调试智能体或对话时，界面背景往往是纯色或静态图，和「海洋、生物、随时间变化的光」这类氛围很难兼得。社区插件 dsh-whalepaper 把一片实时演算的三维 ASCII 海洋嵌进宿主工作区：三头虎鲸自主游动，海面光色随本地时间变化，聊天区保持透明，不拿遮罩挡正文。下面介绍它是什么、能做什么，以及如何安装与配置。
这是什么¶
dsh-whalepaper（仓库 LeriusLei/dsh-whalepaper）由维护者 LeriusLei 发布，在 SkillHub 社区目录中归类为趣味换装。当前包版本 0.6.0，许可证 MIT。它不是预录视频，而是由壁纸渲染器在 1440×810 画布上连续绘制的 ASCII 海洋；虎鲸会跳水、翻滚、潜水、换气喷水，并偶尔追赶会逃离的小鱼。插件以 DSH 插件形式运行，安装后随 profile 加载客户端 bundle 与 Cordis patch，独立、离线可用构建资源，安装时无需在本地编译。
核心功能¶
一天里的海¶
同一片海在一天中有八个时段光色：深夜、凌晨、日出、正午、下午、黄昏、晚霞、傍晚；也可按设备当地时间平滑过渡。README 中提供了各时段预览图（wallpaper/previews/）。
构图与行为¶
海天构图可选三种水上空间比例：28%、33%、38.2%。正常模式以巡游、滑行、近海床深潜和觅食为主；跃出是较少发生的背景事件，落水带冠状飞溅、泡沫、涟漪与水下气泡；换气从露出水面的呼吸孔开始，仅部分换气有可见雾气。
原生插件设置（0.6.0）¶
从 0.6.0 起，设置接入 DSH 「设置 → 插件 → 配置 dsh-whalepaper」。插件通过 Config schema 声明 8 个字段（均为 .volatile()），宿主据此生成表单；写入经当前 profile 的 Cordis patch 持久化并热应用，刷新或重启后保留。可调整项包括：海洋时刻、海天构图、亮度、饱和度、柔化、安静游动、暂停、显示壁纸，以及恢复默认。
README 确认的默认值为：水上 33%、亮度 97%、饱和度 111%、柔化 0.3px，安静游动与显示壁纸开启，暂停关闭。完整默认值见仓库内 default-settings.json。
0.6.0 移除了「阅读方案 preset」与「正文保护 glass」两个旧开关：正文固定直显无遮罩；旧配置里对应字段会被忽略。插件仍保留右下角 ≈ 快速面板，与原生设置页共用同一份状态；每个控件只写自身字段。
侧栏玻璃态（0.6.0）¶
启用壁纸后，左侧导航栏可随壁纸呈现玻璃态：原生侧栏与标题行通过 --dsw-specific-sidebar-fill 保持透明；对自带侧栏表面的第三方插件（例如 @michengai/dsh-codex-ui 的 .dcu-root）会自动启用 data-we-sidebar-glass 并注入 --we-sidebar-* 参数。关闭壁纸或卸载插件时会恢复原样式。若左栏仍不透明，可能是其他背景/皮肤插件同时绘制侧栏，可先单独启用本壁纸对比。
预览与宿主适配¶
构建资源中的 wallpaper/harness.html 提供单一深海色、无遮盖的聊天预览，使用同一份客户端适配器，仅本地示例、不连接真实会话。有不透明顶部栏时，宿主可设置 CSS 变量 --orca-top-inset 为实际占用高度，背景画布会避开该栏。默认不为正文和输入区添加遮盖，滤镜仅作用于背景。
若宿主未显示「配置」卡片，说明客户端 plugins.bundle.config 卡片未注册成功，可回退 ≈ 面板，并在插件管理页检查客户端 bundle 是否加载。
安装与启用¶
带完整构建资源，无需本地构建。收录进 DSH 插件市场后，可在 「设置 → 插件市场」 安装；也可从 GitHub 仓库安装（将 <owner> 换成仓库属主 LeriusLei）：
dsh plugin --profile <实际使用的profile> add github:<owner>/dsh-whalepaper
或下载 Release 中的 dsh-whalepaper.tgz 后本地安装：
dsh plugin --profile <实际使用的profile> add "<tgz 的绝对路径>"
重启是否需要由该 profile 的 HMR 设置决定。启用后，正式配置入口为 「设置 → 插件 → 配置」；右下角 ≈ 可快速调整光色、构图、显示与暂停。插件停用会撤回本包节点、样式、监听器并释放 iframe。
注意： 插件在当前 DSH 进程权限下运行，安装前应自行查看仓库源码与 MIT 许可证，确认可接受后再安装。
典型用法¶
- 用上述命令为实际 profile 安装并启用插件。
- 打开 「设置 → 插件 → 配置 dsh-whalepaper」，按需要改海洋时刻、海天构图、亮度、饱和度、柔化、安静游动、暂停与显示壁纸；或点击右下角
≈做同样调整。 - 需要验证渲染与适配时，可在仓库构建资源中打开
wallpaper/harness.html做本地预览（默认值与default-settings.json一致）。 - 若与多个背景类插件叠用导致侧栏或顶栏异常，建议先单独启用本壁纸，再逐步叠加其他插件。
宿主表单可用时设置写入 profile（原生模式）；预览页等无宿主表单的环境回退本地存储，刷新后均保留。
适用场景与注意¶
适合希望在 DSH 桌面里获得低干扰、可配置、随本地时间变化的 ASCII 海洋背景、又需要聊天工作区保持可读的用户。README 说明 0.6.0 曾在 DSH 桌面 0.2.0-rc.2 本地 profile 实装验证过静态路由与 boot 组合；不同宿主版本或其他主题插件可能需要自行调整表面透明度。仓库要求 Node >= 20，peer 依赖 @deepseek-ai/schemastery ^3.18.4。
社区目录页：skillhub.cn/plugins/LeriusLei/dsh-whalepaper（独立社区站点，与 DeepSeek / 幻方无官方从属关系）。GitHub 仓库当前公开 1 star，属早期社区插件体量。
结尾¶
dsh-whalepaper 把实时 ASCII 虎鲸生态、八时段海洋光色和 DSH 原生插件设置、侧栏玻璃态收进一个 MIT 壁纸插件；安装命令以 README 为准，配置以 default-settings.json 与设置页为准。需要进一步细节时可查阅仓库 README 与 docs/DSH-HANDOFF.md。
