前言¶
DeepSeek Harness（DSH）的会话界面默认偏功能向，长时间对着同一套纯色或极简背景，视觉疲劳并不少见。社区里也有换肤、改 CSS 的做法，但大多只改颜色，很难做出「鼠标划过起涟漪、点击空白落墨」这类与页面同层的动态效果，还要兼顾输入区留白和明暗主题。
墨池（dsh-inkpond）是维护者 shin4 发布的 DSH 客户端插件，npm 包名为 dsh-inkpond，在 SkillHub 上归类为「趣味换装」。它以汉字水墨为视觉语言，在会话容器背后铺 Canvas 背景，不接管点击、键盘或发送消息；属于独立社区插件，与 DeepSeek 官方无隶属关系。
这是什么¶
一句话定位：为 DeepSeek Harness 会话界面提供可交互的中国风水墨背景（Interactive Chinese ink-wash backgrounds for DeepSeek Harness）。
默认场景是莲池——荷叶与荷花之间鲤鱼缓缓游动；鼠标划过起涟漪，点击空白处落墨。还可切换山水、清明上河、二十四节气和北冥等画面，并保留输入区留白、明暗主题跟随及弱设备上的自动性能降级。
核心功能¶
下面介绍 README 中已写明、可在安装后逐项验证的能力。
场景与交互¶
- 莲池（默认）：动态预览见仓库
docs/images/lotus-preview.gif，默认浓度约 45%。 - 山水、清明上河、北冥：北冥呈现海浪与鲸影。
- 二十四节气：随当前日期选择对应画面。
- 交互：鼠标划过涟漪；点击空白落墨；画布不拦截消息发送与键盘输入。
显示范围与外观¶
在 插件 → 已安装 → dsh-inkpond 中可配置：
- 默认仅新会话显示；也可选所有会话（长对话兼容性 README 注明仍需更多实测）。
- 调整淡彩、墨色浓淡；选择跟随系统动画或静态画面。
- 恢复默认回到莲池、45% 浓度、仅新会话、跟随系统动画。
性能与无障碍¶
- 关闭标签页时动画暂停；「减少动画」类设置会生成静态画面。
- 高对比度模式会隐藏画布。
- 弱设备会自动降低动画档位。
本地存储¶
外观偏好保存在当前客户端 origin 的 localStorage：
dsh-inkpond.preferences.v1dsh-inkpond.tier.v1（性能档位）
不跨浏览器、端口或设备同步。卸载会清除运行实例、样式与 DOM 标记，但保留本地偏好便于重装；需彻底清除时可手动删除上述键。
范围说明¶
插件只提供背景与外观设置，没有模型工具、遥测、消息读取或第三方网络请求；五个字体子集随包提供，无需 CDN。绘制核心来自 inkpond，代码 MIT，字体 SIL OFL 1.1。
兼容性¶
首版验证基线为 DSH 0.2.1-rc.3（macOS 官方桌面应用携带的内核，隔离 Web profile）。package.json 中 engines.dsh 暂时固定该版本；其他版本及 Windows/Linux 尚未验证。插件依赖会话容器的语义 DOM 标记，宿主 API 或布局改变时需要重新验证后再扩大版本范围。
安装与启用¶
安装命令须以 README 原文为准；不要从未构建的 GitHub 源码直接安装（需先 npm ci && npm run build）。
桌面版或网页版：添加插件向导（推荐）¶
- 打开 DSH 的 插件 → 添加插件 → 安装第三方插件（Add plugin）。
- 在「包名或地址」中填写 npm 包名：
dsh-inkpond
如需固定版本：
dsh-inkpond@0.2.0
- 「安装源」选 npm 官方源，点击 安装。新版本可能尚未同步到镜像源。
- 安装后新建空白会话即可看到默认莲池；若宿主提示重启，请完全退出并重新打开 DSH。
此入口直接从 npm 安装，不依赖 1024 Store 或 dshmarket 是否收录。包发布于 npm。
CLI：安装到 Web profile¶
桌面版更推荐应用内向导（装到当前应用 profile）；不要假定终端的 web profile 就是桌面配置。
dsh plugin --profile web add dsh-inkpond@0.2.0
Release 安装包¶
从 GitHub Releases 下载 dsh-inkpond-0.2.0.tgz，在插件管理页填本地绝对路径，或：
dsh plugin --profile web add /absolute/path/to/dsh-inkpond-0.2.0.tgz
刷新页面；未热加载则重启对应实例。安装包含构建产物，无安装期编译。
典型用法¶
经过上面的安装步骤后，按下面顺序即可复现 README 描述的体验。
- 新建空白会话，确认默认莲池与交互（涟漪、落墨）。
- 打开 插件 → 已安装 → dsh-inkpond，切换山水、清明上河、节气或北冥，观察输入区是否仍留白。
- 调整淡彩与墨色浓淡，对比明暗主题是否跟随宿主。
- 若需省资源，选静态画面或依赖系统的「减少动画」；在弱设备上观察是否自动降档。
- 仅需新会话背景时保持默认；要对历史会话也铺背景时再选「所有会话」，并留意长对话下的表现。
适用场景与注意¶
适合谁：希望在 DSH 里用中国风动态背景装饰会话、又不需要改模型或工具链的开发者与用户；分类上属于「趣味换装」，不改变 Harness 的核心能力。
安装前：DSH 插件在当前 dsh 进程权限下运行。安装前应自行查看 GitHub 仓库 源码与 MIT / 第三方字体许可，确认符合你的环境与合规要求。
局限：兼容性目前以 DSH 0.2.1-rc.3 与 macOS 桌面验证为主；Windows/Linux 与其他 DSH 版本未在 README 中声明通过。所有会话模式与长对话仍需自行实测。
结尾¶
dsh-inkpond 把 inkpond 的水墨绘制接到 DSH Web 客户端上，用莲池、手卷、节气等场景给会话加一层可交互背景，同时尽量让输入、主题与无障碍设置仍由宿主主导。若要浏览目录简介或跟踪版本，可看 SkillHub 插件页 与 GitHub：shin4/inkpond-dsh。
