メインコンテンツへスキップ
O

notifyhub (dsh)

oldtommmy/notifyhub/integrations/dsh

Sends DeepSeek Harness completion notifications to Feishu and optionally continues dsh or Codex desktop conversations from Feishu.

インストール

dsh plugin --profile web add github:oldtommmy/notifyhub

このプラグインはリポジトリの integrations/dsh サブディレクトリにあります。

README

notifyhub

任务完成,飞书知道。离开电脑,接着聊。

Codex · DeepSeek Harness · Claude Code · Command Code

Python Platform License

快速开始 · 配置飞书 · 手机续聊 · 常见问题

notifyhub 把本地 agent 的完成结果发到你的飞书私聊,带上会话名、最近提问和回答。启用实验性续聊后,可以在飞书选中桌面上的 dsh 或 Codex 会话,接着发消息并收到回答。

我想做什么选择运行方式
agent 跑完后收到提醒完成通知安装对应 hook 或 dsh 通知插件
用飞书继续电脑上的 dsh 或 Codex 对话原生续聊 · 实验性统一的 dsh 桌面插件+飞书长连接

dsh 侧只安装一个 dsh-notifyhub 插件。它提供完成通知,并可按需启用 dsh、Codex 或两者的飞书续聊。

一眼看懂

  • 完成通知:状态、会话标题、最近提问、最终回答;Codex 还可显示剩余额度和 Goal 信息。
  • 本地配置界面:填写飞书凭据、查找接收人、测试发送、安装通知集成。
  • 原生续聊:查看历史主会话,点按钮切换,沿用原会话上下文、模型和工作目录。
  • 手机卡片:项目、模型和运行状态一目了然;回答保留 Markdown,附轮次和耗时。
查看本地配置界面

notifyhub 本地配置界面

快速开始:先收到第一条通知

1. 准备环境

准备 Python 3.10+ 和你要接入的 agent;飞书应用可以在打开 GUI 后按下一步创建。项目主要在 macOS 使用;原生续聊建议使用 Python 3.12。

git clone https://github.com/oldtommmy/notifyhub.git
cd notifyhub
python3 --version

下文的命令均在仓库根目录执行。如果系统的 python3 太旧,请换成已安装的 python3.12。

2. 先打开本地 GUI

python3 scripts/notifyhub.py gui

命令会启动本地配置服务并打开浏览器。没有自动打开时,使用终端打印的完整地址(含访问令牌)。配置期间保持该终端运行,按 Ctrl+C 退出。

先打开页面即可,尚未创建飞书应用时不必填写凭据。GUI 用于配置和测试完成通知;续聊的飞书长连接由 dsh 原生插件启动,打开 GUI 本身不会建立长连接。

3. 创建飞书机器人,回到 GUI 填写凭据

到 飞书开发者后台 创建企业自建应用,开启机器人能力。在权限管理中一次导入 bot-config.json 完整权限预设,按后台要求申请权限、配置应用可用范围并发布。

默认按完整 JSON 导入即可,无需逐个搜索权限。精简权限文件留给需要自行控制授权范围的用户。

完整步骤见 飞书机器人配置教程。应用配置完成后,回到已打开的 GUI:

  1. 填写应用的 App ID 和 App Secret。
  2. 接收人默认用 open_id。填完 App ID 和 App Secret,页面会自动查找应用所有者。也可以点击 获取接收人 重试,或填写已核实的接收人。
  3. 保存配置,点击测试发送,确认飞书私聊收到卡片。

配置默认保存在 ~/.config/notifyhub/config.json。App Secret 在本机界面或环境变量中填写,无需发给聊天里的 agent。

使用命令行配置

先在本机设置环境变量 NOTIFYHUB_FEISHU_APP_SECRET,再执行:

# 查找应用所有者的 open_id;此步骤不发送消息
python3 scripts/feishu_probe.py --app-id cli_xxxxxxxx --owner

# App Secret 自动从环境变量读取;配置写入前会备份旧文件
python3 scripts/setup_config.py \
  --app-id cli_xxxxxxxx \
  --receive-id ou_xxxxxxxx \
  --receive-id-type open_id

python3 scripts/notifyhub.py test --channel feishu_app

自动查找失败时,按教程核对接收人和应用信息权限。

4. 接入你使用的 agent

只安装对应的集成:

Agent安装命令安装之后
Codexpython3 scripts/notifyhub.py install-hooks在 /hooks 或桌面 Settings → Hooks 中信任 hook
Claude Codepython3 scripts/notifyhub.py install-hooks --target claude重启宿主并检查 hook
Command Codepython3 scripts/notifyhub.py install-hooks --target commandcode重启宿主并检查 hook
DSH Desktoppython3 scripts/notifyhub.py install-dsh --profile desktop重启 dsh App
dsh webpython3 scripts/notifyhub.py install-dsh --profile web重启 dsh web
python3 scripts/notifyhub.py doctor

