vaebe · vaebe · Jun 3, 2026 · May 8, 2026 · May 8, 2026 · May 8, 2026
diff --git a/.github/workflows/buildComponents.yml b/.github/workflows/buildComponents.yml
@@ -18,17 +18,17 @@ jobs:
 
       - name: Install pnpm
         uses: pnpm/action-setup@v4
-        with:
-          version: 10
 
       - name: Use Node.js ${{ matrix.node-version }}
         uses: actions/setup-node@v6
         with:
           node-version: ${{ matrix.node-version }}
           cache: pnpm
 
+      # pnpm install 的 postinstall 会自动 bootstrap 前置产物
+      # （icons dist + theme.scss），无需在此单独构建。
       - name: Install dependencies
         run: pnpm install
 
       - name: Run build:components
-        run: pnpm --filter cli build:components
+        run: pnpm --filter ccui-cli build:components
diff --git a/.github/workflows/deploy.yml b/.github/workflows/deploy.yml
@@ -8,7 +8,6 @@ on:
 
 jobs:
   build:
-
     runs-on: ubuntu-latest
 
     strategy:
@@ -21,8 +20,6 @@ jobs:
 
       - name: Install pnpm
         uses: pnpm/action-setup@v4
-        with:
-          version: 9
 
       - name: Use Node.js ${{ matrix.node-version }}
         uses: actions/setup-node@v6

diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
@@ -18,17 +18,17 @@ jobs:
 
       - name: Install pnpm
         uses: pnpm/action-setup@v4
-        with:
-          version: 10
 
       - name: Use Node.js ${{ matrix.node-version }}
         uses: actions/setup-node@v6
         with:
           node-version: ${{ matrix.node-version }}
           cache: pnpm
 
+      # pnpm install 的 postinstall 会自动 bootstrap 前置产物
+      # （icons dist + theme.scss），无需在此单独构建。
       - name: Install dependencies
         run: pnpm install
 
       - name: Run tests
-        run: pnpm --filter vue3-ccui test
+        run: pnpm --filter @vaebe/ccui test
diff --git a/.gitignore b/.gitignore
@@ -31,11 +31,14 @@ packages/ccui/build
 **/.vitepress/config/enSidebar.ts
 **/.vitepress/config.ts.js
 **/.vitepress/cache
+packages/docs/public/llms.txt
+packages/docs/public/llms-full.txt
 
-**CHANGELOG.md
+packages/*/CHANGELOG.md
 # test
 packages/ccui/coverage
 packages/ccui/ui/**/__snapshots__
 .pnpm-debug.log
 .claude
-.codeflicker
+.codeflicker
+docs-notes/screenshots
diff --git a/.husky/commit-msg b/.husky/commit-msg
diff --git a/.husky/pre-commit b/.husky/pre-commit
diff --git a/.vite-hooks/pre-commit b/.vite-hooks/pre-commit
@@ -0,0 +1 @@
+cd "$(git rev-parse --show-toplevel)" && vp staged
diff --git a/AGENTS.md b/AGENTS.md
@@ -0,0 +1,15 @@
+<!--VITE PLUS START-->
+
+# Using Vite+, the Unified Toolchain for the Web
+
+This project is using Vite+, a unified toolchain built on top of Vite, Rolldown, Vitest, tsdown, Oxlint, Oxfmt, and Vite Task. Vite+ wraps runtime management, package management, and frontend tooling in a single global CLI called `vp`. Vite+ is distinct from Vite, and it invokes Vite through `vp dev` and `vp build`. Run `vp help` to print a list of commands and `vp <command> --help` for information about a specific command.
+
+Docs are local at `node_modules/vite-plus/docs` or online at https://viteplus.dev/guide/.
+
+## Review Checklist
+
+- [ ] Run `vp install` after pulling remote changes and before getting started.
+- [ ] Run `vp check` and `vp test` to format, lint, type check and test changes.
+- [ ] Check if there are `vite.config.ts` tasks or `package.json` scripts necessary for validation, run via `vp run <script>`.
+
+<!--VITE PLUS END-->
diff --git a/CHANGELOG.md b/CHANGELOG.md
diff --git a/README.md b/README.md
@@ -1,31 +1,32 @@
 # Vue3-CCUI
 
