收藏物、佩戴与读者护照

适用版本：会员插件 1.5.0 · 核对日期：2026-10-22

用途

创建可领取的纪念物，按免费、成就、亲授、积分兑换或活动奖励发放，并让读者把徽章、称号和装扮佩戴在读者护照上。

前置条件

具备会员控制台权限；图片先上传到 Halo 附件或准备 HTTPS 地址。积分兑换还需要产品插件中的产品和真实积分订单。读者必须已获得收藏物才能佩戴。

操作入口

站长：控制台 → 会员管理 → 读者俱乐部 → 收藏与装扮。

读者：用户中心 → 会员管理 → 读者俱乐部 → 收藏与装扮，佩戴结果展示在「读者护照」。

操作步骤

点击「创建收藏」，填写收藏名称（最多 80 字）、收藏故事（最多 2000 字）、展示图标（Emoji，最多 16 个字符）、背景色与收藏图片。
选择收藏类型：纪念徽章、读者称号、头像框、名片背景、数字明信片、花园植物、博客宠物、花园装饰。
选择获取方式：
- 免费领取：读者直接在收藏与装扮领取。
- 达成成就：选择成就条件并填写阈值（1～100000）。条件为累计签到天数、加入会员天数、审核通过的评论数或收藏文章数。
- 博主亲授：发布后在列表点击「亲授」，选择获赠读者并填写 1～500 字授予理由。
- 积分商品兑换：填写关联产品标识与产品兑换页面；商品价格、库存和订单由产品插件管理。
- 活动纪念奖励：保存并发布后，才能在读者活动中选为完成纪念物。
按需设置开放领取时间与结束领取时间，留空表示不限制；结束时间必须晚于开始时间。
将发布状态设为「已发布」并保存。草稿不展示给读者；归档后停止新领取，已获得的记录保留。
读者在「收藏与装扮」领取：免费与成就类点击「收入收藏」或「检查并领取」，积分商品点击「凭订单领取」并填写产品订单号；获得后点击「佩戴」。
徽章需要选择第一枚、第二枚或第三枚展示位；植物、宠物和装饰的按钮为「放入花园」；明信片用「展开明信片」查看。
读者打开「读者护照」→「编辑护照」，填写护照昵称（1～40 字）与一句自我介绍（最多 300 字），需要分享时勾选“允许通过分享链接公开我的护照”。

预期结果与核对

领取成功后收藏物进入读者收藏册，重复领取或重复授予不会增发；佩戴后护照显示对应徽章、称号、头像框、背景、植物、宠物和装饰。公开护照后，分享链接可被未登录访客访问，页面只展示昵称、简介、佩戴物和花园成长。

限制与注意事项

已发布的收藏物不能退回草稿，类型、获取方式、成就条件、阈值和产品标识不能再修改；需要调整时请新建收藏物。佩戴槽位固定为三枚徽章、一个称号、一个头像框、一个名片背景、一株植物、一只宠物和一个花园装饰，同一件收藏物不能重复佩戴，且必须已获得并类型匹配。积分兑换只核验产品插件的 ProductOrderInfo 成功订单，以及对应的成功积分兑换流水，不二次扣分；不接受商城订单。退款不会自动撤回已领取的纪念物，兑换规则应自行说明。收藏图片与链接只接受站内路径或 HTTPS 地址。公开护照依赖站点匿名角色正常聚合公开护照接口；匿名请求被拒绝时，分享链接只会显示不可查看提示。

常见问题

读者无法领取？ 检查收藏物是否已发布、是否在领取时间内、成就阈值是否达成；积分商品还需订单属于本人、产品标识一致且订单成功。
已发布收藏物想改类型？ 不能修改，请归档后新建。
护照链接打不开？ 未开启公开、已关闭公开或链接中的护照标识不正确，都会返回不存在。
明信片为什么不能佩戴？ 明信片用于收藏和展开阅读，不占用护照佩戴位。