让对应 agent 完成一轮任务,确认飞书收到真实任务的完成通知。DSH 的 desktop 和 web 是不同 profile,需要分别安装。

检测不到 dsh CLI?先处理安装,再安装通知插件

先检查 command -v dsh 和 dsh --version。macOS 已安装桌面 App 时,也检查其自带 CLI:

"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" --version

若该命令可用,可在当前终端把对应 bin 目录加入 PATH 后继续安装插件,保留桌面版的 CLI 版本。确实未安装时,检查 Node.js/npm 后安装:

node --version
npm --version
npm view @deepseek-ai/dsh engines --json
npm install -g @deepseek-ai/dsh
dsh --version

Node.js 不存在时,先从 Node.js 官方下载页安装满足 dsh 要求的版本。安装后若 PATH 尚未更新,重新打开终端再验证;不便全局安装时可用 npx @deepseek-ai/dsh --version 验证 npm 启动方式。完整处理流程见 DSH 安装排障。

安装统一的 dsh 插件

在 dsh 插件市场搜索 NotifyHub。也可以从 GitHub Releases 下载 dsh-notifyhub 安装包。要配置续聊,打开 notifyhub GUI 的 飞书续聊 卡片。

  1. 先保存上方的飞书凭据,并按教程导入完整 bot-config.json。
  2. 填写允许使用者的 open_id(多个用逗号分隔)。
  3. 订阅接收消息后,按需勾选“dsh 续聊”或“Codex 续聊”。订阅卡片回调后可开启会话卡片按钮。
  4. 点击 安装并应用续聊。GUI 会准备独立运行目录和 Python 依赖,并配置 desktop profile。若已有市场版统一插件,GUI 会沿用;旧双插件安装可在此迁移。
  5. 当前任务结束后重启 dsh,在飞书发“DSH会话”或“Codex会话”开始使用。

不勾选启用时,会安装插件但保持续聊关闭。GUI 显示安装和配置状态;保存启用设置不代表已在运行,需重启宿主验证。首次安装依赖需要联网。

也可以交给自己的 agent 安装

把仓库的绝对路径交给能读取本地文件的 agent:

请读取 /绝对路径/notifyhub/SKILL.md,帮我安装 notifyhub 的完成通知。
先检查环境,再指导我配置飞书机器人、接收人和对应的 hook / 插件。
App Secret 由我在本机 GUI 或环境变量填写,不要让我贴到聊天里。
最后运行 doctor,告诉我宿主中还需完成哪些操作。

如果使用 Skills 目录,也可以把仓库安装到 ~/.codex/skills/notifyhub 或对应宿主的 Skills 目录。安装路径应保持稳定,因为 hook 会引用 launcher 的绝对路径。

手机续聊:继续同一个 dsh 会话

实验性功能,已包含在 main。 当前原生方案运行在 dsh 桌面宿主内,Mac 需要保持唤醒、联网,dsh App 需要保持运行。

飞书手机消息 → 本机出站长连接 → dsh 原会话 → 飞书结果卡片

沿用该会话的上下文、模型和工作目录,消息与回答写回同一个会话。连接由本机主动建立,无需公网端口或 VPS。

飞书后台:事件与回调要分别设置

导入权限 JSON 后,续聊还需要配置下面两项。 它们位于「事件与回调」页面的两个独立标签页:

标签页订阅方式添加项作用
事件配置使用长连接接收事件接收消息 im.message.receive_v1接收你发给机器人的消息
回调配置使用长连接接收回调卡片回传交互 card.action.trigger处理“继续此会话”等按钮点击

分别保存,按后台提示完成发布或审核。若提示尚未建立连接,先按下方安装说明启动 dsh 原生插件,再返回后台保存。只接收完成通知时,可以跳过这两项。

截图中其他应用已订阅的消息已读、表情回应、会议和纪要事件,无需照搬;notifyhub 当前续聊只需要上表中的消息事件和按钮回调。

配置入口

  1. 在飞书配置教程中完成“续聊”部分:导入完整 bot-config.json、订阅消息事件;需要按钮时再订阅卡片回调。
  2. 在 GUI 的“飞书续聊”卡片安装;手动安装和可靠性说明见 原生续聊安装说明。
  3. 在 bridge.allow_open_ids 中填写经过核实的本人 open_id,再启用续聊。列表为空时拒绝所有人。
  4. 重启 dsh,在飞书发“DSH会话”,选择目标对话,再发送消息。

