dsh-qqbot-dafeiyu
适用于 DeepSeek Harness (dsh) 的 QQ Bot (QQ 机器人) 即时消息频道插件：支持按用户会话、群组 @提及和关键词触发、图像生成、TTS 语音回复以及附件处理。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:cheesewoo/dsh-qqbot-dafeiyu#c601c1c76f136591c1d06a0d1684b91e138bd4b5Qqbot Dafeiyu 以 dsh-qqbot-dafeiyu 发布，当前版本为 0.6.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
基于 deepseek-harness (dsh) 的 QQ Bot IM 插件，将 QQ 消息平台作为 dsh agent 的前端协议驱动。
中文 | English
QQ 用户 → QQ WebSocket → dsh-im-qqbot → ctx.agents → dsh agent loop → LLM
↑ │
└── session/event ──────────┘
(assistant reply → QQ sendMarkdown)
# 安装到 profile
dsh plugin --profile qqbot add dsh-qqbot-dafeiyu
# 启动
dsh --profile qqbot
首次启动时，插件检测到凭据未配置会自动进入扫码引导：终端输出二维码 → 手机 QQ 扫码绑定 → 凭据自动保存到 profile，后续启动无需再次扫码。
# 构建
cd /path/to/dsh-qqbot
pnpm install && pnpm build
# 安装到 profile（本地路径）
dsh plugin --profile qqbot add /path/to/dsh-qqbot
# 启动
export QQBOT_APPID="你的AppID" QQBOT_SECRET="你的AppSecret"
dsh --profile qqbot
cd /path/to/deepseek-harness
export QQBOT_APPID="你的AppID" QQBOT_SECRET="你的AppSecret"
pnpm dsh web --patch /path/to/dsh-qqbot/cordis.dev.yml
| 配置 | 类型 | 默认值 | 说明 |
|---|---|---|---|
appId | string | 必填 | QQ Bot AppID（或通过 QQBOT_APPID 环境变量） |
appSecret | string | 必填 | QQ Bot AppSecret（或通过 QQBOT_SECRET 环境变量） |
provider | string | deepseek-official | LLM 提供商名称 |
model | string | deepseek-chat | 模型名称 |
preset | string | - | Agent preset id |
cwd | string | process.cwd() | Agent 工作目录 |
requireMention | boolean | true | 群聊是否需要 @bot 才触发 |
groupPrompt | string | - | 群聊额外 system prompt |
directPrompt | string | - | 私聊额外 system prompt |
textChunkLimit | number | 4500 | 单条消息最大字符数 |
sessionIdleTimeout | number | 1800000 | 会话闲置超时(ms)，默认 30 分钟 |
debug | boolean | false | 调试模式 |
| 命令 | 说明 |
|---|---|
/bot-reset | 重置当前会话（清除上下文） |
/bot-model | 查看或切换模型 |
/bot-status | 查看当前会话状态 |
/bot-help | 查看所有指令 |
src/
├── index.ts # Cordis 插件入口（async apply）
├── config.ts # 配置 Schema
├── types.ts # 全局类型定义
├── setup.ts # 凭据绑定（扫码）
├── transport/ # 传输层
│ ├── inbound.ts # QQ 入站消息 → agent.followup()
│ ├── outbound.ts # session/event → QQ sendMarkdown
│ ├── outbound-buffer.ts # 流式缓冲
│ └── chunker.ts # Markdown 文本切分
├── session/ # 会话管理层
│ ├── session-manager.ts # QQ peer → Agent 映射
│ └── idle-evictor.ts # 闲置回收
├── model/ # 模型路由层
│ ├── model-resolver.ts # 路由解析
│ ├── prefs-store.ts # per-peer 偏好持久化
│ └── settings-reader.ts # settings.yaml 只读
├── shared/ # 共享工具
│ ├── utils.ts # 通用函数
│ ├── scope.ts # scope/peer 提取
│ └── send-helper.ts # 分块发送
├── commands/ # 斜杠命令
└── typings/ # 外部模块声明
sessionKey: qqbot:${appId}:${scope}:${peerId}，由 SHA-256 确定性派生 SessionId，重启后可恢复。
解析策略：进程内复用 → 持久化恢复 → 全新创建。
inject = ['agents']，不直接耦合其他插件agent-presets 服务挂载预设（工具集、prompt 等）# 安装依赖
pnpm install
# 构建
pnpm build
# 开发模式（watch）
pnpm dev
# 用 --patch 方式调试（在 dsh monorepo 中）
cd /path/to/deepseek-harness
export QQBOT_APPID="xxx" QQBOT_SECRET="xxx"
pnpm dsh web --patch /path/to/dsh-qqbot/cordis.dev.yml