让接入，更简单。

创建免费账号并立即建立登录会话。

{
  "ok": true,
  "csrf": "...",
  "user": { "plan": "free" },
  "usage": { ... }
}

使用邮箱和密码登录，成功后服务器写入 HttpOnly Cookie。

{ "email": "you@example.com", "password": "your-password" }

恢复当前登录状态，同时取得当前 CSRF Token、账号信息和套餐用量。

注销当前账号会话。

返回套餐使用量与脚本、有效卡密、绑定设备统计。

列出当前账号拥有的脚本元数据与执行入口，不返回源码正文。

上传前预检 Luau 语法。请求体为原始源码文本；语法错误返回 422 LUAU_SYNTAX_ERROR 和行列 diagnostics。真正上传/更新接口还会再次强制校验。

上传新的 Luau 源码；必须通过 X-Project-Id 指定所属项目（每个项目最多 50 个脚本）。请求体是原始文本，不是 JSON。V20.1.10 会再次执行 Luau 语法校验，然后把整份脚本编译为 Primitive Capsule Full-VM。VM wrapper 再进入带链式双轨状态校验和自适应字典压缩的双层 Sharded VM²，最终使用 AES-GCM 私有存储；服务器不保存原始源码正文。

替换已有脚本源码并增加 revision；如果启用 kickOutdatedUsers，旧 Runtime 会被撤销。

保存脚本运行策略。修改设置会撤销当前运行会话，使下一次启动获取新的签名设置。

{
  "scriptId": "sc_...",
  "name": "PY Hub",
  "settings": {
    "freeForAll": false,
    "useHeartbeat": true,
    "kickOutdatedUsers": true,
    "requireSingleSession": true,
    "allowDeviceToken": true,
    "rotateDeviceToken": true,
    "runtimeGuard": true,
    "serverCapabilities": true,
    "riskIpBinding": true,
    "silentMode": false
  }
}

{ "scriptId": "sc_...", "enabled": false }。停用后立即撤销相关 Runtime。

列出当前账号的全部授权记录；V9+ 新卡密可由 License Vault 解密后仅向本人显示。

创建单个 V20.1 PYX2 卡密：内部 payload 经 XXTEA 加密后使用 Base64URL 编码，并由 HMAC-SHA256 认证；旧 PY7 卡密仍兼容。

{
  "label": "user-001",
  "scriptId": "sc_...",
  "days": 30,
  "maxDevices": 1
}

一次批量创建 100–300 个卡密，同时受 Free 总计 1000 个授权记录限制。

{
  "labelPrefix": "batch",
  "scriptId": "sc_...",
  "count": 100,
  "days": 30,
  "maxDevices": 1
}

{ "id": "license-uuid", "enabled": false }

{ "id": "license-uuid" }，清空全部设备槽位并全链撤销现有 Runtime。

{ "id": "license-uuid", "slotId": "ds_..." }，只撤销指定设备槽位，同时撤销其 Session、LEASE、Guard、Capability、Stream。

仅返回与当前账号脚本 / 卡密相关的安全事件，最大 200 条。

返回当前脚本的 Bootstrap Loader，并创建短时一次性 BOOT_TOKEN。不会返回受保护源码正文。

建立一次运行会话。卡密模式提交 key；后续可改用轮换 deviceToken，两者不能同时提交。

{
  "scriptId": "sc_...",
  "installId": "local-install-id",
  "clientInstanceId": "random-per-launch-id",
  "bootToken": "...",
  "nonce": "...",
  "ts": 1789790000000,
  "key": "PYX2-l1-x1-..."
}

刷新运行租约并返回新的 heartbeatToken。Bootstrap 遇到临时网络失败时每 2 秒重试一次，最多 10 次；已成功轮换但响应丢失时支持短暂幂等恢复。

取得短期 Runtime Grant。返回下一枚 Guard Token、epoch、grantExpiresAt 与 HMAC proof，并持续检查脚本 revision、卡密状态、设备黑名单与网络风险绑定。

V20.1.10 Loader 自动附带可选的 diagnostics 摘要。服务端校验格式与校验和，并把有效摘要纳入本次 grant 的 HMAC；返回 diagnosticsAccepted 与 diagnosticProfileStable。这是客户端自报诊断，不能证明客户端未被控制；缺失、异常或特征变化不会取代卡密授权判断。

执行服务器端注册的命名操作。请求绑定 Script、Revision、License、Install、Client Instance、Sequence、Nonce 与时间戳。

local Runtime = getgenv().PYSHIELD_RUNTIME

local result, receipt, meta = Runtime.Execute(
  "example.secure_transform",
  { text = "hello" }
)

if not result then return end
print(result.value)

{
  "ok": true,
  "operation": "example.secure_transform",
  "sequence": 1,
  "result": { "value": "..." },
  "receipt": "...",
  "inputDigest": "...",
  "resultExpiresAt": 1789790030000,
  "runtimeExecuteToken": "next-token"
}

消费一次性 Manifest Ticket，建立当前运行唯一 Stream，返回 segment 数量、滚动 Stream Token、Capability Window 和 Checkpoint 地址。

严格按 index 顺序获取单个 Segment。Header 需要当前 Authorization: Bearer ... 与 X-PY-Capability。

当前 Capability Window 完成后换取下一窗口的新 Capability Token 与 Checkpoint Token。

{ "secret": "ADMIN_SECRET" } → 管理 Cookie + CSRF。

读取管理员会话与 CSRF。

平台总览。

查看安全事件。

验证 HMAC 审计链完整性。

按安装 ID 哈希加入设备黑名单。

平台管理员上传前预检：先做 Luau 语法校验，再做 V20.1 Full-Script VM 兼容性分析；不支持的语法直接返回 FULL_VM_UNSUPPORTED_SYNTAX，不会降级成明文。

平台级上传脚本。

平台级创建卡密。

成功响应包含 result、binding、receipt。当上一枚 receipt 仍在 15 秒有效期内时，下一次请求必须提交 previousReceipt。过期后链自动开启新 epoch。

{
  "previousReceipt": "...",
  "operation": "example.secure_transform",
  "sequence": 2
}

风险分级：5+ 降低 Capability 速率，10+ 撤销当前 Runtime，15+ 临时封禁 30 分钟；分数随时间衰减。

验证、登录和通用限流桶持久化到服务端状态文件，Node 重启后不会全部归零。多实例生产环境仍建议改为 Redis。

Loader 强制状态机 BOOT → VERIFIED → GUARD → CAPABILITY → RUNNING，内部步骤不可正常跳序。