For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /zh/docs/mobile/workspaces.md (or send Accept: text/markdown).
工作区与成员
切换工作区、管理组织并处理邀请。
解析当前工作区
GET /api/workspaces 返回成员的工作区成员资格与当前工作区 id；带工作区 id 的 POST 即切换。服务器按“选择 Cookie → 已存偏好 → 个人工作区”的顺序解析上下文，并核验实时成员资格，因此伪造或过期的选择无法读到别的工作区。
管理组织
GET /api/mobile/organization 返回成员、待处理邀请、席位用量以及调用方能力 —— canManage 与 canLeave；个人工作区则返回 notOrganization。POST 创建组织，PATCH 重命名（仅所有者），DELETE 删除（仅所有者，需输入名称确认）。
组织界面位于“设置 → 成员”与“设置 → 通用”；成员自己的显示名修改走 Better Auth 的 profile 路由，接受 1 到 100 个字符。
邀请与接受
POST /api/mobile/invitations 以邮件发出角色为 admin、member 或 guest 的邀请 —— 仅所有者与管理员可用。带类型的失败涵盖 alreadyMember、alreadyInvited、seatLimitExceeded、dailySendLimit 与 invalidInput，界面可以据此解释每种拒绝。重发与撤销位于邀请 id 路由上，且重发有速率限制。
接受动作通过 <scheme>://invite/<token> 深链接到达：应用把 token 提交到邀请接受路由，后者返回工作区 id、激活该工作区，并在服务端记录此偏好。错误涵盖 expired、emailMismatch、not-pending 与 seat-limit-exceeded。
变更角色与移除成员
PATCH /api/mobile/members/:userId 指派 owner、admin、member 或 guest 角色；DELETE 移除成员；POST /api/mobile/members/leave 主动退出。唯一所有者不能退出或被降级，成员不能通过管理路由移除自己，未产生任何变化的角色修改会被拒绝而非记录。
验证与排障
测试席位上限、已撤销的邀请链接、guest 角色被削减的操作，以及切回个人工作区。被移除成员的缓存选择必须在下一次请求时失败关闭，而不是继续读取旧工作区。