概览

Wechat Share 是一款面向 Halo 2.23+ 的微信自定义分享卡片插件，支持将网址、图片、音乐、视频、文件封装为卡片样式分享至微信。

写在前面

在开始使用本插件之前，请先完成以下必要配置，否则微信分享卡片将无法正常生效：

1. 配置公众号信息

在后台填写你的公众号 AppId 与 AppSecret，用于获取微信 JS-SDK 权限。

2. 设置 JS 接口安全域名

前往微信公众号后台，在「开发 → 接口权限」中配置 JS 接口安全域名，确保当前网站域名已加入白名单。

⚠️ 未配置安全域名时，微信将无法正确获取自定义分享信息。

3. 账号类型说明

支持以下账号类型：

• 公众/服务号正式号
• 测试号

4. 其他说明

• 若未完成上述配置，直接在微信内使用，等配置完成后，请务必清理微信软件缓存，以确保配置生效。

插件功能

• 多种卡片类型：除经典「链接卡片」外，支持 图片 / 音频 / 视频 / 文件 专属页样式（详见下节）
• 分享内容自定义：标题、摘要/介绍、封面图、媒体或跳转地址等；每张卡片独立 SID，数据存 Halo 扩展资源
• 控制台列表：复制分享链接、编辑、删除；支持 二维码预览（依赖外部访问地址与二维码上游接口）
• 插件设置：公众号 AppId / AppSecret（服务端换票与 wx.config 签名）、公开路径前缀（默认 /wechat-share）、二维码上游接口基地址
• 分享落地页在微信内置浏览器中加载 jweixin，调用 updateAppMessageShareData / updateTimelineShareData 更新会话与朋友圈分享卡片

卡片类型说明

新建卡片时可在控制台选择 卡片类型。类型决定访客打开的落地页版式，以及微信内二次分享时的链接策略（与插件内逻辑一致）：