前言¶
DeepSeek Harness（DSH）工作台默认界面偏功能向，长期打开时缺少与个人审美或 IP 氛围一致的视觉层。社区里已有通过 client 注入改 UI 的做法，但多数只改配色或静态图，启动阶段与工作区背景往往仍是平台原生样式。
守岸人主题（npm 包名 @local/dsh-shorekeeper-startup；GitHub：SoliSpark/deepseek-harness-shorekeeper-theme）是一款面向 DSH desktop profile 的 Web 端主题插件：启动时播放「逐笔线稿 → 睁眼 → 文案与标识」的守岸人影片，结束后将同一段画面用作全屏循环背景，并在侧边栏提供设置面板，可替换为本机图片或视频，并调节界面透明度。维护者为 SoliSpark；在 GitHub 上约有 31 stars、3 forks。当前包版本为 1.2.1，许可证 MIT。
下文按定位、能力、安装、用法与注意事项说明，事实均来自项目 README 与 package.json。
这是什么¶
插件在 DSH 客户端侧通过 dsh.client 注入（platform: web，immediately: true），并依赖 @deepseek-ai/dsh-client-ui-layout。Host 侧 index.js 为空实现，仅提供 Loader 入口；实际交互与视觉由构建产物 client.js（约 2.9 MB，内嵌影片、笔画路径与标识部件）在浏览器中执行。
一句话定位：守岸人主题 = 高完成度启动动画 + 可替换背景 + 透明度等显示调节，设置保存在本机 localStorage，关掉总开关可恢复原生外观。
启动动画¶
启动阶段的核心是一条约 1600×900、H.264、静音自动播放的影片，配合 Canvas 线稿与 CSS/粒子过渡。
逐笔线稿与睁眼¶
- 从 4K 原片睁眼前（约 3.0s）定格提取边缘，细化为 406 条矢量笔画；按「结构 → 中景 → 细节」三批、每条笔画独立延迟与速度，用 Canvas 逐帧绘制生长（1.2.1 中影片速率 1.25、线稿约 2.1 秒画完、完整线稿停留约 0.95 秒）。
- 黑底星空与共鸣粒子作衬底；
DeepSeek与「守岸人正在苏醒」自下而上渐显，蓝色由右至左渐变。 - 源片硬切点（约 3.83s）触发闪光、下扫光与粒子爆发，线稿淡出、完整画面亮起；随后欢迎文案与「黑海岸」标识按 README 描述的位移动画依次入场。
- 播放使用
object-fit: cover，CSS 调色为contrast(1.12) saturate(1.08) brightness(1)。可按ESC、点击或「跳过」立即结束。 - 动画挂在
document.body的 portal 上，覆盖整个窗口（含顶部菜单栏）；Windows 原生窗口按钮由系统绘制，网页层无法覆盖。 - DSH 加载界面仍正常显示；动画开始时用不透明舞台幕布遮住工作台，片尾或跳过时淡出，避免开场/收尾闪聊天界面。片尾采用粒子采样、扩散再汇聚的过渡，与后续背景衔接。
- 系统开启
prefers-reduced-motion时，会关闭粒子、笔画生长与位移动画。
与版本的对应关系¶
1.2.1 还对 Windows 标题条玻璃化、内容区可读性、「新会话」按钮、输入区、引导卡 hover、代码块吸顶栏、轨迹页透明、蓝色强调色等做了界面质感调整；线稿侧保留低可见度爆发粒子与常驻光点。若你跟踪上游仓库，安装前可对一下 package.json 中的 version 字段。
主题背景与设置面板¶
启动动画结束后，默认背景为同一段「睁眼」画面做成的无缝循环（截取 6–10s，交叉淡化后约 3.3s 的 loop.mp4）。
左侧栏新增「守岸人主题」入口，打开后可配置：
| 类别 | 能力 |
|---|---|
| 背景 | 启动动画 / 图片 / 视频；支持拖入或点选，单文件上限 120 MB，仅存本机 IndexedDB |
| 显示 | 界面透明度 5%–85%、背景压暗 0–85%、背景模糊 0–30px，实时生效 |
| 启动动画 | 每次启动播放开关，或手动「重播启动动画」 |
界面透明通过 ctx.theme.overrideTokens 覆盖 --dsw-alias-bg-base、--dsw-specific-sidebar-fill、--dsw-specific-input-major、--dsw-alias-bg-layer-1，与用户当前明/暗/跟随系统主题叠加，不改动主题偏好。全部设置键名为 dsh-shorekeeper.theme.v2，写入 localStorage，刷新或重启后保留。
安装与卸载¶
插件以 desktop profile 安装；README 示例中已通过 link: 指向本地目录。若你在本机复现同类路径，可参考官方 README 中的命令（路径需改成你机器上的插件目录）：
dsh plugin --profile desktop add "link:D:\Users\Documents\deepseek-harness\default-workspace\shorekeeper-startup"
安装后确认 ~/.dsh/profiles/desktop/package.json 的 dsh.profile.bundles 中出现 @local/dsh-shorekeeper-startup。
卸载：
dsh plugin --profile desktop remove @local/dsh-shorekeeper-startup
社区目录页：skillhub.cn - deepseek-harness-shorekeeper-theme。源码与说明：GitHub - SoliSpark/deepseek-harness-shorekeeper-theme。DSH 插件生态理念是「一切皆插件」；SkillHub 等为社区站点，与 DeepSeek / 幻方无官方从属关系，安装来源以你实际使用的目录或仓库为准。
典型用法¶
- 按上文完成 desktop profile 安装并重启 DSH（或按你环境要求 reload client）。
- 首次启动可观看完整启动动画，或立即跳过进入工作台。
- 打开侧边栏「守岸人主题」：若只需轻微玻璃感，先将界面透明度调到 20%–40%，再视情况加背景压暗或模糊。
- 若要换背景：在设置中选「图片」或「视频」，拖入本机文件（≤120 MB）；不再使用时可改回「启动动画」或关闭插件总开关恢复原生 UI。
- 需要再次观看开场：在设置里点「重播启动动画」，或开启「每次启动播放」。
开发者若要改节奏或素材，README 给出调整入口：client.template.js 顶部 RATE、CUT_AT、OUT_AT、LOOP_START/END；线稿与标识分别通过 tools/vectorize.py、tools/split_logo.py 再生 JSON；替换 assets/startup.mp4 后执行 node build.mjs 重新生成 client.js。
适用场景与注意¶
适合谁：长期在 desktop 版 DSH 上工作、希望启动与工作区有一致沉浸式背景、且接受本机存储用户自选媒体文件的开发者或重度用户。
权限与安全：插件以当前 DSH 进程权限在浏览器上下文运行，会读写 localStorage 与 IndexedDB。安装前应阅读源码与 MIT 许可证，并从可信来源获取构建产物；勿在未审计的第三方包上直接 link: 指向未知目录。
版权：README 载明影片与标识来自用户提供的《鸣潮》相关素材，角色与影像版权归库洛游戏所有；插件说明为仅作本地个性化使用，不再分发这些素材。自行 fork 并替换 assets/ 时须遵守相应版权与平台规则。
体积与离线：构建后 client.js 内嵌资源，不依赖外部 CDN 或 Host 路由，但单次加载体积约 2.9 MB，低配或远程桌面环境可留意首屏时间。
结尾¶
守岸人主题把 DSH 的启动瞬间和日常背景绑成同一套视觉叙事，又把背景介质和透明度交给侧边栏里的几项开关，在不动系统主题偏好的前提下叠一层可关可换的装饰。需要安装命令与素材构建细节时，以 GitHub README 为准；找插件入口可看 SkillHub 目录页 或 SoliSpark/deepseek-harness-shorekeeper-theme。
