Files

T

刘国栋 8f7f082c3d feat: 重构项目结构并添加平台同步基础架构

- 重构项目目录结构，将功能模块移至 modules/ 目录
- 创建平台同步基础架构，包括发布器基类和 GitHub 发布器
- 新增 UI 状态管理模块 (modules/ui/state.py) 统一管理会话状态
- 更新依赖配置，添加平台同步所需依赖 (httpx, pyperclip)
- 整理文档结构，将所有文档分类移至 docs/ 目录
- 添加 .cursorrules 文件定义项目开发规范
- 清理根目录重复文件，保持项目结构整洁

2026-01-30 10:21:29 +08:00

25 KiB

Raw Blame History

自媒体平台文章同步功能分析报告（最终版）

更新说明：保留原有12个平台，新增8个平台，总计20个平台需要支持文章同步功能

📋 项目现状分析

当前功能

内容生成：已支持12个自媒体平台的内容生成
- 原有平台：
  1. 知乎（专业问答）
  2. 小红书（生活种草）
  3. CSDN（技术博客）
  4. B站（视频脚本）
  5. 头条号（资讯软文）
  6. GitHub（README/文档）
  7. 微信公众号（长文）
  8. 抖音图文（短内容）
  9. 百家号（资讯）
  10. 网易号（资讯）
  11. 企鹅号（资讯）
  12. 简书（文艺）
数据存储：已实现SQLite数据持久化
- 文章内容、关键词、平台信息都已保存
- 支持历史记录查看和导出
内容格式：
- 支持Markdown格式输出
- 平台特定的Prompt模板
- 内容质量评分

缺失功能

❌ 文章发布/同步：目前只生成内容，需要手动复制发布
❌ 发布状态跟踪：无法追踪文章是否已发布
❌ 平台账号管理：没有平台账号认证和配置

🎯 功能需求分析

核心需求

自媒体账号平台的文章同步功能，需要覆盖：

原有12个平台（保留，需添加发布功能）
新增8个平台（需要添加内容生成 + 发布功能）

新增平台列表

新浪博客（新增）
新浪新闻（新增）
搜狐号（新增）
QQ空间（新增）
邦阅网（新增）
一点号（新增）
东方财富（新增）
原创力文档（新增）

总计平台数量

20个平台需要支持文章同步功能

功能要求：

将生成的文章自动发布到对应平台
支持批量发布
发布状态跟踪和记录
发布失败重试机制
新增平台需要同时支持内容生成和发布

🔍 技术可行性分析（20个平台详细评估）

📊 平台分类总览

原有12个平台（已有内容生成，需添加发布功能）

知乎（专业问答）
小红书（生活种草）
CSDN（技术博客）
B站（视频脚本）
头条号（资讯软文）
GitHub（README/文档）
微信公众号（长文）
抖音图文（短内容）
百家号（资讯）
网易号（资讯）
企鹅号（资讯）
简书（文艺）

新增8个平台（需添加内容生成 + 发布功能）

新浪博客（新增）
新浪新闻（新增）
搜狐号（新增）
QQ空间（新增）
邦阅网（新增）
一点号（新增）
东方财富（新增）
原创力文档（新增）

✅ 有官方API支持（可直接实现发布）

原有平台（5个）

B站（哔哩哔哩） ⭐⭐⭐⭐
- API完善度：高
- 官方文档：https://bilibili.apifox.cn/
- 核心接口：专栏稿件管理 /x/article/create
- 认证方式：OAuth2.0
- 实现难度：中等
- 优先级：⭐⭐⭐⭐（高）
知乎 ⭐⭐⭐⭐
- API完善度：中高
- 官方文档：https://www.zhihu.com/open
- 核心接口：内容发布接口
- 认证方式：OAuth2.0
- 实现难度：中等
- 优先级：⭐⭐⭐⭐（高）
CSDN ⭐⭐⭐
- API完善度：中等
- 官方文档：有开放平台
- 认证方式：OAuth2.0
- 实现难度：中等
- 优先级：⭐⭐⭐（中）
百家号 ⭐⭐⭐
- API完善度：中等
- 官方文档：有开放平台
- 认证方式：OAuth2.0
- 实现难度：中等
- 限制：需要企业认证
- 优先级：⭐⭐⭐（中）
企鹅号 ⭐⭐⭐
- API完善度：中等
- 官方文档：https://open.om.qq.com/
- 认证方式：OAuth2.0
- 实现难度：中等
- 限制：第三方服务平台功能"暂停维护中"
- 优先级：⭐⭐⭐（中）

