@csntgao/uni-base 0.1.0

package/packages/web-components/tests/user-menu.test.ts

@@ -0,0 +1,271 @@
+// @vitest-environment happy-dom
+
+import { afterEach, describe, expect, it, vi } from 'vitest'
+import { USER_MENU_TAG, UniplatUserMenu, type UserMenuConfig, type UserMenuEventMap } from '../src'
+
+const CONFIG: UserMenuConfig = {
+  displayName: '张伟',
+  maskedMobile: '138****6688',
+  currentOrganizationId: 'company-beijing',
+  organizations: [
+    {
+      id: 'company-beijing',
+      name: '北京星河科技有限公司',
+      type: 'company',
+      avatarText: '星',
+      role: '超管',
+      memberCount: 128,
+      verificationStatus: 'verified',
+    },
+    {
+      id: 'company-shanghai',
+      name: '星河（上海）信息服务分公司',
+      type: 'company',
+      avatarText: '蓝',
+      role: '管理员',
+      memberCount: 46,
+      verificationStatus: 'unverified',
+    },
+    {
+      id: 'team-growth',
+      name: '星河增长项目组',
+      type: 'team',
+      avatarText: '增',
+      role: '团队负责人',
+      memberCount: 9,
+    },
+  ],
+}
+
+async function settle(menu: UniplatUserMenu): Promise<void> {
+  await menu.updateComplete
+  await Promise.resolve()
+}
+
+describe('<uniplat-user-menu>', () => {
+  afterEach(() => {
+    document.body.replaceChildren()
+  })
+
+  it('renders the updated 40.1 organization switch panel', async () => {
+    expect(customElements.get(USER_MENU_TAG)).toBe(UniplatUserMenu)
+    const menu = document.createElement(USER_MENU_TAG)
+    menu.configure(CONFIG)
+    document.body.append(menu)
+    await settle(menu)
+
+    expect(menu.shadowRoot?.querySelector('.profile-name')?.textContent).toBe('张伟')
+    expect(menu.shadowRoot?.querySelector('.profile-mobile')?.textContent).toBe('138****6688')
+    expect(menu.shadowRoot?.textContent).toContain('个人账号设置')
+    expect(menu.shadowRoot?.textContent).toContain('我的员工信息')
+    expect(menu.shadowRoot?.querySelector('.menu-action-subtitle')?.textContent).toContain(
+      '在 北京星河科技有限公司 的员工信息',
+    )
+    expect(menu.shadowRoot?.textContent).toContain('切换企业 / 团队（3）')
+    expect(menu.shadowRoot?.textContent).toContain('创建企业 / 团队')
+    expect(menu.shadowRoot?.textContent).toContain('退出登录')
+    expect(menu.shadowRoot?.querySelectorAll('.organization')).toHaveLength(3)
+    expect(menu.shadowRoot?.querySelector('.verification-status.verified')?.textContent).toContain(
+      '已认证',
+    )
+    expect(
+      menu.shadowRoot?.querySelector('.verification-status.unverified')?.textContent,
+    ).toContain('未认证')
+    expect(menu.shadowRoot?.querySelector('.verification-status.team')?.textContent).toContain(
+      '无需认证',
+    )
+    const panel = menu.shadowRoot?.querySelector<HTMLElement>('.panel')
+    const avatar = menu.shadowRoot?.querySelector<HTMLElement>('.avatar')
+    const sectionTitle = menu.shadowRoot?.querySelector<HTMLElement>('.section-title')
+    const list = menu.shadowRoot?.querySelector<HTMLElement>('.organization-list')
+    const selected = menu.shadowRoot?.querySelector<HTMLElement>('.organization.selected')
+    const organizationIcon = selected?.querySelector<HTMLElement>('.organization-icon')
+    expect(getComputedStyle(panel!).width).toBe('100%')
+    expect(String(UniplatUserMenu.styles)).toContain('--uniplat-user-menu-width: 330px')
+    expect(getComputedStyle(avatar!).width).toBe('40px')
+    expect(getComputedStyle(sectionTitle!).paddingTop).toBe('10px')
+    expect(getComputedStyle(sectionTitle!).paddingLeft).toBe('10px')
+    expect(getComputedStyle(sectionTitle!).fontSize).toBe('11.5px')
+    expect(getComputedStyle(sectionTitle!).fontWeight).toBe('700')
+    expect(getComputedStyle(list!).gap).toBe('6px')
+    expect(getComputedStyle(list!).scrollbarGutter).not.toBe('stable')
+    expect(getComputedStyle(selected!).borderTopWidth).toBe('1.5px')
+    expect(getComputedStyle(selected!).display).toBe('flex')
+    expect(getComputedStyle(selected!).paddingTop).toBe('9px')
+    expect(String(UniplatUserMenu.styles)).toContain('margin: 6px 4px 0')
+    expect(getComputedStyle(organizationIcon!).width).toBe('30px')
+    expect(organizationIcon?.querySelector('svg[data-prototype-icon="building"]')).not.toBeNull()
+    const selectedCheck = selected?.querySelector(
+      '.check svg[data-prototype-icon="circle-check-filled"]',
+    )
+    expect(selectedCheck).not.toBeNull()
+    expect(selectedCheck?.querySelector('path')?.namespaceURI).toBe('http://www.w3.org/2000/svg')
+    expect(getComputedStyle(selectedCheck!.parentElement!).visibility).toBe('visible')
+    expect(selectedCheck?.querySelector('path')?.getAttribute('d')).toBe(
+      'M17 3.34a10 10 0 1 1 -14.995 8.984l-.005 -.324l.005 -.324a10 10 0 0 1 14.995 -8.336zm-1.293 5.953a1 1 0 0 0 -1.32 -.083l-.094 .083l-3.293 3.292l-1.293 -1.292l-.094 -.083a1 1 0 0 0 -1.403 1.403l.083 .094l2 2l.094 .083a1 1 0 0 0 1.226 0l.094 -.083l4 -4l.083 -.094a1 1 0 0 0 -.083 -1.32z',
+    )
+    expect(
+      selected?.querySelector(
+        '.verification-status svg[data-prototype-icon="discount-check-filled"]',
+      ),
+    ).not.toBeNull()
+    const unverified = menu.shadowRoot?.querySelector<HTMLElement>(
+      '[data-organization-id="company-shanghai"]',
+    )
+    expect(
+      unverified?.querySelector('.organization-icon svg[data-prototype-icon="building"]'),
+    ).not.toBeNull()
+    expect(unverified?.querySelector('.organization-meta.attention')?.textContent).toContain(
+      '认证后可办理业务',
+    )
+    expect(
+      unverified?.querySelector('.verification-status svg[data-prototype-icon="alert-circle"]'),
+    ).not.toBeNull()
+    expect(
+      menu.shadowRoot?.querySelector('.verification-status.team svg[data-prototype-icon="users"]'),
+    ).not.toBeNull()
+    expect(
+      menu.shadowRoot?.querySelector(
+        '.account-settings-action svg[data-prototype-icon="user-cog"]',
+      ),
+    ).not.toBeNull()
+    expect(
+      menu.shadowRoot?.querySelector('.employee-info-action svg[data-prototype-icon="id-badge-2"]'),
+    ).not.toBeNull()
+    expect(
+      menu.shadowRoot?.querySelector('.create-action svg[data-prototype-icon="plus"]'),
+    ).not.toBeNull()
+    expect(
+      menu.shadowRoot?.querySelector('.logout svg[data-prototype-icon="logout"]'),
+    ).not.toBeNull()
+  })
+
+  it('emits only controlled actions without display data', async () => {
+    const menu = document.createElement(USER_MENU_TAG)
+    menu.configure(CONFIG)
+    document.body.append(menu)
+    await settle(menu)
+
+    const received: Array<{ type: keyof UserMenuEventMap; detail: unknown; composed: boolean }> = []
+    const record = (event: Event) => {
+      received.push({
+        type: event.type as keyof UserMenuEventMap,
+        detail: (event as CustomEvent).detail,
+        composed: event.composed,
+      })
+    }
+    document.addEventListener('organization-selected', record, { once: true })
+    document.addEventListener('account-settings-requested', record, { once: true })
+    document.addEventListener('employee-info-requested', record, { once: true })
+    document.addEventListener('organization-create-requested', record, { once: true })
+    document.addEventListener('logout-requested', record, { once: true })
+
+    menu.shadowRoot?.querySelector<HTMLButtonElement>('.account-settings-action')?.click()
+    menu.shadowRoot?.querySelector<HTMLButtonElement>('.employee-info-action')?.click()
+    menu.shadowRoot
+      ?.querySelector<HTMLButtonElement>('[data-organization-id="team-growth"]')
+      ?.click()
+    menu.shadowRoot?.querySelector<HTMLButtonElement>('.create-action')?.click()
+    menu.shadowRoot?.querySelector<HTMLButtonElement>('.logout')?.click()
+
+    expect(received).toEqual([
+      { type: 'account-settings-requested', detail: {}, composed: true },
+      {
+        type: 'employee-info-requested',
+        detail: { organizationId: 'company-beijing' },
+        composed: true,
+      },
+      {
+        type: 'organization-selected',
+        detail: { organizationId: 'team-growth' },
+        composed: true,
+      },
+      { type: 'organization-create-requested', detail: {}, composed: true },
+      { type: 'logout-requested', detail: {}, composed: true },
+    ])
+    expect(JSON.stringify(received)).not.toContain('138****6688')
+    expect(JSON.stringify(received)).not.toContain('北京星河科技有限公司')
+  })
+
+  it('keeps selection Host-controlled and replaces stale content when reconfigured', async () => {
+    const menu = document.createElement(USER_MENU_TAG)
+    const selected = vi.fn()
+    menu.addEventListener('organization-selected', selected)
+    menu.configure(CONFIG)
+    document.body.append(menu)
+    await settle(menu)
+
+    menu.shadowRoot
+      ?.querySelector<HTMLButtonElement>('[data-organization-id="team-growth"]')
+      ?.click()
+    expect(menu.shadowRoot?.querySelector('.organization.selected')?.textContent).toContain(
+      '北京星河科技有限公司',
+    )
+
+    menu.configure({
+      displayName: '李明',
+      organizations: [
+        { id: 'team-product', name: '产品团队', type: 'team', role: '成员', memberCount: 5 },
+      ],
+      currentOrganizationId: 'team-product',
+    })
+    await settle(menu)
+    expect(selected).toHaveBeenCalledTimes(1)
+    expect(menu.shadowRoot?.textContent).toContain('李明')
+    expect(menu.shadowRoot?.textContent).toContain('产品团队')
+    expect(menu.shadowRoot?.textContent).not.toContain('北京星河科技有限公司')
+  })
+
+  it('renders a safe profile avatar and keeps the text fallback when loading fails', async () => {
+    const menu = document.createElement(USER_MENU_TAG)
+    menu.configure({
+      ...CONFIG,
+      avatarText: '张',
+      avatarUrl: 'https://static.example.com/employee.png',
+    })
+    document.body.append(menu)
+    await settle(menu)
+
+    const image = menu.shadowRoot?.querySelector<HTMLImageElement>('.avatar-image')
+    expect(image?.src).toBe('https://static.example.com/employee.png')
+    expect(image?.referrerPolicy).toBe('no-referrer')
+    image?.dispatchEvent(new Event('error'))
+    expect(image?.hidden).toBe(true)
+    expect(menu.shadowRoot?.querySelector('.avatar-fallback')?.textContent).toBe('张')
+    image?.dispatchEvent(new Event('load'))
+    expect(image?.hidden).toBe(false)
+
+    expect(() => menu.configure({ ...CONFIG, avatarUrl: 'javascript:alert(1)' })).toThrow(TypeError)
+  })
+
+  it('rejects raw mobile numbers, duplicate ids and invalid organization counts', () => {
+    const menu = document.createElement(USER_MENU_TAG)
+    expect(() => menu.configure({ ...CONFIG, maskedMobile: '13800138000' })).toThrow(TypeError)
+    expect(() =>
+      menu.configure({
+        ...CONFIG,
+        organizations: [CONFIG.organizations[0]!, CONFIG.organizations[0]!],
+      }),
+    ).toThrow(TypeError)
+    expect(() => menu.configure({ ...CONFIG, organizationCount: 1 })).toThrow(TypeError)
+  })
+
+  it('renders external text as text instead of executable HTML', async () => {
+    const menu = document.createElement(USER_MENU_TAG)
+    menu.configure({
+      displayName: '<script>unsafe()</script>',
+      organizations: [
+        {
+          id: 'safe-id',
+          name: '<img src=x onerror=unsafe()>',
+          type: 'company',
+        },
+      ],
+    })
+    document.body.append(menu)
+    await settle(menu)
+    expect(menu.shadowRoot?.querySelector('script')).toBeNull()
+    expect(menu.shadowRoot?.querySelector('img')).toBeNull()
+    expect(menu.shadowRoot?.textContent).toContain('<img src=x onerror=unsafe()>')
+  })
+})

