核心用法
web-publisher 是一款面向微信公众号运营者的自动化发布工具，支持两种内容来源：
1. URL 抓取：输入任意网页链接，自动提取正文、图片，可选 AI 改写后发布到公众号草稿或直接发布
2. 本地文档：支持 PDF/DOCX/PPTX/XLSX/EPUB/图片/音频等格式，默认版式保留（PDF 逐页转图），也可提取文字生成可编辑文章
关键操作模式：
draft <url|file>：默认存草稿，安全可控publish <url|file>：仅当用户明确说"发布"时才使用convert <input>：纯文档转 Markdown，不发布
AI 改写能力：免费/入门版走分段伪改写，专业版及以上走 DeepSeek 原创合成引擎，支持自定义风格（casual/formal/technical/creative）、封面图生成、图片水印智能识别替换。
显著优点
- 零本地依赖：抓取/转换/改写/发布全在服务端完成，CLI 仅做 HTTP 调用，不装任何 npm 包
- 对话式配置：登录、公众号授权均通过浏览器跳转完成，AI Agent 自动处理流程
- PDF 双模式：默认版式保留（适合扫描件/精美排版），可选文字提取（适合可编辑需求）
- 主题系统：内置 6 套视觉主题（墨黑/橙日/紫雨等），一键切换
- 页眉页脚：专业版可配置自动拼接关注引导、文末二维码
- 安全设计：AppSecret 浏览器直传服务端 AES-256-GCM 加密，永不出现在对话中
潜在缺点与局限性
- 反爬限制：服务端走固定云 IP，小红书、部分知乎专栏、登录墙文章、海外站点常被 403，需配合本地
news-to-markdown-skill作为回退 - 文件大小限制：本地文件上限 50 MiB，超大 PDF 需裁剪或走异步模式
- 微信生态绑定：仅支持微信公众号，其他平台（知乎/头条等）需另寻工具
- 额度消耗：AI 改写、封面图生成、图片重绘均按调用计费，需关注余额
- IP 白名单门槛：新手易漏配微信后台 IP 白名单，导致发布失败
适合人群
- 自媒体运营者：需高频转载/二次创作内容的公众号主
- 企业内容团队：批量处理 PDF 报告、PPT 转公众号图文
- AI Agent 用户：通过 Cursor/Hermes/OpenClaw 等工具链自动化内容工作流
- 技术写作者：快速将文档、论文转为可发布的公众号格式
常规风险
| 风险点 | 说明 | 缓解措施 |
|--------|------|---------|
| 内容抓取失败 | 反爬站点返回 403/内容为空 | 切本地 `news-to-markdown-skill` 用真实 Chrome + 本机 IP 抓取 |
| 图片失效 | 外部图床 24h 过期或被防盗链 | v0.9.7+ 服务端自动转存本地图床 |
| 版权争议 | AI 改写可能涉及洗稿风险 | 保留原文溯源链接，人工复核后发布 |
| 额度误消耗 | 重复调用或超时重试 | 单次任务耗时 30s-5min，勿手动重试；用 `status <jobId>` 查进度 |
| 凭证泄露 | 本地 credentials.json 权限不当 | 文件 mode 0600，勿上传至代码仓库 |
---
版本: 0.9.13
作者: Ping Si <sipingme@gmail.com>
源码: github.com/sipingme/web-publisher-skill