新增平台（0个）

新增的8个平台均无API支持

⚠️ API支持有限（需要特殊处理）

原有平台（7个）

GitHub ⭐⭐⭐⭐⭐
- API完善度：非常高
- 官方文档：https://docs.github.com/en/rest
- 核心接口：创建文件、创建Issue
- 认证方式：Personal Access Token
- 实现难度：低
- 优先级：⭐⭐⭐⭐⭐（最高）
微信公众号 ⭐⭐⭐⭐⭐
- API完善度：高
- 官方文档：https://developers.weixin.qq.com/doc/offiaccount/Publish/Publish.html
- 核心接口：上传图文、发布草稿
- 认证方式：OAuth2.0，需要企业认证
- 实现难度：中等
- 优先级：⭐⭐⭐⭐（高）
头条号 ⭐⭐
- API完善度：低
- 官方文档：https://developer.open-douyin.com/
- 核心接口：无直接内容发布API
- 实现方式：主要通过小程序挂载
- 实现难度：高
- 替代方案：一键复制
- 优先级：⭐⭐（低）
网易号 ⭐⭐⭐
- API完善度：中等
- 官方文档：有OAuth认证等账号体系接口
- 实现难度：中等-高
- 限制：内容发布API需要进一步确认
- 优先级：⭐⭐⭐（中）
小红书 ⭐⭐
- API完善度：低
- 官方文档：无公开API
- 实现难度：高
- 替代方案：一键复制
- 优先级：⭐⭐（低）
抖音 ⭐⭐
- API完善度：低
- 官方文档：主要面向视频，图文支持有限
- 实现难度：高
- 替代方案：一键复制
- 优先级：⭐⭐（低）
简书 ⭐⭐
- API完善度：低
- 官方文档：无公开API
- 实现难度：高
- 替代方案：一键复制
- 优先级：⭐⭐（低）

新增平台（8个）

QQ空间 ⭐⭐
- API完善度：低
- 官方文档：https://open.qq.com/
- 核心接口：主要是分享功能（shareToQzone）
- 实现难度：高
- 替代方案：一键复制
- 优先级：⭐⭐（低）
新浪博客 ⭐⭐
- API完善度：低
- 官方文档：新浪微博有开放平台，但博客API不明确
- 实现难度：高
- 替代方案：一键复制
- 优先级：⭐⭐（低）
新浪新闻 ⭐⭐
- API完善度：低
- 官方文档：无明确公开API
- 实现难度：高
- 替代方案：一键复制
- 优先级：⭐⭐（低）
搜狐号 ⭐⭐
- API完善度：低
- 官方文档：无明确公开API
- 实现难度：高
- 替代方案：一键复制
- 优先级：⭐⭐（低）
一点号 ⭐⭐
- API完善度：低
- 官方文档：无明确公开API
- 实现难度：高
- 替代方案：一键复制
- 优先级：⭐⭐（低）
东方财富 ⭐⭐
- API完善度：低
- 官方文档：无明确公开API
- 实现难度：高
- 替代方案：一键复制
- 优先级：⭐⭐（低）
邦阅网 ⭐⭐
- API完善度：低
- 官方文档：无明确公开API
- 实现难度：高
- 替代方案：一键复制
- 优先级：⭐⭐（低）
原创力文档 ⭐⭐
- API完善度：低
- 官方文档：无明确公开API
- 实现难度：高
- 替代方案：一键复制
- 优先级：⭐⭐（低）

📊 平台分类汇总表

