https://github.com/iniwap/aiwritex
AIWriteX是基于CrewAI、AIForge的新一代智能内容创作平台，从微信公众号自动化工具起步，正在重新定义AI辅助内容创作的边界，融合"搜索+借鉴+AI+创意"四重能力，自动生成高时效、高质量、排版酷炫的多平台内容。
https://github.com/iniwap/aiwritex
agents ai-agents ai-auto-wxgzh ai-wx aipy aipyapp crewai freesimplegui mcp pysimplegui search-mcp search-tool web-search wechat weixin wx wx-template wxgzh
Last synced: about 1 month ago
JSON representation
AIWriteX是基于CrewAI、AIForge的新一代智能内容创作平台，从微信公众号自动化工具起步，正在重新定义AI辅助内容创作的边界，融合"搜索+借鉴+AI+创意"四重能力，自动生成高时效、高质量、排版酷炫的多平台内容。
- Host: GitHub
- URL: https://github.com/iniwap/aiwritex
- Owner: iniwap
- License: apache-2.0
- Created: 2025-04-02T07:28:12.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-09-05T07:50:33.000Z (about 1 month ago)
- Last Synced: 2025-09-05T09:30:56.434Z (about 1 month ago)
- Topics: agents, ai-agents, ai-auto-wxgzh, ai-wx, aipy, aipyapp, crewai, freesimplegui, mcp, pysimplegui, search-mcp, search-tool, web-search, wechat, weixin, wx, wx-template, wxgzh
- Language: Python
- Homepage:
- Size: 5.91 MB
- Stars: 304
- Watchers: 7
- Forks: 74
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Notice: NOTICE
Awesome Lists containing this project
README
# AIWriteX - 基于CrewAI的智能内容创作平台
     
