配置

安装并启用插件后，进入插件的「设置」，分为 微信公众号 与 正文美化 两个标签。

微信公众号 标签：

配置项必填说明
AppID是公众平台「设置与开发 - 基本配置」中的开发者 ID
AppSecret是公众平台的开发者密码。通过 Halo Secret 组件托管：值保存在独立的 Secret 资源中，插件设置（ConfigMap）只保存该 Secret 的名称，不保存任何明文
接口地址否微信接口基址。留空则直连官方 https://api.weixin.qq.com；无固定公网 IP 时填自建反向代理地址，详见接口地址与反向代理
默认作者否同步到公众号时展示的作者名，留空则使用文章作者。微信限制作者名不超过 8 个字（编辑器计字口径：汉字 1 字、半角字符 0.5 字、emoji 2 字，超过会被接口拒绝），超长会被自动截断并在服务端日志中提示，建议直接控制在 8 字以内
留言设置否同步生成的草稿的留言权限，可选「关闭留言」（默认）/「所有人可留言」/「已关注的人可留言」，对应微信 need_open_comment 与 only_fans_can_comment；「已关注 7 天及以上」仅支持在公众号后台设置
图片下载白名单否多行文本，每行一个信任的域名/IP/CIDR。留空（默认）= 不放行任何内网地址；仅当 Halo 部署在内网、图片也在内网地址时才需配置，详见内网部署与图片下载白名单
重复同步更新草稿否开关，默认开启：同一篇文章再次同步时，先校验上次写入的那份草稿是否还在——在则更新那份草稿（draft/update，草稿 media_id 不变）、不在则新建，避免草稿箱里堆出重复草稿。关闭则不做校验，每次同步都新建一份草稿。校验草稿拿不到结论（如「接口地址」代理未放行 /cgi-bin/draft/get）时一律按「不在」处理、改为新建，不会打断同步；更新本身被拒（封面素材失效 40007、或请求被微信网关 / WAF 拒绝）时同样改为新建，任务记录里把实际动作记为 create（由 MCP 的 wechat_sync_status 回报；文章列表的状态说明只写「已同步到公众号草稿箱」，不提新建 / 更新）
缓存保留天数否数字输入，默认 30：素材缓存的保留期（天）。留空、0 或负数表示「全部保留」。保留期按记录的最近一次使用时间计算——某张图只要还会被同步命中，计时就会刷新，因此不会被误删；被清理的都是确实已不再使用的缓存。设为「全部保留」则永久保留（数据库会持续增长）。清理任务固定每天 0 点执行（清理判定只看「多少天没被使用」，执行时刻不影响结果，故不做成配置项）；保留天数在每次执行时读取，改完无需重启插件

正文美化 标签（控制提交草稿前的排版美化，均已提供默认值）：

配置项必填说明
正文文字颜色是段落、列表、表格正文的文字颜色，默认 #3f3f3f
链接颜色是正文中超链接的文字颜色，默认 #576b95
附件链接显示否下拉选择，默认「显示链接地址」：仅对无法提交到微信的正文链接（pdf、zip 等非图片附件）生效——这类链接会被改为纯文本，此项决定显示原始地址（如 /upload/2026/09/manual.pdf）还是链接自身的文字（如「下载手册」）；链接没有文字时回退显示地址
行内代码颜色是行内 code 的文字颜色，默认 #d14（对齐微信图文经典风格）
行内代码底色是行内 code 的背景色，默认 #f2f3f5
引用块显示边框否开关；开启后引用块显示左侧强调边框（颜色由「引用块边框颜色」决定），默认开启
引用块边框颜色是引用块左侧强调边框的颜色，默认微信绿 #07c160
引用块背景色是引用块的背景颜色，默认 #f7f7f7
标题显示边框否开关；开启后 H2–H6 标题显示左侧强调边框（H1 不加），默认关闭
一级标题颜色是H1 标题文字颜色，默认 #222222
一级标题对齐方式否下拉选择，默认「居中」：可选左对齐、居中、右对齐；正文中的 H1 若已自带对齐方式（行内 text-align 或 align 属性），则保持原样、本项对其不生效
二级标题颜色 / 二级标题边框颜色是H2 文字颜色（默认 #222222）与左侧边框颜色（默认 #07c160，仅开关开启时显示）
三级标题颜色 / 三级标题边框颜色是H3 文字颜色（默认 #222222）与左侧边框颜色（默认 #07c160，仅开关开启时显示）
四级标题颜色 / 四级标题边框颜色是H4 文字颜色（默认 #222222）与左侧边框颜色（默认 #07c160，仅开关开启时显示）
五级标题颜色 / 五级标题边框颜色是H5 文字颜色（默认 #333333）与左侧边框颜色（默认 #07c160，仅开关开启时显示）
六级标题颜色 / 六级标题边框颜色是H6 文字颜色（默认 #888888）与左侧边框颜色（默认 #07c160，仅开关开启时显示）
折叠块标题背景色是折叠块（Halo 折叠内容）标题栏的背景色，默认浅灰 #f7f7f7（标题文字保持深色）
折叠块内容背景色是折叠块内容区的背景色，默认白色 #ffffff
折叠块边框颜色是折叠块卡片边框与标题栏分隔线的颜色，默认 #e6e6e6
视频/音频卡片背景色是微信不支持正文内嵌视频与音乐，编辑器插入的视频、音频同步时会重建为提示卡片（▶ 视频 / ♪ 音频 + 「阅读原文」引导语）；此项控制卡片背景色，默认 #f7f7f7
视频/音频卡片主行颜色是提示卡片主行「▶ 视频」/「♪ 音频」的文字颜色，默认 #333333
视频/音频卡片引导语颜色是提示卡片引导语「请点击文末『阅读原文』观看/收听」的文字颜色，默认 #999999
视频/音频卡片标记颜色是提示卡片标记符号「▶」/「♪」的颜色，默认微信绿 #07c160
表格宽度模式否下拉选择，默认「保持比例」：按文章表格的原始列宽比例渲染，列宽总和超出屏宽时在微信里横向滚动查看全貌（推荐）；「宽度铺满」：列宽按比例压缩进屏宽，表格始终铺满屏幕、不产生横向滚动
分栏卡片版式否下拉选择，默认「表格」：各列并排（重建为微信兼容的表格布局，推荐）；「独占一行」：不重建表格，每栏各占一行，栏内内容照常保留
画廊版式否下拉选择，默认「表格」：多图并排（重建为一张整体表格、所有列等宽，推荐）；「独占一行」：不重建表格，每张图片各占一行，图片与描述内容照常保留

还需要在微信公众平台 / Halo 侧完成的准备

  • IP 白名单：在公众平台「基本配置 - IP 白名单」中加入 Halo 服务器的公网出口 IP，否则无法获取 access_token。若 Halo 服务器没有固定公网 IP（动态 IP、家用宽带、部署在 NAT 之后），请改用接口地址与反向代理方案：用一台有固定公网 IP 的服务器做反向代理，把该代理服务器的固定 IP 加入白名单。
  • 外部访问地址：若文章封面或正文图片使用相对路径，需在 Halo「设置 - 基本设置 - 外部访问地址」中配置可公网访问的站点地址，插件据此拼接出图片的绝对地址后再下载转存（会自动兼容地址尾部有无 /）；草稿的「原文链接」同样基于该地址与文章路由拼接。