# 🚀 Nexus Open-Source Launch Checklist

完整的开源发布 & 推广清单，按顺序执行。

---

## Phase 1：发布准备 🔧

### GitHub 仓库

- [ ] 在 GitHub 创建仓库 `songtianye/nexus`
- [ ] 推送代码：`git init && git add . && git commit -m "feat: initial release v0.1.0" && git remote add origin git@github.com:songtianye/nexus.git && git push -u origin main`
- [ ] 添加仓库 Description：`Protocol-native, topology-adaptive multi-agent framework for Python`
- [ ] 添加 Topics 标签：`multi-agent` `ai-agent` `llm` `python` `a2a` `mcp` `orchestration` `openai` `anthropic` `ollama`
- [ ] 设置 Social Preview 图片（1280×640）
- [ ] 启用 Discussions 功能
- [ ] 启用 Issues（已有模板）

### PyPI 发布

- [ ] 注册 PyPI 账号：https://pypi.org/account/register/
- [ ] 创建 API Token：https://pypi.org/manage/account/token/
- [ ] **推荐：配置 Trusted Publishing**
  - PyPI → Publishing → 添加 GitHub publisher
  - Owner: `songtianye`, Repository: `nexus`, Workflow: `publish.yml`, Environment: `pypi`
- [ ] GitHub Settings → Environments → 创建 `pypi` 环境
- [ ] 手动首次发布（详见 `docs/PYPI_PUBLISH.md`）：
  ```bash
  source .venv/bin/activate
  pip install build twine
  python -m build
  twine upload dist/*
  ```
- [ ] 验证：`pip install nexus-agents` 能正常安装

### GitHub Release

- [ ] 创建 tag：`git tag v0.1.0 && git push origin v0.1.0`
- [ ] GitHub → Releases → Create Release from tag `v0.1.0`
- [ ] Release Notes 使用 `CHANGELOG.md` 内容
- [ ] 如果配置了 Trusted Publishing，tag push 会自动触发 PyPI 发布

---

## Phase 2：推广执行 📣

### 第 1 天（周一）— 正式发布

- [ ] GitHub Release v0.1.0
- [ ] PyPI 发布确认
- [ ] 发 Twitter/X 英文推文线程（见 `docs/articles/social_media_templates.md`）
- [ ] 发 Twitter/X 中文推文线程

### 第 2 天（周二）— 中英社区

- [ ] 发 Reddit r/Python 帖子
- [ ] 发掘金文章（见 `docs/articles/cn_juejin_zhihu.md`）

### 第 3 天（周三）— 技术社区

- [ ] 发 Hacker News Show HN（见 `docs/articles/en_hackernews.md`）
  - ⏰ 最佳时间：北京时间周三晚 9-11 点（美东上午）
- [ ] 发知乎文章

### 第 4 天（周四）— 深度内容

- [ ] 发 Reddit r/MachineLearning 讨论帖
- [ ] 发 Dev.to 文章（见 `docs/articles/en_medium_devto.md`）

### 第 5 天（周五）— 本地化 & 垂直

- [ ] 发 Reddit r/LocalLLaMA 帖子（Ollama 角度）
- [ ] 发 CSDN 文章

### 第 6 天（周六）— 长尾内容

- [ ] 发 Medium 文章
- [ ] 再发一轮 Twitter 精简版推文

### 第 7 天（周日）— 公众号

- [ ] 发微信公众号文章（见 `docs/articles/cn_wechat.md`）

---

## Phase 3：持续运营 🔄

### 每周

- [ ] 回复 GitHub Issues 和 Discussions
- [ ] 回复各平台评论
- [ ] 每周发一条进度推文/动态

### 每两周

- [ ] 发一篇技术博客（深入某个功能）
- [ ] 更新 CHANGELOG

### 里程碑

| Star 数 | 行动 |
|---------|------|
| 100 ⭐ | 发感谢帖 + 写 v0.2.0 规划 |
| 500 ⭐ | 提交到 Awesome Lists |
| 1000 ⭐ | 录 YouTube/B站 教程视频 |
| 2000 ⭐ | 申请加入 CNCF Landscape / AI 相关生态列表 |

---

## 📁 已创建的推广资料清单

| 文件 | 用途 |
|------|------|
| `README.md` | GitHub 英文首页 |
| `README_CN.md` | GitHub 中文首页 |
| `CONTRIBUTING.md` | 贡献指南 |
| `CHANGELOG.md` | 版本日志 |
| `docs/PYPI_PUBLISH.md` | PyPI 发布指南 |
| `.github/workflows/publish.yml` | 自动发布 PyPI |
| `.github/workflows/ci.yml` | 持续集成 |
| `.github/ISSUE_TEMPLATE/bug_report.md` | Bug 模板 |
| `.github/ISSUE_TEMPLATE/feature_request.md` | 功能请求模板 |
| `docs/articles/en_medium_devto.md` | Medium / Dev.to 英文长文 |
| `docs/articles/en_hackernews.md` | Hacker News Show HN |
| `docs/articles/cn_juejin_zhihu.md` | 掘金 / 知乎 / CSDN 中文长文 |
| `docs/articles/cn_wechat.md` | 微信公众号推文 |
| `docs/articles/social_media_templates.md` | Twitter + Reddit 模板 |
| `docs/LAUNCH_CHECKLIST.md` | 本清单 |

---

## 💡 加分项

- [ ] 录一个 30 秒 GIF demo（用 `asciinema` 或 `vhs`）放到 README
- [ ] 制作架构图（用 Excalidraw / draw.io）
- [ ] 写一个 `examples/` 下的交互式教程
- [ ] 提交到 [awesome-python](https://github.com/vinta/awesome-python)
- [ ] 提交到 [awesome-llm-agents](https://github.com/kaushikb11/awesome-llm-agents)
- [ ] 在 Product Hunt 发布（周二或周三最佳）

---

**目标：让每一个看到 Nexus 的人，都有理由点下 Star ⭐**
