pinganbbOvO/ai-companion-kit
AI 工程给 QQ 聊天机器人加持久记忆、拟人回复和安卓手机控制能力的一套独立可拆包工具。
项目介绍
AI Companion Kit 是一组可以分开使用、也能拼在一起的 Node.js 包,目的是补上聊天助手的两块短板:记不住人,以及碰不到设备。
companion:基于 OneBot v11 的 QQ 机器人层。记忆按人存储而不是按会话;模拟真人打字(延迟、分条、深夜变慢);按 @、称呼、拍一拍、关键词和概率决定是否开口;加载角色卡;另外维护一本只保留最近几条的日记。phone-mcp:通过 adb 控制安卓设备的 MCP 服务器,提供点击、滑动、中文输入、截图、录屏和动作连招,README 称共 34 个 MCP 工具。qzone/qzone-mcp:让机器人发 QQ 空间说说、看动态、点赞和评论,写操作带限流。own-life:可选的定时静默唤醒,每 2.5 小时向上下文投一条提示,让机器人自己决定发说说或写日记。
快速使用
前置条件是 Node.js 18+;要让机器人上 QQ,还需要一个 OneBot 实现,README 推荐 SnowLuma,并说明安装脚本不会替你装网关。
Windows 上不想碰命令行,下载仓库后运行 tools/安装.bat:检查 Node(缺失时下载便携版)、安装依赖、生成 config.json,最后打开记事本让你填自己的 QQ 号、机器人 QQ 号和网关令牌。
手动跑 companion:
cd packages/companion
cp config.example.json config.json # 填 API key 和你的 QQ 号
cp role.example.md role.md # 写角色卡
npm run check # 角色卡体检
node examples/demo.js # 离线 demo,不需要 key
npm run dry # 生成但不发送
npm start # 真跑,需要 OneBot 网关
npm start 最容易卡住,因为它依赖外部网关;完整教程 第三章专门讲这一步。
只想要手机控制:
cd packages/phone-mcp
npm install
node src/phone-mcp.js --selftest # 自动探测 adb 和设备
然后在 MCP 客户端里注册:
{ "mcpServers": { "phone": { "command": "npx", "args": ["-y", "phone-mcp"] } } }
QQ 空间功能在仓库根目录三步开通:npm install、npm run qzone:test 做令牌与连通性自检、npm run qzone 探测网关并把发布指引写进角色卡(加 --dry 只看不改)。
使用约束
README 给出的实际限制:
phone-mcp把真手机的完整操作权交给模型。不要接在装有支付、银行 App 的主力机上,建议用模拟器或备用机。companion把对话存在本地data/目录,除发给模型的请求内容外不出本机。- QQ 自动化受腾讯风控影响,频率过高会被限速甚至封号;作者以每分钟 20 条发送一天后被限速为例,内置的 QQ 空间发布和评论限额应保留,评论发出后无法撤回。
- QQ 空间发图只能来自白名单目录(
QZONE_IMAGE_DIRS),目录外的绝对路径会被拒绝;没有删除和拉黑功能。
数据以纯文本保存:JSON 记忆、JSONL 对话流,以及每天一份 Markdown 日记。许可证为 MIT。
HotRepo 点评
HotRepo 数据中没有该项目的 GitHub 日榜名次、快照记录或 Hacker News 讨论,因此没有可报告的热度趋势或排名结论。材料能支撑的观察是分层设计取向:各包可单独使用,companion 只依赖 OpenAI 格式接口,phone-mcp 只依赖 adb;代价是首次跑通需要外部 OneBot 网关,README 自己也把这列为最大门槛。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。
相关推荐
- Mieksido/surfcore给 DSH agent 一副长期人设、会遗忘的记忆、QQ 与 B站 的账号活动,以及可选桌面分身。
- DandanLLab/SnowCatQQ基于 NapCat 与 SnowLuma 的第三方 QQ 客户端,通过 V8 通道在官方 QQ 进程内提供 OneBot/MCP 接口,让开发者接入自己的智能体。
- MemPalace/mempalace为 AI 编程代理提供本地优先、原文存储的可检索记忆,按项目与人物限定回忆范围。
- chenkezhen480/dsh-world给 DSH 桌面的陪伴角色加上持久记忆、独立房间和每日作息,开关集中在 DSH 设置里。
- tavern-labs-ai/character-ai-sdk一个用于构建持久 AI 角色的 TypeScript SDK,提供人设、持久记忆及可替换的模型、存储与接口适配器。