dsh-heartbeat

dsh-heartbeat 让 DeepSeek Harness 的 agent 拥有持续存在感的心跳插件：她按节律自己醒来，维护记忆与画像、感知你的忙闲、按兴趣闲逛看新东西、把没说完的话带过下一拍，然后按分寸决定开不开口——开口要有真实来处，沉默要有具体理由。 一分钟了解

装好之后，全部能力都收在插件管理页的心跳面板里，日常使用零命令行： 展开看其余分区：兴趣范围 / 周报 / 节律 · 专注模式 · 换机迁移 设置页把节律、专注模式、换机迁移、账本与摘抄本入口收在一起： 截图为 v2.1.0。画像与会话绑定两张里的条目文字已打码。

它想解决的三件事： 快速开始 安装（npm 包，推荐）

重启 DSH 即生效——插件自动创建专用心跳会话并按节律运行，之后日常无需任何操作。

心跳预设是自动装的：插件加载时直接向宿主注册（agentPresets.register()，v1.9.2 起），不需要任何手动操作，安装清单里也不再声明宿主包。缺失就按包内模板建好，已有文件永不覆写（你手改过的预设原样保留）。无论走哪条路径，没有这个预设心跳 agent 就是个"裸 agent"，连 web_search 都看不见——想手动检查/修复用 preset status / preset install（见下节）；把插件 config 的 installPreset 设为 false 可同时关掉运行时注册与目录自装，预设完全由你管。 从源码安装（开发/改造用）

数据放在哪

数据默认住在包外： /heartbeat-data（没有 DSH_HOME 就是 ~/.dsh/heartbeat-data），重装与升级都不会碰它。老版本装在包目录里的 data/ 会在首次启动时自动搬过去（搬迁前先备份、逐文件校验通过才删原件，见下节「卸载」）。要换位置就用插件 config 的 dataDir，或环境变量 HEARTBEAT_DATA_DIR。 平台支持

Windows 上全部功能可用。v2.1.0 起 Linux / macOS 也能跑起来：心跳循环、表达与投递、时间注入、心事匣 / 账本 / 摘抄本、素材池、周报、设置面板与 RPC 通道都照常；依赖 PowerShell 的那几项——截屏、空闲检测、锁屏检测、前台窗口探测、桌面通知——在这两个平台上不可用，插件会直接按「探针失败」降级，不会卡住某一跳。代价是忙闲判定缺席：静默时段、每日上限、开口冷却照常生效，但「他大概在忙」这类窗口判断不会触发。

数据不跨平台搬家：data/vault.key 在 Windows 上由 DPAPI 保护，在 Linux / macOS 上是一份权限 0600 的密钥文件，两边互不相认。换平台就是重新开一份数据目录。 核心工作机制

一跳 = agent 自己醒一次（默认 60 分钟）。醒着的时候依次走七相，最后由留痕收尾：

点此展开：七相详情与关键概念