平台	类型	API支持	实现难度	优先级	推荐方案
原有平台（12个）
GitHub	原有	✅ 非常高	低	⭐⭐⭐⭐⭐	直接API集成
微信公众号	原有	✅ 高	中等	⭐⭐⭐⭐	直接API集成
B站	原有	✅ 高	中等	⭐⭐⭐⭐	直接API集成
知乎	原有	✅ 中高	中等	⭐⭐⭐⭐	直接API集成
CSDN	原有	✅ 中等	中等	⭐⭐⭐	直接API集成
百家号	原有	✅ 中等	中等	⭐⭐⭐	直接API集成
企鹅号	原有	✅ 中等	中等	⭐⭐⭐	直接API集成
网易号	原有	✅ 中等	中等-高	⭐⭐⭐	直接API集成（需确认）
头条号	原有	⚠️ 低	高	⭐⭐	一键复制
小红书	原有	❌ 无	高	⭐⭐	一键复制
抖音	原有	❌ 无	高	⭐⭐	一键复制
简书	原有	❌ 无	高	⭐⭐	一键复制
新增平台（8个）
QQ空间	新增	⚠️ 低	高	⭐⭐	一键复制
新浪博客	新增	⚠️ 低	高	⭐⭐	一键复制
新浪新闻	新增	❌ 无	高	⭐⭐	一键复制
搜狐号	新增	❌ 无	高	⭐⭐	一键复制
一点号	新增	❌ 无	高	⭐⭐	一键复制
东方财富	新增	❌ 无	高	⭐⭐	一键复制
邦阅网	新增	❌ 无	高	⭐⭐	一键复制
原创力文档	新增	❌ 无	高	⭐⭐	一键复制

统计：

API直接集成：8个平台（GitHub、微信公众号、B站、知乎、CSDN、百家号、企鹅号、网易号）
一键复制功能：12个平台（头条号、小红书、抖音、简书 + 8个新增平台）
总计：20个平台

💡 实现复杂度评估（20个平台）

总体评估：高 ⭐⭐⭐⭐

原因：

20个平台中，只有8个平台有较好的API支持
12个平台API支持有限或没有API
需要混合方案：API集成 + 一键复制功能
新增8个平台需要同时实现内容生成和发布功能

复杂度分解

1. 基础架构 ⭐⭐⭐

数据模型扩展：
- 新增platform_accounts表（存储20个平台的账号信息）
- 新增publish_records表（存储发布记录）
- 扩展articles表（添加发布状态字段）
- 新增platform_configs表（存储平台配置和规则）
实现难度：低-中等
工作量：3-4天

2. 平台API集成 ⭐⭐⭐⭐⭐

需要实现：
- OAuth2.0认证流程（8个平台）
- Token管理和刷新机制
- 各平台API调用封装（8个平台）
- 错误处理和重试机制
- 平台特定规则处理
实现难度：高
工作量：
- GitHub：1-2天（最简单）
- 微信公众号：3-4天
- B站：3-4天
- 知乎：3-4天
- CSDN：3-4天
- 百家号：4-5天（需企业认证）
- 企鹅号：4-5天（API状态需确认）
- 网易号：4-5天（需确认发布API）
- 总计：25-33天（8个平台）

3. 新增平台内容生成 ⭐⭐⭐

需要实现：
- 8个新增平台的Prompt模板
- 平台特定的内容格式要求
- 内容生成功能集成
实现难度：中等
工作量：5-7天（8个平台）

4. 一键复制功能 ⭐⭐⭐

需要实现：
- 12个无API平台的内容格式化
- 平台特定的格式模板（标题、正文、标签等）
- 剪贴板复制功能
- 发布指南生成
实现难度：中等
工作量：7-10天（12个平台）

5. 内容格式转换 ⭐⭐⭐⭐

需要实现：
- Markdown → HTML（部分平台）
- Markdown → 纯文本（部分平台）
- 图片上传和处理（有API的平台）
- 平台特定格式适配（20个平台）
- 字数限制处理
- 标签/分类处理
实现难度：中等-高
工作量：10-14天（20个平台）

