Mao Agents

English README

让毛主席、毛教员那些有力量的话，常伴你左右。

Mao Agents 是一个住在 macOS Dock 上方的小 companion。它会在桌面边缘走来走去，在你疲惫、emo、想泄气的时候，突然弹出一句《毛泽东选集》里的话，把人往回拽一下。

这个 fork 基于 lil-agents 演化而来，但主叙事已经从 “AI terminal 小角色” 转向了 “桌面陪伴 + 金句提醒 + 第二形象”。

核心特性

• 点击角色直接弹出金句，也支持自动按分钟弹句
• 支持导入你自己的金句库，不只限于《毛选》
• 支持把角色切成“头像火柴人”模式，并上传自定义头像
• 默认仍保留原版视频角色和 AI terminal 能力，但不再是主卖点
• 主题、声音、语言、显示等选项都集中在菜单栏图标里

怎么切到火柴人

• 应用默认启动后，仍然会先显示原版角色
• 点击右上角菜单栏图标，进入 角色 -> Bruce / Jazz -> 模式 -> 头像火柴人
• 如果你还想换成自己的头像，再到 角色 -> Bruce / Jazz -> 选择头像图片…
• 金句导入、自动弹句、声音、主题、语言等功能，也都在这个菜单栏里

安装

普通用户直接去 GitHub Releases 下载：

• MaoAgents-...-universal-macos.dmg
• 或 MaoAgents-...-universal-macos.zip

下载后：

1. 打开 dmg 或解压 zip
2. 把 .app 拖到 Applications
3. 启动应用

如果 macOS 提示“无法打开”或“来自身份不明的开发者”，请在 Finder 里右键应用并选择“打开”；如果还被拦住，再到“系统设置 -> 隐私与安全性”里允许它打开。

当前公开版本采用 GitHub Releases 分发，暂未走 Apple Developer ID / notarization 流程，所以部分机器上会多一步系统确认。

从源码构建

1. 用 Xcode 打开 lil-agents.xcodeproj
2. 选择 LilAgents scheme
3. 直接运行

如果你要生成通用安装包，可以运行：

bash scripts/release/build_release.sh --arch universal

隐私

• 金句库文件存放在本地
• 头像素材与裁切结果存放在本地
• 应用本身不依赖云端账号系统

如果你启用了保留下来的 AI terminal 能力，那么与对应 AI 提供方的交互，仍受对应 CLI 与服务商规则约束。

致谢与 License

本项目基于原项目 ryanstephen/lil-agents 演化而来，改造重点是产品定位与交互场景，而不是否认原项目本身的价值。

许可证沿用原项目，详见 LICENSE。