账号、组织与会话基础

这篇解释账号、组织成员关系、当前登录会话和活动组织上下文的区别,帮助用户在正式接入或组织作用域动作之前先读清自己站在哪里。

注册不是开放入口,而是邀请驱动的账号引导

当前注册不是开放注册,而是邀请驱动的账号引导。公开页面可以解释注册路径,但不能把“没有邀请也能自由注册”写成可用路径。技术上,服务端的账号注册动作包括 POST /runtime/accounts/personal/sign-upPOST /runtime/accounts/enterprise/sign-up,两者都要求邀请令牌。

这意味着你看到的注册不是随时开放的公开入口,而是必须带着邀请令牌进入的账号建立动作。文档中心负责把这个边界解释清楚,正式动作页面负责执行,二者不能混成一件事。

对企业和团队来说,这个边界还能避免错误预期:平台不是让任何人匿名进入后再自行声明身份,而是先用邀请把账号进入路径、组织关系和后续责任链连接起来。这样后面的业务协作、智能体接入和组织治理才不会从一个不清楚的身份起点开始。

账号、成员关系和会话不是同一件事

很多读者第一次进入时,最容易把三件事误写成一件事。账号是身份本身;成员关系是你与组织之间的关系;会话是你当前登录后的状态。已经登录,不等于已经选定正确组织;已经属于某个组织,也不等于当前会话已经站在那个组织的活动上下文里。

如果这些关系没拆清,后面的动作就容易误解。例如,一个用户可能已经登录,但还没有选定要代表哪个组织继续;一个用户也可能已经接受某个组织邀请,但当前会话仍需要重新确认活动组织上下文。

这也是文档中心必须先解释这些基础概念的原因。读者不需要先理解所有服务端字段,但必须知道“我是谁”“我属于哪里”“我现在是否登录”“我当前代表哪个组织继续”是四个不同问题。

登录之后先读清当前状态

登录动作对应 POST /runtime/sessions/sign-in。登录成功后,真正该先看的不是“我是不是马上能点下一步”,而是服务端当前账号状态返回了什么。技术读者可以把 GET /runtime/account/me 理解成后续动作前的状态读取入口。

这条状态会告诉你当前账号、成员关系、会话、活动组织上下文和访问边界现在处在什么状态。如果这里还没讲清,后面看到的许多组织作用域动作其实都还不该继续。

如果状态显示还缺少组织上下文,正确做法不是反复尝试后续按钮,而是先回到组织选择或邀请续链。这样能避免把接入、成员治理或业务任务推进到没有责任前提的位置。

什么时候必须处理活动组织上下文

组织作用域动作之前,必须先看活动组织上下文是不是已经明确。技术上,对应的正式动作为 POST /runtime/account/select-org。如果服务端把你放在需要恢复或明确活动组织上下文的状态里,这一步就不是可选导航,而是继续后续组织作用域动作之前的必要动作。

换句话说,状态读取用来告诉你现在站在哪里,选择组织用来让你把当前活动组织上下文站稳。只有这层站稳了,后续的成员治理、系统接入、智能体接入或组织内任务才有清楚前提。

会话管理处理的是当前登录状态

和会话直接相关的动作还包括 POST /runtime/sessions/refreshPOST /runtime/sessions/revoke。它们处理的是当前会话的新鲜度和撤销,而不是替你改变组织归属、成员关系或管理员责任。

不要把会话管理写成组织治理,也不要把组织治理误读成会话操作。对普通读者来说,最重要的是知道:登录状态、组织关系和当前代表哪个组织继续工作,是三件相关但不同的事。

继续阅读