-[![npm version](https://img.shields.io/npm/v/vue3-ccui.svg)](https://www.npmjs.com/package/vue3-ccui)
-[![license](https://img.shields.io/npm/l/vue3-ccui.svg)](https://github.com/vaebe/ccui/blob/main/LICENSE)
-[![downloads](https://img.shields.io/npm/dt/vue3-ccui.svg)](https://www.npmjs.com/package/vue3-ccui)
+[![npm version](https://img.shields.io/npm/v/@vaebe/ccui.svg)](https://www.npmjs.com/package/@vaebe/ccui)
+[![license](https://img.shields.io/npm/l/@vaebe/ccui.svg)](https://github.com/vaebe/ccui/blob/main/LICENSE)
+[![downloads](https://img.shields.io/npm/dt/@vaebe/ccui.svg)](https://www.npmjs.com/package/@vaebe/ccui)
 
-一个基于 Vue 3 + TypeScript + Vite 构建的现代化 UI 组件库。
+一个基于 Vue 3 + TypeScript + [Vite+](https://viteplus.dev/) 构建的现代化 UI 组件库。
 
 ## ✨ 特性
 
 - 🚀 基于 Vue 3 Composition API
 - 💪 使用 TypeScript 开发，提供完整的类型定义
-- ⚡ 使用 Vite 构建，快速的开发体验
+- ⚡ Vite 8 + Rolldown 构建，OXC 全链路加速
+- 🛠️ 全量接入 Vite+ 工具链：`vp dev / build / test / check / lint / fmt`
 - 📦 支持按需引入，减小包体积
-- 🎨 现代化的设计风格
-- 🔧 完善的开发工具链
+- 🎨 视觉设计致敬 Ant Design，沉淀为一套完整的主题 Token 体系
+- 🧩 API 采用 Vue-first 命名（如 `visible` / `closeOnEsc` / `appendToBody`），与 Vue 生态习惯一致
 
 ## 📦 安装
 
 ```bash
 # NPM
-npm install vue3-ccui --save
+npm install @vaebe/ccui --save
 
 # Yarn
-yarn add vue3-ccui
+yarn add @vaebe/ccui
 
 # pnpm
-pnpm install vue3-ccui
+pnpm install @vaebe/ccui
 ```
 
 ## 🚀 快速开始
@@ -34,11 +35,11 @@ pnpm install vue3-ccui
 
 ```ts
 import { createApp } from 'vue'
-import ccui from 'vue3-ccui'
+import ccui from '@vaebe/ccui'
 import App from './App.vue'
 
 import './style.css'
-import 'vue3-ccui/style.css'
+import '@vaebe/ccui/style.css'
 
 createApp(App).use(ccui).mount('#app')
 ```
@@ -47,10 +48,10 @@ createApp(App).use(ccui).mount('#app')
 
 ```ts
 import { createApp } from 'vue'
-import { Button, Card } from 'vue3-ccui'
+import { Button, Card } from '@vaebe/ccui'
 import App from './App.vue'
 
-import 'vue3-ccui/style.css'
+import '@vaebe/ccui/style.css'
 
 const app = createApp(App)
 app.use(Button)
@@ -60,50 +61,85 @@ app.mount('#app')
 
 ## 📚 组件
 
-目前包含以下组件：
-
-- **Avatar** - 头像
-- **Button** - 按钮
-- **Button3D** - 3D 按钮
-- **Calendar** - 日历
-- **Card** - 卡片
-- **CheckBox** - 复选框
-- **Divider** - 分割线
-- **Popover** - 气泡卡片
-- **Radio** - 单选框
-- **Rate** - 评分
-- **Status** - 状态
-- **Tabs** - 标签页
-- **Timeline** - 时间线
-- **Tooltip** - 文字提示
-- **Tree** - 树形控件
+覆盖通用 / 导航 / 反馈 / 数据录入 / 数据展示 / 布局 / 其他七大类，共 **84 个组件 / 工具入口**。**API 命名采用 Vue-first 习惯**（受控显示用 `visible` / `v-model:visible`，而非 React 生态的 `open`），完整命名约定见 [`docs-notes/decisions/benchmark-principles.md`](./docs-notes/decisions/benchmark-principles.md)。
+
+完整组件列表、API 与在线示例见 [📖 在线文档](https://vaebe.github.io/ccui/)。
 
 ## 📖 文档
 
 访问 [在线文档](https://vaebe.github.io/ccui/) 查看详细的组件使用说明和示例。
 
 ## 🛠️ 开发
 
+> 仓库已接入 [Vite+](https://viteplus.dev/)，需要预先全局安装 `vp`：
+>
+> ```bash
+> npm i -g vp
+> ```
+>
+> 同时要求 Node `>= 22.10`（用于 cli 包的原生 TypeScript type stripping）。
+
 ```bash
 # 克隆项目
 git clone https://github.com/vaebe/ccui.git
 
 # 安装依赖
-pnpm install
+vp install
 
-# 启动开发服务器
-pnpm dev
+# 启动开发服务器（默认跑文档站）
+vp run --filter docs dev
 
 # 构建文档
-pnpm docs:build
+vp run --filter docs docs:build
 
 # 运行测试
-pnpm --filter vue3-ccui test
+vp run --filter @vaebe/ccui test
+
+# 一站式格式化 + lint + 类型检查
+vp check --fix
+
+# 单独格式化（Oxfmt）
+vp fmt
+
+# 单独 lint（Oxlint）
+vp lint . --fix
+```
+
+工具链：
 
-# 代码检查
-pnpm lint
+| 能力        | 工具                                                        |
+| ----------- | ----------------------------------------------------------- |
+| 构建        | Vite 8 + Rolldown                                           |
+| 测试        | Vitest 4.1（通过 `vp test`）                                |
+| 格式化      | Oxfmt（antfu 风格：单引号、无分号、`trailingComma: 'all'`） |
+| Lint        | Oxlint                                                      |
+| 类型检查    | tsgolint（在 `vp check` 内串联）                            |
+| 文档站      | VitePress 2                                                 |
+| Git Hooks   | `vp config` + `.vite-hooks/`（替代 husky）                  |
+| Staged 任务 | `vite.config.ts` 的 `staged` 块（替代 lint-staged）         |
+
+## 📦 发布
+
+仓库通过根目录的 `scripts/publish.mjs` 一键发布 3 个公开包到 npm（`@vaebe/ccui` / `@vaebe/ccui-icons` / `@vaebe/unplugin-vue-components-ccui`）。
+
+```bash
+pnpm release          # 默认 dist-tag=beta
+pnpm release:dry      # 走全流程但不真正 publish
+node scripts/publish.mjs --tag latest    # 正式发版
 ```
 
+脚本会自动：
+
+1. 预检 npm 登录态；缺失会引导走 `npm login --auth-type=web`（passkey / Touch ID / WebAuthn）
+2. 校验三个发布包版本号一致
+3. 按依赖顺序构建：icons → ccui → resolver
+4. 顺序 publish；2FA 失败时给出 `[r]` 重登 / `[o]` 兜底输 TOTP / `[x]` 终止三选项
+5. 打 git tag `v<version>` 并 push origin
+
+> npm 自 2025-09 起停止接受新的 TOTP 注册，全面推 WebAuthn / passkey。
+> 老 TOTP 账号仍可用，发布失败时按 `o` 输 6 位码兜底。
+> 详细流程与故障排查见 [`docs-notes/releasing.md`](./docs-notes/releasing.md)。
+
 ## 🤝 贡献
 
 欢迎提交 Issue 和 Pull Request！
@@ -115,5 +151,5 @@ pnpm lint
 ## 🔗 相关链接
 
 - [GitHub](https://github.com/vaebe/ccui)
-- [NPM](https://www.npmjs.com/package/vue3-ccui)
+- [NPM](https://www.npmjs.com/package/@vaebe/ccui)
 - [在线文档](https://vaebe.github.io/ccui/)
diff --git a/docs-notes/README.md b/docs-notes/README.md
@@ -0,0 +1,36 @@
+# Docs Notes
+
+ccui 工程层的 **shared memory**：决策约束、发布流程、维护基线。面向开发者本人 / AI / 未来贡献者，**不进入 VitePress 文档站**。
+
+> 与 [`packages/docs/`](../packages/docs/)（VitePress 文档站）的分工：
+> - `packages/docs/` —— 面向使用方，写 demo / props / events。
+> - `docs-notes/` —— 面向贡献者，写决策、约束、流程、未决项。
+>
+> 一句话判别：读者是「写业务的工程师」→ `packages/docs/`；读者是「下一次会话的我自己 / Claude / Codex」→ `docs-notes/`。
+
+## 目录
+
+| 文件 / 目录                                                | 用途                                              |
+| ---------------------------------------------------------- | ------------------------------------------------- |
+| [decisions/](./decisions/)                                 | 不变性约束（一旦合入，后续工作必须遵守）          |
+| [releasing.md](./releasing.md)                             | npm 发布流程、2FA / passkey、故障排查             |
+| [bundle-size-baseline.md](./bundle-size-baseline.md)       | 当前体积基线（v2.0 snapshot）                     |
+
+## decisions/
+
+约束类决策。**和「修复记录」严格区分**：只有具备「反向决策成本」与「长期不变性约束」的内容才进。
+
+| 文件                                                                       | 主题                                                  |
+| -------------------------------------------------------------------------- | ----------------------------------------------------- |
+| [benchmark-principles.md](./decisions/benchmark-principles.md)             | 对标 Ant Design 的边界：不照搬 React-only，翻译 Vue 化 |
+| [brand-color.md](./decisions/brand-color.md)                               | 默认主色 `#1677ff` 全量对齐 v6                        |
+| [design-values.md](./decisions/design-values.md)                           | 自然 / 确定 / 意义 / 生长 四原则在 ccui 的体现        |
+| [config-provider-locale.md](./decisions/config-provider-locale.md)         | ConfigProvider locale / theme.algorithm 接通承诺      |
+| [testing-principles.md](./decisions/testing-principles.md)                 | 测试术语用 Vue 语境 + 测试优先级（先测真实行为）       |
+
+## 写新笔记的约定
+
+1. **决策**：进 `decisions/`，文件名 `<topic>.md`。顶部写「决策日期 / 状态 / 反向决策开销 / 不变性约束」。
+2. **流程 / 基线**：直接放顶层（如 `releasing.md` / `bundle-size-baseline.md`）。
+3. **修复记录 / 批次记录**：**不再单独写**。提交 PR / 走 git log 即可，避免和 `decisions/` 混淆。
+4. **过期内容**：直接删，靠 git 历史溯源；不在本目录沉淀历史档。
diff --git a/docs-notes/bundle-size-baseline.md b/docs-notes/bundle-size-baseline.md
@@ -0,0 +1,66 @@
+# Bundle Size Baseline — v2.0
+
+snapshot 时间：2026-06-02
+git ref：`eafddf9`
+build cmd：`pnpm build:lib`（实际跑 `vp run --filter ccui-cli build:lib` → `pnpm build:components` → `vite build`，详见 `packages/cli/commands/build.js`）
+产物目录：`packages/ccui/build/`（一份全量 `vue-ccui.es|umd.js` + 82 个按组件目录的子 bundle）
+
+## 总览（全量 all-in-one bundle）
+
+| 项 | raw | gzip |
+|---|---|---|
+| `vue-ccui.es.js` | 515.57 KB | 132.51 KB |
+| `vue-ccui.umd.js` | 418.43 KB | 118.41 KB |
+| `style.css`（顶层合并 css） | 268.59 KB | 36.64 KB |
+
+注：`external = ['vue', 'vue-router', '@vueuse/core', '@floating-ui/dom']`，gzip 体积已扣掉这些 peer。
+
+## 前 10 大组件 chunk（按组件目录 `index.es.js`，按 gzip 排序）
+
+| chunk | raw | gzip |
+|---|---|---|
+| tree-select | 79.77 KB | 24.06 KB |
+| date-picker | 73.59 KB | 22.79 KB |
+| range-picker | 67.18 KB | 21.37 KB |
+| time-range-picker | 68.14 KB | 21.29 KB |
+| time-picker | 62.64 KB | 20.37 KB |
+| cascader | 60.39 KB | 19.06 KB |
+| auto-complete | 51.86 KB | 17.00 KB |
+| modal | 49.99 KB | 16.19 KB |
+| select | 50.81 KB | 15.96 KB |
+| tree | 52.30 KB | 15.77 KB |
+
+## Locale 包
+
+ccui 当前 4 个 locale 用静态 `export` 暴露（`ui/locale/index.ts`），全量 `vue-ccui.es.js` 会把 4 份字符串都打进去；并未单独 emit 为 `locale/zh-CN.js` chunk。源文件体量参考：
+
+| locale 源文件 | source raw |
+|---|---|
+| zh-CN.ts | 1941 B |
+| en-US.ts | 1732 B |
+| ja-JP.ts | 1859 B |
+| ko-KR.ts | 1883 B |
+
+**结论**：i18n 字符串走 named export，用户侧 `import { enUS } from '@vaebe/ccui'` 走 tree-shaking 即可只带一份。全量 bundle 默认带全 4 份（合计 < 8 KB 源码、gzip 后量级更小），未做强行 split。
+
+## dayjs locale 分包
+
+`packages/ccui/build/` 顶层除主 bundle 外另有以下 lazy chunk：
+
+| chunk | raw | gzip |
+|---|---|---|
+| `en-BVwCvuzF.js` | 840 B | 536 B |
+| `ja-B4U4rt8A.js` | 1763 B | 825 B |
+| `ko-BG35I8uK.js` | 1791 B | 827 B |
+| `zh-cn-C8nbfD5S.js` | 2017 B | 993 B |
+| `chunk-Ndeg2fpE.js`（rolldown 共享 runtime） | 998 B | 560 B |
+
+每个 chunk 头部都是 `import { t } from "./vue-ccui.es.js"` + `import('dayjs/locale/xxx')` 的产物，说明 `ui/shared/utils/dayjs-locale.ts` 里 `switch` 显式 `import('dayjs/locale/zh-cn')` 等被打包工具成功识别为按需 chunk。
+
+**结论**：dayjs 4 个 locale 均独立分包，仅在 `setDayjsLocale()` 调用（ConfigProvider 切语言路径）时按需拉取，主 bundle 不内联 dayjs locale 数据。
+
+## 备注
+
+- size-limit / bundlewatch 暂未引入，本基线仅 snapshot；下次升级前手动重跑 `pnpm build:lib` 对比 `packages/ccui/build/vue-ccui.es.js` 与本表即可。
+- 每组件 CSS 文件总和（78 个 `style.css`）= 1071.79 KB raw（按组件按需引入时存在内容重叠，与顶层 268 KB 合并 css 不可直接相加）。
+- per-component 子 bundle 不含 locale 字符串（locale 不在 `discoverComponents` 名单内），仅全量 `vue-ccui.es.js` 包含。
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		cd "$(git rev-parse --show-toplevel)" && vp staged