原生插件的 Python 子进程只负责飞书收发。旧的 bridge start / launchd headless 方案保留供开发排查,使用原生续聊时请停用该旧服务,避免同时消费飞书事件。

飞书命令速查

这些命令发给飞书机器人,不需要在终端执行。只安装完成通知时,机器人只负责发送通知。

第一次使用可发 帮助(也可以发 菜单 或 /help),打开续聊菜单。启用卡片回调后,可以直接点已启用的 DSH 会话、Codex 会话 和 当前会话。会话列表和结果卡片上的 使用帮助 也能打开菜单。

发送什么或点哪里操作
帮助、命令、菜单、help、command、/help 或 /command查看命令和用法,打开常用操作菜单
会话 或 /sessions列出当前 agent 的主会话。只开启一种续聊时,默认使用该 agent;两种都开启时,首次连接默认是 dsh
DSH会话切到 dsh,列出桌面历史会话
Codex会话切到 Codex,列出本地 Codex 会话。需在 GUI 启用 Codex 续聊
继续此会话、回复 2 或发送 /attach 2选择本页第 2 条(按钮直接绑定所在卡片的会话)
下一页 / 上一页翻页,或点击卡片上的分页按钮
状态 或 /status查看当前绑定的会话
直接发送问题在当前选定 agent 的已绑定会话里续聊
切回此会话从回答卡片重新绑定生成该回答的会话

例如,发 Codex会话,选一条会话,再发“请概括刚才的进展”。想回到 dsh 时,发 DSH会话并选择目标。回复序号须在列表发出后 5 分钟内操作;旧按钮失效时重新发送会话列表命令。

当前每个会话允许一条未完成的手机请求。需要权限审批时,仍在桌面 dsh 处理。按钮在 15 分钟后或传输进程重启后失效,发“会话”获取新卡片即可。

完成通知、原会话续写和按钮切换已做过本机真机验证;历史会话恢复与分页已有自动化测试,完整真机验收仍在推进。运行接口核对版本为 dsh 0.2.2-rc.5。

手机续聊 Codex(实验性)

保持 dsh 桌面 App 运行以承载现有飞书长连接,并在 Codex 桌面端打开要继续的本地会话。

  1. 在 notifyhub GUI 打开 飞书续聊 卡片,勾选 Codex 续聊。也可按需勾选 dsh 续聊。应用设置后重启 dsh。
  2. 与机器人私聊,发 Codex会话,点选或回复序号绑定本地会话。
  3. 直接发送文字。机器人确认入队后,由 Codex 原会话处理。审批仍在 Codex 界面完成。
  4. 发 DSH会话 可切回 dsh。

首版通过 Codex 的实验性 App Server 队列协议提交输入,按消息 ID 匹配原轮次,并在 Codex 写入完成时间后回传结果。需要本机 CLI 支持队列及轮次读取接口;已核对的 CLI 版本为 0.155.1。每个会话允许一条未完成的手机请求。重启桥接后,请重新选择 Codex 入口,并在 Codex 中查看重启前仍在运行的请求。若同时安装了普通 Codex 完成通知 hook,可能收到原有的完成通知和续聊结果各一条。

相关接口见 OpenAI CLI 参考和 Codex App Server。

常见问题

现象先检查什么
测试卡片发不出去机器人能力、应用身份发消息权限、应用发布状态、接收人
自动获取接收人失败应用信息权限;也可以手动填写核实过的 open_id
通知正常,发消息却没回复原生插件是否启用;消息读取权限和 im.message.receive_v1 是否配置
按钮无响应回调配置中是否添加 card.action.trigger 并使用长连接
重启后旧按钮失效发“会话”获取新卡片
飞书有消息,dsh 没执行是否有未完成请求或桌面审批等待;检查原会话状态

开发分支的通知网关带有发件箱,可用 python3 scripts/notifyhub.py flush --status 查看积压。原生续聊的结果发送使用独立记录,发送结果不明确时不会盲目重发。具体重试行为以所安装版本为准,详见排障文档。

文档与开发

文档内容
飞书机器人配置从创建应用到权限、订阅和测试
配置参考配置项和通知渠道
DSH 通知集成desktop / web profile 与插件安装
原生续聊安装、接口、可靠性边界与验收
排障凭据、网络、hook 与通知问题
Agent 安装指引完成通知的 agent 辅助安装流程
变更记录 · 交接记录开发历史和已知问题
# 在所需 Python 版本和 Node.js 可用的环境中运行
sh scripts/selftest.sh

本地运行会读取 agent 的会话数据并发送所选内容到飞书;配置文件和会话备份留在本机。续聊沿用原会话的执行权限,请仅将自己的飞书身份加入允许列表。

作者 · oldtommmy

协作者 · OpenAI Codex

MIT License · 查看许可证

関連プラグイン