OpenOutreach

环境要求

• 已安装 uv（安装命令使用 uv tool install）
• 可用的 Python 环境（项目为 Python 实现）
• 一个可正常发信的邮箱（用于从你自己的邮箱发起对话）
• 源码方式安装需额外具备 git 与 make

安装与启动步骤

1. 1安装命令行工具

   通过 uv 以工具方式全局安装 OpenOutreach，不需要浏览器、守护进程或容器。

   uv tool install openoutreach

   复制

2. 2只做初始化引导

   首次建议先跑 init：完成全部问答配置，不查找也不发送，不消耗积分。

   openoutreach init

   复制

3. 3用文件填长字段

   产品描述与目标市场两段长文本可分别写在文件里，用参数直接传入，避免交互输入。

   openoutreach init --product-docs product.md --target target.md

   复制

4. 4免费查找线索

   find 只在本地筛选并输出合格线索（CSV 到 stdout），不花积分、不能消费。

   openoutreach find 10

   复制

5. 5查找带邮箱线索

   加 emails 参数会为线索购买已验证的工作邮箱，每条消耗 1 个积分。

   openoutreach find 10 emails

   复制

6. 6运行并发送邮件

   一步完成引导（如未做）、找线索、买地址、发信；run 5 表示最多消耗 5 个积分。

   openoutreach run 5

   复制

7. 7只发送已存线索

   send 不查找新线索，直接把库里已有线索发出去；send 5 表示发到 5 个对话打开为止。

   openoutreach send 5

   复制

8. 8查看运行状态

   status 显示当前已配置了什么、哪些被阻塞、已消费的积分数，便于排查。

   openoutreach status

   复制

如何确认成功

执行 openoutreach status 能看到当前配置、阻塞项与已计数积分；数据都存在 ~/.openoutreach，重启不丢。

常见问题

注意事项

• 完整引导与查找发送都可只用一条 openoutreach 完成，但先跑 openoutreach init 更安全——它不花钱。
• Docker 部署请看仓库内 docs/docker.md；README 只说明镜像已发布，未提供可直接复制的 docker 命令。
• 源码开发安装：git clone https://github.com/eracle/OpenOutreach.git 后 cd OpenOutreach，再执行 make setup 与 make run。
• README 未列出任何环境变量或配置文件项，本文因此未提供配置项示例。