前言¶
在 DeepSeek Harness 里跑任务时，客户端窗口能看进度，但桌面侧往往缺少一个持续在场、能随任务状态切换反馈的载体。独立安装的桌宠可以补这一层，却还要单独维护启动方式和与 Harness 的联动。维护者 Doya16 将曾在 B 站获得 400+ 收藏的「守岸人 DeepSeek 桌宠」收拢为 npm 插件 dsh-shorekeeper：在 Windows 本机 Harness 中安装启用后，从插件入口下载并启动完整版桌面程序，保留原独立版的主要交互与素材能力，并去掉创建桌面快捷方式等 Harness 侧不需要的步骤。
这是什么¶
dsh-shorekeeper 是《鸣潮》角色守岸人的桌面桌宠，以 DeepSeek Harness 插件形式分发（MIT 许可证，维护者 Doya16）。插件入口体积约 0.3 MB；首次启动完整桌宠需另下载约 229 MiB 的运行程序，内置三套共 83 个 GIF、40 个音频、54 组语音字幕配对和两款字体，无需安装 Python。
适用环境：Windows 10/11 x64、本机已安装并登录 DeepSeek Harness。README 写明验证环境为 0.2.1-rc.5；package.json 中 engines.dsh 为 >=0.2.1-rc.5 <0.3.0。原 守岸人 DeepSeek 桌宠独立安装版 仍保留；与 Codex 版桌宠 可同时运行，设置分别保存。若与独立版同时开，可能出现两只桌宠，需自行关闭其一。
社区目录页：skillhub.cn/plugins/Doya16/dsh-shorekeeper。收录申请见 dsh-plugin-index #158。
核心功能¶
下列能力均来自项目 README 的功能说明与设置项描述。
任务与 Harness 联动
- 根据任务阶段切换表情：思考、查阅、编写、执行、等你回应、完成、报错、暂停等。
- 多个会话分别完成时排队提醒，先完成的会话也会收到回应。
- 在「设置 → 连接 DeepSeek」中可选随 Harness 启动、完全退出时关闭，以及选择跟随的会话；托盘可唤醒或隐藏桌宠。
语音、气泡与素材
- 每个动作可绑定 GIF（或导入 GIF、动态 WebP、PNG、JPG 等）；交互工作室里可设循环、速度、单次播放、播完停留与下一状态。
- 同一动作可添加多条音频（WAV、MP3、OGG、FLAC、M4A、AAC），每条单独配字幕；播放时随机一对。气泡可选「自定义音频+字幕」。
- 思考阶段语音可设为每轮只播一次；待机可设为每次进入、每次启动一次或按概率偶尔播放。
桌面交互与打扰控制
- 摸头、双击、拖动、放下、悬停、投喂等可分别绑定 GIF、音频与气泡。
- 「安静陪伴（静音）」一键停止当前与待播声音；锁定后角色区域点击穿透，悬停时角色与余额框可一起淡化，任务动画与提醒仍继续。
- Ctrl + 滚轮缩放桌宠；字体与气泡、底栏尺寸可在设置中实时预览（内置站酷快乐体、霞鹜文楷，可增本地字体）。
余额与更新（v1.1.4 起可隐藏余额框）
- 底部余额框显示充值与赠送合计；点击刷新，悬停看明细；无读数时显示
--。 - 可在设置或右键菜单中隐藏余额框，隐藏后布局只按角色范围计算，配置可迁移。
- v1.2.0：定时检查新版，无声更新气泡常驻；「更新并重启守岸人」可下载程序更新并保留当前配置与素材；支持「今日不再提醒」及下载中断恢复。
配置迁移
- 修改自动保存；可导出配置素材包或含运行程序的便携完整包，换机时一并带走 GIF、音频、字幕与全部设置。
演示视频与部分配图沿用独立版 v0.5.1 的横屏/竖屏演示（README 中注明客户端窗口、对话、任务、余额等为示例，桌宠与设置为实际界面）。B 站介绍：【DeepSeek x 鸣潮】守岸人来陪你了。
安装与启用¶
DeepSeek Harness 生态里插件通常通过客户端插件管理安装；npm 包名为 dsh-shorekeeper，当前插件版本 1.2.0（见 package.json 与 README）。
推荐路径（桌面客户端）
- 安装并登录 DeepSeek Harness（README 验证版本 0.2.1-rc.5）。
- 在 Harness 的插件管理中安装并启用
dsh-shorekeeper。 - 点击窗口右下角 守岸人桌宠 → 下载并安装完整版（首次约 229 MiB，可选自动、GitHub 或镜像加速）。
- 点击 启动桌宠；右键桌宠 设置…，或从插件入口 打开完整设置。
安装并启用后无需再装旧版「连接插件」。README 说明：桌面客户端的 desktop 配置由客户端管理，不能用独立 npm CLI 直接改桌面客户端里的插件列表。
非 desktop 配置的 CLI 示例（README 原文）
独立 npm CLI 用户可向自己的非 desktop 配置安装，例如：
dsh plugin --profile shorekeeper add dsh-shorekeeper@1.1.2
上述命令不会把插件装入桌面客户端；桌面端仍以客户端插件管理为准。选用 CLI 时请注意示例中的版本号与当前 npm 版本（1.2.0）是否一致，按实际需要指定版本。
部署入口隐藏
首次成功启动桌宠后，右下角部署面板与「守岸人桌宠」按钮会默认隐藏；之后可在 Harness 设置 → 守岸人桌宠 启动、关闭、打开完整设置或更新完整版。点击 显示部署入口 可恢复右下角按钮；主动恢复后不会再次自动隐藏。
典型用法¶
从插件到桌宠
完成安装与完整版下载后，用 启动桌宠 即可。日常改设置：右键桌宠或托盘 → 设置…，同一窗口包含字体与大小、交互工作室、桌面与声音、保存与迁移、连接 DeepSeek、版本与更新。
按动作定制（交互工作室）
- 在交互工作室左侧选中一个动作（如思考、完成、摸头）。
- 在 GIF 素材 中选择内置三套之一或导入/放入素材目录后刷新。
- 在 播放与切换 中调整循环与速度；在 语音与配对气泡 中添加音频与字幕，并设置自动播报频率。
- 需要专心时在右键菜单开启 安静陪伴（静音）；需要操作后方窗口时点击角色上的小锁锁定并启用穿透。
余额框与外观
- 不需要余额展示时：右键桌宠或余额框，在「刷新余额」下一项选择隐藏，或在 设置 → 字体与大小 → 余额框大小 旁取消勾选。
- 缩放：Ctrl + 滚轮；解锁状态下可拖动气泡或余额框边缘调整宽度。
更新完整版程序
旧用户 README 建议：先更新 Harness 侧插件，再在 设置 → 守岸人桌宠 或桌宠内点击 更新并重启守岸人。v1.2.0 支持检查更新、选择 GitHub/镜像来源及中断恢复。
适用场景与注意¶
适合谁
- 在 Windows 上使用本机 DeepSeek Harness，希望在桌面有一个与任务状态同步、可自定义表情与台词的守岸人桌宠的用户。
- 已从 B 站或 GitHub 了解原独立桌宠，希望改在 Harness 内统一安装与启停的用户。
使用前请知悉
- 插件在 当前 DSH 进程权限 下运行；安装前应自行查看 GitHub 仓库 源码与 MIT 许可证，确认可接受其网络下载（完整版约 229 MiB）与本地桌面程序行为。
- 仅支持 Windows x64；余额刷新等功能依赖 Harness/DeepSeek 客户端上下文，README 已说明部分界面为演示示例。
- skillhub.cn 等社区目录为独立收录站点，与 DeepSeek / 幻方无官方从属关系；插件市场「已审查」标签绑定具体版本哈希，新版本需维护者重新核对。
结尾¶
dsh-shorekeeper 把守岸人桌宠的完整桌面能力放进 Harness 插件流程：轻量入口、按需下载完整程序，并与任务状态、语音气泡、静音锁定和配置迁移打通。若要查看简介与分类（趣味换装），可打开目录页 https://www.skillhub.cn/plugins/Doya16/dsh-shorekeeper；安装细节、设置表与更新说明以 https://github.com/Doya16/dsh-shorekeeper README 为准。
