概览
dsh-onebot
README / ZH
插件文档
目录摘要
dsh.pub 核对固定版本的组合包契约、运行时事实与分发语义;完整 README 请查看源仓库。
在 GitHub 阅读完整 READMELIMITATIONS
已知限制
**支持** - 正向 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,全在配置里。
