From 7c703ace4f893c5c8652f5994e0a338698bfb2dd Mon Sep 17 00:00:00 2001
From: ZF sun <34314687@qq.com>
Date: Wed, 27 May 2026 18:15:55 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E6=9B=B4=E6=96=B0README=E6=96=87?=
 =?UTF-8?q?=E6=A1=A3=EF=BC=8C=E8=A1=A5=E5=85=85=E9=B8=BF=E8=92=99=E5=B0=8F?=
 =?UTF-8?q?=E7=A8=8B=E5=BA=8F=E5=8F=91=E5=B8=83=E6=B5=81=E7=A8=8B?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

1.  给原有章节标题增加了多余的井号修正为正确层级
2.  新增鸿蒙小程序发布完整流程章节
3.  更新版本特性和构建脚本说明，新增极限压缩优化、harmony.patch.js等内容
---
 readme.md | 40 ++++++++++++++++++++++++++++++++--------
 1 file changed, 32 insertions(+), 8 deletions(-)

diff --git a/readme.md b/readme.md
index 2add22e..fac02ff 100644
--- a/readme.md
+++ b/readme.md
@@ -29,14 +29,14 @@
 
 #### 4.1.1 基本操作步骤（通用版/定制化版）
 
-##### 4.1.1.1 【前置准备】
+##### ##### ##### ##### 【前置准备】
 1. 在项目根目录打开终端安装依赖：
    ```bash
    npm install
    ```
    *已有依赖可跳过此步骤*
 
-##### 4.1.1.2 【发布构建】
+##### ##### ##### ##### 【发布构建】
 1. 使用 HBuilderX 打开项目（不用改manifest.json的web，只有H5要改 ）
 2. 选择菜单栏「发行」 → 「小程序-微信」→ 「发行」，等待构建完成
    ⚠️ **注意**：底部控制台弹出"请在微信小程序开发者工具中点击上传"后再执行下一步
@@ -46,18 +46,18 @@
    *压缩包文件名末尾为 Git 提交 ID*
    *同时该目录下会生成未压缩的 `mp-weixin` 目录*
 
-##### 4.1.1.3 【验证与重命名】
+##### ##### ##### ##### 【验证与重命名】
 1. 打开未压缩的 `mp-weixin` 目录，找到 `site.js` 文件，将文件内的 `uniacid` 值改为当前客户编号（如：2812）并保存
 2. 打开微信开发者工具，导入「mp-weixin」目录，点击「编译」，在开发者工具控制台验证有无报错，以及能否返回对应客户的业务数据
 3. 确保无误后将生成的 mp-weixin 压缩包重命名
    - **定制化版**格式：`定制化-客户编号-域名-mp-weixin-当前日期-Git提交ID.zip`
    - **通用版**无需重命名
-   
+
    💡 **示例**：`custom-2812-xcx.aigc-quickapp.com-mp-weixin-2026-05-11-3bff91e.zip`
-   
+
    🚫 **禁止**：压缩包命名禁止包含 `/ \ : * ? " < > |` 等特殊字符
 
-##### 4.1.1.4 【交付与最终发布】🔍
+##### ##### ##### ##### 【交付与最终发布】🔍
 1. 将重命名后的文件发送给技术人员
    *📌通用版直接将生成的 mp-weixin 压缩包发送给技术人员*
 2. **技术人员操作流程**：
@@ -65,7 +65,23 @@
    - 确认 `site.js` 中的 `uniacid` 为客户编号
    - 用微信开发者工具导入解压后的代码目录
    - 编译验证无误后，上传发布
-##### 4.1.1.5 【本地设置】
+
+#### 4.1.2 鸿蒙小程序发布（mp-harmony）
+
+##### ##### ##### ##### 【发布构建】
+1. 使用 HBuilderX 打开项目
+2. 选择菜单栏「发行」 → 「HarmonyOS」→ 「发行」，等待构建完成
+3. 构建完成后，**自动执行** `harmony.patch.js` 补丁脚本（配置拷贝 + ZIP 打包）
+4. 找到项目根目录 `/unpackage/dist/build` 下生成的 mp-harmony 压缩包
+
+##### ##### ##### ##### 【交付与最终发布】🔍
+1. 将生成的 `.zip` 文件发送给运维人员
+2. **运维人员操作流程**：
+   - 解压压缩包
+   - 打开鸿蒙开发者工具，导入解压后的代码目录
+   - 验证代码无报错后，执行上传发布操作
+
+##### ##### ##### ##### 【本地设置】
       ![](readme_files/1.jpg) 
 ##### 
 ---
@@ -116,6 +132,7 @@ H5：打开自己的浏览器输入网址(https://5g.aigc-quickapp.com/hwappx/co
 |------|---------|------|
 | `__app_version` 全局变量注入 | 所有平台 | 构建产物的 `vendor.js`（小程序）或 `index.html`（H5）中自动内联版本数据 |
 | 构建版本信息查看 | 所有平台 | 首页右下角连击 5 次弹出模态框显示 `commitId` 和 `buildTime` |
+| 极限压缩优化 | 小程序（mp-weixin / mp-harmony） | 生产构建自动应用多层次压缩配置，显著减小产物包体积 |
 
 版本数据包含：
 - **commitId**：当前构建的 Git 短提交 ID
@@ -136,7 +153,11 @@ H5：打开自己的浏览器输入网址(https://5g.aigc-quickapp.com/hwappx/co
 💡 **示例 ZIP**：`xcx.aigc-quickapp.com-hwappx.common-3bff91e-20260511_1058.zip`
 
 **微信小程序**生产构建时自动执行：
-- 拷贝 `site.js` / `project.config.json` / `project.private.config.json` 到构建目录
+- 拷贝 `site.js` / `project.config.json` / `project.private.config.json` 文件到构建目录
+- 创建 ZIP 包（文件名包含 Git 提交 ID）
+
+**鸿蒙小程序**生产构建时自动执行：
+- 拷贝必要配置文件到构建目录
 - 创建 ZIP 包（文件名包含 Git 提交 ID）
 
 ### 5.3 环境配置
@@ -165,6 +186,9 @@ H5：打开自己的浏览器输入网址(https://5g.aigc-quickapp.com/hwappx/co
 - `VersionInjectPlugin`：webpack emit 钩子自动注入 `__app_version` 到所有平台产物
 - 首页右下角连击 5 次显示构建版本信息（commitId + buildTime）
 - `mp-weixin.patch.js` 精简为仅文件拷贝和 ZIP 打包
+- 新增 `harmony.patch.js`：鸿蒙小程序生产构建补丁脚本（配置拷贝 + ZIP 打包）
+- `open-directory.js`：构建完成后自动打开输出目录
+- 极限压缩优化：集成 `zion-uniapp-mp-load-package` 插件 + TerserWebpackPlugin 多层次压缩配置
 - 修复 `openWxWorkServiceChat` 方法中 fail 回调语法错误
 - ZIP 文件名末尾使用 Git 提交 ID 替换时间戳
 - 构建脚本幂等性修复，支持多次运行不产生重复注入