微信公众号同步插件配置指南
如何使用 WorkBuddy 配置 Halo 的 MCP 连接器

更新日志

新增

• 任务记录新增 draftAction（update / create）：记录本次同步实际执行的动作并落库。

修复

• 更新草稿被网关 / WAF 拦截（如 501）时整次同步失败 → 自动改为新建，同步可正常完成。

优化

• 列表项行内内容补段落包裹避免微信拆行。

MCP

• wechat_sync_submit：移除 draftAction（只是提交时的预判，执行阶段可能回退），说明改为「预计…」并指向状态查询。
• wechat_sync_status：按 draftAction 回报实际动作，描述 / 字段说明 / 结果文本都要求 AI 照字段作答。
• 四个工具的描述、字段说明与结果文本精简为「做什么 + 字段含义 + 一条指令」。

Full Changelog: 1.9.0...1.9.1

---

Generated from 1.9.1

微信公众号同步插件配置指南
如何使用 WorkBuddy 配置 Halo 的 MCP 连接器

更新日志

新功能

• 重复同步更新草稿：首次同步新建草稿；再次同步先检查上次那份草稿是否还在——在就更新（草稿 ID 不变，不会堆重复草稿），不在就新建。检查出错也按「不在」处理，不中断同步。
• 开关：设置 → 微信公众号 → 重复同步更新草稿（默认开启）；关闭后每次都新建。

MCP

• 提交工具新增 draftAction：本次是更新（update）还是新建（create），提交时实查微信确认，AI 照它回答即可。
• 预览：图片/链接补全为完整地址，样式内联在元素上（去掉 <style> 块），客户端清洗或 AI 转述时不再散架；并明确要求「原样输出，不要改写」。
• 工具、字段与设置项文案统一精简。

升级注意

• 反向代理需补放行 /cgi-bin/draft/get、/cgi-bin/draft/update（共 7 个路径，见 README）。不放行也不会失败，只是退化为每次都新建草稿，草稿箱会攒下重复草稿。

Full Changelog: 1.8.2...1.9.0

---

Generated from 1.9.0

微信公众号同步插件配置指南
如何使用 WorkBuddy 配置 Halo 的 MCP 连接器

更新日志

• style(ui): 优化同步预览对话框视觉配色
• feat(mcp): 内嵌公共样式并明确计字口径
  • 确保 MCP 客户端正确渲染预览内容

Full Changelog: 1.8.1...1.8.2

---

Generated from 1.8.2

微信公众号同步插件配置指南

更新日志

• feat(ui): 优化同步预览弹窗加载与渲染

Full Changelog: 1.8.0...1.8.1

---

Generated from 1.8.1

微信公众号同步插件配置指南

更新日志

本次升级要点

本次更新以微信素材缓存体系为主线：新增素材上传缓存，避免同一张图反复上传挤占微信素材库；配套补齐了缓存库的自动备份、每日清理、失效自愈与凭据脱敏；同时新增「一级标题对齐方式」配置项，并在同步任务记录中留存文章标题。

• 重复同步同一篇文章时，图片上传次数显著下降，微信素材库占用更可控
• 缓存库有了备份与自动回收，长期运行不再无限增长
• 封面素材在微信侧被删除导致的 40007 失败，现在能自动自愈
• 日志与任务失败原因中的 access_token 等凭据已脱敏，避免凭据泄露

新增功能

1. 微信素材上传缓存

• 按文件内容指纹缓存已上传素材，同一份文件只向微信上传一次，之后直接复用 media_id / 图片地址
• 命中缓存后仍会校验资源是否真实存在：
  • 正文图片：校验微信图片地址（HEAD 请求，不走代理）
  • 永久素材：用 material/get_material 查询素材本身
• 校验结果为三态（明确存在 / 明确不存在 / 无法判定），只有「明确存在」才复用；失效或判定不出结论时重新上传，宁可多传一份，也不让草稿发不出去
• 新增接口调用支持。若启用代理，请同步配置 material/get_material 接口的代理规则。

2. 媒体缓存库每日自动备份

• 时间：每天 1 点
• 方式：SQLite VACUUM INTO 生成一致快照
• 位置：<插件数据目录>/backups
• 轮转：只保留最新 3 份
• 备份失败仅记录日志，不影响缓存读写与文章同步

3. 新增 MCP 工具

