Yappy 🐶

AI 驱动的 LinkedIn 互动助手。自动发现 LinkedIn 上的帖子，并留下深思熟虑、独一无二、由 AI 生成的评论，听起来就像是你本人写的一样。

Yappy 是一款强大的终端工具，它利用 Google Gemini AI 和 Playwright 浏览器自动化 帮助你保持 LinkedIn 的活跃度，而无需进行无脑的刷屏。

---

快速开始

使用你喜欢的包管理器安装 Yappy：

pip（推荐）

pip install yappy
yap

运行程序

yap              # 启动 TUI 仪表盘
yap onboarding   # 手动运行设置向导
yap --no-tui     # 以无头 CLI 模式运行
yap --report     # 显示活动报告
yap --about      # 显示版本和系统信息

---

✨ 快速上手（首次运行）

首次运行 yap 时，Yappy 会启动设置向导，帮助你在几分钟内完成配置。你可以随时通过 yap onboarding 重新运行该向导。

1. 自动设置： Yappy 会自动安装必要的 Playwright 浏览器并创建你的配置文件。
2. 你的 AI "大脑"： 你需要一个 Google Gemini API 密钥。目前可以从 Google AI Studio 免费获取。
3. 安全登录： Yappy 会打开一个浏览器窗口供你登录 LinkedIn。你的密码永远不会被 Yappy 看到或存储。 它会在你的电脑本地安全地保存你的会话 "cookie"，以便后续运行时保持登录状态。
4. 准备就绪： 连接成功后，Yappy 就可以开始为你寻找帖子了！

---

📺 管理你的机器人

Yappy 提供两种运行方式，取决于你是想亲眼见证整个过程，还是让它静默地在后台运行。

1. Yappy 仪表盘（TUI）

只需运行 yap 即可打开交互式仪表盘。

• 实时信息流： 实时观察 Yappy 发现帖子并草拟有见地的评论。
• 统计面板： 随时查看你的每日进度和账户健康状况。
• 当前策略： 一目了然地查看你的活跃 AI 角色设定和定位规则。
• 配置编辑器： 直接在你的终端内调整设置、管理 Gemini API 密钥 以及刷新 LinkedIn 登录。

2. 后台模式（CLI）

如果你想让 Yappy 工作，同时专注于其他事情：

yap --no-tui

你可以随时通过运行报告来检查它的进度：

yap --report

---

自定义配置

配置文件位于 ~/.config/yappy/config.yaml。你可以自定义定位目标：

targets:
  - type: feed          # 你的主页信息流
    max_posts: 15
  - type: keyword       # 特定主题
    value: "AI startups"
    max_posts: 5

---

卸载

要从系统中移除 Yappy：

1. 卸载包

pip uninstall yappy
# 或者如果通过 Homebrew 安装：
brew uninstall yappy

2. 清理本地数据（可选）

要完全移除你的配置文件、LinkedIn 会话和活动日志：

# macOS
rm -rf ~/Library/Application\ Support/yappy
rm -rf ~/.config/yappy

# Linux
rm -rf ~/.local/share/yappy
rm -rf ~/.config/yappy

---

许可证

基于 MIT 许可证分发。更多信息请参见 LICENSE 文件。

---

Yappy 是一个独立项目，与 LinkedIn 公司无任何关联、授权、维护、赞助或背书关系。