6. 发布流程管理 ⭐⭐⭐⭐

需要实现：
- 批量发布队列（支持API发布和复制提示）
- 发布状态跟踪（API发布 + 手动发布标记）
- 失败重试机制（仅API发布）
- 发布日志记录
- 发布间隔控制（避免频率限制）
实现难度：中等-高
工作量：5-7天

7. 用户界面 ⭐⭐⭐

需要实现：
- 平台账号配置界面（20个平台）
- 发布任务管理界面
- 发布状态展示（区分API发布和手动发布）
- 一键复制按钮和提示
- 发布指南展示
实现难度：中等
工作量：5-7天

总工作量估算

模块	工作量	难度
基础架构	3-4天	⭐⭐⭐
API集成（8个平台）	25-33天	⭐⭐⭐⭐⭐
新增平台内容生成（8个）	5-7天	⭐⭐⭐
一键复制（12个平台）	7-10天	⭐⭐⭐
内容格式转换（20个平台）	10-14天	⭐⭐⭐⭐
发布流程管理	5-7天	⭐⭐⭐⭐
用户界面（20个平台）	5-7天	⭐⭐⭐
总计	60-82天	高

📊 实现方案建议（针对20个平台）

方案一：混合方案（强烈推荐）⭐⭐⭐⭐⭐

核心策略：API集成 + 新增平台内容生成 + 一键复制 + 发布指南

阶段一：MVP版本（4-5周）

目标：支持8个有API的平台 + 新增平台内容生成 + 基础一键复制功能

API集成平台（优先级排序）：

✅ GitHub（1-2天）- 最简单，验证架构
✅ 微信公众号（3-4天）- 用户量大，API完善
✅ B站（3-4天）- API完善，用户量大
✅ 知乎（3-4天）- API相对完善，用户量大
✅ CSDN（3-4天）- 技术平台，API支持
✅ 百家号（4-5天）- 百度生态，需要企业认证
✅ 企鹅号（4-5天）- 腾讯生态，需确认API状态
✅ 网易号（4-5天）- 需确认发布API

新增平台内容生成（8个平台）：

新浪博客、新浪新闻、搜狐号、QQ空间、邦阅网、一点号、东方财富、原创力文档
为每个平台创建Prompt模板
集成到内容生成流程

基础功能：

平台账号管理（20个平台）
单篇API发布（8个平台）
一键复制功能（12个平台）
发布状态记录

阶段二：完善版本（2-3周）

目标：优化体验 + 扩展功能

功能扩展：

批量发布功能
发布失败重试机制
发布间隔控制
发布指南生成（9个无API平台）
内容格式优化

阶段三：高级功能（1-2周）

目标：提升效率

高级功能：

发布队列管理
定时发布
发布数据分析
平台效果对比

方案二：全API集成（不推荐）❌

问题：

9个平台没有API或API支持有限
无法满足"覆盖14个平台"的需求
开发周期长，风险高

方案三：第三方服务集成（备选）

使用第三方服务：

如：新榜、微小宝、壹伴等第三方发布工具
优点：快速实现，支持平台多
缺点：
- 需要付费（100-500元/月/平台）
- 数据安全性问题
- 功能受限
- 可能不支持所有14个平台

⚠️ 主要挑战和风险

1. 平台API限制

问题：部分平台需要企业认证才能使用API
影响：个人用户无法使用自动发布
解决方案：提供手动发布指南，或仅支持有开放API的平台

2. 认证复杂度

问题：OAuth2.0流程复杂，需要用户授权
影响：用户体验可能不够流畅
解决方案：提供详细的授权指南，简化授权流程

3. 内容格式差异

问题：各平台对内容格式要求不同
影响：需要大量格式转换工作
解决方案：建立平台格式转换模板库

4. API稳定性

问题：平台API可能变更或限制
影响：需要持续维护
解决方案：建立API监控和错误处理机制

5. 合规风险

问题：自动发布可能违反平台规则
影响：账号可能被封禁
解决方案：
- 遵守平台发布频率限制
- 提供发布间隔设置
- 明确告知用户风险

