AIWriteX - CrewAI微信公众号全自动生成排版发布工具

AIWriteX是一款基于 CrewAI 、AIForge 的微信公众号自动化工具软件，自动获取抖音、微博等平台热点，融合“搜索+借鉴+AI”，生成高时效（实时）、高质量、排版高大上的文章并发布到微信公众号。

想先看看效果？ 👉 文章预览
心动不如行动？ 👉 马上开始
喜欢这个项目？ ⭐ 点个 Star 支持一下吧！

💎 基本功能

• 自动获取热门话题：从各大平台实时抓取热门话题，确保文章标题及内容紧跟潮流
• 自动生成与排版：利用 CrewAI 多角色协作，自动生成文章并完成酷炫排版
  • 💡 实时性文章生成：采用AIForge多重搜索策略，拒绝过时内容，确保文章时效性
  • 💡 指定话题及参考文章：支持自定义文章话题、提供参考文章，结合 AI 生成高质量内容
• 自动发布图文：一键发布图文消息到微信公众号，简化运营流程
• UI 可视化管理：提供软件界面，操作简单高效
  • 💡 配置管理：配置项编辑更加清晰，简单易用
  • 💡 模板管理：支持模板的各种操作，增删查改等
  • 💡 文章发布管理：支持文章管理的各种操作、批处理、发布记录以及公众号选择等
  • 💡 配图管理：支持自定义设置文章的封面、配图等相关操作
• 支持两种运行模式：
  • 开发模式：适合技术用户，支持灵活定制开发，适配复杂需求
  • 软件模式：无需开发环境，安装软件并填写配置即可，适合非技术用户快速体验

个性化功能（配置）

通过 config.yaml 和 aiforge.toml 配置文件，实现高度个性化的功能（推荐使用界面/软件模式编辑配置），以下是关键配置项说明：

• config.yaml 配置项

配置项	说明
platforms	设置各平台热搜话题随机选取权重，控制选用优先级
wechat	支持配置多个微信公众号（自动发布时，必填appid、appsecret、author）
wechat.credentials	call_sendall、sendall、tag_id用来控制群发情况（仅适用于认证号）
api	支持多种大模型平台，必填api_key
api.api_type	支持多个大模型平台，修改 api_type 切换平台，如OpenRouter
api.OpenRouter.model_index	修改 model_index 选择平台内具体模型
api.OpenRouter.model	支持多种模型（如openrouter/deepseek/deepseek-chat-v3-0324:free）
api.OpenRouter.key_index	修改 key_index 切换账号（充分利用免费额度，付费账号无需多个）
api.OpenRouter.api_key	支持多个 OpenRouter api_key
img_api	图片生成模型，用于公众号封面图
img_api.api_type	ali（需要填写api_key）或picsum（随机图片）
img_api.picsum	随机图片生成方式，降低生成图片消耗
use_template	是否使用内置模板 ，不使用则AI根据要求直接生成文章HTML
template	指定模板文件名（如 template1），为空或不存在时随机选择
template_category	模板分类，精确匹配话题类型（如健康养生），需分类下存在指定模板
need_auditor	是否启用质量审核 agent/task，关闭可降低 token 消耗（默认关闭）
use_compress	是否压缩模板上传，降低 token 消耗
aiforge_search_max_results	AIForge 最大返回搜索结果条数，控制搜索广度
aiforge_search_min_results	AIForge 最小返回搜索结果条数，越大内容越丰富，但失败率越高
min_article_len	生成文章最小字数（默认 1000）
max_article_len	生成文章最大字数（默认 2000）
auto_publish	控制自动发布，勾选（true）自动发布，不勾选(false)需手动发布
article_format	生成文章格式（HTML、Markdown、txt）,非HTML时，只生成文章，不用模板
format_publish	当文章格式为Markdown、txt时（微信不支持，直接发布混乱），格式化发布

• aiforge.toml 配置项

配置项	说明
default_llm_provider	使用模型提供商（默认 OpenRouter），可与 CrewAI 使用的模型不同
api_key	模型提供商的 API Key（必填）
其他选填	根据需要配置其他参数（选填），具体参考 UI 界面说明

1、aiforge.toml详细配置信息，参见AIForge项目主页
2、通过配置管理界面，可以详细了解关键参数的解释说明（建议运行UI界面模式）
2、⚠️ 微信公众号AppID/AppSecret、大模型提供商的API KEY是必填项，其他均可默认

🚀 快速开始

开发模式

1. 克隆仓库：
   • git clone https://github.com/iniwap/AIWriteX.git
2. 安装依赖：

pip install uv
uv venv
uv pip install ./PySimpleGUI-4.60.5-py3-none-any.whl
uv pip install -r requirements.txt

3. 配置 config.yaml、aiforge.toml（微信公众号AppID/AppSecret、大模型提供商的API KEY）
4. 运行：
   • 有UI界面：python .\main.py -d (推荐)
   • 无UI界面：python -m src.ai_write_x.crew_main （不支持文章、模板、配图管理）

