dsh-tuitui-bot

基于 [deepseek-harness](https://github.com/deepseek-ai/deepseek-harness) (dsh) 的 360 推推机器人插件

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

简体中文 | [English](./README_EN.md)

---

这是什么

把推推机器人做成 dsh 的一个渠道前端：推推消息 → 归一化 → 中间件链 → dsh Agent；

dsh 的文本/工具/审批/问答/交付物 → 推推消息、原生交互卡片、原地编辑流式输出。

传输层用推推官方 SDK（[@qihoo/tuitui-bot-sdk](https://www.npmjs.com/package/@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 ：

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

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