dsh-im-bubble
English · 中文
English
Split one reply into several IM bubbles.
@xmanrui/dsh-im sends the final answer as one message, and only splits it when
it exceeds 1,800 characters. There is no way for the model to say "this sentence
belongs in its own bubble". This plugin adds that: it registers a tool that sends a
piece of text immediately through dsh-im's public proactive-delivery service
(ctx.dshIm.send), so each call lands as a separate message before the final reply.
It does not replace or patch dsh-im. It only calls the documented delivery
contract, so upgrading dsh-im does not break it.
Tools
| Tool | What it does |
|---|
im_say | Send one piece of text as its own message right now. Optional botId / targetId / format (plain, markdown). |
im_targets | Read-only list of connected bots and their delivery targets. Use it when im_say reports an unknown or ambiguous target. |
im_target_add | Create a delivery target (so im_say knows who to send to) without clicking through the settings UI. |
im_say resolves the target in this order: the arguments you pass → the plugin
config (botId / targetId) → the only target that exists. With zero targets it
tells you to create one; with several it lists them and asks you to pick.
Requirements
@xmanrui/dsh-im (or a compatible fork) installed and at least one bot connected.- One delivery target for that bot, created either in Settings → IM bots → ⚙ → New
target, or with
im_target_add.
Install
dsh plugin add dsh-im-bubble
From source:
dsh plugin add git+https://github.com/nolighter/dsh-im-bubble.git
Or copy the folder into <dsh profile>/node_modules/dsh-im-bubble and append to
cordis.patch.yml:
- insert:
- id: dsh-im-bubble
name: dsh-im-bubble
Config
Optional, set through the plugin config in the DSH settings (or in the patch entry):
- insert:
- id: dsh-im-bubble
name: dsh-im-bubble
config:
botId: wx_xxxxxxxxxxxxxxxx
targetId: tgt_xxxxxxxxxxxxxxxx
Notes
- The channel still sends the final answer itself.
im_say is for the extra
bubbles; using it for the whole answer duplicates the text.
- A target id is stable and cannot be edited after creation. Delete and recreate if
the route is wrong.
im_target_add accepts the route as JSON. For WeChat the shape is
{"toUserId":"..."} with kind: "user"; other channels differ per dsh-im's own
validation.
License
MIT
中文
把一条回复拆成好几个气泡发出去。
@xmanrui/dsh-im 的最终回复只会作为一条消息发出，而且只有超过 1800 字才会
按换行切段。模型没法主动说「这一句单独发」。这个插件补上这一块：它注册的工具
直接调用 dsh-im 公开的主动投递服务 ctx.dshIm.send，每调一次就是一条独立消息。
它不替换也不修改 dsh-im，只调用已公开的投递契约，所以 dsh-im 升级不会冲突。
工具
| 工具 | 作用 |
|---|
im_say | 立刻把一段文本作为独立消息发出。可选 botId / targetId / format（plain、markdown）。 |
im_targets | 只读列出已连接的机器人和它们的投递目标。im_say 说找不到或目标不唯一时用它确认。 |
im_target_add | 新建一个投递目标（告诉 im_say 发给谁），不用去设置界面点。 |
im_say 找目标顺序：参数 → 插件配置（botId / targetId）→ 当前唯一的目标。
一个目标都没有时会提示去建；有多个时会列出来让你选。
依赖
- 已安装
@xmanrui/dsh-im（或兼容分支），并至少连接了一个机器人。
- 该机器人下有一个投递目标：在 设置 → IM机器人 → ⚙ → 新建目标 建，或者用
im_target_add 建。
安装
dsh plugin add dsh-im-bubble
从源码装：
dsh plugin add git+https://github.com/nolighter/dsh-im-bubble.git
或者把目录复制到 <dsh profile>/node_modules/dsh-im-bubble，再在
cordis.patch.yml 末尾追加：
- insert:
- id: dsh-im-bubble
name: dsh-im-bubble
配置
可选，写在插件配置或 patch 条目里：
- insert:
- id: dsh-im-bubble
name: dsh-im-bubble
config:
botId: wx_xxxxxxxxxxxxxxxx
targetId: tgt_xxxxxxxxxxxxxxxx
注意
- 最终答复仍由通道自己发送。
im_say 只负责多出来的那些气泡；用它发整段答复会重复。
- 目标 id 建好之后不能改。路线填错了就删掉重建。
im_target_add 的 route 是 JSON 字符串。微信的形状是 {"toUserId":"..."} 配
kind: "user"；其他渠道按 dsh-im 自己的校验来。
许可
MIT
