Overview
dsh-onebot
README / EN
Package documentation
Registry summary
dsh.pub verifies the pinned bundle contract, runtime facts, and distribution semantics. The complete README remains in the source repository.
Read the full README on GitHubLIMITATIONS
Known limitations
**支持** - 正向 WebSocket(收事件 + 调 API);HTTP API 发送;两者可同时配(ws 收 + http 发) - 事件:`post_type=message` 的群/私聊消息;`message` 字段两种形态(CQ 码串 / 段数组) - 发送段:`text` / `at` / `image` / `record` / `reply` / `face` - API:`send_group_msg`、`send_private_msg`、`get_msg`、`get_group_member_list`、 `get_group_member_info`、`get_group_info`、`get_login_info` - 回声过滤(`message_sent` 与 `user_id == self_id` 两种)、`self_id` 自动识别 - CQ 码转义/反转义、`@数字` → 真 at 段、人话化(`(图)`/`[语音]`/`[卡片]`…) - 引用展开:本地最近 60 条 + `get_msg` 兜底(同一条 5 分钟内只捞一次) - 成员名册(TTL 6 小时,后台刷新,失败不清空旧数据) - 每会话串行队列(队列上限、单条超时、一条消息一条回复) - 断线重连:指数退避 + 抖动 + 日志收敛;连稳 30 秒后才清零退避 - 群/私聊白名单、`requireMention`、`quoteReply`、`format`、`imageLinks` 等开关 **不支持(有意不做,或这一版没做)** - **反向 WebSocket / HTTP 事件上报**:那需要插件自己起一个 HTTP 服务,这一版没做。 如果你的实现只能反向上报,现在接不上(issue 里说一声,这是最值得加的下一块)。 - **图片/语音/视频的内容**:`[CQ:image]` 只变成「(图)」,语音只变成「[语音]」。 想让它真看得见图,给 dsh 配一个能取图的工具,再打开 `imageLinks: true` 把直链写进正文。 - **合并转发聊天记录**(`forward` 段):只有「[合并转发]」占位,没有展开。 - **主动发消息**:插件自己不排程、不定时;但暴露了 `onebot` 服务(见下),别的插件可以用。 - **notice / request 事件**:戳一戳、进退群、加好友请求,只忽略、不处理。 - **流式/分段**:QQ 没有流式,回复是攒完一次发;超长回复也不分段(会被实现按长度上限拒绝,日志有 retcode)。 - **多账号同时接**:一份配置对一个账号。多账号理论上可以插多个实例、各自 `selfId`,但没测过。 - **设置界面**:没有 UI,全在配置里。
