前言¶
在使用 DeepSeek Harness (DSH) 进行开发或自动化任务时，代理（Agent）常需用户介入，例如提问、请求工具调用批准或完成当前回合。如果离开了 DSH 界面，这些关键事件容易被遗漏。dsh-ping 插件通过 Telegram 发送通知，确保你在任何位置都能收到这些提醒，从而不中断工作流。
插件简介¶
dsh-ping 是一个专注于通知功能的 DSH 插件。它不拦截 DSH 的交互，不生成自定义的问题卡片，也不实现回答或批准逻辑。插件仅通过观察 DSH 的事件流，将关键信息推送到 Telegram。该插件由 chintoleung 维护，采用 MIT 许可证，具备零运行时依赖。
核心功能¶
插件目前提供三类核心事件的通知：
- 提问通知：当代理调用原生 DSH 的
ask_user_question时触发。 - 审批通知：当需要批准工具调用时触发。
- 完成通知：当回合结束（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 上查看源码。