package/packages/web-components/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "noEmit": true,
+    "experimentalDecorators": true
+  },
+  "include": ["src", "tests", "tsup.config.ts", "tsup.runtime.config.ts"]
+}

package/packages/web-components/tsup.config.ts

@@ -0,0 +1,12 @@
+import { defineConfig } from 'tsup'
+
+export default defineConfig({
+  entry: ['src/index.ts'],
+  format: ['esm'],
+  dts: true,
+  sourcemap: true,
+  clean: true,
+  target: 'es2022',
+  treeshake: true,
+  external: ['lit', '@uniplat/ai-employee-client'],
+})

package/packages/web-components/tsup.runtime.config.ts

@@ -0,0 +1,37 @@
+import { readFile } from 'node:fs/promises'
+import { fileURLToPath } from 'node:url'
+import { defineConfig } from 'tsup'
+
+interface PackageManifest {
+  version: string
+}
+
+const packageEntry = fileURLToPath(new URL('./src/index.ts', import.meta.url)).replaceAll('\\', '/')
+const packageManifest = JSON.parse(
+  await readFile(new URL('./package.json', import.meta.url), 'utf8'),
+) as PackageManifest
+const version = packageManifest.version.trim()
+
+if (!/^[0-9A-Za-z][0-9A-Za-z._+-]{0,63}$/.test(version)) {
+  throw new TypeError('Web Components package version cannot be used as a runtime release version')
+}
+
+const releaseDirectory = fileURLToPath(
+  new URL(`../../dist/runtime/releases/${version}/`, import.meta.url),
+)
+
+export default defineConfig({
+  entry: [packageEntry],
+  format: ['esm'],
+  platform: 'browser',
+  target: 'es2022',
+  outDir: releaseDirectory,
+  outExtension: () => ({ js: '.js' }),
+  bundle: true,
+  splitting: false,
+  dts: false,
+  sourcemap: true,
+  clean: true,
+  treeshake: true,
+  noExternal: ['lit', '@uniplat/ai-employee-client'],
+})

