@hxdhxd/harmony-flow-ui 0.1.1 → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -30,7 +30,7 @@ npm run build:demo
30
30
  npm run serve
31
31
  ```
32
32
 
33
- 默认静态服务地址为 `http://127.0.0.1:4173`。
33
+ 默认静态服务地址为 `http://127.0.0.1:6633`。服务监听 `0.0.0.0`,可通过服务器 IP 从外部访问。
34
34
 
35
35
  `npm run test:quality` 是统一质量门,覆盖类型、正式构建、公共 API、浏览器路由、组件文档、视觉证据与完整性。质量门还会锁定 HarmonyOS 7 的白+浅蓝主题,并按文件阻止新增渐变、毛玻璃、超限圆角、阴影和组件文档裸色值;现有功能性视觉与历史样式只允许逐步减少,不允许数量反弹或转移到其他文件。
36
36
 
@@ -44,6 +44,24 @@ npm run test:ui-quality-gate:self-test
44
44
 
45
45
  展示页由 esbuild 正式构建,并由项目内 Node 静态服务托管,不使用 Vite。
46
46
 
47
+ ## 部署预览页
48
+
49
+ 执行以下命令生成可直接上传服务器的部署目录:
50
+
51
+ ```powershell
52
+ npm run build:preview
53
+ ```
54
+
55
+ 将生成的 `preview-deploy/` 整个上传到服务器。服务器只需安装 Node.js 18 或更高版本,不需要上传源码、`node_modules/`、测试、计划、备份或开发依赖,也不需要执行 `npm install`。
56
+
57
+ 在服务器的 `preview-deploy/` 目录中启动:
58
+
59
+ ```bash
60
+ npm start
61
+ ```
62
+
63
+ 默认监听 `0.0.0.0:6633`,请同时在服务器防火墙或云安全组放行 TCP 6633。需要守护进程时,可使用服务器已有的 systemd、Supervisor 或 PM2 托管 `npm start`。
64
+
47
65
  展示页提供“组件展厅”和“成品场景”两个入口:前者包含组件分类、搜索、真实交互预览、示例代码、Props 与无障碍说明,后者展示学习工作台、身份入口和运营洞察等跨组件组合。页面底部提供安装、样式引入与 ThemeProvider 的快速接入示例。
48
66
 
49
67
  核心组件详情支持可复制 URL,例如 `/components/button`;成品页支持 `/templates/dashboard`、`/templates/onboarding` 与 `/templates/insights` 全屏预览。全屏预览可实时切换主题色、界面密度以及桌面、平板和移动视口。