可插拔通知服务 ddtcorex/dsh-maestro-notifier

@ddtcorex/dsh-maestro-notifier

可插拔的通知服务，用于 DeepSeek Harness：一个极小的内存内服务商注册表，Telegram 作为第一个传输通道。投递永不抛错——调用方无需处理错误即可通知；未知服务商和缺失目标都会解析为 { sent: false, reason }。

属于 Maestro Harness 套件（dsh-maestro-*）。Cordis 补丁行 id：maestro-notifier （cordis.patch.yml）。它有一个宿主半边（服务、Telegram 服务商、设置 RPC）和一个客户端半边（一个设置标签页）。

它提供什么

- maestroNotifier 服务：register(provider)、ids()、
send(providerId, target?, message)，分发到已注册的服务商。
- Telegram 服务商（单向机器人消息；protect_content，不显示链接预览，10 秒超时；凭据绝不写入日志）。
- 只负责传输——消息文案属于消费方插件；本包从不撰写领域文本。消费方以结构化方式依赖它（本地类型增强），绝不在编译期依赖。
- 默认目标解析：调用方省略目标时，可选的 resolveTarget 钩子会从共享设置存储（~/.dsh/dsh-maestro-config/settings.json）读取
domains.notifier.telegram.{botToken,chatId}，经由本包内嵌在
src/host/vendor/store.ts 的存储。显式目标优先；解析器任何失败都降级为 { sent: false, reason: 'not-configured' }。

const notifier = ctx.get('maestroNotifier')
await notifier.send('telegram', undefined, { text: 'review finished' }) // target resolved from the store

- 设置 RPC 和标签页：本包拥有 notifier 设置域（自己的校验器在 src/host/validators.ts），并在 /dsh-maestro-notifier 上提供 getConfig / saveConfig。机器人 token 只写：宿主只回答 hasBotToken，绝不返回值。设置标签页（settings.section id maestro-notifier，order 33）用于编辑 Telegram 目标和审查通知开关。

环境要求

- Node.js ^22.19.0 || >=24.0.0 和 pnpm 11+。默认使用 Node 20 的 shell 会失败并报
No such built-in module: node:sqlite；运行 dsh 或 pnpm 前，先把 Node 22 的 bin 放到 PATH 最前面。
- DSH 0.1.x 或 0.2.x（peer 范围 <0.3.0-0）。

安装

dsh plugin --profile web add @ddtcorex/dsh-maestro-notifier

本包自带 cordis.patch.yml，会自动应用。其中包含一个 connection 条目，声明了 webServer，DSH 0.2.x 需要它，rpc.handle 才能注册通道。不要把它复制进配置档补丁，也不要手动添加这些行（重复 id 会让加载器崩溃）。安装后重启 dsh web。

想要精确的发布版本，而不是包管理器解析出的版本，就固定版本： dsh plugin --profile web add @ddtcorex/dsh-maestro-notifier@<version>。

从检出目录用 link: 安装？每次 git pull 之后，运行 pnpm install && pnpm build
（lib/ 已加入 gitignore），然后重启 dsh web。

开发

pnpm install
pnpm verify # tsc --noEmit (host + client)
pnpm test # vitest run
pnpm build # tsc host + client, then the client bundle -> lib/

许可证

MIT