💰 成本估算（20个平台）

开发成本

MVP版本（8个API平台 + 新增平台内容生成 + 基础一键复制）：4-5周（1个开发者）
完整版本（20个平台全覆盖）：10周（1个开发者）
维护成本：每月3-4天（API变更适配 + 平台规则更新 + 新增平台维护）

运营成本

API调用费用：
- 哔哩哔哩：免费
- 知乎：免费（可能有调用限制）
- 百家号：免费（需企业认证）
- 企鹅号：免费（需确认）
- 网易号：免费（需确认）
第三方服务：如使用第三方工具，可能需要付费（100-500元/月/平台）
企业认证费用：
- 百家号：可能需要企业认证（费用视情况而定）
- 企鹅号：可能需要企业认证

总成本估算

开发成本：8周 × 1开发者 = 约2个月
一次性成本：企业认证费用（如需要）
月度运营成本：0-500元（取决于是否使用第三方服务）

✅ 实施建议（20个平台）

技术选型建议

认证管理：
- 使用requests-oauthlib处理OAuth2.0
- Token存储在加密的数据库字段中
API调用：
- 使用httpx或requests进行HTTP请求
- 实现统一的API客户端基类
任务队列：
- 使用celery或简单的后台任务（Streamlit支持）
- 或使用asyncio实现异步发布
错误处理：
- 实现重试机制（exponential backoff）
- 详细的错误日志记录

📝 总结（20个平台）

可行性结论

✅ 可以实现，但需要混合方案：API集成 + 新增平台内容生成 + 一键复制

复杂度评估

总体复杂度：⭐⭐⭐⭐（高）
技术难度：中等-高
工作量：10周（完整版本，20个平台全覆盖）

平台覆盖情况

API直接集成：8个平台（GitHub、微信公众号、B站、知乎、CSDN、百家号、企鹅号、网易号）
一键复制功能：12个平台（头条号、小红书、抖音、简书 + 8个新增平台）
新增平台内容生成：8个平台（新浪博客、新浪新闻、搜狐号、QQ空间、邦阅网、一点号、东方财富、原创力文档）
覆盖率：100%（20/20）

关键成功因素

✅ 混合方案：API集成 + 新增平台内容生成 + 一键复制，确保20个平台全覆盖
✅ 清晰的平台API文档：8个API平台需要详细文档
✅ 完善的错误处理和重试机制：API发布需要
✅ 用户友好的账号配置界面：20个平台配置管理
✅ 详细的发布状态反馈：区分API发布和手动发布
✅ 遵守平台规则和限制：避免账号被封禁
✅ 新增平台内容生成：8个新增平台需要Prompt模板和格式适配
✅ 一键复制功能优化：提供平台特定的格式模板和发布指南

风险提示

⚠️ API状态不确定：企鹅号、网易号的API状态需要进一步确认
⚠️ 企业认证要求：百家号等平台可能需要企业认证
⚠️ 平台规则变化：各平台可能调整API或规则
⚠️ 开发周期：10周开发周期，需要合理安排资源
⚠️ 新增平台调研：8个新增平台的格式要求和发布规则需要详细调研

🔗 相关资源（14个平台）

API平台文档

其他平台

需要进一步调研的平台

搜狐号
一点号
东方财富
邦阅网
原创力文档

📋 实施检查清单

阶段一：基础架构 + 哔哩哔哩

数据库表设计（platform_accounts, publish_records等）
基础架构代码框架
哔哩哔哩API集成
OAuth2.0认证流程
内容格式转换（Markdown → B站格式）
发布功能测试

阶段二：B站 + 知乎 + CSDN + 新增平台内容生成

B站API集成
知乎API集成
CSDN API集成
新增平台内容生成开发（8个平台）
新增平台Prompt模板创建
发布状态跟踪

阶段三：百家号 + 企鹅号 + 网易号

百家号API集成（需企业认证）
企鹅号API集成（需确认API状态）
网易号API集成（需确认发布API）
企业认证流程（如需要）