package/pnpm-workspace.yaml

@@ -0,0 +1,6 @@
+packages:
+  - packages/*
+  - examples/*
+
+allowBuilds:
+  esbuild: true

package/tsconfig.base.json

@@ -0,0 +1,21 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "useDefineForClassFields": true,
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "strict": true,
+    "noUncheckedIndexedAccess": true,
+    "noImplicitOverride": true,
+    "useUnknownInCatchVariables": true,
+    "verbatimModuleSyntax": true,
+    "isolatedModules": true,
+    "skipLibCheck": true,
+    "baseUrl": ".",
+    "paths": {
+      "@uniplat/ai-employee-client": ["packages/core/src/index.ts"],
+      "@uniplat/ai-employee-web-components": ["packages/web-components/src/index.ts"]
+    }
+  }
+}

package/vitest.config.ts

@@ -0,0 +1,20 @@
+import { fileURLToPath, URL } from 'node:url'
+import { defineConfig } from 'vitest/config'
+
+export default defineConfig({
+  resolve: {
+    alias: {
+      '@uniplat/ai-employee-client': fileURLToPath(
+        new URL('./packages/core/src/index.ts', import.meta.url),
+      ),
+      '@uniplat/ai-employee-web-components': fileURLToPath(
+        new URL('./packages/web-components/src/index.ts', import.meta.url),
+      ),
+    },
+  },
+  test: {
+    include: ['packages/**/*.test.ts'],
+    restoreMocks: true,
+    clearMocks: true,
+  },
+})

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

