LokvisAuthSession

Defined in: packages/sdk/src/index.ts:53

Cloud 注入的认证信息(W17.3)。

由 cloud 侧(apps/web 或同构 SDK 容器)在用户完成登录后取得, 透传给 createLokvis({ auth })。SDK 仅据 presence 推导 isPro, 不校验 token 合法性 —— 校验由 cloud 网关完成,本地无 secret。

• session:opaque cloud session 字符串(如 JWT),来自 lokvis-cloud 登录回包
• token:直接 API token(替代 session,用于 CLI / 后端调用场景)
• isPro:显式覆盖。不传时,若 session 或 token 非空则视为 Pro

Properties

session?

optional session?: string

Defined in: packages/sdk/src/index.ts:55

Cloud 会话令牌(由 lokvis-cloud 登录后下发)

---

token?

optional token?: string

Defined in: packages/sdk/src/index.ts:57

API token(替代 session,用于无会话语境)

---

isPro?

optional isPro?: boolean

Defined in: packages/sdk/src/index.ts:65

显式声明 Pro 状态。优先级高于 session/token presence 推导。 用于:cloud 已确认身份但游客身份 / 已订阅但 token 待续签 等场景。

注:isPro 仅控制本地四环门控。若需区分 AI 配额(Pro vs Cloud Pro), 应传 plan 字段。plan 优先级高于 isPro(显式 plan 时据 plan 推导 isPro)。

---

plan?

optional plan?: Plan

Defined in: packages/sdk/src/index.ts:73

用户订阅计划(G1)。比 isPro 更细粒度,用于 AI 调用计费。 优先级高于 isPro:传 plan 时,isPro 据 plan !== 'free' 推导。 未传 plan 时,按原 isPro / session presence 推导,plan 默认为:

• isPro=true → ‘pro’(向下兼容:旧 cloud 注入不区分 Pro/Cloud Pro)
• isPro=false → ‘free’