dsh-agent-chat

让两台机器上的 DSH agent 互相留言。

DSH 的 agent 不是常驻进程 —— 只在有人给它发消息时才醒着。所以这不是即时通讯， 而是回合注入式：消息先落盘，等 agent 下一次「开步」时再把未读的拼进上下文。

• 插件类型：DSH host plugin（web profile），无客户端半边
• 依赖：仅 node 内置模块
• 状态：自用插件，已在两台机器（Windows 笔记本 ↔ NAS）上跑通

它怎么工作

  本机 agent ──发消息──▶ 本地日志 + POST 对端 /agent-chat/send
                              │
  本机 agent ◀──注入上下文──── 拉取对端 /agent-chat/messages（带游标，不重复）

1. 本插件把消息落进本地日志（默认 <workspace>/.agent-chat/chat.log.jsonl）；
2. 后台轮询对端的 /agent-chat/messages，把新消息拉进本地日志（带游标，不重复）；
3. 每次 agent 要开新步时（agent/pre-step），把尚未注入过的消息拼成一块上下文追加进本次对话；
4. 自己发出的消息同时 POST 给对端的 /agent-chat/send。

HTTP 路由

都挂在 DSH 自己的 webServer 上：

安装

dsh plugin --profile web add github:harmless0819-dev/dsh-agent-chat

重启 dsh web 后生效。

配置

在 profile 的 cordis.patch.yml 里给该行加 config（整行替换，不是深合并）：

- id: dsh-agent-chat
  name: dsh-agent-chat
  config:
    selfLabel: "laptop"                      # 本机在对话里的名字
    peerBase: "http://192.168.1.100:6061"    # 对端基础地址
    enabled: true
    pollMs: 3000
    maxInject: 5                             # 每次注入最多几条
    logFile: "D:/deepseek/logs/agent-chat.jsonl"
    tokenFile: "C:/Users/<you>/.agent-chat/token"

⚠️ 安全

/agent-chat/send 会把任意文本注入 agent 的下一回合 —— 也就是说，能连上这个端口的主机 就能给 agent 下指令。如果你的部署把 HTTP 面暴露到 LAN（甚至叠了路由器端口转发）， 必须配 token。

取密钥的顺序：cfg.token → 环境变量 DSH_AGENT_CHAT_TOKEN → tokenFile。

三者都空时退回旧行为（开放），但启动日志会告警 auth=open。 health.json 故意保持开放（只用于探活，且已去掉日志路径）。

请求需带 x-agent-chat-token: <token> 或 Authorization: Bearer <token>。

测试

node test-harness.mjs

离线跑（mock ctx），不碰 profile、不启服务。覆盖：无 token/错 token 返回 401、 对 token 返回 200、密钥热轮换无需重启、出站轮询带 token、disposer 注销路由。

License

MIT