pinganbbOvO/ai-companion-kit

解决的问题

如今的 AI 助手擅长回答，但感觉机械：回复一次性全部到达，它们不会跨对话记住你是谁，也无法在你的手机上操作或发布到社交平台。这个项目修复了两个缺口：让 AI 感觉更人性化（记住人、真实的打字延迟、知道何时保持沉默），并给它一双手（通过 adb 控制真实手机，自主发布 QQ 空间动态）。

工作原理

该工具包分为独立的包，可以一起使用或单独使用：

• ai-companion — 记住每个人的信息（按人存储，而非按聊天会话），写日记（与记忆分开，只有最近的条目进入上下文），像人一样打字（打字时间、拆分消息、暂停、夜间更慢），并决定是否说话或保持安静（规则如“仅 @ 唤醒”、“群聊中除非被点名否则保持沉默”）。
• phone-mcp — 向 AI 暴露 34 个 MCP 工具，使其能够点击、滑动、输入中文、截图、录屏和组合操作，全部通过 adb（适用于真实设备或模拟器）。它还可以控制网易云音乐。
• qzone + qzone-mcp — 允许 AI 自主发布 QQ 空间动态，提供六个工具：发布（文本 + 最多 9 张图片）、查看自己的动态、查看好友动态、查看其他用户动态、点赞和评论（有严格频率限制）。一键脚本（npm run qzone）检查网关、验证设置，并向角色卡追加一段定义 AI 何时可以发布的段落。
• own-life（包含在工具包中）— 每 2.5 小时静默提醒 AI（但不在 3:00–8:00 之间，每天最多 6 次），以便 AI 自主决定发布 QQ 空间更新或写日记。它保存状态，因此重启不会触发消息洪流。

工具包附带简易安装程序：在 Windows 上双击 tools/安装.bat 检查 Node、下载 QQ 桥接器、安装依赖并生成 config.json（只需填写你的 QQ ID、她的 QQ ID 和网关令牌）。Node.js 和 QQ 网关（SnowLuma）必须单独安装（README 指向带截图的指南）。

适用人群

• 非程序员，想要一个感觉有生命力的 QQ 伴侣（记忆、类人打字、日记），甚至能发布 QQ 空间动态。README 解释了如何让任何 AI 桌面应用（DeepSeek、ChatGPT、Cursor）为你安装。
• 有一定命令行经验的人，想要在大约 15 分钟内运行一个基本的纯聊天设置。
• 程序员，想要完全控制：README 包含详细教程，涵盖语音识别、手机控制、听音乐、日记和防限流技巧（第 13 章警告每分钟 20 条消息会触发腾讯限流——不要跳过）。

亮点

• 按人记忆 — AI 分别记住每个联系人的信息，并在群聊和私聊中携带（示例：群聊中说的信息在私聊中也能回忆起来）。
• 类人打字 — 显示“正在输入…”指示器，分段发送消息并暂停，夜间打字更慢。
• 唤醒策略 — 完全可配置：响应 @、戳一戳、主人的消息、关键词，或在群聊中除非被点名否则保持沉默。
• 有性格的日记 — AI 直接根据角色卡、最近上下文和之前的日记条目写自己的日志（1–4 句，第一人称）——避免重复的“今天很充实”填充。你也可以手动添加条目。
• 自主 QQ 空间动态 — AI 自然决定何时发布（不是定时机器人）。它只能从白名单目录发布图片，并且没有删除或屏蔽能力——README 说这是刻意的安全选择。
• 安全的手机控制 — 它可以点击、滑动、输入、截图、录屏和组合操作，但 README 强烈警告不要在有支付或银行应用手机上使用；使用模拟器或备用设备。
• 所有数据都是本地纯文本 — 记忆是 JSON，聊天流是 JSONL，日记是 JSONL 加每日 Markdown 文件。你随时可以读取、编辑、grep 或备份。
• 每层独立可用 — 你可以只使用伴侣、只使用手机控制，或只使用 QQ 空间发布。

（注意：此说明仅基于 README；所有描述的功能都在其中。）