@csntgao/uni-base 0.2.1 → 0.3.0

package/AGENTS.md

@@ -37,7 +37,7 @@ examples/vanilla         原生 HTML / JavaScript 接入示例
 
 `<uniplat-user-login>` 必须严格复刻亲亲企服 40.1 注册登录原型，提供密码、验证码和扫码三个固定页签、逐字段校验错误态及注册成功过渡页。验证码登录只包含手机号和短信验证码，不得因为接口现状增加图形验证码或其他原型中不存在的字段；旧版 `createCaptcha()` 仅为源码兼容保留，组件不得调用。自定义 Host transport 的密码与扫码方法保持可选，未提供时对应页签保持显示但禁用。UniplatBase 专用 transport 已复用短信验证码及统一 `login-application` 接口提供三种登录能力；组件本身不得保存 JWT，登录结果必须先交给宿主 `setAccessToken()`，再派发不含凭据的成功事件。后端明确返回新用户时显示 2 秒过渡页，并通过 `onboarding-requested` 请求 Host 调用 `<uniplat-account-context>.startOrganizationOnboarding()`。
 
-组织入驻不是公开 Web Component。40.1 原型 02、A/B 企业/团队创建分支、校验/成功状态及 4.1 无归属提示均由 `<uniplat-account-context>` 内部实现；Host 在其 `organizationOnboarding.transport` 中注入创建能力，不能使用或注册 `<uniplat-organization-onboarding>`。无归属用户默认必须先入驻：账户投影为零归属时组件用原生 `dialog.showModal()` 自动打开强制态创建流程，不渲染跳过、无归属提示与关闭按钮，遮罩点击、`Escape` 与 `cancel` 都不关闭，用户只能创建组织或点“退出登录”派发 `logout-requested`；企业/团队表单页提供“返回”回到创建方式选择，创建成功页的认证、升级或邀请动作才是关闭对话框的终点。Host 可用 `organizationOnboarding.mandatory: false` 退回原型 4.1 的可跳过行为。强制态必须使用 top layer 对话框，不得只依赖可能被 Host `transform/overflow` 限制的固定遮罩。点击账户菜单或个人态的“创建团队 / 企业”必须直接启动内部流程，不得向 Host 派发 `organization-create-requested` 或 `create-organization-requested`。真实 UniplatBase transport 复用 `createUniplatBaseOrganizationOnboardingTransport()` 与 `system.org/create_organization`。邀请码加入、企业认证、团队升级和邀请成员等未展开页面仍派发业务事件，由 Host 实现。
+组织入驻不是公开 Web Component。40.1 原型 02、A/B 企业/团队创建分支、校验/成功状态及 4.1 无归属提示均由 `<uniplat-account-context>` 内部实现；Host 在其 `organizationOnboarding.transport` 中注入创建能力，不能使用或注册 `<uniplat-organization-onboarding>`。个人用户不允许以非员工身份留在系统里，因此无归属用户必须先入驻，没有任何跳过开关：账户投影为零归属时组件用原生 `dialog.showModal()` 自动打开强制态创建流程，不渲染跳过、无归属提示与关闭按钮，遮罩点击、`Escape` 与 `cancel` 都不关闭。强制态首屏只有三条出路：创建企业、创建团队，或“已有团队 / 企业？用邀请码加入”派发 `join-organization-requested`（公司已存在的员工必须能加入而不是新建重复组织）；另有“退出登录”派发 `logout-requested`。企业/团队表单页提供“返回”回到创建方式选择，创建成功页的认证、升级或邀请动作才是关闭对话框的终点。`organizationOnboarding` 只接收 `transport`，不得再提供 `mandatory` 之类的退出开关。强制态必须使用 top layer 对话框，不得只依赖可能被 Host `transform/overflow` 限制的固定遮罩。点击账户菜单或个人态的“创建团队 / 企业”必须直接启动内部流程，不得向 Host 派发 `organization-create-requested` 或 `create-organization-requested`。真实 UniplatBase transport 复用 `createUniplatBaseOrganizationOnboardingTransport()` 与 `system.org/create_organization`。邀请码加入、企业认证、团队升级和邀请成员等未展开页面仍派发业务事件，由 Host 实现。
 
 `<uniplat-organization-selector>` 覆盖 40.1 原型 S.1 多归属选择弹窗，显示 Host 提供的完整企业/团队列表、类型、认证状态、角色、成员数和最近进入信息，并自行负责脱敏账户摘要、名称与统一社会信用代码搜索、全部/企业/团队类型筛选、“最近进入 / 全部组织”分组、默认选中和带目标名称的主按钮。选中与记住偏好只在组件内临时维护，点击“进入”后交由 Host 完成登录态切换，“退出登录”只派发事件。`presentation: 'modal'` 时组件自渲染 S.1 强制态弹窗：固定遮罩、无关闭按钮，遮罩点击与 `Escape` 都不关闭，`Escape` 也不冒泡到 Host 的全局关闭逻辑；默认 `inline` 只输出卡片，遮罩归 Host。S.0 的“弹不弹”判定由纯函数 `resolveOrganizationEntryDecision()` 提供，只按 0 个归属、1 个归属、命中记住选择、2 个及以上分别返回 `personal | auto-enter | prompt`；它不读写宿主存储，记住偏好由 Host 自行持久化并回传，记住的组织已不在列表时退回 `prompt`。
 