工具（本地名）	类型	参数	说明
wechat_sync_preview	只读	postName	获取预览信息：按与同步一致的规则美化正文，返回美化后的正文 HTML、上传后实际使用的标题（64 字上限）、摘要（120 字）、作者（8 字）、原文链接（阅读原文）与留言设置，以及因超过微信长度上限被截断的字段名；不调用微信接口、不写任何数据，可反复调用
wechat_sync_submit	写操作	postName	提交同步到微信：先做提交前预检（微信配置、封面图、文章是否正在同步中），通过后创建后台同步任务并立即返回；同步时封面与正文图片会自动转存到微信素材库、正文按公众号排版美化，完成后可在公众号草稿箱看到草稿
wechat_sync_status	只读	postName	查询同步状态：返回该文章最近一次同步的状态与说明——PENDING（已提交、正在后台执行）/ SUCCESS（已写入公众号草稿箱）/ FAILED（失败，message 为微信返回的失败原因）/ NONE（尚未同步过）；只读取任务记录，不调用微信接口、不写任何数据，提交同步后可用它轮询结果
wechat_cache_cleanup	写操作	无	清理素材缓存：立即执行一次素材缓存清理（与每天 0 点的计划任务同一套规则），返回本次删除条数与生效的保留策略——deletedRecords（删除条数）、remainingRecords（剩余记录数）、retentionDays（生效的保留策略：保留天数，如 "30"；「全部保留」时为 never）、cutoff（判定时间）；只删除「超过保留期且最近未被使用」的记录，仍被复用的缓存不会误删，也不影响每天 0 点的自动清理

4. 支持配置一级标题（H1）对齐方式

• 配置项：正文美化 → 一级标题对齐方式（h1Align）
• 取值：左对齐 / 居中 / 右对齐，默认居中
• 正文中 H1 若已自带对齐方式（行内 text-align 或 align 属性），保持原样，本项不生效

5. 任务记录留存提交时的文章标题

• 任务落到终态（SUCCESS / FAILED）后，输入快照会被清空以释放正文 HTML 占用的数据库空间
• 文章标题现独立保存在任务记录 spec.postTitle 上，快照清空后仍能在任务列表里认出「这条任务是哪篇文章」

问题修复

• 凭据可能写入日志与任务失败原因：新增脱敏处理，access_token、secret、appsecret、authorization、sign、password 等键的值统一替换为 ***；接口名与参数名保留，不影响排查。appid 为公开标识，不做脱敏

升级注意事项

• 目录权限：新增 SQLite 缓存库与 backups 备份目录，插件数据目录需具备写权限；备份轮转只保留 3 份，磁盘占用可控
• 容器部署确认时区：清理（0 点）与备份（1 点）按 JVM 本地时间触发，请确保容器的 TZ / 系统时区设置正确，否则会按 UTC 执行
• 反向代理需放行 material/get_material：未放行时永久素材校验会「无法判定」，插件将保守地重新上传封面——功能不受影响，但会增加素材库占用与上传耗时
• 日志中的凭据已脱敏：access_token 等显示为 ***，属预期行为，非异常
• MCP 客户端可接入
• 无需数据迁移：缓存库为空时会自动建立，并在首次同步中填充，不影响已有同步任务记录

Full Changelog: 1.7.0...1.8.0

---

Generated from 1.8.0

微信公众号同步插件配置指南

更新日志

• docs: 补充微信接口错误码速查文档
• feat: 支持草稿字段超长截断与预览标识
  • 标题：64字
  • 作者：8字
  • 摘要：120字
  • 计数规则：按微信计数规则计算
• feat: 不可上传微信的附件，直接显示链接名或链接地址
  • 配置入口：插件配置 → 正文美化 → 附件链接显示
  • 显示方式：纯文本形式，不含其他内容
• fix(beautifier): 压紧列表结构避免微信生成空列表项

Full Changelog: 1.6.2...1.7.0

---

Generated from 1.7.0

微信公众号同步插件配置指南

更新日志

• fix(client): 按真实字节判定 WebP 避免素材上传失败

Full Changelog: 1.6.1...1.6.2

---

Generated from 1.6.2

微信公众号同步插件配置指南

更新日志

• feat(sync): 添加文章删除事件监听器以清理同步记录

Full Changelog: 1.6.0...1.6.1

---

Generated from 1.6.1

微信公众号同步插件配置指南

更新日志

• feat(sync): 实现同步任务持久化与重启自动恢复
  • 引入 WechatSyncTask 自定义模型替代 ConfigMap 存储同步状态
  • 任务记录包含输入快照，支持插件重启后自动重放未完成任务
  • 支持在 Data Studio（数据工厂） 中查看同步记录
  • 升级后数据自动迁移，不会丢失

Full Changelog: 1.5.6...1.6.0

---

Generated from 1.6.0

微信公众号同步插件配置指南

更新日志

• feat(content): 添加微信任务列表重建功能
  • 待办清单添加 Emoji 图标支持，已完成显示 ✅，未完成显示 ⬜
• feat(content): 添加视频音频提示卡片功能
  • 将编辑器插入的视频、音频重建为提示卡片（▶ 视频 / ♪ 音频 + 阅读原文引导语）

Full Changelog: 1.5.4...1.5.6

---

Generated from 1.5.6

微信公众号同步插件配置指南

更新日志

• feat(content): 添加微信任务列表重建功能
  • 待办清单添加 Emoji 图标支持，已完成显示 ✅，未完成显示 ⬜

Full Changelog: 1.5.4...1.5.5

---

Generated from 1.5.5

微信公众号同步插件配置指南

更新日志

feat(core): 新增表格宽度模式配置项
fix(core): 修复表格同步至微信公众号后二次编辑导致样式异常的问题

