登录与 API 密钥

浏览器登录

在 vsh.cc 使用邮箱一次性验证码登录。会话由 better-auth 管理；同站 API 请求可走 https://vsh.cc/api，Cookie 为第一方。

API 密钥（CLI / 脚本 / 智能体）

在已登录前提下，可通过控制台或维护命令创建 API key。明文只显示一次，请保存到安全位置（如环境变量 VSH_API_KEY）。

调用 JSON API 时：

• 将 key 放在请求头 x-api-key（better-auth 默认名）。
• 不要把原始 API key 放在 Authorization: Bearer …（该头用于会话 token，语义不同）。

配置优先级与配置文件路径见 CLI 与智能体。

项目（工作区）

请求可带 X-Vsh-Project-Id（若你的客户端支持），否则使用会话中的默认项目。多项目时请确认当前写入的配额归属哪个项目。