@csntgao/uni-base 0.1.4 → 0.2.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>`。点击账户菜单或个人态的“创建团队 / 企业”必须直接启动内部流程，不得向 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` 都不关闭，用户只能创建组织或点“退出登录”派发 `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 实现。
 
 `<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`。
 
@@ -45,7 +45,7 @@ examples/vanilla         原生 HTML / JavaScript 接入示例
 
 `<uniplat-organization-single-employee-selector>` 是语义独立的组织员工单选公共组件。它可与多选组件复用内部数据控制器和真实 transport，但公开标签、`open()` 参数和确认 detail 必须独立。单选界面不渲染多选的已选右侧栏和移动端已选页签，候选区占满内容宽度，选择标识必须为单选圆点而非复选框。单选组件只接收 `initialSelectedEmployeeId`，确认时只返回 `{ employeeId, employee }`；不得向任一组件暴露 `selectionMode`，也不得让单选组件接收 `maxSelection` 或多选 ID 数组。候选数据继续只包含当前 JWT 组织内在职且启用的员工，JWT 和身份字段安全边界与多选组件一致。
 
-`<uniplat-account-context>` 是 40.1 原型导航右侧的统一账户工作台组件，不渲染品牌和全局菜单。它在一个 Host 元素内包含工作台入口、账户胶囊、应用入口浮层和 6.7 企业/团队切换浮层；两个浮层互斥并绝对定位，不改变导航布局。组件根据 Host 提供的 `applicationName` 和账户 transport 自行加载当前应用对应的组织投影与企业认证状态；用户资料复用 `list_available_organizations` 顶层的 `display_name`、`avatar_url` 与 `mobile_masked`，不得再请求 `profile_summary_v2`，Host 不再组装这些展示数据。它支持无归属个人态、企业未认证/审核中/未通过/已认证/认证过期和团队态；组织切换由 Host 响应事件，应用加载与 ticket 跳转复用独立的 Application Switcher transport。选中组织时，账户胶囊和菜单资料区必须使用服务端投影中该组织的员工姓名与头像；没有选中组织或该组织没有员工身份时，回退到用户资料。组织列表严格使用原型中的企业建筑与团队成员图标，不得替换成员工头像或组织首字。
+`<uniplat-account-context>` 是 40.1 原型导航右侧的统一账户工作台组件，不渲染品牌和全局菜单。它在一个 Host 元素内包含工作台入口、账户胶囊、应用入口浮层和 6.7 企业/团队切换浮层；两个浮层互斥并绝对定位，不改变导航布局。组件根据 Host 提供的 `applicationName` 和账户 transport 自行加载当前应用对应的组织投影与企业认证状态；用户资料复用 `list_available_organizations` 顶层的 `display_name`、`avatar_url` 与 `mobile_masked`，不得再请求 `profile_summary_v2`，Host 不再组装这些展示数据。它支持无归属个人态、企业未认证/审核中/未通过/已认证/认证过期和团队态；组织切换由 Host 响应事件，应用加载与 ticket 跳转复用独立的 Application Switcher transport。选中组织时，账户胶囊和菜单资料区必须使用服务端投影中该组织的员工姓名与头像；没有选中组织或该组织没有员工身份时，回退到用户资料。账户胶囊宽度固定，胶囊内姓名超过 6 个字、组织名称超过 8 个字必须截断为省略号，完整值只放在 `title` 上，不得让长名称撑宽胶囊挤压导航左侧内容；展开菜单内仍显示完整名称。组织列表严格使用原型中的企业建筑与团队成员图标，不得替换成员工头像或组织首字。
 
 `<uniplat-notification-center>` 是内嵌通知中心面板，复刻 AE-Enterprise-Admin 通知中心原型的两栏收件箱：面板顶栏、五类页签、列表、详情、关联资源、附件下载与“全部标已读”。**组件和 core 都不建立 WebSocket 连接**：Host 保留自己唯一的 `/api/user-realtime/ws` 连接并订阅 `notification` channel，把事件原始负载通过 `applyRealtimeEvent()` 喂给组件；`authenticate` 首帧、心跳、游标、重连和断连提示全部归 Host。组件只负责收件箱投影、增量更新和未读数，顶栏铃铛仍属 Host chrome。不得为通知新增第二条 socket 或平行实时通道。
 
@@ -324,10 +324,12 @@ userMenu.configure({
 ```ts
 accountContext.configure({
   applicationName,
-  organizationOnboarding: { transport },
+  organizationOnboarding: { transport, mandatory },
 })
 ```
 
+`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`。
@@ -435,11 +437,11 @@ 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 或原始异常。真实 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、拒绝多选打开参数，以及与多选组件相同的数据和认证安全边界。
-- Account Context 需测试必填应用名、组件通过 transport 自行加载用户资料与完整应用组织投影、无归属、企业五种认证状态和团队状态、当前组织员工身份优先及无组织用户身份回退、安全头像与加载失败回退、工作台、账户菜单与内置入驻浮层互斥、浮层不改变导航布局、内嵌应用九宫格、创建入口直接启动内置入驻、Host 响应组织切换事件、退出和公共事件安全。专用 UniplatBase transport 还必须测试不请求 `profile_summary_v2`、从 `list_available_organizations` 顶层读取用户资料、按 `application_name` 加载投影、Open Application 的 `organization_oid` 切换、组织级应用目标 `xid` 选择、JWT 只进入 Authorization header 和 Host `setAccessToken()`、响应净化、稳定错误以及公共数据无 JWT；组件范围不得扩展为品牌或完整导航。
+- Account Context 需测试必填应用名、组件通过 transport 自行加载用户资料与完整应用组织投影、无归属、企业五种认证状态和团队状态、当前组织员工身份优先及无组织用户身份回退、安全头像与加载失败回退、胶囊内姓名 6 字与组织名 8 字截断及完整 `title`、未超长时不加 `title`、工作台、账户菜单与内置入驻浮层互斥、浮层不改变导航布局、内嵌应用九宫格、创建入口直接启动内置入驻、Host 响应组织切换事件、退出和公共事件安全。专用 UniplatBase transport 还必须测试不请求 `profile_summary_v2`、从 `list_available_organizations` 顶层读取用户资料、按 `application_name` 加载投影、Open Application 的 `organization_oid` 切换、组织级应用目标 `xid` 选择、JWT 只进入 Authorization header 和 Host `setAccessToken()`、响应净化、稳定错误以及公共数据无 JWT；组件范围不得扩展为品牌或完整导航。
 - 通知中心需测试组件注册与导出、两栏首版输出、数据驱动分类页签（`includeTypeFacets` 随收件箱请求、后端 `type_facets` 优先、无 facet 回退累积、筛选后页签不塌缩、展示名取 `notification_type_name` 且为空时回退原始 code、契约四个码不得残留内置中文名、实时新分类入目录）、未读角标与 `unread-count-change`、打开未读即标记已读、全部已读、加载更多、关联资源事件只含安全业务标识、附件经 transport 下载、Markdown 净化、`applyRealtimeEvent()` 不建立任何 WebSocket 且原地更新列表与未读数、事件无法映射时降级刷新、收件箱在途时延后 resync 不丢事件、`configure()` 之前与移除之后喂入事件无副作用、错误横幅为净化文案，以及 JWT 与后端原始正文不进入 DOM、公共事件或日志。小型通知浮层还需测试初始关闭、4 条未读投影、未读总数、严格原型结构与 SVG 图标、单条/全部已读、完整通知页意图事件只含稳定 ID、外部关闭、空态以及 Host 实时事件更新。
 - 使用 fake timer 的测试必须恢复 timer；构造 fake WebSocket 时不要把测试凭据写入 URL。
 - 修复竞态或生命周期问题时增加回归测试，不只验证最终 DOM。

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>`。点击账户菜单或个人态的“创建团队 / 企业”必须直接启动内部流程，不得向 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` 都不关闭，用户只能创建组织或点“退出登录”派发 `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 实现。
 
 `<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`。
 