软件模式

1. 请从网盘下载AIWriteX_云盘版_Setup.exe 👇，并安装

网盘类型	下载链接	提取码	版本	是否最新	备注
百度网盘	点击下载	n4gx	V2.1.5	❌	搜索采用aipy版本，后续不再使用
移动云盘	点击下载	a6jk	V2.1.5	❌	搜索采用aipy版本，后续不再使用
Microsoft OneDrive	点击下载	/	V2.1.5	❌	搜索采用aipy版本，后续不再使用
Google Drive	点击下载	/	V2.1.5	❌	搜索采用aipy版本，后续不再使用
移动云盘	点击下载	upkj	V2.1.6	✅	采用强大的AIForge重构版本，后续沿用
Microsoft OneDrive	点击下载	/	V2.1.6	✅	采用强大的AIForge重构版本，后续沿用

2. 打开软件，进行必须要配置（微信公众号AppID/AppSecret、大模型提供商的API KEY）
3. 点击开始执行

🔍 问题定位

遇到问题时，请根据运行模式查看日志并提交 Issue。

开发模式

• 界面模式：
  • 检查 logs/ 目录下的日志文件，如 UI_2025-05-20.log
  • 复制相关日志内容，提交至 Issues
• 无界面模式：
  • 查看命令行输出日志，复制相关错误信息，提交至 Issues
• CrewAI 版本问题：
  • 不同 CrewAI 版本日志输出差异较大，建议临时切换到稳定版本查看详细过程日志：

    pip uninstall crewai
    pip install crewai==0.102.0

  • 如果问题仍未解决，提交日志至 Issues
  • 恢复最新版本：

    pip uninstall crewai
    pip install crewai

软件模式

• 打开软件界面，选择 文件 -> 日志 -> UI_2025-05-20.log（选择当天日志）
• 点击打开日志文件，复制内容，提交至 Issues

AIForge 相关问题

AIForge是我自研的类AIPy库（功能远超AIPy，强大到无法想象）

• 正常现象：
  • 并非所有话题都能搜索到结果，失败属正常，任务会继续执行
  • 搜索代码生成可能出现错误，可忽略（系统有自动纠错机制，后续运行会修复）
• 搜索缓存优化：
  • 搜索代码生成具有随机性，启用AIForge缓存模式(aiforge.toml``cache.codeenabled=True)时，多运行几次可提升效果
• 搜索引擎限制：
  • 由于搜索引擎限制或人工验证，偶尔搜索无结果，属正常现象，不影响整体运行
• ⚠️ OpenRouter 免费服务限制：
  • 免费 OpenRouter 可能不稳定，运行失败时建议等待用户较少时重试
  • 每个账号每日约支持 5 次执行，失败后请切换账号（修改 config.yaml 中的 api.OpenRouter.key_index）

⚠️ 注意：免费 OpenRouter 服务可能因高负载导致不稳定，请合理安排运行时间或切换账号以确保成功运行。

常见问题

请查看close(已关闭)的Issues，以便了解大家常遇到且已经解决的问题。

🔮 微信公众号模板效果预览

以下是精心微调、适配并发布的微信公众号模板，涵盖多个话题分类，欢迎预览！

内置本地模板列表

• 分类模板

类别	模板名称	预览链接	适用话题
科技数码	t1	点击预览	科技前沿与数码评测
财经投资	t1	点击预览	投资趋势与财经资讯
教育学习	t1	点击预览	学习方法与教育资讯
健康养生	t1	点击预览	健康生活小贴士分享
美食旅行	t1	点击预览	美食推荐与旅行攻略
时尚生活	t1	点击预览	时尚潮流与生活方式
职场发展	t1	点击预览	职场技能与职业规划
情感心理	t1	点击预览	情感故事与心理洞察
娱乐八卦	t1	点击预览	最新娱乐圈动态速递
新闻时事	t1	点击预览	全球热点与时事分析

• 其他模板

类别	模板名称	预览链接	适用话题
其他	template1	点击预览	通用模板，无风格限定
其他	template2	点击预览	通用模板，无风格限定
其他	template3	点击预览	通用模板，无风格限定
其他	template4	点击预览	通用模板，无风格限定
其他	template5	点击预览	通用模板，无风格限定
其他	template6	点击预览	通用模板，无风格限定
其他	template7	点击预览	通用模板，无风格限定
其他	template8	点击预览	通用模板，无风格限定
其他	template9	点击预览	通用模板，无风格限定
其他	template10	点击预览	通用模板，无风格限定

全自动发文效果预览

利用本地搜索与 AIForge 搜索生成时效性强的微信公众号文章效果预览：

类型	模板使用情况	预览链接	说明
自动发文	未使用模板	点击预览	AI根据要求生成文章，未使用本地模板
自动发文	使用 template9	点击预览	使用本地模板 template9，视觉效果优化
自动发文	使用 分类模板	点击预览	指定分类健康养生，完美呈现

