rss-to-wechat

# RSS to WeChat | RSS 转微信公众号 将 RSS 文章或任何网页内容转换为微信公众号兼容的 HTML 格式。 ## 快速开始 ```bash # 检查配置和依赖 bash scripts/rss-to-wechat.sh --check # 处理文章 bash scripts/rss-to-wechat.sh --url "https://example.com/article" # 自动选择最新文章（需要 blogwatcher） bash scripts/rss-to-wechat.sh --auto ``` ## 配置 首次使用： ```bash # 复制配置示例 cp references/config.example.sh config.local.sh # 编辑配置 nano config.local.sh ``` 最小配置： ```bash WECHAT_APPID="你的AppID" WECHAT_APPSECRET="你的AppSecret" BRAND_NAME="你的品牌名称" ``` ## 工作流程 1. **数据准备**（自动） - 脚本获取并解析文章 - 提取标题、作者、内容 - 保存为 JSON 2. **HTML 生成**（AI 辅助） - AI 助手生成微信兼容的 HTML - 使用品牌配置 - 遵循严格的格式要求（见 `references/html-template.md`） 3. **封面生成**（可选） - 如果配置了 `COVER_SKILL` - 生成 1283×383 封面图 4. **发布**（可选） - 如果配置了微信凭证 - 通过 API 上传到草稿箱 ## 微信 HTML 格式要求 微信 API 对 HTML 格式有严格要求： **必须使用：** - `<section>` 和 `<p>` 标签（不用 `<div>`） - 内联样式 `style="..."` - `<strong>` 和 `<em>` 标签 - 完整 URL（不用相对链接） **禁止使用：** - `class` 或 `id` 属性 - 外部 CSS - JavaScript - 相对链接 详见 `references/html-template.md` 查看完整模板和示例。 ## 脚本 所有脚本位于 `scripts/` 目录： - `rss-to-wechat.sh` - 主入口 - `parse-article.sh` - 文章内容提取 - `format-wechat.sh` - HTML 格式化（已弃用，使用 AI 生成） - `config.sh` - 默认配置 - `test.sh` - 依赖检查 ## 参考文档 - `references/USER_GUIDE.md` - 完整用户文档 - `references/html-template.md` - 微信 HTML 模板和样式指南 - `references/config.example.sh` - 配置示例（包含所有选项） ## 依赖 **必需：** - `curl` - HTTP 请求 - `jq` - JSON 处理 - `pandoc` - 格式转换 **可选：** - `blogwatcher` - RSS 订阅管理（用于 --auto 模式） - 自定义封面生成脚本 - 自定义发布脚本 ## 配置选项 查看 `references/config.example.sh` 了解所有可用选项： - RSS 源和过滤条件 - 品牌定制（名称、标语、颜色） - 路径配置 - 外部工具集成 - 关键词过滤 ## 故障排除 **错误 45166（invalid content）** - 检查 HTML 格式是否符合要求 - 确保所有样式都是内联的 - 移除 class/id 属性 - 参考成功案例 **文章解析失败** - 检查 URL 是否可访问 - 确认没有反爬虫措施 - 尝试手动提取内容 **配置问题** - 运行 `bash scripts/rss-to-wechat.sh --check` - 确认所有必需工具已安装 - 检查微信凭证 ## 注意事项 - 此 skill 提供数据准备和指导 - AI 助手根据模板生成最终 HTML - 手动 HTML 生成已弃用（因微信格式要求严格） - 本地配置（`config.local.sh`）不会提交到 git