入门指南

令牌体系

安装码、令牌、设备绑定——它们是什么、怎么用。

概念总览

Spiry 的身份体系有三个概念，各司其职：

安装码是你从控制台签发的一串字符，用于首次安装时验证身份。

安装码是一次性的安装码用过即失效。如果你需要在新设备上安装，请重新签发一个新的安装码。安装码有有效期，过期后需要重新签发。

curl -fsSL https://spiry.yundy.net/install/v33 | bash

脚本会提示你粘贴安装码。安装成功后，Spiry 会自动用安装码换取一个长期令牌，安全存储在系统凭据中。

令牌是设备的长期身份凭证。安装成功后自动生成并写入系统凭据，日常使用时你不需要手动管理它。

macOS 与 Linux：用户状态目录下的私有文件 ~/.local/state/spiry/credentials/subscription-token（权限 0600，仅属主可读写）

令牌以 0600 私有文件存储（与设备标识同目录），双平台一致。从旧版本（macOS 钥匙串）升级时会自动一次性迁移、无需手动操作。

在控制台的订阅详情中，你可以点击「查看令牌」来查看当前令牌（需要身份验证）。令牌格式形如 tok_xxxxxxxx。

保护好你的令牌令牌等同于你的设备身份。不要把令牌分享给他人、不要提交到代码仓库。如果令牌泄露，请在控制台中解绑设备后重新安装。

每个令牌绑定一台设备。安装时，Spiry 会生成一个唯一的设备 ID 并与令牌绑定。

根据你的订阅类型：

如果你换了电脑，需要在新设备上重新安装：

如果你已经卸载了旧设备上的 Spiry（执行了 uninstall），设备槽通常会自动释放。

在控制台的订阅详情中，你可以手动解绑设备。解绑后，该设备上的 Spiry 将无法使用。这在你丢失设备或令牌泄露时非常有用。

令牌的有效期跟随你的订阅。订阅到期后，令牌会自动失效。续费后，令牌会在下次 opencode 启动时自动恢复（前提是设备绑定仍然有效）。