浅色/暗色模式下微信显示的效果对比

类型	主题模式	预览链接	说明
手动发文	浅色	点击预览	浏览器最佳模板，但在手机上边距显得过大
手动发文	浅色	点击预览	统一调整边距后的效果，手机上看着更紧凑些，但丢失原来设计效果
手动发文	暗色	点击预览	原版为暗色，发到微信被强转（很难看），反而在浅色模式下正常显示

1、已适配模板可以比较好的显示在微信公众号上，有兴趣的可以继续微调内置模板（如边距等）
2、目前仅尚未适配下的模板未适配，需要适配才能完美显示（配置分类随机可能会随机到未适配模板）
3、目前模板无法很好的应对暗色模式，这和微信僵硬的处理有关

📢 后续计划

• 最近正在研发AIForge，AIWriteX新功能后续奉上（借助强大的AIForge），敬请期待
• 优化配图管理相关功能
• 陆续新增创意性功能，使得软件更好玩、更强大
• 增加功能，使输出效果更好（持续）
• 优化模板，减少token消耗（持续）
• 优化处理，减少不必要的token消耗（持续）
• 增加容错，提升成功率（持续）

📌 其他说明

关于微信公众号

以下是微信公众号开发及自动发文的问题说明：

• CSS 限制：
  • 微信发布文章时会移除 position: absolute（但保留 position: relative），需使用替代布局实现类似效果
  • 动画支持有限：animateMotion 可用，但 animate 仅支持透明度变化，需进一步测试（例如，template1 动画部分支持）
  • <button> 和 background: url 会被自动移除
  • <linearGradient id="catGradient"> 的 id 会被移除，导致动画失效
  • background: linear-gradient(90deg, #4b6cb7 0%, #ff9a9e 100%); -webkit-background-clip: text; color: transparent; 手机/电脑主题暗色模式不支持渐变，浅色模式支持
  • 微信暗色模式会自动添加js_darkmode__，会导致背景色失效，暗色模式效果均不佳（!important 强制不使用暗色模式无效，会自动移除）
• 暗色/浅色模式：目前生成更倾向于适用微信浅色模式，暗色模式效果稍差，后续需要找到二者更好的平衡点
• 文章显示问题：发布的文章（未认证公众号）不会显示在公众号文章列表，但关注者会收到通知（每日3篇）
• ⚠️ 权限回收：自 2025 年 7 月起，个人主体账号、未认证企业账号及不支持认证的账号将失去发布草稿权限，非认证公众号可能无法自动发文
• ⚠️ 微信公众号 IP 白名单问题：
  • 微信 API 需将当前 IP 添加至后台白名单
  • 动态 IP 需手动更新白名单，或使用固定 IP 的代理
  • 解决方案：使用云服务器转发请求，或通过阿里云函数计算（免费，需注册阿里云）代理微信 API 请求
• 公众号文章列表显示问题：
  • 未认证账号：API无法实现显示到公众号列表，只能通过后台操作
  • 认证账号：必须调用群发接口，才能显示到列表。is_to_all（True/False）以及不调用sendAll接口具体情况，请各位自行测试，支持配置这三种情况
  • is_to_all=False,且调用接口时，tag_id（用户标签群组ID）好像是必须填写
  • 关于此的 官方解释（愣是看的云里雾里，WDNMD，为什么会有这么逆天的产品）

⚠️ 注意：2025 年 7 月后，非认证账号可能将面临自动化发布限制（只能发布到草稿，需要后台操作发布草稿，发布后会显示到公众号文章列表）。

关于软件模式

软件模式为非技术用户提供快速体验：

• 安装软件：为支持软件模式，进行了大量调试。请点个 ⭐ 支持！
• IP 白名单：
  • 家庭网络动态 IP 需在微信后台手动更新白名单
  • 使用固定 IP 的代理可提升稳定性
• 无 UI 运行：在服务器上运行无需 UI 时，可删除 gui 和 main 代码，直接以非 UI 模式运行

⚠️ 注意：运行软件模式前，需确保 IP 已添加至微信后台白名单，否则 API 访问将失败。

关于DeepSeek

为了大家能用上DeepSeek，我怒冲10元进行适配调试，给个Star吧~🙏

• CrewAI框架默认不支持DeepSeek，需要手动创建（LiteLLM支持）
• DeepSeek在模板填充阶段速度较慢，请耐心等待（速度似乎不如OpenRouter的DeepSeek）
• 使用DeepSeek请注意费用消耗

🤝 贡献&致谢

贡献

• 提交代码以及优化建议，新功能等等
• 分享自动发文功能的新场景或改进点

感谢

• 感谢 AIForge开源库
• 感谢 ChatGPT、Grok、Gemini、Deepseek等
• 感谢所有贡献者和社区支持

📩 联系我们

如需了解配置详情或扩展、定制功能、商业授权，请联系QQ 522765228

📜 许可证 / License

本项目采用 Apache License 2.0 开源，并附带额外使用限制，详见 NOTICE 文件。