@@ -45,7 +45,7 @@ examples/vanilla         原生 HTML / JavaScript 接入示例
 
 `<uniplat-organization-single-employee-selector>` 是语义独立的组织员工单选公共组件。它可与多选组件复用内部数据控制器和真实 transport，但公开标签、`open()` 参数和确认 detail 必须独立。单选界面不渲染多选的已选右侧栏和移动端已选页签，候选区占满内容宽度，选择标识必须为单选圆点而非复选框。单选组件只接收 `initialSelectedEmployeeId`，确认时只返回 `{ employeeId, employee }`；不得向任一组件暴露 `selectionMode`，也不得让单选组件接收 `maxSelection` 或多选 ID 数组。候选数据继续只包含当前 JWT 组织内在职且启用的员工，JWT 和身份字段安全边界与多选组件一致。
 
-`<uniplat-account-context>` 是 40.1 原型导航右侧的统一账户工作台组件，不渲染品牌和全局菜单。它在一个 Host 元素内包含工作台入口、账户胶囊、应用入口浮层和 6.7 企业/团队切换浮层；两个浮层互斥并绝对定位，不改变导航布局。组件根据 Host 提供的 `applicationName` 和账户 transport 自行加载当前应用对应的组织投影与企业认证状态；用户资料复用 `list_available_organizations` 顶层的 `display_name`、`avatar_url` 与 `mobile_masked`，不得再请求 `profile_summary_v2`，Host 不再组装这些展示数据。它支持无归属个人态、企业未认证/审核中/未通过/已认证/认证过期和团队态；组织切换由 Host 响应事件，应用加载与 ticket 跳转复用独立的 Application Switcher transport。选中组织时，账户胶囊和菜单资料区必须使用服务端投影中该组织的员工姓名与头像；没有选中组织或该组织没有员工身份时，回退到用户资料。组织列表严格使用原型中的企业建筑与团队成员图标，不得替换成员工头像或组织首字。
+`<uniplat-account-context>` 是 40.1 原型导航右侧的统一账户工作台组件，不渲染品牌和全局菜单。它在一个 Host 元素内包含工作台入口、账户胶囊、应用入口浮层和 6.7 企业/团队切换浮层；两个浮层互斥并绝对定位，不改变导航布局。组件根据 Host 提供的 `applicationName` 和账户 transport 自行加载当前应用对应的组织投影与企业认证状态；用户资料复用 `list_available_organizations` 顶层的 `display_name`、`avatar_url` 与 `mobile_masked`，不得再请求 `profile_summary_v2`，Host 不再组装这些展示数据。它支持无归属个人态、企业未认证/审核中/未通过/已认证/认证过期和团队态；组织切换由 Host 响应事件，应用加载与 ticket 跳转复用独立的 Application Switcher transport。选中组织时，账户胶囊和菜单资料区必须使用服务端投影中该组织的员工姓名与头像；没有选中组织或该组织没有员工身份时，回退到用户资料。账户胶囊宽度固定，胶囊内姓名超过 6 个字、组织名称超过 8 个字必须截断为省略号，完整值只放在 `title` 上，不得让长名称撑宽胶囊挤压导航左侧内容；展开菜单内仍显示完整名称。组织列表严格使用原型中的企业建筑与团队成员图标，不得替换成员工头像或组织首字。
 
 `<uniplat-notification-center>` 是内嵌通知中心面板，复刻 AE-Enterprise-Admin 通知中心原型的两栏收件箱：面板顶栏、五类页签、列表、详情、关联资源、附件下载与“全部标已读”。**组件和 core 都不建立 WebSocket 连接**：Host 保留自己唯一的 `/api/user-realtime/ws` 连接并订阅 `notification` channel，把事件原始负载通过 `applyRealtimeEvent()` 喂给组件；`authenticate` 首帧、心跳、游标、重连和断连提示全部归 Host。组件只负责收件箱投影、增量更新和未读数，顶栏铃铛仍属 Host chrome。不得为通知新增第二条 socket 或平行实时通道。
 
