@csntgao/uni-base 0.1.5 → 0.2.1

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`。
 
@@ -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,7 +437,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 或原始异常。真实 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>`。点击账户菜单或个人态的“创建团队 / 企业”必须直接启动内部流程，不得向 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`。
 
@@ -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,7 +437,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 或原始异常。真实 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

@@ -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
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@csntgao/uni-base",
-  "version": "0.1.5",
+  "version": "0.2.1",
   "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.1",
+  "version": "0.25.1",
   "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,6 +117,11 @@ export interface AccountContextConfig {
    */
   organizationOnboarding?: {
     transport: OrganizationOnboardingTransport
+    /**
+     * 无归属用户是否必须先入驻。默认开启：加载到零归属投影时组件自动以
+     * 强制模式对话框打开创建流程，用户只能创建组织或退出登录。
+     */
+    mandatory?: boolean
   }
 }
 
@@ -172,6 +177,7 @@ export class UniplatAccountContext extends LitElement {
     viewModel: { state: true },
     activePanel: { state: true },
     employeeInfo: { state: true },
+    mandatoryOnboarding: { state: true },
   }
 
   static override styles = css`
@@ -450,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;
@@ -680,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
@@ -699,6 +737,7 @@ export class UniplatAccountContext extends LitElement {
     this.viewModel = null
     this.activePanel = null
     this.employeeInfo = null
+    this.mandatoryOnboarding = false
   }
 
   configure(config: AccountContextConfig): void {
@@ -711,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
@@ -837,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 {
@@ -976,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',
@@ -995,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(
@@ -1037,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') {
@@ -1194,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
@@ -1268,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'
@@ -1333,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 {

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/src/organization-selector.ts

@@ -819,7 +819,7 @@ function normalizeOrganizations(
       role: normalizeOptionalText(organization.role, 60),
       memberCount: normalizeMemberCount(organization.memberCount),
       lastEnteredLabel: normalizeOptionalText(organization.lastEnteredLabel, 80),
-      searchKey: `${name}${unifiedSocialCreditCode}`.toLowerCase(),
+      searchKey: `${name} ${unifiedSocialCreditCode}`.toLowerCase(),
     }
   })
 }

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)

package/packages/web-components/tests/organization-selector.test.ts

