新版cli登录认证指南

新版命令行工具（bili-sgame-cli）引入 Token 登录认证：先通过 login 保存平台签发的密钥（Token），之后 serve 本地调试、upload 上传发布都会携带该 Token 完成鉴权，logout 用于清除本地凭证。

整体流程：

login（保存凭证） -> serve / upload（携带 Token 鉴权） -> logout（清除凭证）

1. 获取 Token（密钥）

1. 登录 bilibili 游戏开放平台，进入「游戏管理」，选择目标游戏进入游戏详情页。
2. 切换到「开发」标签页，在页面底部的「密钥」区域点击「创建密钥」（密钥用于 CLI 传包鉴权）。

说明：

• 密钥等同于该账号对该游戏的上传权限，请妥善保管，不要泄露给他人，也不要提交到代码仓库。

2. login — 保存登录凭证

bili-sgame-cli login

按提示依次输入：

请输入您的uid
请输入您的appId
请输入您的secret-token

• uid：你的哔哩哔哩账号 ID。
• appId：游戏的 appId。
• secret-token：上一步在开放平台创建的密钥，输入时不回显。

支持多账号、多游戏：可多次执行 login，分别保存不同 uid、不同 appId 的 Token；相同 uid + appId 重复执行 login 会覆盖原有 Token。

3. serve — 本地调试（需登录）

bili-sgame-cli serve <uid> [vAppId]

• 执行前请确保已 login，且登录时的 uid、appId 与命令参数一致；否则会提示 未找到 uid=... appId=... 的登录凭证，请先执行 bili-sgame-cli login。
• 命令使用本地 Token 完成鉴权：构建游戏包 → 获取预签名上传地址 → 上传至临时存储 → 换取外网下载地址并登记为开发版本 → 终端输出调试二维码，使用哔哩哔哩客户端扫码即可真机调试。

4. upload — 上传发布（需登录）

bili-sgame-cli upload <uid> <description>

• 同样依赖 login 保存的 Token，未登录会提示先执行 bili-sgame-cli login。
• 命令会构建游戏包，携带 Token 完成上传与构建登记，成功后可在开放平台「版本管理」中看到对应的开发版本。

5. logout — 清除登录凭证

# 清除指定 uid + appId 的凭证
bili-sgame-cli logout <uid> <appId>

# 清除所有凭证
bili-sgame-cli logout -a

常见问题

Q：执行 serve / upload 提示「未找到 uid=... appId=... 的登录凭证」？

A：尚未执行 login，或登录时输入的 uid / appId 与命令参数不一致。重新执行 bili-sgame-cli login 即可。

Q：如何切换账号或游戏？

A：直接使用新的 uid + appId 执行一次 login 即可；如需清理旧凭证，使用 logout <uid> <appId> 或 logout -a。

Q：Token 会被发送到哪里？

A：Token 仅用于向小游戏上传服务鉴权，不会写入游戏包。