SuperAPI AI 工具集

zhy-wechat-writing

写作与研究

查看项目

更新于 10-15 18:17

技能介绍

用途

本技能用于根据用户提供的主题(可选参考 URL),自动完成公众号文章写作全流程:多来源检索与证据池整理、初稿生成、自审润色、参考资料整理,并可选自动配图与保存到公众号草稿箱(不提交发布)。

主要能力与工作流程

流程按顺序执行,产物默认落盘到 articles/<slug>/... 目录,便于复跑与追溯:

  • Phase 0 Preflight:确定可稳定复用的目录与路径规范。计算 slug:用户提供则直接使用(推荐英文/拼音 kebab-case);topic 含拉丁字母/数字则做 kebab-case;否则降级为 wechat-article-YYYYMMDD。创建 articles/<slug>/ 与 articles/<slug>/sources/。要求 Markdown 图片引用使用相对路径与 / 分隔符。
  • Step 1 素材搜集:用户提供 urls 时并行使用 webfetch 获取内容并提取要点,记录 URL 与可获得的发布日期;未提供则并行使用 WebSearch 做多来源检索(覆盖官方文档、X、Reddit、技术论坛、微信公众号、工程实践等)。合并去重后按可信度分级(high/medium/low),形成证据池并落盘到 articles/<slug>/sources/evidence.md。条目包含 title、url、published_at、source_type、key_takeaways、confidence。
  • Step 2 初稿生成:标题可使用数字型、提问型、对比型、悬念型等技巧;开头提出痛点或悬念并明确价值;正文用小标题分段,每段 200-300 字,包含案例与数据,使用列表增强可读性;结尾总结观点并引导互动。字数要求 1500-2500 字。关键事实需可在证据池找到支撑,文末追加 ## 参考资料/来源(5-10 条链接)。保存到 articles/<slug>/article.md。
  • Step 3 智能审稿:从逻辑(30%)、表达(25%)、数据(25%)、结构(20%)四个维度审稿,并做可追溯性与标题一致性检查。评分 90-100 可直接发布,80-89 小幅优化,70-79 需修改,70 以下需重写。建议保存到 articles/<slug>/sources/review.md。
  • Step 4 润色打磨:去除 AI 痕迹(如将“综上所述”替换为“总的来说”等)、增强口语化、优化节奏、根据审稿报告修复问题。强制保留或补齐 ## 参考资料/来源,建议保留 5-10 条并按 official / community / practice 分组。
  • Step 5 保存与输出:保存文章并输出执行摘要,包含 article_path、sources_path、字数统计、审稿评分。
  • Step 6 自动配图(可选,调用 zhy-article-illustrator):触发条件 with_illustrations=true。为文章生成统一风格配图并产出插图版文章,产物包括 article.illustrated.md 与 illustrations/ 目录下的 visual-bible.md、outline.md、prompts/ 等。单张失败可重试一次,仍失败则记录并继续,最终输出失败清单。
  • Step 7 HTML 主题样式输出(可选,调用 zhy-markdown2wechat):触发条件 with_html_theme=true。将 Markdown 转换为带微信内联样式的 HTML,输出 article.zhy.html。脚本零依赖(纯 Node.js),无需 npm install。
  • Step 8 保存到公众号草稿箱(可选,调用 zhy-wechat-publish):触发条件 post_to_wechat=true。通过微信官方 API 保存到草稿箱,不做最终发布提交。前置条件包括 .env 配置 WECHAT_APP_ID 与 WECHAT_APP_SECRET、运行机器公网 IP 已加入白名单等。

使用方式

执行前需确认:用户已提供文章主题(topic);如有参考文章 URL 可一并提供(urls);若 topic 为纯中文且未提供 slug,建议补充英文/拼音 kebab-case 目录名。输入示例可包含 topic、urls、search_count 以及 with_illustrations、with_html_theme、post_to_wechat 等开关。输出包含 article_path、sources_path、illustrated_article_path、illustrations_dir、html_article_path、word_count、review_score、wechat_draft_status 等字段。

适用场景

用户请求“写一篇关于 XXX 的公众号文章”、请求“生成公众号文章,主题是 XXX”、需要完整的公众号文章创作流程,或希望“写完后自动配图”或“写完后发到公众号草稿箱”。

限制与注意事项

文章风格应符合公众号调性:轻松、有用、有共鸣;避免敏感内容和过度营销;保持原创性,不要直接复制素材内容。草稿保存后不会自动提交发布,需人工在公众号后台确认;标题长度不得超过 64 字符。使用 publish_with_cover.js 时本机需可用 bun。若当前环境没有可用生图配置,优先改用 wechat_draft.js 直接上传 HTML。