前言¶

在 DSH 里长时间盯屏写 prompt、调插件、跟智能体来回对话，常见做法是设系统提醒或自己掐表起身；覆盖层类工具往往要手动关、还容易挡输入框。潮间（dsh-intertidal）走另一条路：按你设定的间隔把屏幕短暂交给一片按本地太阳位置算出来的「此刻」海面，到点自动淡出，不弹确认、不改动滚动位置与输入焦点。下面介绍它是什么、能做什么，以及如何安装与配置。

这是什么¶

dsh-intertidal 是维护者 winditer 发布的 DSH 插件，npm 包名 dsh-intertidal，当前资料中的版本为 0.2.0，许可证 MIT。它不联网取天文数据、不采集使用数据、不写会话记录；素材模式里若你填写公网链接，才会发起你指定的那次网络请求。

插件注册覆盖层与设置页分区，不注册侧栏入口，也不改 DSH 内容区布局。需要宿主 DSH >=0.2.1-rc.5 且 <0.3.0，以及 Node >=20。

核心功能¶

定时浮现与节奏¶

默认每 120 分钟浮现 3 分钟，到点自行淡出。节奏相关能力还包括：

• 夜间静默时段（默认 23:00–07:00）
• 输入中时推迟浮现（最多等 10 分钟）
• 「今天跳过」
• 首次安装后首次投放延迟 20 分钟
• 设置页「看一眼海」手动触发；命令 intertidal.open（文案「涨一次潮」）可在 设置 → 快捷键 绑定，插件不带默认键位

浮现形态支持整屏或右下角小窗（可拖拽、吸附四角）；两种形态共享同一次浮现的剩余时长。右上角有 m:ss 倒计时，暂停时数字冻结。

忠于此刻的天文与画面¶

时段按太阳高度角判定，而非单纯钟点（资料举例：同一刻上海可能是黄昏，雷克雅未克可能仍是下午）。月相按 29.53 天朔望周期绘制；高纬极昼、极夜走单独分支。白天有成群海鸥随机掠过（非定时动画）。

海面有两种来源：

1. 程序化海：五档色阶与斑块场（水面碎块、朝观察者推进的涌浪、太阳光路与近岸白浪），无需素材、不联网，作为兜底。
2. 素材模式：从本地目录随机取图片/视频，或对网页/图片链接抓取并缓存，再按此刻天光着色；可配置天光着色强度、缓慢推拉、每次换一张等。

无障碍方面跟随系统「减少动态」（静态一帧），设置页可强制开关。可选 WebAudio 合成海浪声（默认关闭，需点一次解锁）。

宿主接口与本地文件¶

宿主半片在 /intertidal 下提供接口，请求经同源准入围栏。常用路径包括：

素材模式另有 /intertidal/media 等路径。状态写入 ~/.dsh/intertidal/state.json（原子写、权限 0600）；素材缓存目录 ~/.dsh/intertidal/cache/，上限 200 MB，按最旧淘汰。

安装与启用¶

插件市场：在 DSH 的 插件 → 插件市场 中搜索 dsh-intertidal 安装。

命令行（资料原文命令，请将 profile 换成你的配置名）：

dsh plugin --profile <你的 profile> add dsh-intertidal

装完后刷新页面即可；资料注明宿主半片首次加载可能需要一次 DSH 重启。

本机从源码 link 开发时，可在 profile 目录执行（一般用户可忽略）：

pnpm add link:/path/to/dsh-intertidal

配置一览¶

在 DSH 设置 → 潮间 中调整。资料中的默认值摘要如下：

地点决定太阳高度与时段分支；只用程序化海时不必准备任何图片。若启用素材模式，只读你指定的本地目录（文件名按 basename 与扩展名白名单），链接仅接受公网 http/https。

典型用法¶

1. 安装并刷新（必要时重启 DSH）后，保持默认即可：约每两小时自动出现 3 分钟程序化海，夜间与打字时尽量不打扰。
2. 需要立刻休息时，打开设置页点「看一眼海」，或为 intertidal.open 绑快捷键后手动「涨一次潮」。
3. 想用自己拍的视频当海面：在潮间设置里把素材来源改为本地目录或网页链接，按需打开天光着色与「每次换一张」。
4. 跨时区协作、希望黄昏感与真实太阳一致时，在「地点」选内置城市或填经纬度与时区。

经过上面的步骤，覆盖层会在倒计时结束后自行消失，无需再点关闭。

适用场景与注意¶

适合希望在 DSH 长会话中插入短、可预期、可跳过视觉休息、又不愿被模态弹窗打断的开发者。依赖槽位 shell.overlay 与 settings.section；若某一槽位注册失败，资料说明仅打印告警，不阻止 DSH 启动。

安装前建议像对待任意社区插件一样：在 GitHub 浏览源码与 MIT 许可证，并记住插件以当前 DSH 进程权限运行；素材模式会读你配置的目录并在你填链接时访问网络。社区目录 SkillHub 插件页 与 DeepSeek / 幻方无官方从属关系，属「一切皆插件」生态中的独立条目。

延伸阅读¶

• 插件目录：winditer/dsh-intertidal
• 源码与 README：github.com/winditer/dsh-intertidal