Full Changelog: 1.5.3...1.5.4

---

Generated from 1.5.4

微信公众号同步插件配置指南

更新日志

• feat(wechat-sync): 添加对 Halo 折叠内容的支持
  • 添加折叠块标题栏和内容区的样式配置选项（标题背景色、内容背景色、边框颜色）
  • 实现了折叠块的静态展示，标题栏带 ▸ 标记和底部分割线，内容区保持原有样式

Full Changelog: 1.5.2...1.5.3

---

Generated from 1.5.3

微信公众号同步插件配置指南

更新日志

• feat(sync): 支持同步文章摘要至公众号草稿

  • 自动读取文章摘要并写入草稿摘要字段
  • 摘要为空时留空，不做默认填充
  • 摘要超出 120 字时需手动在草稿中调整

• feat(sync): 新增同步前预检，提前拦截已知异常

  • 预检配置项完整性、封面图设置及同步任务状态
  • 命中异常时立即中断流程并提示具体原因，避免无效同步

Full Changelog: 1.5.0...1.5.2

---

Generated from 1.5.2

微信公众号同步插件配置指南

更新日志

• feat(sync): 支持同步文章摘要至公众号草稿

  • 自动读取文章摘要并写入草稿摘要字段
  • 摘要为空时留空，不做默认填充
  • 摘要超出 120 字时需手动在草稿中调整

• feat(sync): 新增同步前预检，提前拦截已知异常

  • 预检配置项完整性、封面图设置及同步任务状态
  • 命中异常时立即中断流程并提示具体原因，避免无效同步

Full Changelog: 1.5.0...1.5.1

---

Generated from 1.5.1

微信公众号同步插件配置指南

更新日志

• feat(setting): 添加引用块背景色配置选项
• feat(sync): 实现微信公众号同步状态轮询与并发控制
• feat(core): 添加分栏卡片与画廊版式配置选项，支持：表格、单独一行
• remove(content)：移除内容中的 style 与 script 标签。因微信平台不支持这两类标签，预览环节采用 DOM 隔离方案，模拟受限环境以确保预览效果。

Full Changelog: 1.4.0...1.5.0

---

Generated from 1.5.0

微信公众号同步插件配置指南

更新日志

• docs(README): 添加 1Panel 反向代理配置示例
• refactor(wechat): 移除代码块主题配置项，文章内代码块统一采用微信原生样式。
• feat(sync): 默认同步原文链接到草稿
• feat(comment): 新增留言设置功能，支持：关闭留言、所有人可留言、已关注的人可留言，**「已关注 7 天及以上」**仅支持在公众号后台设置
• remove(comment): 移除开启评论功能，现在由留言设置功能控制，此为破坏性调整，需要重新配置
• fix(content): 优化表格排版样式适配微信编辑器原生观感
• feat(sync):「同步到微信公众号」确认弹窗升级为同步预览

Full Changelog: 1.1.0...1.4.0

---

Generated from 1.4.0

微信公众号同步插件配置指南

更新日志

• docs(README): 添加 1Panel 反向代理配置示例
• refactor(wechat): 移除代码块主题配置项，文章内代码块统一采用微信原生样式。
• feat(sync): 默认同步原文链接到草稿
• feat(comment): 新增留言设置功能，支持：关闭留言、所有人可留言、已关注的人可留言，**「已关注 7 天及以上」**仅支持在公众号后台设置
• remove(comment): 移除开启评论功能，现在由留言设置功能控制，此为破坏性调整，需要重新配置
• fix(content): 优化表格排版样式适配微信编辑器原生观感

Full Changelog: 1.1.0...1.3.1

---

Generated from 1.3.1

微信公众号同步插件配置指南

更新日志

• docs(README): 添加 1Panel 反向代理配置示例
• refactor(wechat): 移除代码块主题配置项，文章内代码块统一采用微信原生样式。
• feat(sync): 默认同步原文链接到草稿
• feat(comment): 新增留言设置功能，支持：关闭留言、所有人可留言、已关注的人可留言，**「已关注 7 天及以上」**仅支持在公众号后台设置
• remove(comment): 移除开启评论功能，现在由留言设置功能控制，此为破坏性调整，需要重新配置

Full Changelog: 1.1.0...1.3.0

---

Generated from 1.3.0

微信公众号同步插件配置指南

更新日志

• docs(README): 添加 1Panel 反向代理配置示例 by @mjsoftking in #2
• refactor(wechat): 移除代码块主题配置项，文章内代码块统一采用微信原生样式。 by @mjsoftking in #3

Full Changelog: 1.1.0...1.2.0

---

Generated from 1.2.0

更新

• 新增“图片下载白名单”配置
  • 默认拒绝下载内网/环回等受限地址的图片（防 SSRF）。内网部署导致同步失败时，可按行添加信任目标放行：域名、*.子域、IP 或 CIDR（如 192.168.0.0/16）。留空最安全。

Full Changelog: 1.0.0...1.1.0

---

Generated from 1.1.0

首发版本

插件文档