dsh-heartbeat-inner

给 DeepSeek Harness 的一个主动心跳插件： 它会定时醒来，自己判断「现在要不要主动找主人说句话」——不是机械的定时问候，而是大多数时候不发。

一句话概括：让 AI 有自己的节律，而不是只在被叫时才有反应。

它和「定时任务」有什么不一样

	定时任务	dsh-heartbeat
触发	到点必发	到点先想，再决定发不发
内容	模板 / 复读	结合「多久没聊、你上次说了什么、现在几点」现想一句
克制	需要人工配	内建四道刹车，多数时候选择沉默
记忆	无	内心会话持久化，上次想过什么还记得

真实产生的两种日志：

[heartbeat] 发出去了：在呢在呢，刚把水杯放下就看到你喊我了 🐟
[heartbeat] 决定不发：他刚问完话，聊天正热着，我等着顺着那句接就行，不用再单独塞一条过去

工作方式

每 N 分钟醒来
   │
   ├─ 安静时段？ ────────────────→ 睡回去
   ├─ 距上次主动发 < 最小间隔？ ──→ 睡回去
   ├─ 主人刚说过话？ ────────────→ 睡回去
   ├─ 今天发够上限了？ ──────────→ 睡回去
   │
   ▼
POST 思考接口（或本地子进程）→ 模型输出 JSON
   │
   ├─ {"send": false, "reason": "…"}  → 记一笔，睡回去
   └─ {"send": true,  "message": "…"} → 通过 OneBot 发出去

安装

1. 拿到源码

DSH_HOME="${DSH_HOME:-$HOME/.dsh}"
git clone https://github.com/zy666946/dsh-heartbeat-inner "$DSH_HOME/plugins/dsh-heartbeat"

（或者解压 release 里的 dsh-heartbeat-*.tgz 到 $DSH_HOME/plugins/dsh-heartbeat）

2. 挂进 profile

以 web profile 为例：

DSH_HOME="${DSH_HOME:-$HOME/.dsh}"
cd "$DSH_HOME/profiles/web"
mkdir -p node_modules
ln -sfn "$DSH_HOME/plugins/dsh-heartbeat" node_modules/dsh-heartbeat

编辑 $DSH_HOME/profiles/web/package.json，加两行：

{
  "dependencies": {
    "dsh-heartbeat": "link:../../plugins/dsh-heartbeat"
  },
  "dsh": {
    "profile": {
      "bundles": [
        "@deepseek-ai/dsh-base",
        "@deepseek-ai/dsh-web-app",
        "dsh-heartbeat"
      ]
    }
  }
}

3. 配置

在 $DSH_HOME/profiles/web/cordis.patch.yml 末尾追加：

- id: heartbeat
  config:
    enabled: true
    intervalMinutes: 30      # 多久醒一次
    quietFrom: 0             # 安静时段（支持跨零点，23→7 表示 23:00-07:00）
    quietTo: 7
    minGapMinutes: 120       # 两次主动消息最小间隔
    userActiveMinutes: 40    # 主人刚说话后多少分钟内不打扰
    dailyMax: 5              # 每天最多主动发几条
    cwd: "/path/to/your/workspace"
    thinkUrl: "http://127.0.0.1:3002"   # 见下节
    channel:
      kind: onebot
      wsUrl: "ws://127.0.0.1:3001?access_token=你的token"
      targetId: "主人的QQ号"

重启 dsh，然后 设置 → 心跳 就有可视化面板了（改完点保存即时生效，不用重启）。

两种「思考」引擎

A. HTTP 引擎（推荐）

插件把 prompt 发给一个本地 HTTP 服务，由它调用模型并返回纯文本。这样可以把「想」交给一个常驻的 SDK 进程，避免每次冷启动。

如果你装了 dsh-qq，它的 127.0.0.1:3002/think 就是现成的思考接口， thinkUrl 直接指向它即可，不用再单独跑一个桥接进程 —— 两个插件共享同一个常驻 SDK 会话。

没装 dsh-qq 的话，本项目自带一个参考实现 examples/bridge-think-endpoint.mjs： 它就是一个 POST /think 接口，内部复用 dsh --profile sdk 的会话。

# 请求
curl -X POST http://127.0.0.1:3002/think \
  -H 'content-type: application/json' \
  -d '{"prompt":"..."}'

# 响应
{"ok": true, "text": "{\"send\": false, \"reason\": \"凌晨了，别吵他\"}"}

B. 子进程引擎（零依赖）

不配 thinkUrl 时，插件会自己 spawn 一个 dsh --profile sdk，问一句、收答案、关掉。

• 优点：不需要额外服务
• 缺点：每次多 5~10 秒冷启动；同一个 profile 不能被两个 dsh 实例同时占用，否则会卡在启动（建议给它单独的 profile，比如 hb）

    dshBin: "/usr/local/bin/dsh"
    profile: hb          # 基于 sdk 模板初始化的独立 profile

发送渠道

目前内置 OneBot v11 正向 WebSocket（NapCat / LLOneBot / Lagrange 都支持）：

    channel:
      kind: onebot
      wsUrl: "ws://127.0.0.1:3001?access_token=xxx"
      targetId: "123456789"

发送走 send_private_msg。如果要发群消息，改 lib/index.js 里 sendViaOneBot 的 action 即可（欢迎提 PR 做成配置项）。

设置页

挂进 web profile 后，设置里会出现「心跳」页：

• 状态：今天发了几条 / 下次醒来 / 上次说了什么
• 参数：上面那张表里的全部项
• 按钮：保存并生效（写盘 + 重排下一拍）、现在就想一次（绕过安静时段）

保存写入 $DSH_HOME/heartbeat/config.json，优先级高于 profile 配置，重启后保留。

对应的 HTTP 接口（同源，需登录态）：

方法	路径	作用
GET	/api/heartbeat/state	状态 + 生效配置
GET	/api/heartbeat/config	可编辑配置
POST	/api/heartbeat/config	保存并热更新
POST	/api/heartbeat/trigger	手动想一次
POST	/api/heartbeat/reset	清空设置页覆盖值

环境变量

变量	作用
DSH_NO_HEARTBEAT=1	本进程不跑心跳（给桥接等子进程用，避免抢同一个内心会话）
DSH_HEARTBEAT_DEBUG=1	打印子进程 stderr，排查用

状态文件

$DSH_HOME/heartbeat/state.json    # 上次发送时间、今日计数、上次说的话
$DSH_HOME/heartbeat/config.json   # 设置页保存的覆盖值

删掉 config.json 即回到 profile 配置。

已知限制

• 内心会话与真实聊天会话不共享记忆：它记得自己想发过什么，但不知道你在另一个渠道聊了什么
• 子进程引擎在 web 服务里实测容易卡（同 profile 锁），优先用 HTTP 引擎
• 插件被装载两次时会打印 duplicate prefix route（已加幂等保护，正常不会出现）
• 目前只有 OneBot 渠道，且只发私聊

开发

node --check lib/index.js   # 服务端
node --check lib/client.js  # 浏览器端（手写 bundle，只验语法）

浏览器端是手写的 __ModuleLoader__ bundle，不需要构建工具，改完重启 dsh 即可。

License

MIT