前言¶
在 DeepSeek Harness（DSH）里做 QQ 伴侣时，常见做法是：人设写得很满，行为仍像「有消息才回」的客服机器人——你不说话就长期潜水，群里一有动静又容易长篇秒回；人设里「在追番、在逛商城」往往止于文字，没有可验证的屏幕与动作。
下面介绍社区插件 dsh-qq-agency（维护者 Law-Of-Cycles），分类为工作流。它在 DSH 会话之上叠加「自主心智节律 + OneBot 11 群聊/私聊 + 通过 ADB 操作专属安卓机」的组合，让伴侣在不打扰主人的前提下有自己的状态演化，并在授权范围内真的看手机、截图分享、按规则办事。协议侧走 OneBot 11 HTTP（README 推荐 NapCat 或 SnowLuma 等协议端）。
这是什么¶
dsh-qq-agency 是 DSH 插件包（package.json 中 dsh.bundle.patch 指向 cordis.patch.yml），当前版本 0.3.0，许可证 MIT，运行环境要求 Node.js >= 20。README 说明其定位为：给 DSH 里的 AI 伙伴一套「内在状态 + 心跳 + 具身小手机」——自主心智节律、群聊分寸决策、主动找主人、通过 ADB 看屏幕、点划、打字、开 App、截图分享与安全委托办事。
插件在架构上把 DSH 仿真会话/大模型与四类能力衔接：Mind（内心心智）、Phone（ADB 具身）、Task（双阶段安全委托）、Client（集成在 DSH 设置中心的 Web 控制台）。
核心功能¶
心智节律与社交分寸（Mind）¶
README 描述心智并非固定 cron，而是由 Energy（精力）、Boredom（无聊）、Longing（想念）、Mood（情绪） 等状态持续演化，并带作息倾向（如凌晨低沉、上午活跃、午后发蔫、深夜思念加权等表述）。
社交侧规则包括：群聊被点名会回应；冷场过久可能偶尔冒泡；他人聊得火热且话题无关时会选择潜水；深夜免打扰时自行玩手机但不打扰主人。克制发言的原因会记入内心流水，可在 Web 控制台查看（Journal）。
安卓具身（Phone + ADB）¶
通过 ADB 连接真机或模拟器（README 写明已在 MuMu 模拟器 12、雷电模拟器、实体安卓机上跑通；支持 USB 与无线调试）。对外暴露给模型的典型能力包括：
phone_ui：基于 uiautomator 读取界面树（文字、可点击属性与坐标）。phone_tap_text：按语义点击界面文字（如「立即购买」「搜索」），无需手算像素。phone_look：截图供视觉理解，并可配合 QQ 侧工具发图或发空间。
README 还提到连接守护与模拟器端口灾备，降低设备掉线后「设备不存在」类失败。
QQ 相关能力在文档片段中出现 qq_send_image（发好友/群图片）、qq_publish_feed（发 QQ 空间说说）等名称；具体触发条件以插件实现与 DSH 工具注册为准。
安全委托办事（Task）¶
README 用「两段式授权」描述购物类场景：
- 先征得主人同意，仅允许浏览搜索，不允许下单。
- 确认具体商品与价格后，主人明确同意才进入订单确认流程。
遇到支付密码或短信验证码界面时，插件锁死并汇报，不输入密码、不保存卡号。主人在任何阶段说「算了」「别买了」「停」等，任务应永久取消。
Web 控制台（Client）¶
集成在 DSH 设置 → 它自己 (dsh-qq-agency)。README 列举：总开关、目标 Session、主人 QQ、群聊勾选、是否允许玩手机、ADB 路径与设备号、主动性/免打扰/预算等滑块，以及手机连接测试、真机体检与心智流水查看。
安装与启用¶
安装插件¶
在 DSH 终端执行（桌面 profile 一般为 desktop，Web 端为 web；也可在插件市场填仓库地址）：
dsh plugin --profile desktop add github:Law-Of-Cycles/dsh-qq-agency
装完后重启一次 DSH。
准备 OneBot 与手机¶
- 启动 OneBot 11 HTTP 服务（README 推荐 NapCat 或 SnowLuma），默认示例为
http://127.0.0.1:3000。 - 准备安卓模拟器（MuMu 12 或雷电）或真机（开发者选项中开启 USB 调试并授权电脑）。
- 若需在手机里输入中文，README 建议可选安装 ADBKeyboard 并设为默认输入法。
验证 ADB（不经过 QQ）¶
在插件仓库目录下（已安装到 DSH 后对应路径）可运行硬件体检：
npm run test:phone
或指定设备（MuMu 12 默认端口示例）：
node tests/phone-check.mjs 127.0.0.1:16384
README 说明通过时会打印设备在线、读状态、截图、读界面树、打开设置并按文字点击、按键与清理等项，并提示「这台机器可以交给她当身体了」。
在 Web 控制台打开¶
进入 DSH 设置 → 它自己 (dsh-qq-agency)，按 README 步骤：
- 打开总开关。
- 选择作为「灵魂大脑」的 Session。
- 填写主人 QQ，勾选常驻群聊。
- 勾选允许玩手机，填写 ADB 路径（默认
adb）与设备号。 - 保存。
典型用法与测试¶
除真机体检外，package.json 的 scripts 还提供：
npm test
README 徽章写明自动化测试 92/92 Passing；npm test 会串联 mind、loop、task、flow、contract 等测试入口。另有 npm run test:app（app-walkthrough.mjs）用于应用层 walkthrough，细节见仓库 tests/。
生活向行为（自主刷 B 站、截屏发私聊、发 QQ 空间说说、拼多多浏览与两段式确认等）在 README「真实生活场景实录」中以截图与对话说明，可作为能力边界参考，复现时需自备 QQ 协议端、ADB 设备与 DSH Session。
适用场景与注意¶
适合谁：已在 DSH 中维护 QQ 伴侣 Session、并愿意单独维护 OneBot 11 协议端与一台「专属于伴侣」的安卓机或模拟器的开发者；希望减少「纯聊天脚本感」，引入状态机驱动的主动性与具身操作。
运行与权限：插件随当前 DSH 进程权限运行，ADB 与 OneBot HTTP 均在本机或你配置的网络范围内生效。安装前应阅读 GitHub 源码 与 MIT 许可证，确认协议端账号、群聊范围与购物委托策略符合你的安全要求。
生态说明：DSH 社区插件目录托管在独立站点（如 SkillHub 插件页），与 DeepSeek / 幻方无官方从属关系；星标与版本以仓库当前信息为准。
结尾¶
dsh-qq-agency 把「会演化的心智 + OneBot QQ 社交 + ADB 小手机」收进一个 DSH 工作流插件：群聊懂分寸、无聊能自己玩手机、截图与空间动态可回传聊天，敏感操作走两段式委托与支付界面硬刹车。若要试用，从官方安装命令加入 profile，再按 README 完成 OneBot、ADB 体检与 Web 控制台配置即可。
