前言¶
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 / 幻方無官方從屬關係。
