账号、密钥、套餐与计费

本页回答账号侧最常见的问题。凡是要「操作」的事都在控制台完成；命令行只负责登录本机与查看状态。

登录与账号

控制台支持哪些登录方式？ 邮箱验证码、手机短信验证码、微信；组织可另配 SSO 身份源供成员登录。命令行本身不做登录，它用你在控制台创建的个人访问令牌（PAT）完成初始化。

账号绑定邮箱有什么用？ 平台会外投四类邮件：审批待办与结果、组织邀请、余额低于阈值预警（同一账号同日至多一封）、新应用键创建通知（含派生途径，恒不携密钥明文）。未绑邮箱静默跳过，不影响任何功能。

一个人可以有多个组织吗？ 可以。个人账号可创建或加入组织；组织有成员、邀请、团队与治理策略；套餐挂在账户（个人或组织）上。

如何注销账号？ 控制台提供账号匿名化流程（先发起挑战确认，再执行）。注销前请先处理未用完的余额与未结账单。

个人访问令牌（PAT）与设备键

PAT 在哪创建、怎么用？ 控制台「API 密钥」页创建，只展示一次，请立刻复制。用途只有一个：tansr init 登录本机命令行（掩码输入，或 CI 用 TANSR_PAT 环境变量）。PAT 代表你本人。

tansr init 之后发生了什么？ 向导验证 PAT → 为这台设备派生一枚应用键（命名 cli:<主机名>:<装置id>）→ 写入操作系统密钥库 → 展示摘要卡（账号指纹、余额、近期用量、可用模型数、派生键有效期）。之后 tansr 直接可用，模型清单与价目由平台下发。

PAT 丢了 / 怀疑泄露。 到控制台删除或停用该 PAT（支持恢复与永久删除两级），新建一枚，各设备 tansr init --fresh 重新登录。

设备键会过期吗？ 会。临期时会话内会有「密钥即将过期」提示，重跑 tansr init 即轮换顺延；不再使用的设备到控制台停用其装置键，或在该设备上 tansr logout。tansr logout 不吊销 PAT。

多台电脑、同一个主机名会互相顶掉吗？ 不会。每台装置有 8 位随机装置 id 参与键名，克隆虚机与公司统一镜像各持各键。

摘要卡说凭据降级为明文文件了。 表示这台机器的密钥库不可用（常见于无桌面会话的 Linux 或容器），凭据以 0600 权限文件落盘。tansr doctor 的凭据存储段会持续归因；能修密钥库就修，不能就确保该目录不被其他用户读取。

应用与应用密钥（开发者）

应用密钥和 PAT 有什么不同？ 应用密钥（appid / appkey）代表你的应用，由你在控制台「应用」页签发，只放在你的服务端，用来为你的终端用户换取短期令牌；终端用户不需要 tansr 账号。PAT 代表你本人，只给命令行用。

创建应用要选什么类型？ 桌面应用（Electron 等）/ 移动应用（Android / iOS，经会话服务）/ 服务端应用。一应用一平台，多端多 appid，分吊销面、分用量归因。

appkey 泄露了。 控制台「应用」页轮换，更新服务端环境变量并重启；旧 appkey 即时失效。还可以按终端用户定向吊销其存量令牌，或停用整个应用。应用还可配置 IP 白名单（命中外为 app_ip_denied）。

新签发的应用键要求请求签名？ 是，缺省强制；你的换发端点须带 x-tansr-ts / x-tansr-nonce / x-tansr-sign 三头，未签名恒 401 signature_invalid。官方样板 examples/token-server 有即拿即用实现。

套餐与并发

能力分档吗？ 不。裁决人、记忆、上下文方案、媒体、MCP、组织治理全档同一套产品，档位只差并发、应用数、成员数、模型资费与服务。你在测试期做出来的东西升档零改动。

档	对应人群	并发上限	应用数	模型资费
个人	个人用户，仅命令行	不设档	0（创建应用即进入测试期）	牌价
测试期	集成测试、企业起步	10	3	牌价；套餐费全额转为模型余额
小规模	独立软件制作人	100	10	牌价
中规模	入门级企业	1,000	32	协议价
较大规模	旗舰级企业	10,000	100	协议价，专属上游可选

价格、月付 / 年付选项与购买入口以控制台「套餐」页为准。

并发怎么算？ 账户（个人 / 组织）下 5 分钟心跳窗内活跃会话数的峰值：命令行成员会话与你的 SDK / 会话服务终端用户会话合并计数，同一账号下按会话 id 去重。硬帽 = 档位 × 1.1（10% 抖动宽限）；80% / 100% 水位由平台每日告警一次。

撞帽会发生什么？ 平台回 429 plan_concurrency_exceeded，携 Retry-After: 30。只拒新会话，既有会话不断。 命令行 TUI 出一条横幅并附套餐页链接，不自动重试——30 秒后手动再发即可；会话服务形态下终端用户只看到「稍后重试」，配额事实进你的服务端日志。

测试期还有什么帽？ 月度不同终端用户数 100（仅铸令牌径），触顶 plan_end_users_exceeded。应用数、组织成员数达档位上限时只禁新建、不停用存量。

到期会怎样？ 14 天宽限期；宽限后回落到测试期上限，应用不消失。tansr doctor 的套餐行会显示三态之一：生效中 / 已到期处于宽限期 / 已回落到测试期上限（附原档名）。控制台可查看套餐、报价与套餐用量，也支持卡密兑换。

个人档为什么 doctor 说「无套餐费」？ 个人用命令行不收套餐费，按牌价从余额扣；这行不是故障，不进阻断问题。

余额、账单与发票

怎么充值？ 控制台「余额」页下单（订单页可查历史订单状态）。余额为零或不可得时 tansr init 摘要卡会警示并附首充引导，不阻断。

余额低了会有什么提示？ TUI 状态栏余额段低于 1 元转为恒可见警示；控制台按预警阈值显示横幅；绑了邮箱会收到预警邮件（同日至多一封）。余额耗尽后平台模型调用被服务端计费闸拒绝（insufficient_balance），本地功能不受影响。

在哪看用量与账单？ 控制台用量页（按应用 / 按成员分解）、月度账单页；命令行 /cost /usage 看本会话。开发者对终端用户的对账用 GET /v1/app-usage/by-end-user（含金额）；终端自查 GET /v1/my-usage 恒无金额字段。

发票怎么开？ 控制台填写开票资料（发票抬头信息页）后按账单申请。

套餐能退吗？ 有资格条件；不满足时返回 refund_not_eligible，以控制台提示为准。

还是不行

登录 / 密钥问题：先跑 tansr doctor，把凭据存储段与 localProviders 段截图或复制（不含密钥值）。
计费问题：准备好账号指纹（tansr init 摘要卡上的形态，不是 PAT 本身）、订单号或账单月份。
然后去联系支持。