前阵子我在电脑上搭好了 DeepSeek Harness，一个开源的 AI Agent 框架。它能自己调工具、写代码、读写文件，甚至能开子代理并行干活，能力跟网页版 AI 聊天完全不是一个量级。但用着用着发现一个特别现实的问题：这玩意儿只能坐在电脑前用。出门、坐地铁、躺床上，想让它查个东西、跑个脚本，都得先回工位。我就琢磨，能不能把它接到 QQ 上？手机随手发条消息，它就在服务器上把活干了，回来我直接看结果。折腾了一周，还真接上了，今天这篇就是完整记录。

先说为什么选 QQ 而不是微信。微信对个人开发者做机器人基本是关门的，接口不开放，风控还严。QQ 不一样，腾讯开放平台（q.qq.com）对个人开发者很友好，注册个应用就能拿到 AppID 和 AppSecret，机器人类型选「公域」，私聊、群聊、频道 @ 全都支持。整个过程不需要公网服务器做回调，走 WebSocket 长连接就行，个人电脑就能跑，门槛低很多。

我用的插件叫 dsh-im-qq，是 DeepSeek Harness 官方插件体系里的一个接入插件。它的思路是把 QQ 当成一个遥控器：QQ 里发的每条消息，都会变成 Harness 里 agent 的输入；agent 干活时调用的工具、记忆、子代理、文件系统，跟在网页上操作完全一样。换句话说，你在 QQ 里跟机器人聊天，背后是一个完整的 AI Agent 在工作，不是那种一问一答的玩具机器人。

安装过程比想象中简单。环境里装好 DeepSeek Harness 之后，一条命令就搞定：dsh plugin add dsh-im-qq。装完打开设置，找到「QQ 机器人」配置卡片，把 q.qq.com 上拿到的 AppID 和 AppSecret 填进去，点保存，机器人就自动启动了。这里有个细节值得夸：凭据存在本机的凭据库里，不会明文写进配置文件，而且保存后不用重启应用，机器人立刻生效。

配置里有两个默认值我是建议大家看一眼的。一个是工作区路径，默认在 ~/qq-workspace，每个聊天对象一个独立子目录，会话互不干扰；另一个是白名单，默认是放行所有（allowFrom: ['*']），联调阶段图省事可以这样，但正式用之前一定要收紧，只放行自己的 openid。openid 是平台按机器人维度哈希的，没法提前预知，只能从真实收到的消息日志里抄——这个我一开始没搞明白，白名单填了半天填不对。

接上之后的使用体验，说实话有点惊喜。私聊里直接发消息，机器人就回；群聊里 @ 它一下再说话；频道里也一样。agent 干活的过程，QQ 里会收到整理好的回复，不是一堆乱七八糟的工具调用日志。长回复会自动分段，一条发不完就拆几条，不会出现发一半被平台掐掉的情况。

我最满意的是审批按钮这个设计。agent 要执行高危操作（比如跑一条删文件的命令）时，不会闷头就干，而是先在 QQ 里弹三个按钮：✅ 允许一次、⭐ 始终允许、❌ 拒绝。你点一下就决定放不放行。担心误操作的话，点过 ⭐ 之后随时可以发 /revoke 撤销，恢复成每次询问。这个设计对「把 agent 当员工使」的场景太重要了，毕竟谁也不想半夜收到一条消息说「我删了你的整个项目目录」。

斜杠命令也做了几个实用的：/new 开新会话清空上下文，/me 查看当前会话信息，/ping 测试连通，/approve 和 /always 是审批按钮的文字版。每个聊天对象对应一个独立会话，互不串味——群 A 聊的话题，不会带进群 B 的上下文。

接下来是踩坑时间，这几条是我觉得最值得分享的。头号大坑是报错 11255，这是个永久性错误，重试多少次都没用。查了半天才发现两个原因：要么机器人类型选成了「私域」，要么发消息的人不在测试人员名单里。解决方案都在 q.qq.com 的后台：机器人类型改成公域，开发设置里把你的 QQ 号加进测试人员。第二个坑是连不上网关，排查半天发现是代理的锅——Shadowrocket 这类工具的 TUN 模式会把 bots.qq.com 解析成 198.18.x.x 这种 fake-ip，把请求全拦了。在代理规则里放行 bots.qq.com 和 api.sgroup.qq.com 就好。第三个坑是群消息发不出去但私聊正常，基本就是机器人不是公域类型，同上处理。

还有一个细节值得提：QQ 对被动回复有限制，一条入站消息最多被动回复 4 次，超了就只能发主动消息，而主动消息的频控更严。插件里做了预算管理，正常对话基本碰不到这个限制，但如果你拿它做批量推送，一定会撞上 50015014 这个频控错误码，好在插件会自动指数退避重试。

说点实在的。这套东西最大的价值，是把「AI Agent」从电脑桌面上解放出来了。手机不在身边的时候，QQ 就是你指挥 agent 的遥控器；在家用电脑的时候，还能跟网页端无缝衔接，因为会话数据是持久化的，重启之后自动恢复上下文。对想折腾 AI Agent 又不想买服务器的人来说，这是个门槛很低的入门路径——不需要公网、不需要域名、不花一分钱服务器钱，一台能跑 Harness 的电脑就行。

如果你也正在折腾 AI Agent 或者各种 AI 工具，可以来 AI House 排行榜（aibunkhouse.com/rankings/）看看，上面有几百个云端大模型、本地模型和 Agent 工具的真实用户投票排行，选型之前先看看大家实际用下来哪个顺手。项目源码在 GitHub 的 988hj7tczd-oss/dsh-im-qq，npm 包名 dsh-im-qq，国内用户可以用 Gitee 镜像，欢迎围观和提意见。