emiliagarfield6-bot/dsh-telegram-notify

README 摘要

dsh-telegram-notify DeepSeek Harness（DSH）的 Telegram 通知插件。当 agent 任务完成 、 向你提问 、 请求审批 或 长期目标完成/被阻塞 时，自动给你的 Telegram 发消息。 触发时机 事件 消息 开关（默认） agent 从运行回到空闲 ✅ 任务完成（内容取决于通知模式，见下） notifyOnIdle （开） agent 调用 ask user question 🔔 需要你的回答（附问题内容） notifyOnQuestion （开） agent 请求工具审批 🛡️ 请求审批（附工具名和原因） notifyOnApproval （开） 长期目标完成 / 被阻塞 🏁 / ⛔（附目标与原因） notifyOnGoal （开） agent 运行出错 ⚠️ 错误摘要 notifyOnError （关） 「任务完成」做了两项降噪：连续运行不足 minRunSeconds （默认 30 秒）不通知； 回到空闲后去抖 8 秒（goal 自动续轮、追问等不会重复发）。只有根会话会通知， 子 agent（subagent）结束不会打扰你。 通知模式 - 简洁模式 （ mode: "simple" ，默认）：只通知任务结果——✅ 任务完成 + 会话 + 等待输入。 - 复杂模式 （ mode: "complex" ）：在结果之上附带 任务用时 、 token 消耗 （输入/输出）与 缓存命中率 （按最后一轮各 step 的 provider 用量汇总）。 - 产出内容 （ sendTaskContent ，默认关）：仅复杂模式下有效。开启后把本轮的 最终产出内容 作为单独一条消息一并发送（超长自动截断到 Telegram 上限内）。 安装 本插件遵循 DSH 的插件包契约： package.json 声明 dsh.bundle.patch 指向自带的 bundle 层 cordis.patch.yml ，通过 dsh plugin 安装后自动挂载，无需手工编辑 profile 的补丁文件。 dsh plugin 会把包交给 pnpm 装进 profile，并自动把声明了 dsh.bundle 的包追加到 profile package.json 的 dsh.profile.bundles 层列表——之后每次启动，bundle 层的 insert 行负责挂载插件，你的 profile cordis.patch.yml 只需放个人配置覆盖。 开发提示： file: 依赖是安装时打包复制的，改了源码要重新 dsh plugin add 才会生效； 想在源码目录里边改边用，可以用 dsh plugin --profile web add link: （符号链接）。 卸载： dsh plugin --profile …

分类