@hxdhxd/harmony-flow-ui 0.1.0 → 0.1.2

package/README.md

@@ -30,19 +30,45 @@ npm run build:demo
 npm run serve
 ```
 
-默认静态服务地址为 `http://127.0.0.1:4173`。
+默认静态服务地址为 `http://127.0.0.1:6633`。服务监听 `0.0.0.0`，可通过服务器 IP 从外部访问。
 
-`npm run test:quality` 是统一质量门，覆盖类型、正式构建、公共 API、浏览器路由、组件文档、视觉证据与完整性。
+`npm run test:quality` 是统一质量门，覆盖类型、正式构建、公共 API、浏览器路由、组件文档、视觉证据与完整性。质量门还会锁定 HarmonyOS 7 的白＋浅蓝主题，并按文件阻止新增渐变、毛玻璃、超限圆角、阴影和组件文档裸色值；现有功能性视觉与历史样式只允许逐步减少，不允许数量反弹或转移到其他文件。
+
+可单独执行以下视觉规范检查：
+
+```powershell
+npm run test:theme-contract
+npm run test:ui-quality-gate
+npm run test:ui-quality-gate:self-test
+```
 
 展示页由 esbuild 正式构建，并由项目内 Node 静态服务托管，不使用 Vite。
 
+## 部署预览页
+
+执行以下命令生成可直接上传服务器的部署目录：
+
+```powershell
+npm run build:preview
+```
+
+将生成的 `preview-deploy/` 整个上传到服务器。服务器只需安装 Node.js 18 或更高版本，不需要上传源码、`node_modules/`、测试、计划、备份或开发依赖，也不需要执行 `npm install`。
+
+在服务器的 `preview-deploy/` 目录中启动：
+
+```bash
+npm start
+```
+
+默认监听 `0.0.0.0:6633`，请同时在服务器防火墙或云安全组放行 TCP 6633。需要守护进程时，可使用服务器已有的 systemd、Supervisor 或 PM2 托管 `npm start`。
+
 展示页提供“组件展厅”和“成品场景”两个入口：前者包含组件分类、搜索、真实交互预览、示例代码、Props 与无障碍说明，后者展示学习工作台、身份入口和运营洞察等跨组件组合。页面底部提供安装、样式引入与 ThemeProvider 的快速接入示例。
 
 核心组件详情支持可复制 URL，例如 `/components/button`；成品页支持 `/templates/dashboard`、`/templates/onboarding` 与 `/templates/insights` 全屏预览。全屏预览可实时切换主题色、界面密度以及桌面、平板和移动视口。
 
 ## 发布状态与下一步
 
-正式 npm 包名为 `@hxdhxd/harmony-flow-ui`，当前版本为 `0.1.0`。后续建议在每次发布前更新版本号、运行完整质量门，并在 GitHub 创建对应 Release 或维护变更日志。
+正式 npm 包名为 `@hxdhxd/harmony-flow-ui`，当前版本为 `0.1.1`。后续建议在每次发布前更新版本号、运行完整质量门，并在 GitHub 创建对应 Release 或维护变更日志。
 
 本项目采用 [MIT License](./LICENSE)，允许免费用于个人和商业项目；再分发时须保留原许可证和版权声明。
 
@@ -83,7 +109,9 @@ export default function App() {
 }
 ```
 
-`ThemeProvider` 建议放在应用根部。主题覆盖支持 `colorPrimary`、`colorPrimaryHover`、`colorBackground`、`colorSurface`、`colorText`、`colorTextMuted`、`colorBorder`、`radiusMd`、`radiusLg`、`shadowElevated` 与 `motionDuration`。
+`ThemeProvider` 建议放在应用根部。主题覆盖支持颜色、形状、阴影与动效语义令牌。新代码优先使用 `radiusControl`、`radiusPanel`、`radiusOverlay`、`shadowPopover` 与 `shadowModal`；`radiusMd`、`radiusLg`、`shadowElevated` 仅为现有消费者保留，后续版本将逐步迁移。
+
+默认主题继续遵循 HarmonyOS 7 的白色内容面、浅蓝窗口背景、鸿蒙蓝主强调色与深蓝正文。形状和深度令牌建议按语义覆盖，而不是为单个组件写死圆角或阴影。
 
 ### Next.js App Router
 
@@ -126,7 +154,7 @@ npm pack
 然后在目标项目中安装生成的 `.tgz` 文件（请替换为实际路径和文件名）：
 
 ```powershell
-npm install "D:\path\to\harmony-flow-ui-0.1.0.tgz"
+npm install "D:\path\to\harmony-flow-ui-0.1.1.tgz"
 ```
 
 安装后仍按正式 npm 包的方式从 `@hxdhxd/harmony-flow-ui` 导入。当前不建议直接通过 GitHub URL 安装，因为仓库不提交 `dist/`，Git 依赖安装流程无法保证生成完整发布产物。