前言¶
DeepSeek Harness (DSH) 的核心理念是”一切皆插件”。在常规使用中，Agent 往往处于被动响应状态，缺乏持续的存在感。dsh-heartbeat 插件由 Kanadego 维护，旨在赋予 Agent 自主的”心跳”能力。它让 Agent 能够按节律自己醒来，维护记忆与画像、感知环境忙闲、按兴趣范围闲逛，并最终按分寸决定是否开口。
核心能力¶
插件的核心是一次”心跳”的完整生命周期，包含以下关键机制：
- 定时心跳与七相循环：默认每 20 分钟一跳。一跳内部包含七个阶段：维护、采集、闲逛、闸门、Digest、反刍、投递。
- 分寸闸门：在投递前进行纯代码判定，依次检查静默时段、是否处于忙时窗口、用户是否在场、每日表达上限、开口冷却时间。只有全部通过才会触发模型调用。
- 感知与闲逛：支持状态栏与时间感知，并可选视觉感知（需 ModLens）。Agent 会按设定的兴趣范围，使用
web_search查看新事物，并将结果存入素材池。 - 素材池（双仓）：包含话题库存（默认 16 条）和聊天素材（默认 14 条）。素材具有生命周期，会根据 TTL、消费退休、冷板凳或容量挤出进行确定性淘汰。
- 反刍与投递：引擎室从素材池中挑选最值得说的素材，各压缩成一句话（反刍），然后打包成素材包投递到绑定的会话中。真正开口说话的决策权由目标会话的 Agent 把握。
- 画像与账本：维护本地结构化用户画像（兴趣、项目、沟通偏好等）和账本工具。Agent 可自动记账。
- 持久化与安全：支持 Journal 快照、换机迁移（加密容器）以及本地 DPAPI 加密。
安装与依赖¶
安装前请确保环境满足以下要求：
- 平台：仅限 Windows。
- Node.js：版本需 >= 22.19.0。
- DSH 版本：依赖特定版本的 DSH 设置和 LLM。
安装命令如下：
dsh plugin --profile web add @kanadego/dsh-heartbeat
安装后重启 DSH，插件会自动创建专用心跳会话并按节律运行。日常操作主要在 DSH 设置页的心跳卡片中完成，CLI 命令用于高级场景。
常用操作¶
以下为部分关键命令示例：
会话与绑定¶
查看可用会话 ID 并进行绑定：
sessions list
bind add <id> # 投递消息到该会话
bind add <id> --observe # 仅观察该会话内容，不投递
素材与账本¶
手动管理素材或待办事项：
seeds add <text> # 手写一条种子素材
ledger add <text> # 在账本中记录待办
ledger done <id> # 标记待办完成
画像与迁移¶
导出画像或进行换机迁移：
profile export # 解密导出画像 Markdown
migrate export [file] # 打包记忆文件为口令加密容器
数据管理¶
清理日志或焚毁数据：
burn # 预演并执行数据覆写与删除
注意事项¶
- 工具限制：心跳 Agent 的工具面被硬限制为只有
web_search，无其他文件系统或 shell 权限。 - 加密机制：数据使用 Windows DPAPI（CurrentUser 作用域）加密，仅限当前用户解密。
- 生态背景：DSH 是一个插件生态，本插件由社区维护，与 DeepSeek / 幻方无官方从属关系。
