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