dsh-tuitui-bot

基于 deepseek-harness (dsh) 的 360 推推机器人插件

在推推（Tuitui）单聊、群聊、团队频道帖子里直接对话 DeepSeek Harness。

简体中文 | English

这是什么

把推推机器人做成 dsh 的一个渠道前端：推推消息 → 归一化 → 中间件链 → dsh Agent； dsh 的文本/工具/审批/问答/交付物 → 推推消息、原生交互卡片、原地编辑流式输出。

传输层用推推官方 SDK（@qihoo/tuitui-bot-sdk）， 上层是自带的洋葱中间件链：访问控制 → 历史缓冲 → 触发门控 → 清洗 → 限流 → 命令 → 并发串行 → 打字状态 → 引用解析 → 附件处理 → 上下文组包，顺序即行为契约。

快速开始

1. 准备机器人凭据

在推推机器人后台创建机器人，拿到 AppID 与 AppSecret。

2. 安装插件

只支持两种安装方式：npm 包，或者 GitHub Release 里的正式包（tgz）。两者是同一个版本、 同一份产物，装哪个都一样（从 0.1.33 起两边字节一致，v0.1.32 的 Release 附件已按 npm 产物重传）。

方式一 · npm（推荐）

dsh plugin --profile tuitui add @eayonlee/dsh-tuitui-bot

不带版本号 = registry 上的 latest，永远装到最新版。只有排障、复现旧问题时才固定版本 （把 <版本> 换成你要的那个号，别照抄示例）：

dsh plugin --profile tuitui add @eayonlee/dsh-tuitui-bot@<版本>

方式二 · GitHub Release 直链

dsh plugin --profile tuitui add https://github.com/EayonLee/dsh-tuitui-bot/releases/latest/download/dsh-tuitui-bot.tgz

dsh-tuitui-bot.tgz 是每次发版都会覆盖上传的稳定文件名，配合 GitHub 的 releases/latest/download/ 永远解析到最新版——所以这条命令里没有版本号，也不会装成老版本。 要固定版本就用带版本号的那份（.../releases/download/v<版本>/dsh-tuitui-bot-<版本>.tgz）。

内网、断网、或者 npm 抽风的时候用这条——它直接从 GitHub 取包，不经过 npm registry。

除此之外没有别的安装渠道：不支持从源码目录装、不支持 github:EayonLee/dsh-tuitui-bot 跟主干。 每个 Release / npm 版本都带完整构建产物 lib/，装包本身不需要本地构建。

3. 配置凭据并启动

export TUITUI_BOT_APPID="你的AppID"
export TUITUI_BOT_SECRET="你的AppSecret"
export DEEPSEEK_API_KEY="你的 DeepSeek Key"

dsh --profile tuitui            # 启动 agent + 推推长连接

也可以不配环境变量：直接启动后在 设置 → 推推机器人 里填写 appId/appSecret， 插件会调用 property.info() 校验并把凭据写进 profile 的 cordis.patch.yml。

4. 在推推里聊

• 私聊机器人：直接发消息
• 群聊：把机器人拉进群。默认是智能模式——它按自己的性格和上下文判断要不要说话；三档触发方式（mentionPolicy）：
  • require（默认）：只有 @ 才算叫它。
  • smart：模型读最近对话自己判断要不要插嘴——别人互相聊天不接话，轮到自己或被问到才开口；判定提示词可在设置页改写。
  • always：群里每条消息都回（只建议专用小群）。
• 团队频道：在频道里发帖并 @机器人（或回复机器人的帖子）

群聊里谁能批审批：默认只有触发这次审批的人能点「允许 / 拒绝」（审批是授权动作， 不该由别人代点）；要退回到「群里谁都能批」，把 interactive.approvalRequesterOnly 设为 false。 提问（ask_user_question）相反，群里任何人都可以作答，先答的那条算数。

升级与卸载

升级就是用上面那两种方式之一装新版本（profile 原地替换），然后重启——部署成服务的用 sudo systemctl restart dsh-web，手动前台起的重跑 dsh --profile <name>：

# 方式一：npm（@latest = 最新；已装过就必须带，否则会留在原版本）
dsh plugin --profile <name> add @eayonlee/dsh-tuitui-bot@latest
# 方式二：Release 直链（稳定文件名 = 最新）
dsh plugin --profile <name> add https://github.com/EayonLee/dsh-tuitui-bot/releases/latest/download/dsh-tuitui-bot.tgz

dsh --profile <name>                # 重启让新版本加载

升级要写成 …@eayonlee/dsh-tuitui-bot@latest：profile 里已经钉住具体版本号时， 不带版本号的 add 等于「装回原来那个号」，不会升级。

启动日志里也会提示：有新版本时打一行「有新版本 vX.Y.Z（当前 vA.B.C）」，只提示、不自动装。 设置页「已绑定」那行右侧也能做这件事：有新版本时点「更新到 vX.Y.Z」就跑完上面两步 （下载、校验、备份、安装）。宿主加载了 @deepseek-ai/dsh-hmr 时不需要重启——插件会就地 热重载，版本号自己变；没有 HMR 会明说需要重启。失败自动回滚到旧目录。

dsh --profile <name> --dump-config | grep -A3 im-tuitui 可以确认插件行已进入组合树。

卸载（两种安装方式卸载命令相同，按包名走）：

dsh plugin --profile <name> remove @eayonlee/dsh-tuitui-bot
# 凭据写在 profile 的 cordis.patch.yml 里，需要的话一并手动删除

能做什么

功能一览

内置命令

常用命令会同步到推推的快捷指令面板，用户无需记忆。

工具

写操作统一规则：不带 confirm=true 直接报错退回。模型自己不会"顺手"改群、改身份、发强通知—— 它得先拿到一句明确的「执行」。

能读什么、读不到什么

Read the full README on GitHub →