搜索你想找的开源项目

输入名称、用途或关键词,也可粘贴 GitHub 仓库链接

分享到微信

当前解读页的微信分享二维码

用微信扫一扫打开,点击右上角「···」分享给朋友或朋友圈。

手机上可截屏后,在微信扫一扫中从相册识别二维码。

pinganbbOvO/ai-companion-kit

AI 工程

给 QQ 聊天机器人加持久记忆、拟人回复和安卓手机控制能力的一套独立可拆包工具。

572
43
JavaScript
MIT
创建于 41 天前

项目介绍

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 生成,更新于 ,以项目官方文档为准。

相关推荐

  1. Mieksido/surfcore给 DSH agent 一副长期人设、会遗忘的记忆、QQ 与 B站 的账号活动,以及可选桌面分身。JavaScript766
  2. DandanLLab/SnowCatQQ基于 NapCat 与 SnowLuma 的第三方 QQ 客户端,通过 V8 通道在官方 QQ 进程内提供 OneBot/MCP 接口,让开发者接入自己的智能体。TypeScript320
  3. MemPalace/mempalace为 AI 编程代理提供本地优先、原文存储的可检索记忆,按项目与人物限定回忆范围。Python60,124
  4. chenkezhen480/dsh-world给 DSH 桌面的陪伴角色加上持久记忆、独立房间和每日作息,开关集中在 DSH 设置里。TypeScript107
  5. tavern-labs-ai/character-ai-sdk一个用于构建持久 AI 角色的 TypeScript SDK,提供人设、持久记忆及可替换的模型、存储与接口适配器。TypeScript156