- 本指南对应当前仓库协议。npm 已发布 0.0.1 beta；使用与 Indiana 部署匹配的 SDK，后续源码变更需要相应构建与发布。仓库更新不等于新版本已在 npm、SPM 或 Maven 发布。
- 浏览器不自动续期客户会话；Funnel controller 的 retry 重放原命令，不启动另一笔付款。换号时销毁并丢弃旧运行。
- 商品、Paywall 与 Funnel 发布版本不可变；功能保存当前配置，默认费率影响后续新消费。默认免费套餐与自动试用须分别配置并校验资格。
- 原生试用、优惠和席位取决于商店配置：席位仅固定 SKU 包含容量，不能从 App 自行改价或传任意购买数量。
- 真实 Auth/RLS、Sandbox 商店、通知与恢复验收需独立证据；源码接通不能宣称完成实际支付验收。
Beta 状态与限制
确认当前支持范围与需要单独配置的能力。
SDK 0.0.1更新于
当前范围与发布边界
会员管理与套餐变更
会员屏幕的取消／恢复续费按钮连接到对应会员组的业务动作节点；打开账单管理使用 billing_portal 节点。操作由服务端固定会员和付款账户，再通过原回执重试。
当前 Stripe 套餐变更使用 previewUpdate → update → readSubscriptionUpdate，支持冻结差额报价和立即／下期执行，Funnel 的 change_membership 节点复用相同核心。席位和预付数量按对应 change 类型处理；共享订阅保留兄弟套餐并核对共同收费条件。已有主会员应变更原合同，不能另建普通主套餐结账。原生替换使用 store 时机和商店购买指令。
相关:Funnel 接入
0.0.1 beta
npm 已发布 0.0.1 beta。请使用指南中的固定版本；latest 仍为 0.0.1。SDK 与 Indiana 部署须匹配，当前源码参考中的后续变更需要单独构建和发布。下载 ZIP 只包含宿主接入文件。
- 客户与 App 用量分析包含零费用 AI 事件、各类 Token 与实际提供商成本。
- 套餐余额编辑与超额控制协议随包交付；独立赠送恢复需要匹配的 Indiana runtime 与数据库迁移。
- Funnel 支持服务端优惠查询、wait 指令以及独立的业务和凭证期限；renewFunnelRun 在同一客户的业务期限内轮换运行凭证。
- OpenRouter 用量集成使用独立的 /openrouter 入口及可选 peer dependency；普通服务端接入无需安装它。
- 鉴权方式保持一致：企业后端使用 Secret Key，浏览器使用后端签发的 Customer Token。
文档站与产品共用部署。测试环境上线和 Sandbox 功能验收不等于生产数据库或 Live 计费已验收。
已发布包与最新源码
固定安装 @tinkerlandai/indiana-sdk@0.0.1。2026-10-14 已读取实际 0.0.1 npm 产物：它与旧个人包 @houzhen888/groove-grow 的版本空间独立。HTTP 和 SDK 参考页覆盖当前源码，下面列出的后续入口不能直接假定存在于安装包中。
| 能力 | 安装包状态 | 接入要求 |
|---|---|---|
| 客户、会话、持有、账本和订阅操作 | 0.0.1 | 匹配服务部署和迁移；付款另需当前 App Sandbox 绑定 |
| manageSubscriptionTrial / readSubscriptionTrial | 0.0.1 | 可信后端 billing:write／billing:read；商店管理结果须区分 |
| AI SDK／OpenRouter 与服务端回执 | 0.0.1 | 配置价格和持久回调／签名端点；真实联调分别验收 |
| checkEntitlement / showPaywall / createPaywallStartClient | 后续源码，未包含在该 npm 产物 | 先完成匹配 SDK 构建／发布、服务部署与迁移 |
| 功能保存即生效与当前默认费率 | 服务端／数据库增量 | 保存后读取当前配置；已冻结报价保持原价，安装 SDK 不自动部署此变更 |
当前接入范围
客户、会话、持有、账本和订阅操作
- 安装包状态
- 0.0.1
- 接入要求
- 匹配服务部署和迁移；付款另需当前 App Sandbox 绑定
manageSubscriptionTrial / readSubscriptionTrial
- 安装包状态
- 0.0.1
- 接入要求
- 可信后端 billing:write／billing:read；商店管理结果须区分
AI SDK／OpenRouter 与服务端回执
- 安装包状态
- 0.0.1
- 接入要求
- 配置价格和持久回调／签名端点；真实联调分别验收
checkEntitlement / showPaywall / createPaywallStartClient
- 安装包状态
- 后续源码，未包含在该 npm 产物
- 接入要求
- 先完成匹配 SDK 构建／发布、服务部署与迁移
功能保存即生效与当前默认费率
- 安装包状态
- 服务端／数据库增量
- 接入要求
- 保存后读取当前配置；已冻结报价保持原价，安装 SDK 不自动部署此变更
源码 package.json 仍写 0.0.1，不代表 2026-10-13 发布的 tarball 已包含后续修改。生产部署、测试部署、业务 sandbox／live、npm 和独立原生包分别核对；完成本地示例或安装包检查不代表真实付款已验证。