120 lines
2.8 KiB
Markdown
120 lines
2.8 KiB
Markdown
|
# 平台同步功能测试指南
|
|||
|
|
|
|||
|
|
## ✅ 已实现功能
|
|||
|
|
|
|||
|
|
### 1. GitHub发布功能
|
|||
|
|
- ✅ 数据库扩展（platform_accounts、publish_records表）
|
|||
|
|
- ✅ GitHub发布器（platform_sync/github_publisher.py）
|
|||
|
|
- ✅ DataStorage扩展（平台账号和发布记录管理）
|
|||
|
|
- ✅ UI界面（Tab 9：平台同步）
|
|||
|
|
|
|||
|
|
## 🚀 快速测试
|
|||
|
|
|
|||
|
|
### 步骤1：安装依赖
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
pip install httpx pyperclip
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
或安装所有依赖：
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
pip install -r requirements.txt
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 步骤2：获取GitHub Token
|
|||
|
|
|
|||
|
|
1. 访问 https://github.com/settings/tokens
|
|||
|
|
2. 点击 "Generate new token" -> "Generate new token (classic)"
|
|||
|
|
3. 填写Token名称（如：GEO Tool）
|
|||
|
|
4. 选择权限：勾选 `repo`（完整仓库访问权限）
|
|||
|
|
5. 点击 "Generate token"
|
|||
|
|
6. **重要**：复制Token（只显示一次）
|
|||
|
|
|
|||
|
|
### 步骤3：运行应用
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
streamlit run geo_tool.py
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 步骤4：配置GitHub账号
|
|||
|
|
|
|||
|
|
1. 在侧边栏设置品牌信息
|
|||
|
|
2. 进入 **Tab 9：平台同步**
|
|||
|
|
3. 在 "GitHub 配置" 中填写：
|
|||
|
|
- GitHub Personal Access Token
|
|||
|
|
- 仓库所有者（用户名）
|
|||
|
|
- 仓库名称
|
|||
|
|
4. 点击 "💾 保存配置"
|
|||
|
|
|
|||
|
|
### 步骤5：发布文章
|
|||
|
|
|
|||
|
|
1. 在 **Tab 2：自动创作** 中生成一篇文章（选择GitHub平台）
|
|||
|
|
2. 进入 **Tab 9：平台同步**
|
|||
|
|
3. 选择要发布的文章
|
|||
|
|
4. 选择平台：GitHub
|
|||
|
|
5. （可选）修改文件路径
|
|||
|
|
6. 点击 "🚀 发布到GitHub"
|
|||
|
|
7. 等待发布完成，查看结果
|
|||
|
|
|
|||
|
|
### 步骤6：查看发布记录
|
|||
|
|
|
|||
|
|
在 **Tab 9：平台同步** 的 "发布记录" 部分查看：
|
|||
|
|
- 总发布数
|
|||
|
|
- 成功/失败统计
|
|||
|
|
- 最近发布记录列表
|
|||
|
|
|
|||
|
|
## 🔍 验证发布成功
|
|||
|
|
|
|||
|
|
1. 访问GitHub仓库
|
|||
|
|
2. 检查 `content/` 目录（或你指定的路径）
|
|||
|
|
3. 确认文件已创建或更新
|
|||
|
|
4. 点击文件查看内容是否正确
|
|||
|
|
|
|||
|
|
## ⚠️ 常见问题
|
|||
|
|
|
|||
|
|
### 1. Token验证失败
|
|||
|
|
- 检查Token是否正确复制
|
|||
|
|
- 确认Token有 `repo` 权限
|
|||
|
|
- 检查Token是否过期
|
|||
|
|
|
|||
|
|
### 2. 发布失败：404 Not Found
|
|||
|
|
- 检查仓库所有者名称是否正确
|
|||
|
|
- 检查仓库名称是否正确
|
|||
|
|
- 确认仓库存在且有访问权限
|
|||
|
|
|
|||
|
|
### 3. 发布失败：403 Forbidden
|
|||
|
|
- 检查Token权限是否足够
|
|||
|
|
- 确认Token未过期
|
|||
|
|
- 检查仓库是否为私有（需要相应权限）
|
|||
|
|
|
|||
|
|
### 4. 文件路径错误
|
|||
|
|
- 路径不能以 `/` 开头
|
|||
|
|
- 路径中不能包含特殊字符
|
|||
|
|
- 建议使用 `content/文件名.md` 格式
|
|||
|
|
|
|||
|
|
## 📝 下一步
|
|||
|
|
|
|||
|
|
如果GitHub发布功能正常工作，可以：
|
|||
|
|
|
|||
|
|
1. **扩展其他平台**：
|
|||
|
|
- 微信公众号
|
|||
|
|
- B站
|
|||
|
|
- 知乎
|
|||
|
|
- CSDN
|
|||
|
|
|
|||
|
|
2. **添加一键复制功能**：
|
|||
|
|
- 头条号
|
|||
|
|
- 小红书
|
|||
|
|
- 抖音
|
|||
|
|
- 其他无API平台
|
|||
|
|
|
|||
|
|
3. **批量发布功能**：
|
|||
|
|
- 支持一次发布到多个平台
|
|||
|
|
- 发布队列管理
|
|||
|
|
- 定时发布
|
|||
|
|
|
|||
|
|
## 🎉 完成！
|
|||
|
|
|
|||
|
|
如果测试成功，说明架构是正确的，可以按照相同模式实现其他平台。
|