@@ -324,12 +324,10 @@ userMenu.configure({
 ```ts
 accountContext.configure({
   applicationName,
-  organizationOnboarding: { transport, mandatory },
+  organizationOnboarding: { transport },
 })
 ```
 
-`mandatory` 默认 `true`，非布尔值一律拒绝。
-
 transport 只提供 `createEnterprise()` 和 `createTeam()`；稳定冲突错误使用 `OrganizationOnboardingTransportError`，不得把原始响应、JWT 或内部异常透传给组件。`createEnterprise()` 接收组织名称、企业名称与统一社会信用代码，`createTeam()` 只接收团队名称。创建成功响应只包含稳定 ID、展示名称和 `enterprise | team` 类型。
 
 真实 UniplatBase 对接使用 `createUniplatBaseOrganizationOnboardingTransport({ serviceBaseUrl, getAccessToken })`，复用 `system.org/create_organization`。每次创建前必须重新取 JWT，并只放入 `Authorization: Bearer` header；请求不得携带调用方身份字段。只对白名单冲突码做字段级映射，`INVALID_ARGUMENT`、`ORGANIZATION_CREATE_FAILED` 和所有非协议异常统一收敛为 `UNKNOWN`。
@@ -437,7 +435,7 @@ npm 包名、导出类型名、Custom Element 标签、`configure()` 结构、
 - Account Context 内嵌工作台需测试不注册独立应用切换标签、JWT 只交给 transport、HTTP Authorization header、入口净化、当前组织级应用加 `application_scope=open` 应用的筛选、缺字段时 `oid=0` 兼容、`issue_ticket` 空请求体、签发响应来源进入新 Fragment、公共事件无 JWT/Ticket、Ticket 只进入局部导航 URL、目标页面先清 Fragment 再按初始化应用登录、响应应用绑定校验、加载错误、仅请求应用列表和应用选择交互。
 - User Login 需测试组件注册与导出、三个固定页签、不可用能力禁用、原型中不存在图形验证码且不调用兼容方法、逐字段失焦校验和协议错误态、稳定后端错误码映射、短信倒计时、密码登录、扫码待确认/已扫码/过期/成功状态、注册成功过渡页、2 秒自动入驻和立即开始、页签切换与断开后的定时器清理、登录回调，以及 JWT、密码和二维码 challenge 不进入 URL、DOM、公共事件、日志或安全错误。
 - User Menu 需测试组件注册与导出、40.1 6.7 原型关键内容、个人账号与当前组织员工信息入口、企业认证与团队样式、安全头像与文字回退、Host 受控选中状态、重新配置、空组织状态、完整手机号拒绝、创建与退出事件、普通文本插值，以及公共事件只包含必要的组织 ID，不包含显示名、手机号、组织名称、头像 URL、JWT 或内部配置。
-- 内置组织入驻需测试所有原型步骤、逐字段校验、稳定 transport 错误映射、企业/团队成功状态、跳过与未展开流程事件、普通文本插值，以及公共事件不包含企业信息、信用代码、JWT 或原始异常。强制入驻还需测试零归属投影自动打开 top layer 对话框、不渲染跳过与无归属提示、`Escape` 与外部点击都不关闭、“退出登录”只派发空 detail、表单页“返回”回到创建方式选择、成功页动作才关闭对话框，以及 `mandatory: false` 保持原可跳过行为。真实 UniplatBase transport 还必须测试每次请求重新取 JWT、JWT 只进入 Authorization header、企业/团队请求字段、成功响应净化和未知错误收敛。
+- 内置组织入驻需测试所有原型步骤、逐字段校验、稳定 transport 错误映射、企业/团队成功状态、跳过与未展开流程事件、普通文本插值，以及公共事件不包含企业信息、信用代码、JWT 或原始异常。强制入驻还需测试零归属投影自动打开 top layer 对话框、不渲染跳过与无归属提示、`Escape` 与外部点击都不关闭、“退出登录”与“用邀请码加入”只派发空 detail 且加入不关闭对话框、表单页“返回”回到创建方式选择、成功页动作才关闭对话框，以及传入历史 `mandatory: false` 也不能让无归属用户跳过。真实 UniplatBase transport 还必须测试每次请求重新取 JWT、JWT 只进入 Authorization header、企业/团队请求字段、成功响应净化和未知错误收敛。
 - Organization Selector 需测试完整列表、企业认证与团队类型样式、脱敏账户摘要与完整手机号拒绝、按名称和统一社会信用代码搜索且代码不进入 DOM、类型筛选与常显计数、“最近进入 / 全部组织”分组与默认选中、带目标名称的主按钮、无匹配与空归属状态、记住偏好、创建/进入/退出登录事件、`modal` 强制态无关闭按钮且遮罩点击与 `Escape` 都不关闭并在移除后解除 `Escape` 拦截、非法 `presentation` 与重复 ID 拒绝和普通文本插值；事件只包含稳定组织 ID 与偏好，不含姓名、手机号、组织名称或信用代码。`resolveOrganizationEntryDecision()` 需测试 0 个归属、单一归属、命中与失效的记住选择、2 个及以上的默认选中项和非法输入拒绝。
 - Organization Multi Employee Selector 需测试部门树、员工分页和搜索、初始选择补取、跨部门按员工 ID 去重、多选上限、受保护项、确认/取消事件、独立滚动、移动视图、错误重试、身份切换清理，以及 JWT、完整手机号、身份字段和后端错误不进入 DOM、事件、URL或日志。专用 transport 必须测试每次请求重新读取 JWT、只使用 Authorization header、组织级 directory scope 和无调用方身份参数。
 - Organization Single Employee Selector 需测试独立标签与导出、初始单个 ID 回显、新选择替换旧选择、未选时禁止确认、受保护项、标量确认 detail、拒绝多选打开参数，以及与多选组件相同的数据和认证安全边界。

package/CLAUDE.md

@@ -37,7 +37,7 @@ examples/vanilla         原生 HTML / JavaScript 接入示例
 
 `<uniplat-user-login>` 必须严格复刻亲亲企服 40.1 注册登录原型，提供密码、验证码和扫码三个固定页签、逐字段校验错误态及注册成功过渡页。验证码登录只包含手机号和短信验证码，不得因为接口现状增加图形验证码或其他原型中不存在的字段；旧版 `createCaptcha()` 仅为源码兼容保留，组件不得调用。自定义 Host transport 的密码与扫码方法保持可选，未提供时对应页签保持显示但禁用。UniplatBase 专用 transport 已复用短信验证码及统一 `login-application` 接口提供三种登录能力；组件本身不得保存 JWT，登录结果必须先交给宿主 `setAccessToken()`，再派发不含凭据的成功事件。后端明确返回新用户时显示 2 秒过渡页，并通过 `onboarding-requested` 请求 Host 调用 `<uniplat-account-context>.startOrganizationOnboarding()`。
 
-组织入驻不是公开 Web Component。40.1 原型 02、A/B 企业/团队创建分支、校验/成功状态及 4.1 无归属提示均由 `<uniplat-account-context>` 内部实现；Host 在其 `organizationOnboarding.transport` 中注入创建能力，不能使用或注册 `<uniplat-organization-onboarding>`。无归属用户默认必须先入驻：账户投影为零归属时组件用原生 `dialog.showModal()` 自动打开强制态创建流程，不渲染跳过、无归属提示与关闭按钮，遮罩点击、`Escape` 与 `cancel` 都不关闭，用户只能创建组织或点“退出登录”派发 `logout-requested`；企业/团队表单页提供“返回”回到创建方式选择，创建成功页的认证、升级或邀请动作才是关闭对话框的终点。Host 可用 `organizationOnboarding.mandatory: false` 退回原型 4.1 的可跳过行为。强制态必须使用 top layer 对话框，不得只依赖可能被 Host `transform/overflow` 限制的固定遮罩。点击账户菜单或个人态的“创建团队 / 企业”必须直接启动内部流程，不得向 Host 派发 `organization-create-requested` 或 `create-organization-requested`。真实 UniplatBase transport 复用 `createUniplatBaseOrganizationOnboardingTransport()` 与 `system.org/create_organization`。邀请码加入、企业认证、团队升级和邀请成员等未展开页面仍派发业务事件，由 Host 实现。
+组织入驻不是公开 Web Component。40.1 原型 02、A/B 企业/团队创建分支、校验/成功状态及 4.1 无归属提示均由 `<uniplat-account-context>` 内部实现；Host 在其 `organizationOnboarding.transport` 中注入创建能力，不能使用或注册 `<uniplat-organization-onboarding>`。个人用户不允许以非员工身份留在系统里，因此无归属用户必须先入驻，没有任何跳过开关：账户投影为零归属时组件用原生 `dialog.showModal()` 自动打开强制态创建流程，不渲染跳过、无归属提示与关闭按钮，遮罩点击、`Escape` 与 `cancel` 都不关闭。强制态首屏只有三条出路：创建企业、创建团队，或“已有团队 / 企业？用邀请码加入”派发 `join-organization-requested`（公司已存在的员工必须能加入而不是新建重复组织）；另有“退出登录”派发 `logout-requested`。企业/团队表单页提供“返回”回到创建方式选择，创建成功页的认证、升级或邀请动作才是关闭对话框的终点。`organizationOnboarding` 只接收 `transport`，不得再提供 `mandatory` 之类的退出开关。强制态必须使用 top layer 对话框，不得只依赖可能被 Host `transform/overflow` 限制的固定遮罩。点击账户菜单或个人态的“创建团队 / 企业”必须直接启动内部流程，不得向 Host 派发 `organization-create-requested` 或 `create-organization-requested`。真实 UniplatBase transport 复用 `createUniplatBaseOrganizationOnboardingTransport()` 与 `system.org/create_organization`。邀请码加入、企业认证、团队升级和邀请成员等未展开页面仍派发业务事件，由 Host 实现。
 
 `<uniplat-organization-selector>` 覆盖 40.1 原型 S.1 多归属选择弹窗，显示 Host 提供的完整企业/团队列表、类型、认证状态、角色、成员数和最近进入信息，并自行负责脱敏账户摘要、名称与统一社会信用代码搜索、全部/企业/团队类型筛选、“最近进入 / 全部组织”分组、默认选中和带目标名称的主按钮。选中与记住偏好只在组件内临时维护，点击“进入”后交由 Host 完成登录态切换，“退出登录”只派发事件。`presentation: 'modal'` 时组件自渲染 S.1 强制态弹窗：固定遮罩、无关闭按钮，遮罩点击与 `Escape` 都不关闭，`Escape` 也不冒泡到 Host 的全局关闭逻辑；默认 `inline` 只输出卡片，遮罩归 Host。S.0 的“弹不弹”判定由纯函数 `resolveOrganizationEntryDecision()` 提供，只按 0 个归属、1 个归属、命中记住选择、2 个及以上分别返回 `personal | auto-enter | prompt`；它不读写宿主存储，记住偏好由 Host 自行持久化并回传，记住的组织已不在列表时退回 `prompt`。
 
@@ -324,12 +324,10 @@ userMenu.configure({
 ```ts
 accountContext.configure({
   applicationName,
-  organizationOnboarding: { transport, mandatory },
+  organizationOnboarding: { transport },
 })
 ```
 
-`mandatory` 默认 `true`，非布尔值一律拒绝。
-
 transport 只提供 `createEnterprise()` 和 `createTeam()`；稳定冲突错误使用 `OrganizationOnboardingTransportError`，不得把原始响应、JWT 或内部异常透传给组件。`createEnterprise()` 接收组织名称、企业名称与统一社会信用代码，`createTeam()` 只接收团队名称。创建成功响应只包含稳定 ID、展示名称和 `enterprise | team` 类型。
 
 真实 UniplatBase 对接使用 `createUniplatBaseOrganizationOnboardingTransport({ serviceBaseUrl, getAccessToken })`，复用 `system.org/create_organization`。每次创建前必须重新取 JWT，并只放入 `Authorization: Bearer` header；请求不得携带调用方身份字段。只对白名单冲突码做字段级映射，`INVALID_ARGUMENT`、`ORGANIZATION_CREATE_FAILED` 和所有非协议异常统一收敛为 `UNKNOWN`。
@@ -437,7 +435,7 @@ npm 包名、导出类型名、Custom Element 标签、`configure()` 结构、
 - Account Context 内嵌工作台需测试不注册独立应用切换标签、JWT 只交给 transport、HTTP Authorization header、入口净化、当前组织级应用加 `application_scope=open` 应用的筛选、缺字段时 `oid=0` 兼容、`issue_ticket` 空请求体、签发响应来源进入新 Fragment、公共事件无 JWT/Ticket、Ticket 只进入局部导航 URL、目标页面先清 Fragment 再按初始化应用登录、响应应用绑定校验、加载错误、仅请求应用列表和应用选择交互。
 - User Login 需测试组件注册与导出、三个固定页签、不可用能力禁用、原型中不存在图形验证码且不调用兼容方法、逐字段失焦校验和协议错误态、稳定后端错误码映射、短信倒计时、密码登录、扫码待确认/已扫码/过期/成功状态、注册成功过渡页、2 秒自动入驻和立即开始、页签切换与断开后的定时器清理、登录回调，以及 JWT、密码和二维码 challenge 不进入 URL、DOM、公共事件、日志或安全错误。
 - User Menu 需测试组件注册与导出、40.1 6.7 原型关键内容、个人账号与当前组织员工信息入口、企业认证与团队样式、安全头像与文字回退、Host 受控选中状态、重新配置、空组织状态、完整手机号拒绝、创建与退出事件、普通文本插值，以及公共事件只包含必要的组织 ID，不包含显示名、手机号、组织名称、头像 URL、JWT 或内部配置。
-- 内置组织入驻需测试所有原型步骤、逐字段校验、稳定 transport 错误映射、企业/团队成功状态、跳过与未展开流程事件、普通文本插值，以及公共事件不包含企业信息、信用代码、JWT 或原始异常。强制入驻还需测试零归属投影自动打开 top layer 对话框、不渲染跳过与无归属提示、`Escape` 与外部点击都不关闭、“退出登录”只派发空 detail、表单页“返回”回到创建方式选择、成功页动作才关闭对话框，以及 `mandatory: false` 保持原可跳过行为。真实 UniplatBase transport 还必须测试每次请求重新取 JWT、JWT 只进入 Authorization header、企业/团队请求字段、成功响应净化和未知错误收敛。
+- 内置组织入驻需测试所有原型步骤、逐字段校验、稳定 transport 错误映射、企业/团队成功状态、跳过与未展开流程事件、普通文本插值，以及公共事件不包含企业信息、信用代码、JWT 或原始异常。强制入驻还需测试零归属投影自动打开 top layer 对话框、不渲染跳过与无归属提示、`Escape` 与外部点击都不关闭、“退出登录”与“用邀请码加入”只派发空 detail 且加入不关闭对话框、表单页“返回”回到创建方式选择、成功页动作才关闭对话框，以及传入历史 `mandatory: false` 也不能让无归属用户跳过。真实 UniplatBase transport 还必须测试每次请求重新取 JWT、JWT 只进入 Authorization header、企业/团队请求字段、成功响应净化和未知错误收敛。
 - Organization Selector 需测试完整列表、企业认证与团队类型样式、脱敏账户摘要与完整手机号拒绝、按名称和统一社会信用代码搜索且代码不进入 DOM、类型筛选与常显计数、“最近进入 / 全部组织”分组与默认选中、带目标名称的主按钮、无匹配与空归属状态、记住偏好、创建/进入/退出登录事件、`modal` 强制态无关闭按钮且遮罩点击与 `Escape` 都不关闭并在移除后解除 `Escape` 拦截、非法 `presentation` 与重复 ID 拒绝和普通文本插值；事件只包含稳定组织 ID 与偏好，不含姓名、手机号、组织名称或信用代码。`resolveOrganizationEntryDecision()` 需测试 0 个归属、单一归属、命中与失效的记住选择、2 个及以上的默认选中项和非法输入拒绝。
 - Organization Multi Employee Selector 需测试部门树、员工分页和搜索、初始选择补取、跨部门按员工 ID 去重、多选上限、受保护项、确认/取消事件、独立滚动、移动视图、错误重试、身份切换清理，以及 JWT、完整手机号、身份字段和后端错误不进入 DOM、事件、URL或日志。专用 transport 必须测试每次请求重新读取 JWT、只使用 Authorization header、组织级 directory scope 和无调用方身份参数。
 - Organization Single Employee Selector 需测试独立标签与导出、初始单个 ID 回显、新选择替换旧选择、未选时禁止确认、受保护项、标量确认 detail、拒绝多选打开参数，以及与多选组件相同的数据和认证安全边界。

package/README.md

@@ -300,20 +300,17 @@ accountContext.configure({
 
 内部流程会经账户组件派发 `onboarding-skipped`、`join-organization-requested`、`organization-created`、`enterprise-authentication-requested`、`enterprise-authentication-deferred`、`team-upgrade-requested`、`team-invite-members-requested`、`logout-requested` 和安全的 `error` 事件。Host 可通过账户组件的 `onboarding-panel` part 定制该浮层或对话框。
 
-无归属用户默认必须先入驻。账户投影返回零归属时，组件用原生 `dialog.showModal()` 自动打开强制态创建流程：
+个人用户不允许以非员工身份留在系统里，所以无归属用户必须先入驻，没有跳过开关。账户投影返回零归属时，组件用原生 `dialog.showModal()` 自动打开强制态创建流程：
 
 ```js
 accountContext.configure({
   applicationName: 'OfficialWebsite',
   transport: accountTransport,
-  organizationOnboarding: {
-    transport: organizationOnboardingTransport,
-    mandatory: true, // 默认值；传 false 回到可跳过的原型 4.1 行为
-  },
+  organizationOnboarding: { transport: organizationOnboardingTransport },
 })
 ```
 
-强制态下不渲染“跳过”“暂不创建，先逛逛”“用邀请码加入”和关闭按钮，遮罩点击、`Escape` 与原生 `cancel` 都不关闭，用户只有两条出路：创建组织，或点“退出登录”（派发 `logout-requested`，由 Host 清理登录态）。企业/团队表单页提供“返回”回到创建方式选择，避免困在错误分支；创建成功页的“去认证 / 稍后认证 / 升级为企业 / 邀请成员”是关闭对话框的终点。对话框使用 top layer，不受 Host 导航 `transform` 或 `overflow` 影响。
+强制态下不渲染“跳过”“暂不创建，先逛逛”和关闭按钮，遮罩点击、`Escape` 与原生 `cancel` 都不关闭。首屏出路有三条：创建企业、创建团队，或“已有团队 / 企业？用邀请码加入”（派发 `join-organization-requested`，Host 打开邀请码页面；公司已存在的员工必须能加入而不是新建重复组织）；另有“退出登录”派发 `logout-requested`，由 Host 清理登录态。企业/团队表单页提供“返回”回到创建方式选择，避免困在错误分支；创建成功页的“去认证 / 稍后认证 / 升级为企业 / 邀请成员”是关闭对话框的终点。对话框使用 top layer，不受 Host 导航 `transform` 或 `overflow` 影响。
 
 ### Organization Selector
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@csntgao/uni-base",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "type": "module",
   "packageManager": "pnpm@11.3.0",
   "publishConfig": {

package/packages/web-components/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniplat/ai-employee-web-components",
-  "version": "0.25.1",
+  "version": "0.26.0",
   "description": "Framework-independent Web Components for Uniplat account, login, application switching and AI Employee chat",
   "type": "module",
   "sideEffects": true,

package/packages/web-components/src/account-context.ts

@@ -117,11 +117,6 @@ export interface AccountContextConfig {
    */
   organizationOnboarding?: {
     transport: OrganizationOnboardingTransport
-    /**
-     * 无归属用户是否必须先入驻。默认开启：加载到零归属投影时组件自动以
-     * 强制模式对话框打开创建流程，用户只能创建组织或退出登录。
-     */
-    mandatory?: boolean
   }
 }
 
@@ -719,7 +714,6 @@ export class UniplatAccountContext extends LitElement {
 
   private workbenchConfig: ApplicationSwitcherConfig | null = null
   private organizationOnboardingTransport: OrganizationOnboardingTransport | null = null
-  private organizationOnboardingMandatory = true
   private configuredOnboardingMandatory = false
   private applicationName = ''
   private accountTransport: AccountContextTransport | null = null
@@ -750,9 +744,6 @@ export class UniplatAccountContext extends LitElement {
     this.organizationOnboardingTransport = normalizeOrganizationOnboardingTransport(
       config.organizationOnboarding?.transport,
     )
-    this.organizationOnboardingMandatory = normalizeMandatoryOnboarding(
-      config.organizationOnboarding?.mandatory,
-    )
     this.mandatoryOnboarding = false
     this.configuredApplicationSwitcher = null
     this.configuredUserMenu = null
@@ -884,13 +875,12 @@ export class UniplatAccountContext extends LitElement {
   }
 
   /**
-   * 无归属用户必须先入驻：加载到零归属投影时自动以强制模式对话框打开创建流程。
-   * 创建成功后投影不再为空，但对话框保持强制态直到用户在成功页完成后续动作，
-   * 避免界面从模式对话框跳回小浮层。
+   * 无归属用户必须先入驻，没有可跳过的开关：加载到零归属投影时自动以强制模式
+   * 对话框打开创建流程。创建成功后投影不再为空，但对话框保持强制态直到用户在
+   * 成功页完成后续动作，避免界面从模式对话框跳回小浮层。
    */
   private syncMandatoryOnboarding(): void {
     if (
-      this.organizationOnboardingMandatory &&
       this.organizationOnboardingTransport &&
       this.viewModel &&
       this.viewModel.organizations.length === 0 &&
@@ -1462,14 +1452,6 @@ function normalizeWorkbench(
   return workbench
 }
 
-function normalizeMandatoryOnboarding(value: unknown): boolean {
-  if (value === undefined) return true
-  if (typeof value !== 'boolean') {
-    throw new TypeError('account-context organizationOnboarding.mandatory must be a boolean')
-  }
-  return value
-}
-
 function normalizeOrganizationOnboardingTransport(
   transport: OrganizationOnboardingTransport | undefined,
 ): OrganizationOnboardingTransport | null {

package/packages/web-components/src/organization-onboarding.ts

@@ -273,6 +273,11 @@ export class InternalOrganizationOnboarding extends LitElement {
       background: #ffffff;
     }
 
+    .join-action {
+      width: 100%;
+      margin-top: 10px;
+    }
+
     .form {
       display: grid;
       gap: 15px;
@@ -635,6 +640,19 @@ export class InternalOrganizationOnboarding extends LitElement {
           >
             下一步
           </button>
+          ${
+            // 强制入驻时这里是唯一的首屏出口之一：公司已存在的员工应当加入而不是新建重复组织。
+            this.mandatory
+              ? html`<button
+                  class="secondary join-action"
+                  part="join-action"
+                  type="button"
+                  @click=${() => this.requestJoin()}
+                >
+                  已有团队 / 企业？用邀请码加入
+                </button>`
+              : nothing
+          }
         </div>
       </section>
     `

package/packages/web-components/tests/account-context.test.ts

@@ -69,24 +69,28 @@ function emptyProjection(): AccountContextProjection {
   }
 }
 
-async function mountUnassigned(
-  mandatory?: boolean,
-): Promise<{ context: UniplatAccountContext; logout: ReturnType<typeof vi.fn> }> {
+async function mountUnassigned(extraOnboardingConfig: Record<string, unknown> = {}): Promise<{
+  context: UniplatAccountContext
+  logout: ReturnType<typeof vi.fn>
+  join: ReturnType<typeof vi.fn>
+}> {
   const context = document.createElement(ACCOUNT_CONTEXT_TAG)
   const logout = vi.fn()
+  const join = vi.fn()
   context.addEventListener('logout-requested', logout)
+  context.addEventListener('join-organization-requested', join)
   context.configure({
     applicationName: APPLICATION_NAME,
     transport: { load: async () => emptyProjection() },
     organizationOnboarding: {
       transport: createMockOrganizationOnboardingTransport(),
-      ...(mandatory === undefined ? {} : { mandatory }),
+      ...extraOnboardingConfig,
     },
   })
   document.body.append(context)
   await vi.waitFor(() => expect(context.shadowRoot?.querySelector('.display-name')).not.toBeNull())
   await settle(context)
-  return { context, logout }
+  return { context, logout, join }
 }
 
 describe('<uniplat-account-context>', () => {
@@ -237,6 +241,7 @@ describe('<uniplat-account-context>', () => {
     expect(onboardingRoot?.textContent).toContain('创建你的团队 / 企业')
     expect(onboardingRoot?.textContent).not.toContain('跳过')
     expect(onboardingRoot?.textContent).not.toContain('暂不创建')
+    expect(onboardingRoot?.textContent).not.toContain('先逛逛')
     expect(onboardingRoot?.querySelector('[part="skip-action"]')).toBeNull()
 
     const logoutAction = onboardingRoot?.querySelector<HTMLButtonElement>('[part="logout-action"]')
@@ -302,12 +307,28 @@ describe('<uniplat-account-context>', () => {
     expect(context.shadowRoot?.querySelector('[part="onboarding-panel"]')).toBeNull()
   })
 
-  it('keeps the previous optional onboarding behaviour when mandatory is disabled', async () => {
-    const { context } = await mountUnassigned(false)
+  it('has no opt-out: a legacy mandatory flag cannot let unassigned users skip onboarding', async () => {
+    const { context } = await mountUnassigned({ mandatory: false })
 
-    expect(context.shadowRoot?.querySelector('.onboarding-modal')).toBeNull()
-    expect(context.shadowRoot?.querySelector('[part="onboarding-panel"]')).toBeNull()
-    expect(context.shadowRoot?.textContent).toContain('创建团队 / 企业')
+    expect(context.shadowRoot?.querySelector('dialog.onboarding-modal')).not.toBeNull()
+    const onboardingRoot = context.shadowRoot?.querySelector(
+      'uniplat-internal-organization-onboarding',
+    )?.shadowRoot
+    expect(onboardingRoot?.querySelector('[part="skip-action"]')).toBeNull()
+  })
+
+  it('keeps the invite-code path in the forced flow so existing employees do not create duplicates', async () => {
+    const { context, join } = await mountUnassigned()
+    const onboardingRoot = context.shadowRoot?.querySelector(
+      'uniplat-internal-organization-onboarding',
+    )?.shadowRoot
+
+    const joinAction = onboardingRoot?.querySelector<HTMLButtonElement>('[part="join-action"]')
+    expect(joinAction?.textContent?.trim()).toBe('已有团队 / 企业？用邀请码加入')
+    joinAction?.click()
+    expect(join).toHaveBeenCalledTimes(1)
+    expect(join.mock.calls[0]?.[0].detail).toEqual({})
+    expect(context.shadowRoot?.querySelector('dialog.onboarding-modal')).not.toBeNull()
   })
 
   it('registers and renders the personal account navigation state', async () => {