账号、语言与设置
一些零碎但会被问到的事：怎么登录、中英文怎么切、深色模式在哪、账户菜单里那几行是什么意思。
一览
| 登录方式 | Google 账号或微信，在统一登录页上选 |
|---|---|
| 界面语言 | 中文 / English 两种 |
| 对话语言 | 不受界面语言限制。你用什么语言说，它就用什么语言回（能分辨中文 / 英文 / 日语 / 韩语） |
| 主题 | 浅色 / 深色 |
| 积分与用量 | 目前显示「即将支持」，还没上线 |
| 文档要不要登录 | 不要。你正在看的这份文档不登录也能打开 |
登录
点登录会跳到统一登录页，在那里用 Google 账号或微信授权。首次登录会自动建好你的账号，不需要单独注册。产品本身需要登录才能用——因为项目、源码和固件都属于你的个人数据。
English 可以把这一页切成英文。不登录能做什么：看这份文档、看别人公开发布的项目（包括下载固件）。要建项目或者复刻，就必须登录。
界面语言和对话语言不是一回事
这是最容易混淆的一处，但规则很简单：
| 界面语言 | 按钮、标签、菜单这些产品自己写死的文字。「中 / EN」那个按钮控制它，只有中英两种。按钮的位置分两种：项目列表页在左栏底部，进到项目里在顶栏右侧 |
|---|---|
| 对话语言 | 它回复你用的语言。优先跟着你这句话走；这句话看不出语言时才回落到上文，再看不出才用界面语言 |
所以：界面开着英文、你用中文提问，回复仍然是中文。用日语问就用日语回。对话语言不限于中英两种——明确能分辨的是中文、英文、日语、韩语这四种。其他用拉丁字母书写的语言（法语、西班牙语等）不保证：句子里带常见英文虚词的多数会被当成英文，不带的则回落到上文语言或界面语言。
一个细节：如果你这一句本身没有语言特征（比如只回了个 OK、一个数字、一个型号），它会往前看你更早说过的话来判断。所以在中文对话里回一个 OK，接下来仍然是中文。如果连更早的话也没有——比如一个新项目的第一句就是这种——那就用当前的界面语言兜底。
深色模式
一个月亮/太阳的按钮，点一下切换。它和语言按钮挨在一起，位置同样分两种：项目列表页在左栏底部，进到项目里在顶栏右侧。设置存在你这台机器的浏览器里。
账户菜单
你的头像点开是账户菜单，分个人信息和用量两块。头像的位置与上面两个按钮相同：项目列表页在左栏底部，进到项目里在顶栏右侧。
| 用户 ID | 你的唯一标识。报问题的时候把它带上：日志和数据都按它归属，没有它只能靠项目名反查 |
|---|---|
| 昵称 | 显示名 |
| 状态 | 账号状态，正常是 ACTIVE。不是 ACTIVE 的账号，所有接口都会被拒绝 |
| 账号来源 | 这条账号记录是怎么建起来的。从统一登录页进来的账号一律是 USER_SERVICE——它不区分 Google 还是微信 |
| 平台角色 | 你在平台里的角色，普通账号是 USER。它不是账号状态，和上一行是两回事 |
| 积分 · Token 消耗 | 即将支持。现在这两栏还没有真实数据 |
「即将支持」就是字面意思。目前没有计费，也没有用量上限展示。等这块上线了，这里会变成真实数字。
项目列表与搜索
项目列表页的左栏是你所有的项目，新建 project 在最上面，下面是搜索框，按名字过滤。项目很多的时候这个比翻列表快。
首页下方还有两个标签页：我的 project（按最近活动排序）和 公开共享（别人发布出来的，按发布时间排序）。
删除项目
删除是不可逆的，所以要你输入 DELETE（全大写）确认。
⚠️ 如果这个项目有公开发布出去的版本，删除不会把它下架，而且删除之后你就再也没法撤下它了。
要下架，顺序必须是：先回项目里说「转私有」，再回来删除。界面上删除弹窗里也会提醒你这一条。
实时连接
「实时连接」这盏小灯只在项目里面才有，位置是顶栏右侧、下载与烧录那排按钮的旁边；项目列表页上没有它。它标的是页面的取数状态——长任务的进度和结果都是通过实时通道推给你的。
灯上只会出现两种文字：
| 实时连接 | 常态，绿点。表示这个项目的数据已经取回来了 |
|---|---|
| 需要同步 | 红点，表示页面正在重新拉取这个项目的数据。拉完会自己变回「实时连接」，不需要你做什么；如果它写着「需要同步」停了几秒以上还不变，就刷新页面 |
还有一件必须知道的事：实时通道断了，这盏灯不会变。连接掉线之后浏览器会按 1 秒、2 秒、5 秒、10 秒、30 秒的间隔自动重连，界面上看不出来。所以判断「是不是卡住了」不能靠这盏灯，要看进度是不是长时间一动不动；真是那样就刷新页面。刷新不会丢失内容，正在跑的那一轮还在后台继续。
如果你熟悉软件开发
那盏灯读的是页面的取数状态，不是 WebSocket 的连接状态：项目快照的 HTTP 请求一返回就置成「实时连接」，之后 socket 掉线只会触发退避重连，不回写界面。而 socket 断了本身也只影响推送，不影响执行——后台的任务照常跑完并落库，刷新页面即可获取结果。
另外一件值得知道的：多标签页同时开着同一个账号可能互相踢掉登录。刷新令牌是轮换的，两个标签页同时轮换会被判成重放，整族令牌一起撤销。表现是两边同时要求重新登录。日常用一个标签页即可。
常见问题
我的数据存在哪？
项目、源码、上传的资料在服务端。串口日志例外——它只在你浏览器本地，不上传。
能换绑账号吗？
目前不行。
项目有数量上限吗？
没有硬性上限。不过首页对话一次最多能看到最近 50 个项目——项目特别多的时候，直接说项目名比让它列清单准。
怎么报问题？
把这四项一起发过来，可以少一轮往返：你的用户 ID、项目名、你在对话里说的那句原话、你看到的报错原文或截图。别转述，原文最有用。