阶段四：一键复制功能（12个平台）

原有平台一键复制（4个平台：头条号、小红书、抖音、简书）
新增平台一键复制（8个平台）
平台格式模板（标题、正文、标签等）
发布指南生成

阶段四：批量发布 + 优化

批量发布功能
发布队列管理
发布间隔控制
发布数据分析
用户界面优化
全面测试

报告生成时间：2025-01-26
更新说明：保留原有12个平台，新增8个平台，总计20个平台需要支持文章同步功能
分析基于：项目代码分析 + 平台API调研 + 最新平台政策

📌 重要说明

原有平台（12个）

已有内容生成功能
需要添加发布功能
部分平台已有API支持

新增平台（8个）

需要同时实现内容生成和发布功能
均无API支持，需使用一键复制方案
需要创建Prompt模板和格式适配

总计

20个平台需要支持文章同步功能
8个平台支持API直接发布
12个平台使用一键复制功能

25 KiB Raw Blame History Unescape Escape

自媒体平台文章同步功能分析报告（最终版）

📋 项目现状分析

当前功能

缺失功能

🎯 功能需求分析

核心需求

新增平台列表

总计平台数量

🔍 技术可行性分析（20个平台详细评估）

📊 平台分类总览

原有12个平台（已有内容生成，需添加发布功能）

新增8个平台（需添加内容生成 + 发布功能）

✅ 有官方API支持（可直接实现发布）

原有平台（5个）

新增平台（0个）

⚠️ API支持有限（需要特殊处理）

原有平台（7个）

新增平台（8个）

📊 平台分类汇总表

💡 实现复杂度评估（20个平台）

总体评估：高 ⭐⭐⭐⭐

复杂度分解

1. 基础架构 ⭐⭐⭐

2. 平台API集成 ⭐⭐⭐⭐⭐

3. 新增平台内容生成 ⭐⭐⭐

4. 一键复制功能 ⭐⭐⭐

5. 内容格式转换 ⭐⭐⭐⭐

6. 发布流程管理 ⭐⭐⭐⭐

7. 用户界面 ⭐⭐⭐

总工作量估算

📊 实现方案建议（针对20个平台）

方案一：混合方案（强烈推荐）⭐⭐⭐⭐⭐

阶段一：MVP版本（4-5周）

阶段二：完善版本（2-3周）

阶段三：高级功能（1-2周）

方案二：全API集成（不推荐）❌

方案三：第三方服务集成（备选）

推荐实施路径（详细）

第1-2周：基础架构 + GitHub + 微信公众号

第3-4周：B站 + 知乎 + CSDN

第5-6周：百家号 + 企鹅号 + 网易号

第7-8周：一键复制功能（12个平台）

第9-10周：批量发布 + 优化

⚠️ 主要挑战和风险

1. 平台API限制

2. 认证复杂度

3. 内容格式差异

4. API稳定性

5. 合规风险

💰 成本估算（20个平台）

开发成本

运营成本

总成本估算

✅ 实施建议（20个平台）

推荐实施路径（按优先级）

第一步：基础架构 + GitHub + 微信公众号（验证可行性）

第二步：B站 + 知乎 + CSDN（扩大覆盖）

第三步：百家号 + 企鹅号 + 网易号（完善API平台）

第四步：新增平台内容生成（8个平台）

第五步：一键复制功能（覆盖12个无API平台）

第六步：批量发布 + 优化（提升效率）

技术选型建议

📝 总结（20个平台）

可行性结论

复杂度评估

平台覆盖情况

推荐方案

关键成功因素

风险提示

🔗 相关资源（14个平台）

API平台文档

其他平台

需要进一步调研的平台

📋 实施检查清单

阶段一：基础架构 + 哔哩哔哩

阶段二：B站 + 知乎 + CSDN + 新增平台内容生成

阶段三：百家号 + 企鹅号 + 网易号

阶段四：一键复制功能（12个平台）

阶段四：批量发布 + 优化

25 KiB

Raw Blame History