wechat-mp-publisher
把文章交给 Agent，把发布控制留给你
先在本地校验和预览微信 HTML，再创建一个可审核的公众号草稿。
校验结构和危险标记。
在禁用脚本的沙箱中预览。
确认后只创建草稿。
最终发布仍由你在微信后台完成。
wechat-mp-publisher
公众号发布前，先在本地把 HTML 看清楚。
一个 npm 包，安装 Agent Skill，校验微信兼容性，并在隔离沙箱中预览文章。确认后只创建草稿。
$ wechat-mp-publisher validate demo.html
通过本地检查
- 错误0
- 警告0
- 根节点<section>
- 危险标记0
实际 demo 通过当前校验器。预览仍不会替代微信后台的手机预览。
CLI 不读凭证
不调用微信 API，预览可加载微信 CDN 图片
127.0.0.1
预览服务只监听本机
隔离沙箱
脚本、表单和 fetch 连接禁用
只建草稿
最终发布必须手动完成
一个包，两层职责。
本地工具与远程发布流程彼此分开。每一层只拿到它需要的权限。
Local CLI
安装、校验、预览
把 Skill 复制到受管目录，检查微信 HTML 的保守规则，并在沙箱 iframe 中打开本地预览。
validate article.html
preview article.html
用户明确确认
才能继续
才能继续
Agent Skill
传图、创建草稿
Agent 在运行时读取用户指定的凭证，调用微信官方 API 上传素材，并创建一个待审核草稿。
stable_token
draft/add
从文章到草稿，控制点清楚。
流程在本地检查后暂停。只有你确认预览，Agent 才进入远程写入阶段。
安装 Skill
用 npm CLI 写入选定的 Agent 目录。
准备 HTML
生成单一 <section> 根节点与内联样式。
校验并预览
修复错误，在本机沙箱查看真实文章。
明确确认
核对标题、摘要、图片和剩余警告。
创建草稿
上传并替换图片，通过 --final 校验后写入草稿箱。
装到你正在用的 Agent。
默认安装到共享 Agents 目录。也可以明确选择 OpenCode、Claude Code、Codex，或一次安装全部目标。
共享技能目录，适合多个 Agent 共用同一份安装。
$ npx wechat-mp-publisher@latest install --target agents
安装器拒绝覆盖非受管目录或符号链接，卸载也只删除由本包管理的安装。
你的 AppSecret 不应该出现在这个包里。
公共包不保存账号、AppID、AppSecret、access token 或密钥管理器记录。远程凭证只在获批的 Agent 运行时读取。
npm CLI
不读取微信凭证，不调用微信 API，不上传本地文章。
Agent Skill
本地预览确认后，才按用户已有的密钥来源执行远程草稿流程。
WeChat Admin
移动端预览与最终发布留在微信公众平台后台。
常见问题
npm 包会自动发布公众号文章吗？
不会。CLI 只安装 Skill、校验和预览本地 HTML。Agent 经确认后也只创建草稿，最终发布必须在微信后台手动完成。
支持哪些 Agent？
安装器支持共享 Agents、OpenCode、Claude Code 与 Codex 目录。也可以用 --target all 写入全部受管目标。
本地预览等于微信最终效果吗？
不等于。本地预览用于尽早发现结构和安全问题。创建草稿后，仍需在微信后台完成最终手机预览。
个人订阅号一定能用草稿接口吗？
不一定。接口权限取决于当前账号类型与微信平台配置。请先检查「接口权限与额度」，不要把 48001 当成可绕过的错误。
以前用 git clone 安装，怎么升级？
先检查并移走旧 clone，再运行 npm 安装命令。v2 会把旧目录视为非受管目录并拒绝覆盖，--force 也不会绕过这条边界。