微信小程序 URL Link / Short Link 生成工具包
纯 Python 3 标准库，零 pip 依赖。用于生成可粘贴到微信（含朋友圈文案）的官方外链。
重要说明（能力与边界）
| 项目 | 说明 |
|---|---|
| 本工具做什么 | 调用微信官方接口，生成 https://wxaurl.cn/...（URL Link）或 Short Link。 |
| 本工具不做什么 | 不能代替你在微信里点击「发表朋友圈」；微信不提供第三方「全自动发帖到朋友圈」的公开 API。使用方式：运行脚本 → 复制输出的链接 → 在微信朋友圈发文字时粘贴该链接。 |
| 谁可以调接口 | 须持有该小程序的 AppSecret（与 AppID 对应）。个人/企业类目若接口被拒，以微信返回 errcode 为准。 |
| 打开环境 | 链接一般在 微信内 打开才能拉起小程序；站外浏览器可能看到提示页。 |
运行条件
- Python 3.9+（推荐 3.10+），系统已安装
python3。 - 能访问公网
https://api.weixin.qq.com（公司网络若拦截需放行）。 - 小程序 AppID、AppSecret（微信公众平台 → 开发设置）。
凭证配置（三选一）
方式 A — 本目录 .env（推荐解压独立使用）
cp .env.example .env
# 编辑 .env，填入 WECHAT_APPID 与 WECHAT_APPSECRET（不要加中文说明句）
方式 B — 环境变量
export WECHAT_APPID=wx…………
export WECHAT_APPSECRET=…………
方式 C — 指定任意 .env 路径
export WECHAT_ENV_FILE=/绝对路径/含WECHAT键的.env
若把整个文件夹仍放在「一场soul的创业实验-永平」仓库内、且未配置以上项，脚本会尝试读取 ../soul-api/.env（与仓库原脚本行为兼容）。
命令示例
URL Link（适合复制到朋友圈/聊天）
python3 generate_share_link.py --mode urllink --path pages/read/read --query "id=1.1" --expire-days 30
成功时标准输出仅一行链接，可直接复制。
首页
python3 generate_share_link.py --mode urllink --path pages/index/index --query ""
Short Link（偏微信内场景）
python3 generate_share_link.py --mode shortlink --page-url "pages/read/read?id=1.1" --page-title "荷包"
官方文档
安全
- 不要把
.env、AppSecret 提交到 Git 或发在公开群。 - 本包内不包含任何真实密钥。
与仓库内脚本的关系
永平仓库中 scripts/wechat_generate_share_link.py 与本包 generate_share_link.py 逻辑等价；本包增强了任意目录下读取本文件夹 .env 与 WECHAT_ENV_FILE，便于拷贝到其它电脑使用。