# 发布检查清单
在发布股票收益计算器到 crates.io 之前，请完成以下检查清单：
## 1. 代码质量检查
### ✅ 代码检查
- [ ] `cargo check` 通过
- [ ] `cargo test` 通过
- [ ] `cargo clippy` 通过
- [ ] `cargo fmt` 通过
### ✅ 功能测试
- [ ] 计算功能正常
- [ ] API 调用正常
- [ ] 数据存储正常
- [ ] 通知功能正常
- [ ] 配置管理正常
## 2. 文档检查
### ✅ README 文档
- [ ] 安装说明完整
- [ ] 使用示例清晰
- [ ] 功能特性描述准确
- [ ] 贡献指南完整
### ✅ 其他文档
- [ ] LICENSE 文件存在
- [ ] QUICKSTART.md 完整
- [ ] PUBLISHING.md 完整
- [ ] IMPLEMENTATION_SUMMARY.md 完整
## 3. 配置检查
### ✅ Cargo.toml
- [ ] 版本号正确
- [ ] 描述信息准确
- [ ] 关键词合适
- [ ] 分类正确
- [ ] 依赖版本合适
### ✅ GitHub 配置
- [ ] GitHub Actions 工作流配置正确
- [ ] Issue 模板完整
- [ ] PR 模板完整
- [ ] .gitignore 合适
## 4. 发布准备
### ✅ crates.io 发布
- [ ] 注册 crates.io 账户
- [ ] 获取 API token
- [ ] 运行 `cargo login`
- [ ] 运行 `cargo package` 检查
- [ ] 准备发布说明
### ✅ GitHub Release
- [ ] 创建 GitHub 仓库
- [ ] 推送代码到仓库
- [ ] 创建 Release 标签
- [ ] 上传二进制文件
## 5. 自动化配置
### ✅ GitHub Actions
- [ ] CI 工作流配置正确
- [ ] Release 工作流配置正确
- [ ] 密钥配置正确
### ✅ 发布脚本
- [ ] `scripts/release.sh` 可执行
- [ ] 脚本功能正常
## 6. 测试发布
### ✅ 本地测试
- [ ] 从源码安装正常
- [ ] 功能测试通过
- [ ] 性能测试通过
### ✅ 集成测试
- [ ] 跨平台编译正常
- [ ] 依赖解析正常
- [ ] 安装过程正常
## 7. 发布步骤
### 步骤 1: 发布到 crates.io
```bash
# 1. 检查包信息
cargo package
# 2. 发布
cargo publish
# 3. 验证
cargo search stock-calc
```
### 步骤 2: 创建 GitHub Release
```bash
# 1. 运行发布脚本
./scripts/release.sh
# 2. 在 GitHub 上创建 Release
# 3. 上传二进制文件
```
## 8. 发布后检查
### ✅ 安装测试
- [ ] `cargo install stock-calc` 正常
- [ ] 功能使用正常
### ✅ 文档更新
- [ ] 更新安装链接
- [ ] 更新示例代码
- [ ] 更新版本信息
### ✅ 社区建设
- [ ] 回复用户反馈
- [ ] 处理 Issues
- [ ] 合并 PRs
## 9. 监控和维护
### ✅ 使用统计
- [ ] 监控下载量
- [ ] 监控用户反馈
- [ ] 监控错误报告
### ✅ 版本更新
- [ ] 制定更新计划
- [ ] 准备更新内容
- [ ] 测试更新功能
## 10. 营销推广
### ✅ 社区分享
- [ ] Reddit r/rust
- [ ] Rust 论坛
- [ ] 技术博客
- [ ] 社交媒体
### ✅ 文档完善
- [ ] 使用教程
- [ ] 视频演示
- [ ] 案例分享
## 完成检查
发布前请确保所有项目都已检查完成：
- [ ] 所有代码质量检查通过
- [ ] 所有文档检查完成
- [ ] 所有配置检查正确
- [ ] 所有发布准备就绪
- [ ] 所有自动化配置正确
- [ ] 所有测试通过
**祝您发布成功！** 🚀