快速开始
1) 安装插件
在 Halo 应用市场安装，或在本仓库 Releases 下载构建产物后 手动上传 安装。
2) 打开控制台
进入 Halo 控制台：系统 → 工具 → 自定义微信分享卡片。
3) 插件配置（右上角「插件配置」）
按需填写下表；分享链接、跳转 URL 中的 站点根 取自 Halo 设置 → 外部访问地址，插件内 无需 再填站点域名。
| 配置项 | 说明 |
|---|---|
| 公众号 AppId / AppSecret | 服务端换取 access_token、jsapi_ticket，并为分享页生成 wx.config 签名（正式号或测试号均可） |
| 公开路径前缀 | 默认 /wechat-share；保存后与站点根拼接，形成对外访问路径 |
| 二维码上游接口 | 控制台列表「二维码预览」调用的 HTTP 接口基地址；一般保持默认即可 |
微信公众平台侧（必须）：
- 在公众号后台配置 JS 接口安全域名（域名不含
http(s)://与路径），须与你在微信内打开的分享页域名一致。 - 使用 测试号：将测试号提供的 AppId / AppSecret 填入本插件；测试号同样需在后台维护「JS 接口安全域名」及相关接口权限，流程与正式号类似。
4) 新建卡片
- 选择 卡片类型（链接 / 图片 / 音频 / 视频 / 文件）。
- 按表单填写对应字段：至少包含分享所需的标题与封面；链接类需跳转 URL；媒体类需媒体地址（音频/视频/文件）及介绍文案等。
- 保存后可在列表中复制 分享链接 或打开 二维码预览 用于推广。
各类型字段含义与校验以控制台界面为准；编辑弹窗右侧提供 实时预览（版式与访客落地页一致）。
5) 在微信中使用
将生成的二维码在微信内扫描打开，按页面提示从右上角菜单发起分享即可。 注意，必须是通过扫描二维码才可达成卡片样式，至于为什么不能通过生成的链接访问再分享成卡片我也不知道，能用就行，有空我再研究。
公开 URL 说明
假定 Halo 外部访问地址为 https://example.com，公开路径前缀为 /wechat-share（默认）：
| 路径 | 作用 |
|---|---|
https://example.com/wechat-share/share?sid={sid} | 微信内分享落地页，注入 JSSDK 分享参数 |
https://example.com/wechat-share/go?sid={sid} | 302 跳转到卡片配置的落地 URL |
修改「公开路径前缀」并保存后，对外路径随之变化（别忘了更新已发出的推广链接）。