dsh-qq-channel

日常使用

会话和工作方向

• 白名单只决定谁能发起任务，不会提前建立会话。
• 联系人第一次发送普通消息时，插件才在“QQ 渠道”工作区创建对话。
• 同一联系人之后的普通消息持续使用这一对话。
• 当前任务仍在运行时，新消息通过 dsh 的 steer 能力补充到当前任务。
• 发送 /新任务 后只是解除映射；下一条普通消息才新建对话。
• 旧会话和文件不会被 /新任务 删除，仍可从 dsh WebUI 查看。

当前版本没有“通过 QQ 指定并恢复任意旧会话”的指令。需要查看旧对话时请使用 dsh WebUI。

文件、图片与 QQ 表情

• 收到的普通文件保存在该联系人的 .qq-inbox 范围内，模型可按权限读取和处理。
• 图片会作为 dsh 原生图片附件交给视觉模型，而不是只把本地路径写进提示词。
• Agent 可调用 qq_send_file、qq_send_image、qq_send_face、qq_send_mface 回传真实内容。
• OneBot face 会保留表情编号，并尽量从 QQ NT 本地缓存解析图片。
• mface / marketface 会保留商城表情的 ID、包 ID、key 和摘要；只有拿到图片时才交给视觉模型。
• 当前图片回传支持 PNG、JPEG、WebP 和 GIF；单张图片默认不超过 20 MiB，普通附件默认不超过 50 MiB。

默认语气与自定义模板

默认 stylePromptFile 为空，因此插件不会自动模仿任何联系人。回复语气来自实际选中的 dsh Agent 预设，通常以直接完成任务、清楚汇报结果为主。

启用自定义语气时，把 contact-style.example.md 复制到：

~/.dsh/qq-channel/contact-style.md

修改复制后的文件，再把它的绝对路径写入 config.json 的 stylePromptFile。模板适合填写称呼、长短、语气词、标点习惯、汇报方式和对话示例。详细步骤见完整安装教程的语气章节。

Agent 预设与可选路由插件

默认候选顺序是：

router-auto → router-standard → standard → minimal

router-auto 是 Agent 预设名称，不是模型名称。dsh-routing-suite 是独立、可选且推荐的开源预设套件，可提供 router-standard 等路由预设；本仓库没有复制或捆绑它。即使没有安装，插件也会回退到 dsh 自带的 standard 或 minimal，QQ 渠道仍可工作。