核心用法
web-publisher 是面向微信公众号内容运营者的自动化发布工具，通过对话式 CLI 实现「输入即发布」的极简工作流。核心能力覆盖三类场景：
1. URL 抓取发布：输入任意网页链接（公众号、知乎、今日头条、36kr、CSDN、小红书等），服务端自动提取正文、下载图片、生成微信图文草稿或直接发布
2. 本地文档转换：支持 PDF/DOCX/PPTX/XLSX/EPUB/图片/音频等格式，通过 Microsoft markitdown 引擎转为结构化 Markdown，可选 AI 改写后发布
3. 纯文档转换：convert 命令将任意文档转为 Markdown 本地保存，不触发发布
使用路径采用「对话式两步接入」：首次 login 生成浏览器授权链接，用户点击确认后 login-status 完成凭证落盘；公众号配置通过 wechat config 生成表单短链，AppSecret 浏览器直传服务端 AES-256-GCM 加密，永不进入对话上下文。专业版可配置页眉页脚（关注引导、文末二维码）自动拼接。
显著优点
- 零本地依赖：CLI 仅做 HTTP 调用和凭证管理，抓取/解析/改写/发布全在服务端完成，无需安装 Puppeteer、markitdown 等重型依赖
- 多格式原生支持：markitdown 后端支持 Office 全家桶、EPUB、图片 OCR、音频转录（需插件），单 skill 覆盖内容全链路
- AI 改写可控：
--rewrite支持 casual/formal/technical/creative 四档风格，或自定义 prompt，改写后自动处理微信图片上传和排版 - 主题化排版：6 套预设主题（墨黑/橙日/紫雨等），中文名自动映射，无需手写 CSS
- 安全设计：device_code 一次性消耗、apiKey 远端可撤销、本地凭证 0600 权限、AppSecret 浏览器直传加密
潜在局限与风险
- 反爬站点受限：服务端走云端固定 IP，小红书全站、部分知乎专栏、登录墙文章、海外站点常被 403/反爬拦截，需回退到用户本地
news-to-markdown-skill抓取 - 本地文件上限 50MiB：学术 PDF/扫描件需预处理或走
--async异步模式 - 发布额度计费：按任务消耗 credits，余额不足时中断，需额外充值
- IP 白名单强制依赖：微信公众号接口要求授权服务器 IP，用户需手动在 mp.weixin.qq.com 后台配置，无法绕过
- CLI 仅接受 URL：本地抓取的 Markdown 文件不能直接喂给
draft/publish，需等待服务端开放本地稿件入口或人工粘贴
适合人群
- 内容运营者：需批量迁移多平台文章至公众号的编辑者
- 知识管理用户：希望将 PDF/EPUB/会议录音转为可发布的图文
- AI Agent 工作流：配合
browser-web-search实现「搜索→筛选→改写→发布」全自动 pipeline
常规风险
- 凭证泄露：
~/.web-publisher/credentials.json包含 apiKey，需确保 0600 权限且不上传至公共仓库 - 误操作发布：默认
draft需用户明确说「发布」才执行publish，但 AI Agent 需严格遵守此约定 - 服务端依赖：tools.siping.me 可用性决定服务连续性，建议本地保留
convert输出的 Markdown 备份