适用版本:TinyTale 小程序 3.0.0 / TinyTale 配置插件 2.1.2。
Tools 集成用于识别文章中的受限区域,并按服务端规则判断是否可以阅读。没有使用受限内容的站点可以不启用;文章限制本身仍需在 Tools 和文章编辑流程中维护。
配置集成
安装并启用与当前 TinyTale 集成接口兼容的 Tools 插件。
在 Tools 中配置 TinyTale 专用集成令牌
tinyTaleIntegrationToken。在 TinyTale → 插件集成 → Tools 插件中启用集成,把同一令牌填入
integrationToken。使用验证码扫码交付时,配置有效的扫码图片地址,并确认相关域名可在小程序访问。
选择一篇测试文章,分别以游客、普通账号和满足条件的账号验证限制。
专用集成令牌只在服务端配置,不放入小程序环境文件、文章正文或公开截图。它与旧网页使用的 authToken 不是同一个配置项。
当前交互能力
验证码扫码入口依赖可用的扫码配置。后台虽然保留广告验证码类型和广告位字段,当前广告验证码接口返回 AD_VERIFICATION_UNAVAILABLE,不能将其作为已支持的广告解锁能力宣传或上线。
小程序没有在此流程内完成原生支付。原文支付后仍需满足对应账号和文章策略;如果返回后依旧受限,核对网站与小程序使用的账号、订单授权和服务端状态,不要假定网页 Cookie 会自动传给小程序。
匿名评论后的阅读凭证
允许匿名评论的文章,客户端提交主评论后会尝试申请与该文章关联的匿名阅读凭证。凭证签发与最终阅读许可仍受服务端校验和文章策略约束。
出现“评论成功,内容解锁暂未生效”时,说明评论与阅读凭证是两个独立结果。先确认评论状态,再重新加载;不要仅为了获取凭证重复发表评论。回复评论不等同于这一步主评论凭证申请。
配置失败与停用
令牌不匹配、Tools 不可用或返回数据不符合要求时,受限内容会保持不可读,不会自动降级公开全文。这有助于避免配置故障时意外展示受限部分。
如果准备停用集成,先在源文章和 Tools 中梳理已有策略,确认哪些内容应公开、迁移或继续受限,再停用。仅关闭集成开关不能当作取消文章限制的方法。
故障排查时记录文章名、阅读条件、当前登录状态和接口错误码,隐藏令牌、密码、验证码和个人信息。