shaobeichen/dsh-im-bridge--packages-im1

dsh-im

统一 IM 桥核心:让 DeepSeek Harness 通过 IM 可指挥、可通知、可审批(会话映射 / 命令 / 通知总线 / 审批流 / MockChannel)。

AI 分析

核心用途是让 DeepSeek Harness 支持通过 IM 进行指挥、通知和审批。适合需要将 DSH 接入即时通讯软件并进行会话映射与审批流管理的用户,依赖 agents 服务。

パッケージ
dsh-im
バージョン
0.1.0-rc.1
ライセンス
MIT
最終更新
2026/08/15

インストール

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:shaobeichen/dsh-im-bridge#9e5f1f6118c747193a639f78aa5ee1cf1c4105a1&path:packages/im

ドキュメント

README 全文を読む ↗

dsh-im(核心)

统一 IM 桥核心插件:ctx.im 服务、会话映射、命令、渲染、通知总线、审批管理、MockChannel。

  • 依赖:inject: ['agents'](需要 dsh-agent/dsh-agent-loop)、可选 approvaldsh-user-approval,缺省 ask→deny)
  • 配置:见 docs/example-cordis.patch.ymldocs/install.md
  • 测试:npm run test:im(44 个:单测 + 真实 agent-loop 全链路 e2e,无网络/无 key)

扩展点(§8.3)

// 第三方渠道:实现 send() 契约后注册即可
ctx.im.registerChannel({
  platform: 'my-im',
  send: async (out) => { /* 发消息 */ },
  sendFile: async (chatId, name, text, mime) => { /* 发文件 */ },
});
// 入站:构造 ImMessage 后交给核心
ctx.im.dispatchInbound({ platform: 'my-im', chatId, userId, text, msgId, chatType });
// 按钮回调:data 载荷约定 approve::yes|no / trust:
: / retry:
ctx.im.handleCallback({ platform, chatId, userId, userName, data });

事件(其他插件可复用):im/messageim/commandim/dispatchim/approval

审批接线(FR-6)

  • tools/pre-execute 风险门:仅拦截 IM 会话的工具调用(不双弹窗,§10),风险规则见 lib/risk.js
  • approval/request answerer:把官方审批缝路由到 IM 卡片;超时 → pending(可恢复拒绝 FR-6.4)
  • 文本降级:/approve yes|no;首个响应者生效(FR-6.5);approvals.log 审计(FR-6.7)