@@ -143,6 +143,10 @@ describe('<uniplat-organization-selector>', () => {
     expect(rowNames(selector)).toEqual(['北京星河科技有限公司'])
     expect(selector.shadowRoot?.textContent).not.toContain('91110108MA01XY7788')
 
+    // 名称与信用代码之间用空格分隔，搜索键里不得出现控制字符。
+    await typeSearch(selector, '北京星河科技有限公司 91110108MA01XY7788')
+    expect(rowNames(selector)).toEqual(['北京星河科技有限公司'])
+
     await typeSearch(selector, '不存在的组织')
     expect(rowNames(selector)).toEqual([])
     expect(selector.shadowRoot?.textContent).toContain('没有匹配的团队或企业')

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

@@ -6,7 +6,7 @@
 >
 > 分支：`main`
 >
-> 交接基线提交：`7d2f9bb docs(docs): 修正失效的原型与接口说明文档路径`
+> 交接基线提交：`d19ac72 feat(web-components): 无归属用户强制走创建组织流程`
 
 ## 1. Claude 接手后的第一步
 
@@ -23,9 +23,9 @@ git log -5 --oneline --decorate
 交接文档更新前的 Git 状态为：
 
 ```text
-main 领先 origin/main 4 个提交（未推送）
+main 领先 origin/main 9 个提交（未推送）
 工作树无代码改动
-HEAD = 7d2f9bb
+HEAD = d19ac72
 ```
 
 不要清理、覆盖或提交根目录已有的 `.tgz`。它们是历史及当前本地发布产物，已由 `.gitignore` 忽略。
@@ -38,9 +38,9 @@ HEAD = 7d2f9bb
 
 | 位置                      | npm 名称                               | 当前本地版本 | 说明                                    |
 | ------------------------- | -------------------------------------- | -----------: | --------------------------------------- |
-| 根目录                    | `@csntgao/uni-base`                    |      `0.1.4` | 当前公开发布入口；npmjs 已发布此版本    |
+| 根目录                    | `@csntgao/uni-base`                    |      `0.2.0` | 当前公开发布入口；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.25.0` | Lit Web Components 与独立浏览器 runtime |
 | `examples/vanilla`        | `@uniplat/ai-employee-vanilla-example` |     私有示例 | 必须消费 workspace 包的构建产物         |
 
 注意：根包改名为 `@csntgao/uni-base` 不代表两个 workspace 包、已有 Web Component 标签或公开类型可以随之改名。`@uniplat/*` 名称和 `uniplat-*` 标签仍是公开契约。
@@ -71,6 +71,36 @@ HEAD = 7d2f9bb
 
 ## 4. 近期完成的改动
 
+### 4.-2 无归属用户强制入驻
+
+最新提交：
+
+```text
+d19ac72 feat(web-components): 无归属用户强制走创建组织流程
+```
+
+账户投影零归属时，`<uniplat-account-context>` 用原生 `dialog.showModal()`（top layer，不受 Host
+导航 `transform/overflow` 影响）自动打开强制态创建流程：不渲染跳过、无归属提示、邀请码加入与
+关闭按钮，遮罩点击、`Escape` 与 `cancel` 都不关闭，只能创建组织或点“退出登录”派发
+`logout-requested`。企业/团队表单页的“跳过”换成“返回”，创建成功页的认证、升级或邀请动作才关闭
+对话框。Host 可用 `organizationOnboarding.mandatory: false` 退回可跳过行为，默认开启。
+
+该行为**覆盖**了 40.1 原型 4.1 的“暂不创建，先逛逛”和 S.0 图中“0 归属不弹窗”两条既有约定，
+是按用户新需求做的行为变更，不是实现偏差。
+
+### 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 +274,13 @@ Account Context 对外只派发净化后的 `LOAD_FAILED`，精确排错应看
 
 ## 7. 当前构建和验证状态
 
-在 `67d8d83` 上最近一次完整检查结果：
+在 `d19ac72` 上最近一次完整检查结果：
 
 ```text
 pnpm format:check   通过
 pnpm lint           通过
 pnpm typecheck      通过
-pnpm test           25 个测试文件通过；275 passed，2 skipped
+pnpm test           25 个测试文件通过；281 passed，2 skipped
 pnpm build          core、web-components、runtime、vanilla 全部通过
 ```
 
@@ -258,7 +288,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.25.0.tgz
 ```
 
 根包本地产物：
@@ -291,9 +321,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.25.0
+Module:   https://10.10.10.131:8787/releases/0.25.0/index.js
+SHA-256:  3a37ff4225d346b9f32bdc1ee725a9050f5e0b631520f387407067bca6384631
 ```
 
 最后验证结果：
@@ -301,7 +331,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.25.0/index.js`。
 
 静态服务未启动时可执行：
 
@@ -323,13 +353,13 @@ https://registry.npmjs.org/
 
 ```text
 npm whoami                       csntgao（已登录）
-@csntgao/uni-base                0.1.4 已发布并回读校验
+@csntgao/uni-base                0.2.0 已发布并回读校验
 @uniplat/ai-employee-client      未发布，PUT 返回 404（无 scope 创建权限）
 @uniplat/ai-employee-web-components  未发布，同上
 ```
 
-`@csntgao/uni-base@0.1.4` 的远端 shasum 为 `1ec9b946789b1840cd418af26ab1621ea1c8af96`，
-与本地打包一致。注意该包没有 `main`/`exports`/`files`，发布内容是 91 个源码文件，
+`@csntgao/uni-base@0.2.0` 的远端 shasum 为 `b02599ed1443de9909b7e005767ecc045e7a67db`，
+与本地打包一致。发布后远端 `npm view` 有几秒传播延迟，第一次回读到旧版本要重试再确认。注意该包没有 `main`/`exports`/`files`，发布内容是 91 个源码文件，
 不是可直接 `import` 的库；调用方仍应使用 runtime 或 workspace 包。
 
 发布需要浏览器 2FA。本机 shell 不是交互终端，直接 `npm publish` 会以 `EOTP` 退出；