**AIWriteX**是基于CrewAI、[AIForge](https://iniwap.github.io/AIForge/)的新一代智能内容创作平台，从微信公众号自动化工具起步，正在重新定义AI辅助内容创作的边界，融合"搜索+借鉴+AI+创意"四重能力，自动生成高时效、高质量、排版酷炫的多平台内容。
> **想先看看效果？** 👉 [文章预览](#-微信公众号模板效果预览)
> **心动不如行动？** 👉 [马上开始](#-快速开始)
> **喜欢这个项目？** ⭐ 点个 Star 支持一下吧！
## 💎 基本功能
- **自动获取热门话题**：从各大平台实时抓取热门话题，确保文章标题及内容紧跟潮流
- **自动生成与排版**：利用 CrewAI 多角色协作，自动生成文章并完成酷炫排版
- **💡 实时性文章生成**：采用AIForge多重搜索策略，拒绝过时内容，确保文章时效性
- **💡 指定话题及参考文章**：支持自定义文章话题、提供参考文章，结合 AI 生成高质量内容
- **自动发布图文**：一键发布图文消息到微信公众号，简化运营流程
- **UI 可视化管理**：提供软件界面，操作简单高效
- **💡 配置管理**：配置项编辑更加清晰，简单易用
- **💡 模板管理**：支持模板的各种操作，增删查改等
- **💡 文章发布管理**：支持文章管理的各种操作、批处理、发布记录以及公众号选择等
- **💡 配图管理**：支持自定义设置文章的封面、配图等相关操作
- **支持两种运行模式**：
- **开发模式**：适合技术用户，支持灵活定制开发，适配复杂需求
- **软件模式**：无需开发环境，安装软件并填写配置即可，适合非技术用户快速体验
## 核心特性（开发中）：
- 🤖 多智能体协作：基于CrewAI框架的研究员、作家、审核员、设计师团队协作
- 🔍 实时信息融合：集成AIForge引擎，自动获取全网热点与最新资讯
- 🎨 创意内容变换：支持文体转换、时空穿越、角色扮演等多种创意模式
- 📱 全平台发布：支持微信公众号、小红书、抖音、知乎等主流平台
- ⚡ 高时效性：融合"搜索+借鉴+AI"，生成实时性强的高质量内容
- 🎯 智能排版：自动生成酷炫排版，适配各平台展示特性
### 个性化功能（配置）
通过 `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](https://github.com/iniwap/AIForge)项目主页*
> *2、通过配置管理界面，可以详细了解关键参数的解释说明（建议运行UI界面模式）*
> *2、⚠️ 微信公众号AppID/AppSecret、大模型提供商的API KEY是必填项，其他均可默认*
## 🚀 快速开始
### 开发模式
1. 克隆仓库：
- `git clone https://github.com/iniwap/AIWriteX.git`
2. 安装依赖：
```shell
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` 👇，并安装
| 网盘类型 | 下载链接 | 提取码 | 版本 |是否最新 |
|-----------------------------|-------------------------------------------------------------------------------------------------------|--------|---------|------------|
| **百度网盘** |[Win](https://pan.baidu.com/s/1BVRdcA0y2BtiO8Zrz3SfkA?pwd=nktk) / [Mac](https://pan.baidu.com/s/1MxuIbi2SQrcvWHSkGm5WGw?pwd=dsey) |nktk / dsey |V2.1.9 |✅ |
| **Google Drive** |[Win](https://drive.google.com/file/d/1gTPITXPk6aw_xwU-MWzQ_vH2nHbSYG-K/view?usp=sharing) |/ |V2.1.9 |✅ |
| **移动云盘** |[Win](https://caiyun.139.com/w/i/2prAJy9hSHNw0) |e9q9 |V2.1.9 |✅ |
| **Microsoft OneDrive** |[Win](https://1drv.ms/u/c/c831e3cc9be11110/EdisfnmwKsJHp0dZqMjungsBrFxXSCwfwAaUydzeiEmGmw?e=GdOhHT)|/ |V2.1.9 |✅ |
2. 打开软件，进行必须要配置（*微信公众号AppID/AppSecret、大模型提供商的API KEY*）
3. 点击`开始执行`
## 🔍 问题定位
遇到问题时，请根据运行模式查看日志并提交 Issue。
### 开发模式
- **界面模式**：
- 检查 `logs/` 目录下的日志文件，如 `UI_2025-05-20.log`
- 复制相关日志内容，提交至 [Issues](https://github.com/iniwap/AIWriteX/issues)
- **无界面模式**：
- 查看命令行输出日志，复制相关错误信息，提交至 [Issues](https://github.com/iniwap/AIWriteX/issues)
- **CrewAI 版本问题**：
- 不同 CrewAI 版本日志输出差异较大，建议临时切换到稳定版本查看详细过程日志：
```shell
pip uninstall crewai
pip install crewai==0.102.0
```
- 如果问题仍未解决，提交日志至 [Issues](https://github.com/iniwap/AIWriteX/issues)
- 恢复最新版本：
```shell
pip uninstall crewai
pip install crewai
```
### 软件模式
- 打开软件界面，选择 `文件 -> 日志 -> UI_2025-05-20.log`（选择当天日志）
- 点击打开日志文件，复制内容，提交至 [Issues](https://github.com/iniwap/AIWriteX/issues)
### AIForge 相关问题
**[AIForge](https://github.com/iniwap/AIForge)是我自研的类AIPy库（功能远超AIPy，强大到无法想象）**
- **正常现象**：
- 并非所有话题都能搜索到结果，失败属正常，任务会继续执行
- 搜索代码生成可能出现错误，可忽略（系统有自动纠错机制，后续运行会修复）
- **搜索缓存优化**：
- 搜索代码生成具有随机性，启用AIForge缓存模式(`aiforge.toml``cache.code`enabled=True)时，多运行几次可提升效果
- **搜索引擎限制**：
- 由于搜索引擎限制或人工验证，偶尔搜索无结果，属正常现象，不影响整体运行
- **⚠️ OpenRouter 免费服务限制**：
- **免费 OpenRouter 可能不稳定**，运行失败时建议等待用户较少时重试
- 每个账号每日约支持 5 次执行，失败后请切换账号（修改 `config.yaml` 中的 `api.OpenRouter.key_index`）
> **⚠️ 注意**：免费 OpenRouter 服务可能因高负载导致不稳定，请合理安排运行时间或切换账号以确保成功运行。
### 常见问题
请查看`close`(已关闭)的[Issues](https://github.com/iniwap/AIWriteX/issues?q=is%3Aissue%20state%3Aclosed)，以便了解大家常遇到且已经解决的问题。
## 🔮 微信公众号模板效果预览
以下是精心微调、适配并发布的微信公众号模板，涵盖多个话题分类，欢迎预览！
### 内置本地模板列表
- 分类模板
| 类别 | 模板名称 | 预览链接 | 适用话题 |
|------------|----------|------------------------------|--------------------------|
| 科技数码 | t1 | [点击预览](https://mp.weixin.qq.com/s/UCjBHaZ_EZVBdEaSEH-6mQ) | 科技前沿与数码评测 |
| 财经投资 | t1 | [点击预览](https://mp.weixin.qq.com/s/uTfYVXUG3_bjqSZ-uuJKeg) | 投资趋势与财经资讯 |
| 教育学习 | t1 | [点击预览](https://mp.weixin.qq.com/s/DOr7sSBQ2sYSqu4WmlH__g) | 学习方法与教育资讯 |
| 健康养生 | t1 | [点击预览](https://mp.weixin.qq.com/s/ZG6SFUYSZlrxyRw6_GH9yg) | 健康生活小贴士分享 |
| 美食旅行 | t1 | [点击预览](https://mp.weixin.qq.com/s/Lw29haJDk4uKODh7rlBOrw) | 美食推荐与旅行攻略 |
| 时尚生活 | t1 | [点击预览](https://mp.weixin.qq.com/s/ZgeIbl7l0KC1ex9ybrZBRg) | 时尚潮流与生活方式 |
| 职场发展 | t1 | [点击预览](https://mp.weixin.qq.com/s/-jJ-OxCr7BMaaYY68vSecQ) | 职场技能与职业规划 |
| 情感心理 | t1 | [点击预览](https://mp.weixin.qq.com/s/2j-C1tBWkpYIQhhR6tOwSg) | 情感故事与心理洞察 |
| 娱乐八卦 | t1 | [点击预览](https://mp.weixin.qq.com/s/3YeEH2Nvhsw8JqHIV0tftQ) | 最新娱乐圈动态速递 |
| 新闻时事 | t1 | [点击预览](https://mp.weixin.qq.com/s/M_l2LCJjiGmCWRvSm7lYvA) | 全球热点与时事分析 |
- 其他模板
| 类别 | 模板名称 | 预览链接 | 适用话题 |
|------------|------------|------------------------------|--------------------------|
|其他 | template1 | [点击预览](https://mp.weixin.qq.com/s/9MoMFXgY7ieEMW0kqBqfvQ) | 通用模板，无风格限定 |
|其他 | template2 | [点击预览](https://mp.weixin.qq.com/s/0vCNvgbHfilSS77wKzM6Dg) | 通用模板，无风格限定 |
|其他 | template3 | [点击预览](https://mp.weixin.qq.com/s/ygroULs7dx5Q54FkR8P0uA) | 通用模板，无风格限定 |
|其他 | template4 | [点击预览](https://mp.weixin.qq.com/s/-SexfJ1yUcgNDtWay3eLnA) | 通用模板，无风格限定 |
|其他 | template5 | [点击预览](https://mp.weixin.qq.com/s/pDPkktE_5KnkQkJ1x2-y9Q) | 通用模板，无风格限定 |
|其他 | template6 | [点击预览](https://mp.weixin.qq.com/s/7F_Qdho-hzxeVV6NrsPmhQ) | 通用模板，无风格限定 |
|其他 | template7 | [点击预览](https://mp.weixin.qq.com/s/ug7NseZDziDMWBVwe3s1pw) | 通用模板，无风格限定 |
|其他 | template8 | [点击预览](https://mp.weixin.qq.com/s/uDjKVrWop4XNrM-csQ-IKw) | 通用模板，无风格限定 |
|其他 | template9 | [点击预览](https://mp.weixin.qq.com/s/EVhL67x8w35IuNnoxI1IEA) | 通用模板，无风格限定 |
|其他 | template10 | [点击预览](https://mp.weixin.qq.com/s/pDN5rgCgz0CbA8Q92CugYw) | 通用模板，无风格限定 |
### 全自动发文效果预览
利用本地搜索与 AIForge 搜索生成时效性强的微信公众号文章效果预览：
| 类型 | 模板使用情况 | 预览链接 | 说明 |
|----------------|--------------|------------------------------|--------------------------------|
| 自动发文 | 未使用模板 | [点击预览](https://mp.weixin.qq.com/s/KI4yHYrjAt8hd_nUEZP8kA) | AI根据要求生成文章，未使用本地模板 |
| 自动发文 | 使用 template9 | [点击预览](https://mp.weixin.qq.com/s/1XPMUPR09Ipuzm_yXgAvKw) | 使用本地模板 template9，视觉效果优化 |
| 自动发文 | 使用 分类模板 | [点击预览](https://mp.weixin.qq.com/s/Dys7eszxP33k6tonXMO1VA) | 指定分类`健康养生`，完美呈现 |
### 浅色/暗色模式下微信显示的效果对比
| 类型 | 主题模式 | 预览链接 | 说明 |
|----------------|--------------|---------------------------------------------------------|--------------------------------------------|
| 手动发文 | 浅色 | [点击预览](https://mp.weixin.qq.com/s/GOiOxGiym1dgqA77wrrFLw) |浏览器最佳模板，但在手机上边距显得过大 |
| 手动发文 | 浅色 | [点击预览](https://mp.weixin.qq.com/s/MFKPQIBdldyC_dxcpooOSw) |统一调整边距后的效果，手机上看着更紧凑些，但丢失原来设计效果 |
| 手动发文 | 暗色 | [点击预览](https://mp.weixin.qq.com/s/jOWDpRSAw9twSptzZbBODg) |原版为暗色，发到微信被强转（很难看），反而在浅色模式下正常显示 |
> *1、已适配模板可以比较好的显示在微信公众号上，有兴趣的可以继续微调内置模板（如边距等）*
> *2、目前仅**尚未适配**下的模板未适配，需要适配才能完美显示（配置**分类随机**可能会随机到未适配模板）*
> *3、目前模板无法很好的应对暗色模式，这和微信僵硬的处理有关*
## 📢 后续计划
- **最近正在研发[AIForge](https://iniwap.github.io/AIForge)，AIWriteX新功能后续奉上（借助强大的AIForge），敬请期待**
- 优化配图管理相关功能
- 陆续新增创意性功能，使得软件更好玩、更强大
- 增加功能，使输出效果更好（持续）
- 优化模板，减少token消耗（持续）
- 优化处理，减少不必要的token消耗（持续）
- 增加容错，提升成功率（持续）
## 📌 其他说明
### 关于微信公众号
以下是微信公众号开发及自动发文的问题说明：
- **CSS 限制**：
- 微信发布文章时会移除 `position: absolute`（但保留 `position: relative`），需使用替代布局实现类似效果
- 动画支持有限：`animateMotion` 可用，但 `animate` 仅支持透明度变化，需进一步测试（例如，template1 动画部分支持）
- `` 和 `background: url` 会被自动移除
- `` 的 `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）好像是必须填写
- 关于此的 [官方解释](https://developers.weixin.qq.com/doc/service/guide/product/message/Batch_Sends.html)（愣是看的云里雾里，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](https://github.com/iniwap/AIForge)开源库
- 感谢 ChatGPT、Grok、Gemini、Deepseek等
- 感谢所有贡献者和社区支持
## 📩 联系我们
如需了解配置详情或扩展、定制功能、商业授权，请联系QQ 522765228
## 📜 许可证 / License
本项目采用 [Apache License 2.0](./LICENSE) 开源，并附带额外使用限制，详见 [NOTICE](./NOTICE) 文件。