前言¶

在使用 DeepSeek Harness (DSH) 进行开发或自动化任务时，代理（Agent）常需用户介入，例如提问、请求工具调用批准或完成当前回合。如果离开了 DSH 界面，这些关键事件容易被遗漏。dsh-ping 插件通过 Telegram 发送通知，确保你在任何位置都能收到这些提醒，从而不中断工作流。

插件简介¶

dsh-ping 是一个专注于通知功能的 DSH 插件。它不拦截 DSH 的交互，不生成自定义的问题卡片，也不实现回答或批准逻辑。插件仅通过观察 DSH 的事件流，将关键信息推送到 Telegram。该插件由 chintoleung 维护，采用 MIT 许可证，具备零运行时依赖。

核心功能¶

插件目前提供三类核心事件的通知：

1. 提问通知：当代理调用原生 DSH 的 ask_user_question 时触发。
2. 审批通知：当需要批准工具调用时触发。
3. 完成通知：当回合结束（turn end）时触发，默认开启。

插件完全使用 DSH 的原生 GUI 进行交互，不支持在 Telegram 中回答问题或批准操作。

安装与启用¶

安装前请确保环境满足以下要求：
* 已安装 DSH（建议使用 next 频道）。
* Node.js 版本 >= 22。

1. 获取 Telegram 凭据¶

在 Telegram 中通过 @BotFather 创建机器人，并使用 /getUpdates 接口获取你的 chat.id。请妥善保管 botToken。

2. 安装插件¶

在当前使用的 profile（例如 web）下执行安装命令：

dsh plugin --profile web add github:chintoleung/dsh-ping

3. 配置凭证¶

编辑 profile 目录下的 cordis.patch.yml 文件，添加以下配置：

- id: dsh-ping
  config:
    telegram:
      botToken: !!js "process.env.DSH_PING_TG_TOKEN || ''"
      chatId: !!js "process.env.DSH_PING_TG_CHAT || ''"

4. 设置环境变量¶

设置环境变量并确保它们对启动 DSH 的进程可见：

export DSH_PING_TG_TOKEN='your-bot-token'
export DSH_PING_TG_CHAT='your-chat-id'

5. 重启 DSH¶

重启 DSH 服务，检查日志确认插件已加载（例如 [dsh-ping] armed: question/approval/turnEnd）。

兼容性说明¶

插件维护者会监控 DSH 的 next 频道版本，并在新版本发布时运行兼容性检查。截至 2026 年 10 月 17 日，插件已验证与 DSH 0.2.1-rc.2 版本的兼容性。插件本身不进行 npm 依赖检查或更新，仅发送通知。

注意事项¶

• 无入站连接：插件不进行入站轮询，不使用 webhook，也没有管理控制台或运行时状态文件。
• 隐私风险：通知内容（问题摘要、审批详情、会话标题）可能包含敏感信息，请确保发送通道的安全。
• 交互权限：DSH 拥有所有交互权限，插件仅负责通知，不会干扰批准流程。

结语¶

dsh-ping 提供了 DSH 与 Telegram 之间的轻量级连接。你可以通过社区目录查看更多详情，或在 GitHub 上查看源码。