DWZ / v0.8.0 / 2026-10-16

轻松登录，分享每次发现。

顾客用手机号和验证码即可注册或登录。密码完全自愿；商品和活动分享不要求先注册。

当前可验证：本地账号流程、分享预览与网页链接。

真实短信、小程序微信授权、官方小程序链接和 App 微信卡片需要正式平台配置与真机验收。当前电脑未具备完整 Android/iOS 编译环境，尚未生成可安装的签名 App。

顾客怎么使用

打开“我的 → 登录 / 注册”，输入手机号，阅读并同意政策，获取验证码后登录。新手机号自动建立会员，无须设置密码。
需要密码时，进入“我的 → 账号与密码”，再次验证已绑定手机号，主动设置8–64位、包含字母和数字的密码。之后验证码和密码都可登录同一会员。
忘记密码时，先用验证码登录，再到“账号与密码”重置。修改成功后，其他设备的旧登录状态失效，当前设备使用新的登录凭证。
在原生微信小程序中，也可点击“微信授权登录”。已有手机号会员先用手机号登录，再绑定当前微信，可避免建立两份会员。系统不会未经核实合并两个历史账户。

没有设置密码时，系统不会弹出强制设置。设置密码不会替代验证码登录。密码不会明文保存或显示给管理员。

分享方式有什么区别

入口	顾客操作与结果	上线条件
微信小程序商品、活动、板块商品集合	“转发给好友”生成带标题和封面的小程序卡片；可转发好友或群。也提供复制链接入口。	对应页面与商品/活动已在小程序发布；真机验证分享菜单。
Android / iOS App 商品和活动	点击“分享 → 发送小程序卡片给微信好友 / 群”，由微信完成选择接收者。	微信 OpenSDK、移动应用和小程序绑定关系、AppID/签名/回调配置、安装微信及真机验证。
复制小程序链接	生成官方 URL Link，点击后进入小程序打开流程；部分环境先显示微信官方中间页。	服务端开通链接能力、对应小程序页面已发布。
复制网页链接	打开公开分享预览；内容已在官网发布时，可继续在浏览器查看。未登录也能打开。	商城正式 HTTPS 域名可访问；本机127.0.0.1链接仅供本机测试。

普通文字链接并不保证被微信自动显示成小程序卡片。要得到原生小程序卡片，请使用小程序的转发按钮或 App 内的微信卡片按钮。本次 App 卡片目标是好友／群聊；App 分享到朋友圈不能承诺同样的小程序卡片形式。见微信 Android 分享规则和iOS 分享规则。

运营时需要注意什么

卡片标题和封面来自小程序端已发布版本；在后台修改商品或活动后，记得勾选小程序端生效。
未发布到小程序的内容仍可分享网页；不会伪造小程序卡片。只在小程序发布的内容不会被导向不存在的官网详情。
分享只针对公开内容。私人一次性定制邀请不进入普通分享；收到卡片的人仍需满足自己的定制资格。
活动到期、被关闭，或者商品下架后，公开访问与新链接生成会被拦截。微信聊天里已有卡片的旧标题/封面不一定同步刷新，打开后以服务器状态为准。
官方链接当前按7天有效期生成，并按内容复用。过期后重新复制可生成新链接。系统自行缓存以减少平台调用；这不是一次性邀请链接。

上线时，我们按这个顺序配置

先部署共同后台：正式域名、HTTPS、政策与隐私联系信息；继续按上线步骤操作。
接通阿里云短信：你确认公司签名及验证码模板，我配置受限权限与服务器私密参数。发送一条经授权的真实测试短信，验证注册、验证码登录、可选密码设置和密码登录进入同一会员。密钥不放聊天、网页或 App。
完成小程序配置：你确认公司小程序账号，提供公开 AppID 与 gh_ 开头的原始 ID；AppSecret 放服务器私密配置。设置合法域名、隐私指引，上传体验版并验证微信授权登录、手机号绑定、好友与群分享。需要正式 URL Link 时先发布对应页面。
开通官方链接：服务端填写下面的公开开关和 ID，配置已有小程序密钥后再开启。检查从微信内、微信外浏览器和不同手机打开链接，不把官方中间页误判为失败。
接入 App 卡片：你确认微信开放平台移动应用、包名、签名、Apple 团队和关联关系；我运行配置工具并编译。App 与小程序应在同一微信开放平台账号下，或满足官方第三方授权例外。分别用 Android/iPhone 测试发送、取消、未安装微信及回调。
再发布各端：小程序发布、官网部署、Android/iOS 安装包更新各自完成。后台内容发布勾选不能代替小程序代码发布和 App 安装包更新。

给技术部署使用的配置清单

你不必自行输入这些命令；提供公开的账号标识与域名后，由我在部署阶段填写。真实凭证单独保存。

WECHAT_MODE=live
WECHAT_APP_ID=小程序的wx开头AppID
WECHAT_APP_SECRET=只在服务器安全填写
WECHAT_MINIPROGRAM_ORIGINAL_ID=gh_开头的小程序原始ID
WECHAT_MINIPROGRAM_ENV=release
WECHAT_SHARE_LINK_ENABLED=true
WECHAT_NATIVE_APP_ID=开放平台移动应用的wx开头AppID
WECHAT_APP_PAY_ENABLED=false

移动应用 AppID 与小程序 AppID 是不同的。分享不依赖开启 App 支付；当前 App 原生支付方法仍未完成，支付开关继续保持 false。链接开关开启不代表平台已批准或测试成功。

# 在 mobile 目录，先用 --check 只检查公开参数
python3 scripts/configure-wechat.py \
  --appid wx移动应用ID \
  --origin https://正式商城域名 \
  --universal-link https://正式商城域名/wechat/ \
  --team-id Apple团队ID --check
# 核对后移除 --check 写入；再运行构建与 cap sync

工具会填写 Capacitor 配置、iOS URL Scheme、Associated Domains 与服务器 Apple 关联文件。仍需在 Apple 开发者配置中开启关联域名能力、使用正确签名，并在微信开放平台登记一致的 Universal Link。Android 更改包名时，需要同步移动 wxapi/WXEntryActivity.java；微信开放平台登记签名必须与实际安装包一致。

服务端关联文件地址为 /.well-known/apple-app-site-association。须能通过正式HTTPS直接返回JSON，无登录要求和重定向。说明书中的占位ID不应提交到生产平台。

验收记录

本次107项自动测试通过；115个JS/JSON文件与13个小程序页面结构检查通过。浏览器已验证验证码/密码入口切换、匿名商品和活动分享预览、复制链接以及打开对应商品。iOS仅完成Swift语法和Package清单解析，Android/iOS前端构建与Capacitor同步通过；没有完成原生链接编译或真机验收。

上线前还需把实际使用的短信和微信SDK信息纳入正式隐私政策与SDK说明，并测试用户同意前后的行为。真实短信、微信授权、URL Link、跨App回调和卡片实际收发均留待正式账号联调。

官方资料：URL Link · Android SDK接入 · iOS SDK接入。核对日期：2026-10-16。