@@ -0,0 +1,254 @@
+# Uni-Base 项目交接说明
+
+## 1. 当前仓库状态
+
+- 仓库：`/Users/gaostudio/uni-base`
+- 分支：`main`
+- 交接时分支：`main`，客服、通知中心、发布说明等提交已通过完整验证并随本次交接推送。
+- 根目录历次 `pnpm pack` 生成的 `.tgz` 是本地发布产物，已由 `.gitignore` 忽略；不要提交或覆盖调用方正在使用的包。
+- 当前版本：
+  - Core：`@uniplat/ai-employee-client@0.12.0`
+  - Web Components：`@uniplat/ai-employee-web-components@0.19.0`
+  - 本地 runtime manifest：`0.19.0`
+- `https://10.10.10.131:8787` 在本次交接时已启动，`current.json` 与 `releases/0.19.0/index.js` 可匿名读取。
+- npm registry 是 `https://registry.npmmirror.com`，当前机器未登录，npm 发布受认证条件阻塞。
+
+下一位 Agent 开始前必须完整阅读仓库根目录的 `AGENTS.md`，它替代所有旧版规则。
+
+## 2. 当前公开 Web Components
+
+```html
+<uniplat-ai-employee-chat></uniplat-ai-employee-chat>
+<uniplat-customer-support-chat></uniplat-customer-support-chat>
+<uniplat-user-login></uniplat-user-login>
+<uniplat-organization-selector></uniplat-organization-selector>
+<uniplat-account-context></uniplat-account-context>
+<uniplat-user-menu></uniplat-user-menu>
+<uniplat-notification-center></uniplat-notification-center>
+```
+
+以下标签不再公开或注册：
+
+```html
+<uniplat-application-switcher></uniplat-application-switcher>
+<uniplat-organization-onboarding></uniplat-organization-onboarding>
+```
+
+工作台应用面板和组织入驻流程均内置于 `<uniplat-account-context>`。
+
+## 3. 数字员工聊天
+
+`<uniplat-ai-employee-chat>` 渲染完整右侧抽屉，Host 只负责 `configure()` 和 `open()`，不能再在外部拼装标题、消息区或输入区。
+
+关键规则：
+
+- 支持登录用户和匿名用户。
+- WebSocket 使用 `/api/user-realtime/ws` 的 `ai_employee` channel。
+- 同一连接只订阅当前 AI 会话，切换会话时取消旧订阅。
+- 打开抽屉或点击新对话只建立本地草稿。
+- 首条消息通过 `createSessionWithFirstMessage()` 原子创建会话。
+- 不允许先创建空 Session 再发送首条消息。
+- 当前会话始终视为已读，不显示角标，也不计入总未读。
+- “转人工”直接在同一抽屉切换到 `<uniplat-customer-support-chat>`。
+
+## 4. 人工客服组件
+
+主要实现：
+
+- `packages/core/src/customer-support-client.ts`
+- `packages/web-components/src/customer-support-chat.ts`
+- `packages/web-components/src/customer-support-transport.ts`
+
+配置方式：
+
+```ts
+customerSupportChat.configure({
+  realtimeUrl,
+  transport,
+  sessionId,
+})
+
+customerSupportChat.open()
+```
+
+### 4.1 实时连接规则
+
+人工客服使用同一个 `/api/user-realtime/ws`，但申请：
+
+```json
+{
+  "requested_channels": ["customer_support"]
+}
+```
+
+服务端按当前认证身份推送该用户所有客服会话的事件，而不是只推送当前会话。
+
+最新完成的处理逻辑：
+
+- 任意客服会话事件都会重新请求会话列表。
+- 其他会话产生消息：
+  - 更新会话标题、最后消息、状态和未读数。
+  - 不刷新当前聊天历史。
+  - 更新顶部聚合红点及会话列表红点。
+- 当前会话产生消息：
+  - 刷新会话列表。
+  - 刷新当前历史消息。
+  - 自动同步已读。
+- `support_read_state_changed`：
+  - 只刷新会话列表和未读投影。
+  - 不刷新历史。
+  - 不再次触发已读写入，避免反馈循环。
+- 当前正在查看的会话：
+  - 不显示未读红点。
+  - 不计入顶部聚合未读数量。
+
+相关提交：
+
+```text
+2b5d5b9 fix(customer-support): 实时刷新全部客服会话与未读提示
+b65dcb9 fix(customer-support): 阻断客服已读事件反馈环并实现游标幂等
+```
+
+### 4.2 客服 UI 状态
+
+标题：`企业客服人工顾问`
+
+状态由“会话状态 + 实时连接状态”组合：
+
+- 尚无会话、连接正常：`客服通道已连接`
+- 尚无会话、连接中：`正在连接客服通道`
+- `waiting`：`等待客服接入`
+- `active` 且实时正常：`人工客服在线`
+- `active` 但实时断开：`正在恢复实时连接`
+- `closed`：`会话已结束`
+
+提交 `cca4db1` 修复了连接恢复后仍残留“鉴权服务暂不可用”横幅的问题：连接状态恢复为 `connected` 时清空可恢复错误提示。
+
+## 5. 通知中心组件
+
+`<uniplat-notification-center>` 是通知收件箱 Web Component，提供分类目录、通知列表与详情、未读状态、全部已读、关联资源和附件下载。
+
+关键边界：
+
+- 组件和 Core 不建立 WebSocket。
+- Host 复用自己的 `/api/user-realtime/ws`，订阅 `notification` channel，并通过 `applyRealtimeEvent(rawEvent)` 把事件交给组件。
+- 分类目录随 `listInbox({ includeTypeFacets: true })` 一并加载，不额外请求接口。
+- 分类显示名称来自后端 `notification_type_name`，SDK 不维护中文名映射。
+- 真实 HTTP transport 使用 `createUniplatBaseNotificationCenterTransport()`；JWT 只进入 transport 内部的 Authorization header。
+- 当前版本 Core `0.12.0`、Web Components `0.19.0` 已包含通知中心实现、测试与独立浏览器运行时。
+
+## 6. 登录、账户和工作台
+
+### 6.1 User Login
+
+必须严格复刻 40.1 原型：
+
+- 密码登录。
+- 短信验证码登录。
+- 扫码登录。
+- 不显示图形验证码。
+- 发送短信按钮始终可见，仅在手机号不完整或倒计时时禁用。
+- 登录结果先交给 Host `setAccessToken()`，再派发无凭据事件。
+- 登录设备信息包括稳定浏览器设备指纹，不得每次随机生成 `device_id`。
+
+### 6.2 Account Context
+
+`<uniplat-account-context>` 负责：
+
+- 用户姓名、头像、脱敏手机号。
+- 当前组织和可选组织。
+- 企业认证状态。
+- 员工信息弹窗。
+- 创建企业/团队流程。
+- 内嵌工作台应用面板。
+- 应用 ticket 跳转。
+
+必须传入 `applicationName`。账户资料从 `list_available_organizations` 顶层读取：
+
+- `display_name`
+- `avatar_url`
+- `mobile_masked`
+
+不得再调用 `profile_summary_v2`。
+
+工作台只请求应用列表，不请求组织列表；组织上下文由 Account Context 管理。
+
+应用跳转流程：
+
+1. 先构造完整目标 URL。
+2. 使用当前 JWT 以 `POST {}` 调用 `issue_ticket`。
+3. 从签发响应取得 Ticket、15 秒有效期和权威 `source_system`。
+4. 新窗口打开目标页面。
+5. Ticket 放入 `#uniplat_identity_ticket=<ticket>&source_system=<source_system>`。
+6. 目标页先清除 Ticket Fragment，再以项目初始化的 `applicationName` 调用 `login_with_ticket`。
+7. JWT 交给目标 Host 的 `setAccessToken()`。
+
+## 7. 关联项目与资料
+
+跨项目工作前先读取：
+
+```text
+/Users/gaostudio/.vibe-requirements/projects.md
+```
+
+主要关联项目：
+
+- Kanban 后端：`/Users/gaostudio/ae_design/实现/uniplat-kanban/backend`
+- HR-SaaS：`/Users/gaostudio/ae_design/实现/hr_saas`
+- UniplatBase：`/Users/gaostudio/ae_design/实现/uniplat_base`
+- 官网：`/Users/gaostudio/qqxbwebsite`
+- Enterprise Admin：`/Users/gaostudio/ae_design/实现/ae-enterprise-admin`
+
+40.1 总原型：
+
+```text
+/Users/gaostudio/qqxbwebsite/原型/40.1、注册登录与企业入驻流程-standalone.html
+```
+
+跨项目只允许查阅。未经用户明确授权，不得直接修改其他项目；如需后端或 Host 配合，应在 `.vibe-requirements` 编写独立联合需求。
+
+## 8. 验证与发布要求
+
+任何代码修改后必须执行：
+
+```bash
+pnpm format:check
+pnpm lint
+pnpm typecheck
+pnpm test
+pnpm build
+pnpm --filter @uniplat/ai-employee-client pack
+pnpm --filter @uniplat/ai-employee-web-components pack
+```
+
+确认修法后直接完成：
+
+```text
+实现 → 测试 → 构建 → 打包 → 版本递增 → 提交 → 发布
+```
+
+不要在提出修法后停下来等待重复确认。
+
+发布时：
+
+- 先发布并验证版本化 runtime 目录。
+- 再原子切换 `current.json`。
+- 发布后重新读取远端 manifest 和模块校验。
+- npm 未认证时明确报告外部阻塞，不得声称 npm 发布成功。
+- 不要提交根目录历史 tarball。
+
+## 9. 下一步建议
+
+下一位 Agent 应优先确认当前远端与发布状态：
+
+1. 核对 `main` 已推送到 `origin/main`。
+2. 运行完整验证，确认 Core `0.12.0`、Web Components `0.19.0`。
+3. 确认 HTTPS runtime 服务仍在运行；未运行时执行 `node /Users/gaostudio/.uni-base-runtime/serve.mjs`。
+4. 验证：
+
+   ```text
+   https://10.10.10.131:8787/current.json
+   https://10.10.10.131:8787/releases/0.19.0/index.js
+   ```
+
+5. npm 发布仍需用户先为配置的 registry 完成登录。