@@ -324,10 +324,12 @@ userMenu.configure({
 ```ts
 accountContext.configure({
   applicationName,
-  organizationOnboarding: { transport },
+  organizationOnboarding: { transport, mandatory },
 })
 ```
 
+`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`。
@@ -435,11 +437,11 @@ 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 或原始异常。真实 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、拒绝多选打开参数，以及与多选组件相同的数据和认证安全边界。
-- Account Context 需测试必填应用名、组件通过 transport 自行加载用户资料与完整应用组织投影、无归属、企业五种认证状态和团队状态、当前组织员工身份优先及无组织用户身份回退、安全头像与加载失败回退、工作台、账户菜单与内置入驻浮层互斥、浮层不改变导航布局、内嵌应用九宫格、创建入口直接启动内置入驻、Host 响应组织切换事件、退出和公共事件安全。专用 UniplatBase transport 还必须测试不请求 `profile_summary_v2`、从 `list_available_organizations` 顶层读取用户资料、按 `application_name` 加载投影、Open Application 的 `organization_oid` 切换、组织级应用目标 `xid` 选择、JWT 只进入 Authorization header 和 Host `setAccessToken()`、响应净化、稳定错误以及公共数据无 JWT；组件范围不得扩展为品牌或完整导航。
+- Account Context 需测试必填应用名、组件通过 transport 自行加载用户资料与完整应用组织投影、无归属、企业五种认证状态和团队状态、当前组织员工身份优先及无组织用户身份回退、安全头像与加载失败回退、胶囊内姓名 6 字与组织名 8 字截断及完整 `title`、未超长时不加 `title`、工作台、账户菜单与内置入驻浮层互斥、浮层不改变导航布局、内嵌应用九宫格、创建入口直接启动内置入驻、Host 响应组织切换事件、退出和公共事件安全。专用 UniplatBase transport 还必须测试不请求 `profile_summary_v2`、从 `list_available_organizations` 顶层读取用户资料、按 `application_name` 加载投影、Open Application 的 `organization_oid` 切换、组织级应用目标 `xid` 选择、JWT 只进入 Authorization header 和 Host `setAccessToken()`、响应净化、稳定错误以及公共数据无 JWT；组件范围不得扩展为品牌或完整导航。
 - 通知中心需测试组件注册与导出、两栏首版输出、数据驱动分类页签（`includeTypeFacets` 随收件箱请求、后端 `type_facets` 优先、无 facet 回退累积、筛选后页签不塌缩、展示名取 `notification_type_name` 且为空时回退原始 code、契约四个码不得残留内置中文名、实时新分类入目录）、未读角标与 `unread-count-change`、打开未读即标记已读、全部已读、加载更多、关联资源事件只含安全业务标识、附件经 transport 下载、Markdown 净化、`applyRealtimeEvent()` 不建立任何 WebSocket 且原地更新列表与未读数、事件无法映射时降级刷新、收件箱在途时延后 resync 不丢事件、`configure()` 之前与移除之后喂入事件无副作用、错误横幅为净化文案，以及 JWT 与后端原始正文不进入 DOM、公共事件或日志。小型通知浮层还需测试初始关闭、4 条未读投影、未读总数、严格原型结构与 SVG 图标、单条/全部已读、完整通知页意图事件只含稳定 ID、外部关闭、空态以及 Host 实时事件更新。
 - 使用 fake timer 的测试必须恢复 timer；构造 fake WebSocket 时不要把测试凭据写入 URL。
 - 修复竞态或生命周期问题时增加回归测试，不只验证最终 DOM。

package/README.md

@@ -298,7 +298,22 @@ accountContext.configure({
 
 该 transport 复用 `POST system.org/create_organization`。企业请求映射为 `organization_type/team_name/customer_name/credit_code`，团队请求只发送 `organization_type/team_name`；不会提交 `uid/oid/eid/owner` 等身份字段。它在每次创建前重新调用 `getAccessToken()`，JWT 只进入 `Authorization: Bearer` header，成功响应只保留组件需要的组织 ID、展示名称和类型。`INVALID_ARGUMENT`、`ORGANIZATION_CREATE_FAILED`、HTTP、解析及 token provider 异常均收敛为 `UNKNOWN`，不透传后端正文。
 
-内部流程会经账户组件派发 `onboarding-skipped`、`join-organization-requested`、`organization-created`、`enterprise-authentication-requested`、`enterprise-authentication-deferred`、`team-upgrade-requested`、`team-invite-members-requested` 和安全的 `error` 事件。Host 可通过账户组件的 `onboarding-panel` part 定制该浮层。
+内部流程会经账户组件派发 `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()` 自动打开强制态创建流程：
+
+```js
+accountContext.configure({
+  applicationName: 'OfficialWebsite',
+  transport: accountTransport,
+  organizationOnboarding: {
+    transport: organizationOnboardingTransport,
+    mandatory: true, // 默认值；传 false 回到可跳过的原型 4.1 行为
+  },
+})
+```
+
+强制态下不渲染“跳过”“暂不创建，先逛逛”“用邀请码加入”和关闭按钮，遮罩点击、`Escape` 与原生 `cancel` 都不关闭，用户只有两条出路：创建组织，或点“退出登录”（派发 `logout-requested`，由 Host 清理登录态）。企业/团队表单页提供“返回”回到创建方式选择，避免困在错误分支；创建成功页的“去认证 / 稍后认证 / 升级为企业 / 邀请成员”是关闭对话框的终点。对话框使用 top layer，不受 Host 导航 `transform` 或 `overflow` 影响。
 
 ### Organization Selector
 
@@ -421,6 +436,8 @@ selector.addEventListener('selection-confirmed', (event) => {
 
 账户区和组织菜单中的工作台、选择器、认证状态、选中、创建及退出图标使用 40.1 原型指定的 Tabler Icons 2.47.0 原始 SVG 路径；组织列表左侧使用原型中的企业建筑或团队成员图标。组件将这些原型资源打入独立运行时，不依赖 Host 的图标字体或全局样式。
 
+账户胶囊宽度固定：胶囊内姓名超过 6 个字、当前组织名称超过 8 个字会截断为省略号，完整值只放在 `title` 上，长名称不会撑宽胶囊挤压导航左侧内容；展开后的菜单仍显示完整名称。
+
 ```js
 import {
   createUniplatBaseAccountContextTransport,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@csntgao/uni-base",
-  "version": "0.1.4",
+  "version": "0.2.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.24.0",
+  "version": "0.25.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

@@ -17,6 +17,10 @@ import type { UniplatUserMenu, UserMenuConfig } from './user-menu'
 
 const INTERNAL_APPLICATION_SWITCHER_TAG = 'uniplat-internal-application-switcher'
 
+// 账户胶囊固定宽度，超出的姓名与组织名在胶囊内截断，完整值只放在 title 里。
+const CAPSULE_DISPLAY_NAME_MAX_CHARS = 6
+const CAPSULE_ORGANIZATION_NAME_MAX_CHARS = 8
+
 if (
   typeof customElements !== 'undefined' &&
   !customElements.get(INTERNAL_APPLICATION_SWITCHER_TAG)
@@ -113,6 +117,11 @@ export interface AccountContextConfig {
    */
   organizationOnboarding?: {
     transport: OrganizationOnboardingTransport
+    /**
+     * 无归属用户是否必须先入驻。默认开启：加载到零归属投影时组件自动以
+     * 强制模式对话框打开创建流程，用户只能创建组织或退出登录。
+     */
+    mandatory?: boolean
   }
 }
 
@@ -168,6 +177,7 @@ export class UniplatAccountContext extends LitElement {
     viewModel: { state: true },
     activePanel: { state: true },
     employeeInfo: { state: true },
+    mandatoryOnboarding: { state: true },
   }
 
   static override styles = css`
@@ -328,16 +338,19 @@ export class UniplatAccountContext extends LitElement {
       display: none;
     }
 
+    /* 胶囊宽度固定，姓名与组织名再长也不挤压导航左侧内容。 */
     .copy {
       display: flex;
+      width: 96px;
       min-width: 0;
+      flex: none;
       flex-direction: column;
       line-height: 1.3;
     }
 
     .display-name {
       overflow: hidden;
-      max-width: 120px;
+      max-width: 100%;
       font-size: 12.5px;
       font-weight: 700;
       text-overflow: ellipsis;
@@ -348,7 +361,7 @@ export class UniplatAccountContext extends LitElement {
       display: inline-flex;
       align-items: center;
       gap: 4px;
-      max-width: 212px;
+      max-width: 100%;
       margin-top: 1px;
     }
 
@@ -443,6 +456,35 @@ export class UniplatAccountContext extends LitElement {
       width: min(400px, calc(100vw - 24px));
     }
 
+    /*
+     * 强制入驻使用原生 dialog 的 top layer，不受 Host 导航 transform / overflow 影响；
+     * 无关闭按钮，遮罩点击与 Escape 都不关闭。
+     */
+    .onboarding-modal {
+      position: fixed;
+      z-index: 1200;
+      inset: 0;
+      display: grid;
+      width: 100vw;
+      max-width: none;
+      height: 100dvh;
+      max-height: none;
+      overflow: auto;
+      margin: 0;
+      padding: 24px;
+      border: 0;
+      background: transparent;
+      place-items: center;
+    }
+
+    .onboarding-modal::backdrop {
+      background: rgb(20 35 56 / 56%);
+    }
+
+    .onboarding-modal uniplat-internal-organization-onboarding {
+      width: min(400px, 100%);
+    }
+
     .employee-info-modal {
       position: fixed;
       z-index: 1100;
@@ -673,9 +715,12 @@ export class UniplatAccountContext extends LitElement {
   declare private viewModel: ResolvedAccountContext | null
   declare private activePanel: ActivePanel
   declare private employeeInfo: AccountContextEmployeeInfo | null
+  declare private mandatoryOnboarding: boolean
 
   private workbenchConfig: ApplicationSwitcherConfig | null = null
   private organizationOnboardingTransport: OrganizationOnboardingTransport | null = null
+  private organizationOnboardingMandatory = true
+  private configuredOnboardingMandatory = false
   private applicationName = ''
   private accountTransport: AccountContextTransport | null = null
   private showWorkbench = true
@@ -692,6 +737,7 @@ export class UniplatAccountContext extends LitElement {
     this.viewModel = null
     this.activePanel = null
     this.employeeInfo = null
+    this.mandatoryOnboarding = false
   }
 
   configure(config: AccountContextConfig): void {
@@ -704,6 +750,10 @@ 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
     this.configuredOrganizationOnboarding = null
@@ -830,6 +880,29 @@ export class UniplatAccountContext extends LitElement {
       showWorkbench: config.showWorkbench ?? true,
       showVerificationStatus: organization ? (config.showVerificationStatus ?? true) : false,
     }
+    this.syncMandatoryOnboarding()
+  }
+
+  /**
+   * 无归属用户必须先入驻：加载到零归属投影时自动以强制模式对话框打开创建流程。
+   * 创建成功后投影不再为空，但对话框保持强制态直到用户在成功页完成后续动作，
+   * 避免界面从模式对话框跳回小浮层。
+   */
+  private syncMandatoryOnboarding(): void {
+    if (
+      this.organizationOnboardingMandatory &&
+      this.organizationOnboardingTransport &&
+      this.viewModel &&
+      this.viewModel.organizations.length === 0 &&
+      !this.viewModel.organization
+    ) {
+      this.mandatoryOnboarding = true
+      this.activePanel = 'onboarding'
+    }
+  }
+
+  private get onboardingLocked(): boolean {
+    return this.mandatoryOnboarding && this.activePanel === 'onboarding'
   }
 
   override connectedCallback(): void {
@@ -912,7 +985,12 @@ export class UniplatAccountContext extends LitElement {
             }
           </span>
           <span class="copy">
-            <span class="display-name" part="display-name">${viewModel.displayName}</span>
+            <span
+              class="display-name"
+              part="display-name"
+              title=${capsuleTitle(viewModel.displayName, CAPSULE_DISPLAY_NAME_MAX_CHARS)}
+              >${truncateCapsuleText(viewModel.displayName, CAPSULE_DISPLAY_NAME_MAX_CHARS)}</span
+            >
             ${
               organization
                 ? this.renderOrganizationLine(organization, viewModel.showVerificationStatus)
@@ -964,14 +1042,26 @@ export class UniplatAccountContext extends LitElement {
     const onboarding = this.renderRoot.querySelector<InternalOrganizationOnboarding>(
       INTERNAL_ORGANIZATION_ONBOARDING_TAG,
     )
-    if (onboarding && onboarding !== this.configuredOrganizationOnboarding) {
+    if (
+      onboarding &&
+      (onboarding !== this.configuredOrganizationOnboarding ||
+        this.configuredOnboardingMandatory !== this.mandatoryOnboarding)
+    ) {
       const transport = this.organizationOnboardingTransport
       if (transport) {
-        onboarding.configure({ transport, initialStep: 'method-selection' })
+        onboarding.configure({
+          transport,
+          initialStep: 'method-selection',
+          mandatory: this.mandatoryOnboarding,
+        })
         this.configuredOrganizationOnboarding = onboarding
+        this.configuredOnboardingMandatory = this.mandatoryOnboarding
       }
     }
-    if (!onboarding) this.configuredOrganizationOnboarding = null
+    if (!onboarding) {
+      this.configuredOrganizationOnboarding = null
+      this.configuredOnboardingMandatory = false
+    }
 
     const employeeInfoModal = this.renderRoot.querySelector<HTMLDialogElement>(
       'dialog.employee-info-modal',
@@ -983,6 +1073,16 @@ export class UniplatAccountContext extends LitElement {
         employeeInfoModal.setAttribute('open', '')
       }
     }
+
+    const onboardingModal =
+      this.renderRoot.querySelector<HTMLDialogElement>('dialog.onboarding-modal')
+    if (onboardingModal && !onboardingModal.open) {
+      try {
+        onboardingModal.showModal()
+      } catch {
+        onboardingModal.setAttribute('open', '')
+      }
+    }
   }
 
   private renderOrganizationLine(
@@ -995,7 +1095,8 @@ export class UniplatAccountContext extends LitElement {
         <span
           class=${`organization-name${status === 'verified' || status === 'team' ? ' normal' : ''}`}
           part="organization-name"
-          >${organization.name}</span
+          title=${capsuleTitle(organization.name, CAPSULE_ORGANIZATION_NAME_MAX_CHARS)}
+          >${truncateCapsuleText(organization.name, CAPSULE_ORGANIZATION_NAME_MAX_CHARS)}</span
         >
         ${
           status
@@ -1024,13 +1125,30 @@ export class UniplatAccountContext extends LitElement {
       </div>`
     }
     if (this.activePanel === 'onboarding' && this.organizationOnboardingTransport) {
+      const onboarding = html`<uniplat-internal-organization-onboarding></uniplat-internal-organization-onboarding>`
+      if (this.mandatoryOnboarding) {
+        return html`<dialog
+          class="onboarding-modal"
+          part="onboarding-panel"
+          aria-label="创建团队或企业"
+          @cancel=${this.blockMandatoryOnboardingCancel}
+          @onboarding-skipped=${this.handleOnboardingSkipped}
+          @organization-created=${this.refreshAfterOrganizationCreated}
+          @enterprise-authentication-requested=${this.finishMandatoryOnboarding}
+          @enterprise-authentication-deferred=${this.finishMandatoryOnboarding}
+          @team-upgrade-requested=${this.finishMandatoryOnboarding}
+          @team-invite-members-requested=${this.finishMandatoryOnboarding}
+        >
+          ${onboarding}
+        </dialog>`
+      }
       return html`<div
         class="floating-panel onboarding-panel"
         part="onboarding-panel"
-        @onboarding-skipped=${this.closePanelAfterAction}
+        @onboarding-skipped=${this.handleOnboardingSkipped}
         @organization-created=${this.refreshAfterOrganizationCreated}
       >
-        <uniplat-internal-organization-onboarding></uniplat-internal-organization-onboarding>
+        ${onboarding}
       </div>`
     }
     if (this.activePanel === 'account') {
@@ -1181,6 +1299,24 @@ export class UniplatAccountContext extends LitElement {
     this.activePanel = null
   }
 
+  private readonly blockMandatoryOnboardingCancel = (event: Event): void => {
+    // 强制入驻不允许 Escape 关闭原生对话框。
+    if (this.onboardingLocked) event.preventDefault()
+  }
+
+  private readonly handleOnboardingSkipped = (): void => {
+    // 强制入驻没有跳过入口；即使宿主自行派发也不放行。
+    if (this.onboardingLocked) return
+    this.activePanel = null
+  }
+
+  // 成功页的认证 / 升级 / 邀请动作是强制入驻的终点，此时才允许关闭对话框。
+  private readonly finishMandatoryOnboarding = (): void => {
+    if (!this.mandatoryOnboarding) return
+    this.mandatoryOnboarding = false
+    this.activePanel = null
+  }
+
   private readonly openEmployeeInfo = (): void => {
     if (!this.viewModel?.organization) {
       this.activePanel = null
@@ -1255,11 +1391,17 @@ export class UniplatAccountContext extends LitElement {
   }
 
   private readonly handleDocumentPointerDown = (event: PointerEvent): void => {
+    if (this.onboardingLocked) return
     if (this.activePanel && !event.composedPath().includes(this)) this.activePanel = null
   }
 
   private readonly handleDocumentKeyDown = (event: KeyboardEvent): void => {
     if (event.key !== 'Escape' || !this.activePanel) return
+    if (this.onboardingLocked) {
+      event.preventDefault()
+      event.stopPropagation()
+      return
+    }
     const activePanel = this.activePanel
     this.activePanel = null
     const selector = activePanel === 'workbench' ? '.workbench' : '.account'
@@ -1320,6 +1462,14 @@ 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 {
@@ -1474,6 +1624,15 @@ function normalizeOptionalText(value: unknown, maxLength: number): string {
   return normalized
 }
 
+function truncateCapsuleText(value: string, maxChars: number): string {
+  const characters = [...value]
+  return characters.length > maxChars ? `${characters.slice(0, maxChars).join('')}…` : value
+}
+
+function capsuleTitle(value: string, maxChars: number): string | typeof nothing {
+  return [...value].length > maxChars ? value : nothing
+}
+
 function organizationStatus(
   organization: ResolvedAccountContextOrganization,
 ): EnterpriseVerificationStatus | 'team' {

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

@@ -17,12 +17,17 @@ export type OrganizationOnboardingStep =
 export interface OrganizationOnboardingConfig {
   transport: OrganizationOnboardingTransport
   initialStep?: 'unassigned' | 'method-selection'
+  /**
+   * 强制入驻：隐藏所有跳过入口，无归属用户只能创建组织或退出登录。
+   */
+  mandatory?: boolean
 }
 
 export interface OrganizationOnboardingEventMap {
   'onboarding-skipped': CustomEvent<{
     source: 'unassigned' | 'method-selection' | 'enterprise-form' | 'team-form'
   }>
+  'logout-requested': CustomEvent<Record<string, never>>
   'join-organization-requested': CustomEvent<{ enterpriseName?: string }>
   'organization-created': CustomEvent<{ organizationId: string; type: 'enterprise' | 'team' }>
   'enterprise-authentication-requested': CustomEvent<{ organizationId: string }>
@@ -468,6 +473,7 @@ export class InternalOrganizationOnboarding extends LitElement {
 
   private transport: OrganizationOnboardingTransport | null = null
   private skipReturnStep: SkippableStep = 'method-selection'
+  private mandatory = false
 
   constructor() {
     super()
@@ -494,13 +500,18 @@ export class InternalOrganizationOnboarding extends LitElement {
     if (config.initialStep && !['unassigned', 'method-selection'].includes(config.initialStep)) {
       throw new TypeError('organization-onboarding initialStep is invalid')
     }
+    if (config.mandatory !== undefined && typeof config.mandatory !== 'boolean') {
+      throw new TypeError('organization-onboarding mandatory must be a boolean')
+    }
     this.transport = config.transport
-    this.reset(config.initialStep ?? 'method-selection')
+    this.mandatory = config.mandatory ?? false
+    // 强制入驻不展示带“暂不创建”的无归属提示，直接进入创建流程。
+    this.reset(this.mandatory ? 'method-selection' : (config.initialStep ?? 'method-selection'))
   }
 
   start(step: 'unassigned' | 'method-selection' = 'method-selection'): void {
     if (!this.transport) throw new Error('organization-onboarding is not configured')
-    this.reset(step)
+    this.reset(this.mandatory ? 'method-selection' : step)
   }
 
   override render() {
@@ -513,6 +524,41 @@ export class InternalOrganizationOnboarding extends LitElement {
     return this.renderSuccess()
   }
 
+  /**
+   * 普通模式保留原型的“跳过”；强制入驻时创建流程首屏只提供“退出登录”，
+   * 表单页提供“返回”回到创建方式选择，用户不会被困在某个分支里。
+   */
+  private renderHeadingAction(step: SkippableStep) {
+    if (!this.mandatory) {
+      return html`<button
+        class="skip"
+        part="skip-action"
+        type="button"
+        @click=${() => this.openSkip(step)}
+      >
+        跳过
+      </button>`
+    }
+    if (step === 'method-selection') {
+      return html`<button
+        class="skip"
+        part="logout-action"
+        type="button"
+        @click=${this.requestLogout}
+      >
+        退出登录
+      </button>`
+    }
+    return html`<button
+      class="skip"
+      part="back-action"
+      type="button"
+      @click=${this.openMethodSelection}
+    >
+      返回
+    </button>`
+  }
+
   private renderUnassigned() {
     return html`
       <section class="card" part="shell" aria-label="无归属团队或企业">
@@ -565,14 +611,7 @@ export class InternalOrganizationOnboarding extends LitElement {
                 办理社保、薪酬、用工等业务需先归属一个团队 / 企业
               </p>
             </div>
-            <button
-              class="skip"
-              part="skip-action"
-              type="button"
-              @click=${() => this.openSkip('method-selection')}
-            >
-              跳过
-            </button>
+            ${this.renderHeadingAction('method-selection')}
           </div>
           <div class="options" role="list" part="method-options">
             ${this.renderOption(
@@ -672,14 +711,7 @@ export class InternalOrganizationOnboarding extends LitElement {
         <div class="content">
           <div class="heading-row">
             <div><h2 part="title">填写企业信息</h2></div>
-            <button
-              class="skip"
-              part="skip-action"
-              type="button"
-              @click=${() => this.openSkip('enterprise-form')}
-            >
-              跳过
-            </button>
+            ${this.renderHeadingAction('enterprise-form')}
           </div>
           ${
             errorCount > 0
@@ -813,14 +845,7 @@ export class InternalOrganizationOnboarding extends LitElement {
         <div class="content">
           <div class="heading-row">
             <div><h2 part="title">填写团队信息</h2></div>
-            <button
-              class="skip"
-              part="skip-action"
-              type="button"
-              @click=${() => this.openSkip('team-form')}
-            >
-              跳过
-            </button>
+            ${this.renderHeadingAction('team-form')}
           </div>
           <div class="team-notice" part="team-notice">
             ${icon('check')}<span
@@ -960,10 +985,15 @@ export class InternalOrganizationOnboarding extends LitElement {
   }
 
   private openSkip(returnStep: SkippableStep) {
+    if (this.mandatory) return
     this.skipReturnStep = returnStep
     this.step = 'skip-confirmation'
   }
 
+  private readonly requestLogout = () => {
+    this.dispatchPublicEvent('logout-requested', {})
+  }
+
   private readonly continueCreating = () => {
     this.step = this.skipReturnStep
   }

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

@@ -59,6 +59,36 @@ async function settle(context: UniplatAccountContext): Promise<void> {
   await Promise.resolve()
 }
 
+function emptyProjection(): AccountContextProjection {
+  return {
+    applicationName: APPLICATION_NAME,
+    user: { displayName: '131****2222', maskedMobile: '131****2222', avatarText: '1' },
+    currentOrganizationId: null,
+    currentOrganization: null,
+    organizations: [],
+  }
+}
+
+async function mountUnassigned(
+  mandatory?: boolean,
+): Promise<{ context: UniplatAccountContext; logout: ReturnType<typeof vi.fn> }> {
+  const context = document.createElement(ACCOUNT_CONTEXT_TAG)
+  const logout = vi.fn()
+  context.addEventListener('logout-requested', logout)
+  context.configure({
+    applicationName: APPLICATION_NAME,
+    transport: { load: async () => emptyProjection() },
+    organizationOnboarding: {
+      transport: createMockOrganizationOnboardingTransport(),
+      ...(mandatory === undefined ? {} : { mandatory }),
+    },
+  })
+  document.body.append(context)
+  await vi.waitFor(() => expect(context.shadowRoot?.querySelector('.display-name')).not.toBeNull())
+  await settle(context)
+  return { context, logout }
+}
+
 describe('<uniplat-account-context>', () => {
   afterEach(() => {
     document.body.replaceChildren()
@@ -193,6 +223,93 @@ describe('<uniplat-account-context>', () => {
     expect(menu?.shadowRoot?.textContent).toContain('新创建团队')
   })
 
+  it('forces unassigned users into a mandatory onboarding modal with only create or logout', async () => {
+    const { context, logout } = await mountUnassigned()
+
+    const modal = context.shadowRoot?.querySelector<HTMLDialogElement>('dialog.onboarding-modal')
+    expect(modal).not.toBeNull()
+    expect(modal?.getAttribute('aria-label')).toBe('创建团队或企业')
+    expect(modal?.hasAttribute('open')).toBe(true)
+    expect(context.shadowRoot?.querySelector('.floating-panel')).toBeNull()
+
+    const onboarding = context.shadowRoot?.querySelector('uniplat-internal-organization-onboarding')
+    const onboardingRoot = onboarding?.shadowRoot
+    expect(onboardingRoot?.textContent).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"]')
+    expect(logoutAction?.textContent?.trim()).toBe('退出登录')
+    logoutAction?.click()
+    expect(logout).toHaveBeenCalledTimes(1)
+    expect(logout.mock.calls[0]?.[0].detail).toEqual({})
+  })
+
+  it('keeps the mandatory onboarding modal open on outside clicks and Escape', async () => {
+    const { context } = await mountUnassigned()
+
+    document.body.dispatchEvent(new PointerEvent('pointerdown', { bubbles: true }))
+    await settle(context)
+    expect(context.shadowRoot?.querySelector('.onboarding-modal')).not.toBeNull()
+
+    const escape = new KeyboardEvent('keydown', { key: 'Escape', bubbles: true, cancelable: true })
+    document.dispatchEvent(escape)
+    await settle(context)
+    expect(escape.defaultPrevented).toBe(true)
+    expect(context.shadowRoot?.querySelector('.onboarding-modal')).not.toBeNull()
+  })
+
+  it('offers a way back to the creation choice instead of skipping inside the forced flow', async () => {
+    const { context } = await mountUnassigned()
+    const onboarding = context.shadowRoot?.querySelector('uniplat-internal-organization-onboarding')
+    const onboardingRoot = onboarding?.shadowRoot
+
+    onboardingRoot?.querySelector<HTMLButtonElement>('[part="primary-action"]')?.click()
+    await onboarding?.updateComplete
+    expect(onboardingRoot?.textContent).toContain('填写企业信息')
+    const back = onboardingRoot?.querySelector<HTMLButtonElement>('[part="back-action"]')
+    expect(back?.textContent?.trim()).toBe('返回')
+    expect(onboardingRoot?.querySelector('[part="skip-action"]')).toBeNull()
+
+    back?.click()
+    await onboarding?.updateComplete
+    expect(onboardingRoot?.textContent).toContain('创建你的团队 / 企业')
+  })
+
+  it('closes the mandatory modal only after the created organization success action', async () => {
+    const { context } = await mountUnassigned()
+    const onboarding = context.shadowRoot?.querySelector('uniplat-internal-organization-onboarding')
+    const onboardingRoot = onboarding?.shadowRoot
+
+    onboardingRoot?.querySelector<HTMLButtonElement>('[part="primary-action"]')?.click()
+    await onboarding?.updateComplete
+    const inputs = [...(onboardingRoot?.querySelectorAll<HTMLInputElement>('[part="input"]') ?? [])]
+    const values = ['星河科技', '北京星河科技有限公司', '91110108MA01XY7788']
+    inputs.forEach((input, index) => {
+      input.value = values[index] ?? ''
+      input.dispatchEvent(new Event('input', { bubbles: true }))
+    })
+    await onboarding?.updateComplete
+    onboardingRoot?.querySelector('form')?.dispatchEvent(new Event('submit', { bubbles: true }))
+
+    await vi.waitFor(() => expect(onboardingRoot?.textContent).toContain('已创建'))
+    expect(context.shadowRoot?.querySelector('.onboarding-modal')).not.toBeNull()
+
+    onboardingRoot?.querySelector<HTMLButtonElement>('[part="secondary-action"]')?.click()
+    await settle(context)
+    expect(context.shadowRoot?.querySelector('.onboarding-modal')).toBeNull()
+    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)
+
+    expect(context.shadowRoot?.querySelector('.onboarding-modal')).toBeNull()
+    expect(context.shadowRoot?.querySelector('[part="onboarding-panel"]')).toBeNull()
+    expect(context.shadowRoot?.textContent).toContain('创建团队 / 企业')
+  })
+
   it('registers and renders the personal account navigation state', async () => {
     expect(customElements.get(ACCOUNT_CONTEXT_TAG)).toBe(UniplatAccountContext)
     const context = document.createElement(ACCOUNT_CONTEXT_TAG)
@@ -273,7 +390,9 @@ describe('<uniplat-account-context>', () => {
       await settle(context)
 
       expect(context.shadowRoot?.textContent).toContain('工作台')
-      expect(context.shadowRoot?.textContent).toContain('北京星河科技有限公司')
+      const capsuleOrganization = context.shadowRoot?.querySelector('.organization-name')
+      expect(capsuleOrganization?.textContent?.trim()).toBe('北京星河科技有限…')
+      expect(capsuleOrganization?.getAttribute('title')).toBe('北京星河科技有限公司')
       const statusIcon = context.shadowRoot?.querySelector(`.status-icon.${cssClass}`)
       expect(statusIcon?.getAttribute('aria-label')).toBe(label)
       expect(statusIcon?.querySelector('svg')?.dataset.prototypeIcon).toBe(iconName)
@@ -797,6 +916,49 @@ describe('<uniplat-account-context>', () => {
     expect(image?.hidden).toBe(false)
   })
 
+  it('truncates long capsule names so the navigation width stays fixed', async () => {
+    const context = document.createElement(ACCOUNT_CONTEXT_TAG)
+    context.configure({
+      applicationName: APPLICATION_NAME,
+      displayName: '欧阳夏尔泽辉安',
+      organization: {
+        id: 'enterprise-huaqin',
+        name: '北京华勤百业技术服务有限公司',
+        type: 'enterprise',
+        applicationNames: [APPLICATION_NAME],
+        verificationStatus: 'verified',
+      },
+    })
+    document.body.append(context)
+    await settle(context)
+
+    const capsuleName = context.shadowRoot?.querySelector('.display-name')
+    const capsuleOrganization = context.shadowRoot?.querySelector('.organization-name')
+    expect(capsuleName?.textContent?.trim()).toBe('欧阳夏尔泽辉…')
+    expect(capsuleName?.getAttribute('title')).toBe('欧阳夏尔泽辉安')
+    expect(capsuleOrganization?.textContent?.trim()).toBe('北京华勤百业技术…')
+    expect(capsuleOrganization?.getAttribute('title')).toBe('北京华勤百业技术服务有限公司')
+
+    context.configure({
+      applicationName: APPLICATION_NAME,
+      displayName: '高高高',
+      organization: {
+        id: 'team-small',
+        name: '小团队',
+        type: 'team',
+        applicationNames: [APPLICATION_NAME],
+      },
+    })
+    await settle(context)
+
+    const shortName = context.shadowRoot?.querySelector('.display-name')
+    const shortOrganization = context.shadowRoot?.querySelector('.organization-name')
+    expect(shortName?.textContent?.trim()).toBe('高高高')
+    expect(shortName?.hasAttribute('title')).toBe(false)
+    expect(shortOrganization?.textContent?.trim()).toBe('小团队')
+    expect(shortOrganization?.hasAttribute('title')).toBe(false)
+  })
+
   it('requires enterprise status, rejects raw mobile numbers and renders labels as text', async () => {
     const context = document.createElement(ACCOUNT_CONTEXT_TAG)
     expect(() =>
@@ -826,6 +988,8 @@ describe('<uniplat-account-context>', () => {
     document.body.append(context)
     await settle(context)
     expect(context.shadowRoot?.querySelector('script')).toBeNull()
-    expect(context.shadowRoot?.textContent).toContain('<script>unsafe()</script>')
+    const capsuleName = context.shadowRoot?.querySelector('.display-name')
+    expect(capsuleName?.textContent?.trim()).toBe('<scrip…')
+    expect(capsuleName?.getAttribute('title')).toBe('<script>unsafe()</script>')
   })
 })

package//344/272/244/346/216/245/346/226/207/346/241/243.md

@@ -6,7 +6,7 @@
 >
 > 分支：`main`
 >
-> 交接基线提交：`7d2f9bb docs(docs): 修正失效的原型与接口说明文档路径`
+> 交接基线提交：`605c783 fix(web-components): 固定账户胶囊宽度并截断过长姓名与组织名`
 
 ## 1. Claude 接手后的第一步
 
@@ -23,9 +23,9 @@ git log -5 --oneline --decorate
 交接文档更新前的 Git 状态为：
 
 ```text
-main 领先 origin/main 4 个提交（未推送）
+main 领先 origin/main 7 个提交（未推送）
 工作树无代码改动
-HEAD = 7d2f9bb
+HEAD = 605c783
 ```
 
 不要清理、覆盖或提交根目录已有的 `.tgz`。它们是历史及当前本地发布产物，已由 `.gitignore` 忽略。
@@ -38,9 +38,9 @@ HEAD = 7d2f9bb
 
 | 位置                      | npm 名称                               | 当前本地版本 | 说明                                    |
 | ------------------------- | -------------------------------------- | -----------: | --------------------------------------- |
-| 根目录                    | `@csntgao/uni-base`                    |      `0.1.4` | 当前公开发布入口；npmjs 尚未发布此版本  |
+| 根目录                    | `@csntgao/uni-base`                    |      `0.1.5` | 当前公开发布入口；npmjs 已发布此版本    |
 | `packages/core`           | `@uniplat/ai-employee-client`          |     `0.14.0` | UI 无关的 HTTP/WebSocket/Core 状态机    |
-| `packages/web-components` | `@uniplat/ai-employee-web-components`  |     `0.24.0` | Lit Web Components 与独立浏览器 runtime |
+| `packages/web-components` | `@uniplat/ai-employee-web-components`  |     `0.24.1` | Lit Web Components 与独立浏览器 runtime |
 | `examples/vanilla`        | `@uniplat/ai-employee-vanilla-example` |     私有示例 | 必须消费 workspace 包的构建产物         |
 
 注意：根包改名为 `@csntgao/uni-base` 不代表两个 workspace 包、已有 Web Component 标签或公开类型可以随之改名。`@uniplat/*` 名称和 `uniplat-*` 标签仍是公开契约。
@@ -71,6 +71,19 @@ HEAD = 7d2f9bb
 
 ## 4. 近期完成的改动
 
+### 4.-1 账户胶囊固定宽度
+
+最新提交：
+
+```text
+605c783 fix(web-components): 固定账户胶囊宽度并截断过长姓名与组织名
+```
+
+导航右侧账户胶囊的 `.copy` 固定 96px；胶囊内姓名超过 6 个字、当前组织名称超过 8 个字按
+字符数截断为 `…`，完整值只写入 `title`，未超长时不加 `title`。展开后的 User Menu 仍显示
+完整名称，截断只作用于胶囊。相关常量在 `packages/web-components/src/account-context.ts`
+的 `CAPSULE_DISPLAY_NAME_MAX_CHARS` 与 `CAPSULE_ORGANIZATION_NAME_MAX_CHARS`。
+
 ### 4.0 多归属组织选择改为 S.0 / S.1
 
 最新提交：
@@ -244,13 +257,13 @@ Account Context 对外只派发净化后的 `LOAD_FAILED`，精确排错应看
 
 ## 7. 当前构建和验证状态
 
-在 `67d8d83` 上最近一次完整检查结果：
+在 `605c783` 上最近一次完整检查结果：
 
 ```text
 pnpm format:check   通过
 pnpm lint           通过
 pnpm typecheck      通过
-pnpm test           25 个测试文件通过；275 passed，2 skipped
+pnpm test           25 个测试文件通过；276 passed，2 skipped
 pnpm build          core、web-components、runtime、vanilla 全部通过
 ```
 
@@ -258,7 +271,7 @@ pnpm build          core、web-components、runtime、vanilla 全部通过
 
 ```text
 /Users/gaostudio/uni-base/uniplat-ai-employee-client-0.14.0.tgz
-/Users/gaostudio/uni-base/uniplat-ai-employee-web-components-0.24.0.tgz
+/Users/gaostudio/uni-base/uniplat-ai-employee-web-components-0.24.1.tgz
 ```
 
 根包本地产物：
@@ -291,9 +304,9 @@ pnpm --filter @uniplat/ai-employee-web-components pack
 
 ```text
 Manifest: https://10.10.10.131:8787/current.json
-Version:  0.24.0
-Module:   https://10.10.10.131:8787/releases/0.24.0/index.js
-SHA-256:  2cc1ba9ab48eb20e23cd1f95e68ca9d70413c602aa5f400828147020d4cc0341
+Version:  0.24.1
+Module:   https://10.10.10.131:8787/releases/0.24.1/index.js
+SHA-256:  c45894bb393dd5a99e484f01ce302cf39024a4d6c1124cf8f33ab9db6063405d
 ```
 
 最后验证结果：
@@ -301,7 +314,7 @@ SHA-256:  2cc1ba9ab48eb20e23cd1f95e68ca9d70413c602aa5f400828147020d4cc0341
 - `current.json`：HTTP 200、`Cache-Control: no-store`；
 - 版本模块：HTTP 200、CORS `*`、`immutable`；
 - 远端模块 hash 与本地一致；
-- `current.json` 指向 `./releases/0.24.0/index.js`。
+- `current.json` 指向 `./releases/0.24.1/index.js`。
 
 静态服务未启动时可执行：
 
@@ -322,27 +335,31 @@ https://registry.npmjs.org/
 当前远端状态：
 
 ```text
-@csntgao/uni-base 最新公开版本：0.1.3
-本地待发布版本：0.1.4
-npm whoami：E401 Unauthorized
+npm whoami                       csntgao（已登录）
+@csntgao/uni-base                0.1.5 已发布并回读校验
+@uniplat/ai-employee-client      未发布，PUT 返回 404（无 scope 创建权限）
+@uniplat/ai-employee-web-components  未发布，同上
 ```
 
-因此 `@csntgao/uni-base@0.1.4` 尚未发布，不能声称 npm 发布成功。用户完成以下登录后再继续：
+`@csntgao/uni-base@0.1.5` 的远端 shasum 为 `b962d7140a2ae62247b4ed3a45782bb821238b17`，
+与本地打包一致。发布后远端 `npm view` 有几秒传播延迟，第一次回读到旧版本要重试再确认。注意该包没有 `main`/`exports`/`files`，发布内容是 91 个源码文件，
+不是可直接 `import` 的库；调用方仍应使用 runtime 或 workspace 包。
 
-```bash
-npm login --registry=https://registry.npmjs.org/
-npm whoami
-```
-
-登录成功后必须重新查询远端版本；确认 `0.1.4` 不存在，再从已提交且干净的工作树发布并回读：
+发布需要浏览器 2FA。本机 shell 不是交互终端，直接 `npm publish` 会以 `EOTP` 退出；
+用伪终端包一层即可让 npm 停下来等浏览器授权：
 
 ```bash
-npm view @csntgao/uni-base version
-npm publish --access public
-npm view @csntgao/uni-base@0.1.4 version
+script -q /dev/null npm publish <绝对路径或 tarball> --access public
 ```
 
-两个 `@uniplat/*` 包当前在 npmjs 不存在或对当前账号不可见。发布它们需要 `@uniplat` 组织管理员把账号 `csntgao` 加入组织，并授予创建、发布 public package 的权限；不要通过重命名内部包规避公开契约。
+注意两个陷阱：`npm publish packages/core` 会被当成 git 仓库简写；`npm publish <目录>`
+不会改写 `workspace:*`，发布 web-components 必须使用 `pnpm pack` 生成的 tarball。
+
+两个 `@uniplat/*` 包仍未发布，属外部阻塞。`npm access list packages @uniplat` 只显示
+`@uniplat/html5-qrcode: read-write`，且该包 maintainer 是 `ytl003
+<yanghua19970726@163.com>`，`npm org ls uniplat` 无输出，说明当前账号在该 scope 下
+只有单包权限、没有创建新包的权限。需要 scope 所有者发布，或把 `@uniplat` 作为组织把
+`csntgao` 加入并授予创建 public package 的权限；不要通过重命名内部包规避公开契约。
 
 ## 9. 发布流程
 
@@ -388,7 +405,7 @@ Enterprise Admin：/Users/gaostudio/ae_design/实现/ae-enterprise-admin
 1. 完整阅读 `AGENTS.md`；
 2. 确认 Git 分支、工作树和最新提交；
 3. 根据用户当前任务定位对应组件及测试，不要顺手改公开契约；
-4. 若继续 npm 发布，先让用户恢复 npmjs 登录，再核对远端版本；
+4. 若继续 npm 发布，两个 `@uniplat/*` 包仍缺 scope 创建权限，见第 8.2 节；
 5. 若继续官网登录联调，重点确认 `setAccessToken()` 完成后是否调用 Account Context `refresh()`；
 6. 所有认证问题排查只查看安全状态码和白名单错误码，不复制 JWT；
 7. 代码修改完成后走完整验证、打包、版本、提交、发布和远端回读流程。