@vdhewei/xlsx-template-lib 1.6.10 → 1.6.12

package/README.md

@@ -233,7 +233,7 @@ Configure rendering rules in a rule sheet (e.g., `export.metadata.config`) with
 | Rule Type | Syntax | Description |
 |:----------|:-------|:------------|
 | **alias** | `alias: @#key => use aliasKey: @# => @#` | Alias for field mapping |
-| **rowCell** | `G-AP:12=compile GenCell(...)` | Row rule configuration |
+| **rowCell** | `G-AP:12=compile:GenCell(...)` | Row rule configuration |
 | **mergeCell** | `G-AQ:13-17=sum(...)` | Merge cell calculation |
 | **cell** | `D-7=@#[@D.MY]` | Single cell value assignment |
 
@@ -278,8 +278,8 @@ Configure row rules to assign values to cell ranges. Multiple rowCell configurat
 
 | Rule | Description |
 |:-----|:------------|
-| `G-AP:12=compile GenCell(@#item,[compile Macro]#index@0)` | Assign generated values to row 12, columns G-AP |
-| `A-Z:5=compile Macro(@#data,2,5,!!codeKey)` | Assign formatted cell value to row 5, columns A-Z |
+| `G-AP:12=compile:GenCell(@#item,[compile:Macro]#index@0)` | Assign generated values to row 12, columns G-AP |
+| `A-Z:5=compile:Macro(@#data,2,5,!!codeKey)` | Assign formatted cell value to row 5, columns A-Z |
 
 #### MergeCell Rules
 
@@ -445,14 +445,14 @@ Format macro output using special formatters starting with `!!`:
 **Example 1: Generate CodeKey with Row Cell**
 
 ```
-Rule: G-AQ:117=compile GenCell(#LT[compile Macro]#err@F118[#codeKey],[compile Macro]#index@0)
+Rule: G-AQ:117=compile:GenCell(#LT[compile:Macro]#err@F118[#codeKey],[compile:Macro]#index@0)
 Result: errValue·1, errValue·2, errValue·3, ...
 ```
 
 **Example 2: Format Cell Value with CodeKey**
 
 ```
-Rule: D-7=compile Macro(@#[@D.MY],5,7,!!codeKey)
+Rule: D-7=compile:Macro(@#[@D.MY],5,7,!!codeKey)
 If cell(5,7) = "project-alpha-2024"
 Result: PROJECT_ALPHA_2024
 ```
@@ -460,7 +460,7 @@ Result: PROJECT_ALPHA_2024
 **Example 3: Generate CodeKeyAlias**
 
 ```
-Rule: cell F-10=compile Macro(@#key,3,10,!!codeKeyAlias)
+Rule: cell F-10=compile:Macro(@#key,3,10,!!codeKeyAlias)
 If cell(3,10) = "test..data"
 Result: @TEST_DATA
 ```
@@ -468,11 +468,11 @@ Result: @TEST_DATA
 **Example 4: Number Conversion**
 
 ```
-Rule: row-5=compile Macro(@#value,2,5,!!number)
+Rule: row-5=compile:Macro(@#value,2,5,!!number)
 If cell(2,5) = "42"
 Result: 42
 
-Rule: row-6=compile Macro(@#hex,4,6,!!number)
+Rule: row-6=compile:Macro(@#hex,4,6,!!number)
 If cell(4,6) = "0x1A"
 Result: 26
 ```
@@ -496,8 +496,8 @@ LLR=exportData.LRR
 CTR=contract.contractCode
 
 # RowCell Rules (assign values to cell ranges)
-G-AQ:12=compile GenCell(@#item,[compile Macro]#index@0)
-A-Z:5=compile Macro(@#data,2,5,!!codeKey)
+G-AQ:12=compile:GenCell(@#item,[compile:Macro]#index@0)
+A-Z:5=compile:Macro(@#data,2,5,!!codeKey)
 
 # MergeCell Rules (merge cells and apply calculations)
 G-AQ:13-17=sum(@LT,[compile:Macro(exprArr,F,13,17,!!codeKey)],compile:Macro(index),0)
@@ -533,8 +533,8 @@ Built-in and custom functions for data processing:
 import { ZipXlsxTemplateApp } from '@vdhewei/xlsx-template-lib';
 import * as fs from 'node:fs/promises';
 
-// Load template from buffer
-const templateBuffer = await fs.readFile('template.xlsx');
+// Load zip template from buffer,zip file has [a.xlsx,b.xlsx...]
+const templateBuffer = await fs.readFile('template.zip');
 const app = new ZipXlsxTemplateApp(templateBuffer);
 
 // Render with data
@@ -562,7 +562,7 @@ await fs.writeFile('output.xlsx', output);
 ```typescript
 import { XlsxRender } from '@vdhewei/xlsx-template-lib';
 
-const templateBuffer = await fs.readFile('template.xlsx');
+const templateBuffer = await fs.readFile('template.zip');
 const xlsx = await XlsxRender.create(templateBuffer);
 
 // Render a specific sheet
@@ -594,7 +594,7 @@ const compileOpts = {
   remove: true                           // Remove rule sheet after compile
 };
 
-const zipBuffer = await fs.readFile('template.xlsx');
+const zipBuffer = await fs.readFile('template.zip');
 const result = await ZipXlsxTemplateApp.compileTo(zipBuffer, {
   checker: async (buf, opts, values, fileName) => {
     // Custom validation logic
@@ -620,6 +620,17 @@ Or use directly from `npx`:
 npx @vdhewei/xlsx-template-lib <command> [options]
 ```
 
+Or git clone source code use bun compile to local Native CLI
+```bash
+git clone https://github.com/VDHewei/xlsx-template-lib.git
+cd xlsx-template-lib
+pnpm i
+npm install -g bun
+pnpm run complie-cli # default output bin/xlsx-cli 
+# or use -o compile to user local dir
+pnpm run compile-cli -o your-path/
+```
+
 #### Commands
 
 ##### 1. Compile Command
@@ -642,19 +653,19 @@ xlsx-cli compile <xlsx-file> [options]
 
 ```bash
 # Basic compile with default settings
-xlsx-cli compile template.xlsx
+xlsx-cli compile template.zip
 
 # Compile and save to specific location
-xlsx-cli compile template.xlsx -s ./output/
+xlsx-cli compile template.zip -s ./output/
 
 # Compile specific sheet
-xlsx-cli compile template.xlsx -n Sheet1
+xlsx-cli compile template.zip -n Sheet1
 
 # Compile and remove config sheet
-xlsx-cli compile template.xlsx -r
+xlsx-cli compile template.zip -r
 
 # Full example
-xlsx-cli compile template.xlsx -s ./output/ -n Sheet1 -r
+xlsx-cli compile template.zip -s ./output/ -n Sheet1 -r
 ```
 
 **Output:**
@@ -685,34 +696,34 @@ xlsx-cli render <xlsx-file> [options]
 
 ```bash
 # Basic render with empty data
-xlsx-cli render template.xlsx
+xlsx-cli render template.zip
 
 # Render with JSON data string
-xlsx-cli render template.xlsx -d '{"name":"John","age":30}'
+xlsx-cli render template.zip -d '{"name":"John","age":30}'
 
 # Render with JSON file
-xlsx-cli render template.xlsx -d ./data.json
+xlsx-cli render template.zip -d ./data.json
 
 # Render with remote JSON URL
-xlsx-cli render template.xlsx -d 'https://api.example.com/data.json'
+xlsx-cli render template.zip -d 'https://api.example.com/data.json'
 
 # Render with auto-compile
-xlsx-cli render template.xlsx -c -d './data.json'
+xlsx-cli render template.zip -c -d './data.json'
 
 # Render specific sheet
-xlsx-cli render template.xlsx -n Sheet1 -d './data.json'
+xlsx-cli render template.zip -n Sheet1 -d './data.json'
 
 # Render with custom HTTP headers
-xlsx-cli render template.xlsx -d 'https://api.example.com/data.json' --header 'Authorization:Bearer token123' --header 'Content-Type:application/json'
+xlsx-cli render template.zip -d 'https://api.example.com/data.json' --header 'Authorization:Bearer token123' --header 'Content-Type:application/json'
 
 # Render with POST request body
-xlsx-cli render template.xlsx -d 'https://api.example.com/api/query' --body '{"query":"SELECT * FROM users"}' --header 'Content-Type:application/json'
+xlsx-cli render template.zip -d 'https://api.example.com/api/query' --body '{"query":"SELECT * FROM users"}' --header 'Content-Type:application/json'
 
 # Render with POST method via header
-xlsx-cli render template.xlsx -d 'https://api.example.com/api/create' --body '{"name":"Test"}' --header 'Content-Type:application/json' --header 'method:POST'
+xlsx-cli render template.zip -d 'https://api.example.com/api/create' --body '{"name":"Test"}' --header 'Content-Type:application/json' --header 'method:POST'
 
 # Full example
-xlsx-cli render template.xlsx -c -n Sheet1 -s ./output/ -d './data.json'
+xlsx-cli render template.zip -c -n Sheet1 -s ./output/ -d './data.json'
 ```
 
 **Data Sources:**
@@ -734,26 +745,26 @@ xlsx-cli render template.xlsx -c -n Sheet1 -s ./output/ -d './data.json'
 
 ```bash
 # GET request with custom headers
-xlsx-cli render template.xlsx \
+xlsx-cli render template.zip \
   -d 'https://api.example.com/data.json' \
   --header 'Authorization:Bearer your-token' \
   --header 'X-API-Key:api-key-123'
 
 # POST request with JSON body
-xlsx-cli render template.xlsx \
+xlsx-cli render template.zip \
   -d 'https://api.example.com/api/query' \
   --body '{"query":"SELECT * FROM users LIMIT 10"}' \
   --header 'Content-Type:application/json'
 
 # POST request with method specified in header
-xlsx-cli render template.xlsx \
+xlsx-cli render template.zip \
   -d 'https://api.example.com/api/create' \
   --body '{"name":"New Record","value":100}' \
   --header 'Content-Type:application/json' \
   --header 'method:POST'
 
 # Complex example with authentication and query body
-xlsx-cli render template.xlsx \
+xlsx-cli render template.zip \
   -d 'https://api.example.com/v1/export' \
   --header 'Authorization:Bearer eyJhbGc...' \
   --header 'Content-Type:application/json' \
@@ -820,28 +831,28 @@ xlsx-cli rules <xlsx-file> [options]
 **Single Rule (Command Line):**
 ```bash
 # Add alias rule
-xlsx-cli rules template.xlsx -t alias -r 'T=template'
+xlsx-cli rules template.zip -t alias -r 'T=template'
 
 # Add cell rule
-xlsx-cli rules template.xlsx -t cell -r 'D:7=${@LLR.value}'
+xlsx-cli rules template.zip -t cell -r 'D:7=${@LLR.value}'
 
 # Add rowCell rule
-xlsx-cli rules template.xlsx -t rowCell -r 'G-AQ:12=compile GenCell(@#item,[compile Macro]#index@0)'
+xlsx-cli rules template.zip -t rowCell -r 'G-AQ:12=compile:GenCell(@#item,[compile:Macro]#index@0)'
 
 # Add mergeCell rule
-xlsx-cli rules template.xlsx -t mergeCell -r 'G-AQ:13-17=sum(@LT,[compile:Macro(exprArr,F,13,17,!!codeKey)],compile:Macro(index),0)'
+xlsx-cli rules template.zip -t mergeCell -r 'G-AQ:13-17=sum(@LT,[compile:Macro(exprArr,F,13,17,!!codeKey)],compile:Macro(index),0)'
 ```
 
 **Multiple Rules (Command Line):**
 ```bash
 # Add multiple rules with same type
-xlsx-cli rules template.xlsx -t cell -r 'D:7=${@LLR.value}' -r 'A:1=${@T}' -r 'B:1=${@LLR.value}'
+xlsx-cli rules template.zip -t cell -r 'D:7=${@LLR.value}' -r 'A:1=${@T}' -r 'B:1=${@LLR.value}'
 ```
 
 **Rules from File:**
 ```bash
 # Read rules from file
-xlsx-cli rules template.xlsx -f rules.txt
+xlsx-cli rules template.zip -f rules.txt
 
 # Create rules.txt file:
 # This is a comment
@@ -849,14 +860,14 @@ alias T=template
 alias LLR=exportData.LRR
 cell D:7=${@T}
 cell A:1=${@LLR.value}
-rowCell G-AQ:12=compile GenCell(@#item,[compile Macro]#index@0)
+rowCell G-AQ:12=compile:GenCell(@#item,[compile:Macro]#index@0)
 mergeCell G-AQ:13-17=sum(@LT,[compile:Macro(exprArr,F,13,17,!!codeKey)],compile:Macro(index),0)
 ```
 
 **Save to Specific Directory:**
 ```bash
-xlsx-cli rules template.xlsx -f rules.txt -s ./output/
-xlsx-cli rules template.xlsx -t cell -r 'D:7=${@LLR.value}' -s ./output/
+xlsx-cli rules template.zip -f rules.txt -s ./output/
+xlsx-cli rules template.zip -t cell -r 'D:7=${@LLR.value}' -s ./output/
 ```
 
 **File Format (-f mode):**
@@ -867,7 +878,7 @@ xlsx-cli rules template.xlsx -t cell -r 'D:7=${@LLR.value}' -s ./output/
 
 cell D:7=${@LLR.value}
 alias T=template
-rowCell G-AQ:12=compile GenCell(@#item,[compile Macro]#index@0)
+rowCell G-AQ:12=compile:GenCell(@#item,[compile:Macro]#index@0)
 mergeCell G-AQ:13-17=sum(@LT,[compile:Macro(exprArr,F,13,17,!!codeKey)],compile:Macro(index),0)
 ```
 
@@ -921,7 +932,7 @@ AddCommand('multiply', (obj, args) => {
   const values = args.groups.map(g => valueDotGet(obj, g));
   return values.reduce((a, b) => a * b, 1);
 });
-
+const data = await fs.readFile('simple.xlsx');
 // Generate template with custom commands
 const buffer = await generateCommandsXlsxTemplate(data, options);
 ```
@@ -989,7 +1000,7 @@ Main class for rendering single Excel files.
 ### Template Structure
 
 ```
-template.xlsx
+template.zip
 ├── Sheet1 (Data Sheet with placeholders)
 │   ├── A1: ${contract.contractCode}
 │   ├── B1: ${contract.contractTitle}
@@ -1002,12 +1013,12 @@ template.xlsx
 
 ### Compile & Render Flow
 
-| Step | Input | Output | Description |
-|:-----|:------|:-------|:------------|
-| 1. Load | `template.xlsx` Buffer | `ZipXlsxTemplateApp` | Load template file |
-| 2. Compile | Rule Config Sheet | Compiled Rules | Parse mergeCell/cell/rowCell rules |
-| 3. Substitute | Data Object | Rendered Sheets | Replace `${...}` placeholders |
-| 4. Generate | - | `output.xlsx` Buffer | Final output file |
+| Step | Input                 | Output | Description |
+|:-----|:----------------------|:-------|:------------|
+| 1. Load | `template.zip` Buffer | `ZipXlsxTemplateApp` | Load template file |
+| 2. Compile | Rule Config Sheet     | Compiled Rules | Parse mergeCell/cell/rowCell rules |
+| 3. Substitute | Data Object           | Rendered Sheets | Replace `${...}` placeholders |
+| 4. Generate | -                     | `output.xlsx` Buffer | Final output file |
 
 ```typescript
 import { ZipXlsxTemplateApp, AddCommand } from '@vdhewei/xlsx-template-lib';
@@ -1022,7 +1033,7 @@ AddCommand('calculateTotal', (obj, args) => {
 
 // Main processing
 async function processTemplate() {
-  const templateBuffer = await fs.readFile('template.xlsx');
+  const templateBuffer = await fs.readFile('template.zip');
   
   const app = new ZipXlsxTemplateApp(templateBuffer);
   

package/README.zh-CN.md

@@ -231,7 +231,7 @@ A               B
 | 规则类型 | 语法 | 说明 |
 |:---------|:-----|:-----|
 | **alias** | `alias: @#key => use aliasKey: @# => @#` | 字段别名映射 |
-| **rowCell** | `G-AP:12=compile GenCell(...)` | 行规则配置 |
+| **rowCell** | `G-AP:12=compile:GenCell(...)` | 行规则配置 |
 | **mergeCell** | `G-AQ:13-17=sum(...)` | 合并单元格计算 |
 | **cell** | `D-7=@#[@D.MY]` | 单个单元格值赋值 |
 
@@ -274,10 +274,10 @@ A               B
 
 **示例：**
 
-| 规则 | 说明 |
-|:-----|:-----|
-| `G-AP:12=compile GenCell(@#item,[compile Macro]#index@0)` | 为第 12 行的 G-AP 列赋值生成的值 |
-| `A-Z:5=compile Macro(@#data,2,5,!!codeKey)` | 为第 5 行的 A-Z 列赋值格式化后的单元格值 |
+| 规则                                                        | 说明 |
+|:----------------------------------------------------------|:-----|
+| `G-AP:12=compile:GenCell(@#item,[compile:Macro]#index@0)` | 为第 12 行的 G-AP 列赋值生成的值 |
+| `A-Z:5=compile:Macro(@#data,2,5,!!codeKey)`               | 为第 5 行的 A-Z 列赋值格式化后的单元格值 |
 
 #### MergeCell 规则
 
@@ -443,14 +443,14 @@ sub(orders,[money,food,game],1,0)
 **示例 1: 使用行单元格生成 CodeKey**
 
 ```
-规则: G-AQ:117=compile GenCell(#LT[compile Macro]#err@F118[#codeKey],[compile Macro]#index@0)
+规则: G-AQ:117=compile:GenCell(#LT,compile:Macro(index),0)
 结果: errValue·1, errValue·2, errValue·3, ...
 ```
 
 **示例 2: 使用 CodeKey 格式化单元格值**
 
 ```
-规则: D-7=compile Macro(@#[@D.MY],5,7,!!codeKey)
+规则: D-7=compile:Macro(expr,5,7,!!codeKey)
 如果 cell(5,7) = "project-alpha-2024"
 结果: PROJECT_ALPHA_2024
 ```
@@ -458,7 +458,7 @@ sub(orders,[money,food,game],1,0)
 **示例 3: 生成 CodeKeyAlias**
 
 ```
-规则: cell F-10=compile Macro(@#key,3,10,!!codeKeyAlias)
+规则: cell F-10=compile:Marco(expr,3,10,!!codeKeyAlias)
 如果 cell(3,10) = "test..data"
 结果: @TEST_DATA
 ```
@@ -466,11 +466,11 @@ sub(orders,[money,food,game],1,0)
 **示例 4: 数字转换**
 
 ```
-规则: row-5=compile Macro(@#value,2,5,!!number)
+规则: row-5=compile:Macro(expr,2,5,!!number)
 如果 cell(2,5) = "42"
 结果: 42
 
-规则: row-6=compile Macro(@#hex,4,6,!!number)
+规则: row-6=compile:Macro(expr,4,6,!!number)
 如果 cell(4,6) = "0x1A"
 结果: 26
 ```
@@ -478,9 +478,9 @@ sub(orders,[money,food,game],1,0)
 **示例 5: 使用 Index 迭代**
 
 ```
-第 1 行: Code-${compile:Macro(index)}  →  Code-1
-第 2 行: Code-${compile:Macro(index)}  →  Code-2
-第 3 行: Code-${compile:Macro(index)}  →  Code-3
+第 1 行: Code-compile:Macro(index)  →  Code-1
+第 2 行: Code-compile:Macro(index)  →  Code-2
+第 3 行: Code-compile:Macro(index)  →  Code-3
 ```
 
 #### 完整规则配置示例
@@ -494,8 +494,8 @@ LLR=exportData.LRR
 CTR=contract.contractCode
 
 # RowCell 规则（为单元格范围赋值）
-G-AQ:12=compile GenCell(@#item,[compile Macro]#index@0)
-A-Z:5=compile Macro(@#data,2,5,!!codeKey)
+G-AQ:12=compile:GenCell(@#item,G,compile:Macro(index),0)
+A-Z:5=compile:Macro(@#data,2,5,!!codeKey)
 
 # MergeCell 规则（合并单元格并应用计算）
 G-AQ:13-17=sum(@LT,[compile:Macro(exprArr,F,13,17,!!codeKey)],compile:Macro(index),0)
@@ -531,8 +531,8 @@ B:1=${@LLR.value}
 import { ZipXlsxTemplateApp } from '@vdhewei/xlsx-template-lib';
 import * as fs from 'node:fs/promises';
 
-// 从 buffer 加载模板
-const templateBuffer = await fs.readFile('template.xlsx');
+// 从 zip buffer 加载模板 zip 文件有 : [a.xlsx,b.xlsx...]
+const templateBuffer = await fs.readFile('template.zip');
 const app = new ZipXlsxTemplateApp(templateBuffer);
 
 // 使用数据渲染
@@ -560,7 +560,7 @@ await fs.writeFile('output.xlsx', output);
 ```typescript
 import { XlsxRender } from '@vdhewei/xlsx-template-lib';
 
-const templateBuffer = await fs.readFile('template.xlsx');
+const templateBuffer = await fs.readFile('template.zip');
 const xlsx = await XlsxRender.create(templateBuffer);
 
 // 渲染特定工作表
@@ -592,7 +592,7 @@ const compileOpts = {
   remove: true                           // 编译后移除规则工作表
 };
 
-const zipBuffer = await fs.readFile('template.xlsx');
+const zipBuffer = await fs.readFile('template.zip');
 const result = await ZipXlsxTemplateApp.compileTo(zipBuffer, {
   checker: async (buf, opts, values, fileName) => {
     // 自定义验证逻辑
@@ -618,6 +618,17 @@ npm install -g @vdhewei/xlsx-template-lib
 npx @vdhewei/xlsx-template-lib <命令> [选项]
 ```
 
+或者 直接下载源码使用 Bun 将源码编译成本地二进制CLI
+```bash
+git clone https://github.com/VDHewei/xlsx-template-lib.git
+cd xlsx-template-lib
+pnpm i
+npm install -g bun
+pnpm run complie-cli # 默认编译产物在当前 bin/目录下 (windows:xlsx-cli.exe ,other:xlsx-cli  ) 
+# 或者用户指定编译输出目录 (-o 或者 --output-dir)
+pnpm run compile-cli -o your-path/
+```
+
 #### 命令
 
 ##### 1. compile 命令
@@ -640,19 +651,19 @@ xlsx-cli compile <xlsx-文件> [选项]
 
 ```bash
 # 使用默认设置编译
-xlsx-cli compile template.xlsx
+xlsx-cli compile template.zip
 
 # 编译并保存到指定位置
-xlsx-cli compile template.xlsx -s ./output/
+xlsx-cli compile template.zip -s ./output/
 
 # 编译指定工作表
-xlsx-cli compile template.xlsx -n Sheet1
+xlsx-cli compile template.zip -n Sheet1
 
 # 编译并移除配置工作表
-xlsx-cli compile template.xlsx -r
+xlsx-cli compile template.zip -r
 
 # 完整示例
-xlsx-cli compile template.xlsx -s ./output/ -n Sheet1 -r
+xlsx-cli compile template.zip -s ./output/ -n Sheet1 -r
 ```
 
 **输出:**
@@ -683,34 +694,34 @@ xlsx-cli render <xlsx-文件> [选项]
 
 ```bash
 # 使用空数据基本渲染
-xlsx-cli render template.xlsx
+xlsx-cli render template.zip
 
 # 使用 JSON 字符串渲染
-xlsx-cli render template.xlsx -d '{"name":"张三","age":30}'
+xlsx-cli render template.zip -d '{"name":"张三","age":30}'
 
 # 使用 JSON 文件渲染
-xlsx-cli render template.xlsx -d ./data.json
+xlsx-cli render template.zip -d ./data.json
 
 # 使用远程 JSON URL 渲染
-xlsx-cli render template.xlsx -d 'https://api.example.com/data.json'
+xlsx-cli render template.zip -d 'https://api.example.com/data.json'
 
 # 渲染并自动编译
-xlsx-cli render template.xlsx -c -d './data.json'
+xlsx-cli render template.zip -c -d './data.json'
 
 # 渲染指定工作表
-xlsx-cli render template.xlsx -n Sheet1 -d './data.json'
+xlsx-cli render template.zip -n Sheet1 -d './data.json'
 
 # 使用自定义 HTTP 请求头渲染
-xlsx-cli render template.xlsx -d 'https://api.example.com/data.json' --header 'Authorization:Bearer token123' --header 'Content-Type:application/json'
+xlsx-cli render template.zip -d 'https://api.example.com/data.json' --header 'Authorization:Bearer token123' --header 'Content-Type:application/json'
 
 # 使用 POST 请求体渲染
-xlsx-cli render template.xlsx -d 'https://api.example.com/api/query' --body '{"query":"SELECT * FROM users"}' --header 'Content-Type:application/json'
+xlsx-cli render template.zip -d 'https://api.example.com/api/query' --body '{"query":"SELECT * FROM users"}' --header 'Content-Type:application/json'
 
 # 通过 header 指定 POST 方法
-xlsx-cli render template.xlsx -d 'https://api.example.com/api/create' --body '{"name":"测试"}' --header 'Content-Type:application/json' --header 'method:POST'
+xlsx-cli render template.zip -d 'https://api.example.com/api/create' --body '{"name":"测试"}' --header 'Content-Type:application/json' --header 'method:POST'
 
 # 完整示例
-xlsx-cli render template.xlsx -c -n Sheet1 -s ./output/ -d './data.json'
+xlsx-cli render template.zip -c -n Sheet1 -s ./output/ -d './data.json'
 ```
 
 **数据源:**
@@ -732,26 +743,26 @@ xlsx-cli render template.xlsx -c -n Sheet1 -s ./output/ -d './data.json'
 
 ```bash
 # 带自定义请求头的 GET 请求
-xlsx-cli render template.xlsx \
+xlsx-cli render template.zip \
   -d 'https://api.example.com/data.json' \
   --header 'Authorization:Bearer your-token' \
   --header 'X-API-Key:api-key-123'
 
 # 带 JSON 请求体的 POST 请求
-xlsx-cli render template.xlsx \
+xlsx-cli render template.zip \
   -d 'https://api.example.com/api/query' \
   --body '{"query":"SELECT * FROM users LIMIT 10"}' \
   --header 'Content-Type:application/json'
 
 # 通过 header 指定 POST 方法
-xlsx-cli render template.xlsx \
+xlsx-cli render template.zip \
   -d 'https://api.example.com/api/create' \
   --body '{"name":"新记录","value":100}' \
   --header 'Content-Type:application/json' \
   --header 'method:POST'
 
 # 复杂示例：带认证和查询请求体
-xlsx-cli render template.xlsx \
+xlsx-cli render template.zip \
   -d 'https://api.example.com/v1/export' \
   --header 'Authorization:Bearer eyJhbGc...' \
   --header 'Content-Type:application/json' \
@@ -818,28 +829,28 @@ xlsx-cli rules <xlsx-文件> [选项]
 **单个规则（命令行）：**
 ```bash
 # 添加 alias 规则
-xlsx-cli rules template.xlsx -t alias -r 'T=template'
+xlsx-cli rules template.zip -t alias -r 'T=template'
 
 # 添加 cell 规则
-xlsx-cli rules template.xlsx -t cell -r 'D:7=${@LLR.value}'
+xlsx-cli rules template.zip -t cell -r 'D:7=${@LLR.value}'
 
 # 添加 rowCell 规则
-xlsx-cli rules template.xlsx -t rowCell -r 'G-AQ:12=compile GenCell(@#item,[compile Macro]#index@0)'
+xlsx-cli rules template.zip -t rowCell -r 'G-AQ:12=compile:GenCell(@#item,[compile:Macro]#index@0)'
 
 # 添加 mergeCell 规则
-xlsx-cli rules template.xlsx -t mergeCell -r 'G-AQ:13-17=sum(@LT,[compile:Macro(exprArr,F,13,17,!!codeKey)],compile:Macro(index),0)'
+xlsx-cli rules template.zip -t mergeCell -r 'G-AQ:13-17=sum(@LT,[compile:Macro(exprArr,F,13,17,!!codeKey)],compile:Macro(index),0)'
 ```
 
 **多个规则（命令行）：**
 ```bash
 # 添加同类型的多个规则
-xlsx-cli rules template.xlsx -t cell -r 'D:7=${@LLR.value}' -r 'A:1=${@T}' -r 'B:1=${@LLR.value}'
+xlsx-cli rules template.zip -t cell -r 'D:7=${@LLR.value}' -r 'A:1=${@T}' -r 'B:1=${@LLR.value}'
 ```
 
 **从文件读取规则：**
 ```bash
 # 从文件读取规则
-xlsx-cli rules template.xlsx -f rules.txt
+xlsx-cli rules template.zip -f rules.txt
 
 # 创建 rules.txt 文件：
 # 这是注释行
@@ -847,14 +858,14 @@ alias T=template
 alias LLR=exportData.LRR
 cell D:7=${@T}
 cell A:1=${@LLR.value}
-rowCell G-AQ:12=compile GenCell(@#item,[compile Macro]#index@0)
+rowCell G-AQ:12=compile:GenCell(@#item,[compile:Macro]#index@0)
 mergeCell G-AQ:13-17=sum(@LT,[compile:Macro(exprArr,F,13,17,!!codeKey)],compile:Macro(index),0)
 ```
 
 **保存到指定目录：**
 ```bash
-xlsx-cli rules template.xlsx -f rules.txt -s ./output/
-xlsx-cli rules template.xlsx -t cell -r 'D:7=${@LLR.value}' -s ./output/
+xlsx-cli rules template.zip -f rules.txt -s ./output/
+xlsx-cli rules template.zip -t cell -r 'D:7=${@LLR.value}' -s ./output/
 ```
 
 **文件格式（-f 模式）：**
@@ -865,7 +876,7 @@ xlsx-cli rules template.xlsx -t cell -r 'D:7=${@LLR.value}' -s ./output/
 
 cell D:7=${@LLR.value}
 alias T=template
-rowCell G-AQ:12=compile GenCell(@#item,[compile Macro]#index@0)
+rowCell G-AQ:12=compile:GenCell(@#item,[compile:Macro]#index@0)
 mergeCell G-AQ:13-17=sum(@LT,[compile:Macro(exprArr,F,13,17,!!codeKey)],compile:Macro(index),0)
 ```
 
@@ -920,7 +931,8 @@ AddCommand('multiply', (obj, args) => {
   const values = args.groups.map(g => valueDotGet(obj, g));
   return values.reduce((a, b) => a * b, 1);
 });
-
+// 读取xlsx模板
+const data = await fs.readFile('simple.xlsx');
 // 使用自定义命令生成模板
 const buffer = await generateCommandsXlsxTemplate(data, options);
 ```
@@ -988,7 +1000,7 @@ const output = await app.generate();
 ### 模板结构
 
 ```
-template.xlsx
+template.zip
 ├── Sheet1 (数据工作表，包含占位符)
 │   ├── A1: ${contract.contractCode}
 │   ├── B1: ${contract.contractTitle}
@@ -1001,12 +1013,12 @@ template.xlsx
 
 ### 编译与渲染流程
 
-| 步骤 | 输入 | 输出 | 说明 |
-|:-----|:-----|:-----|:-----|
-| 1. 加载 | `template.xlsx` Buffer | `ZipXlsxTemplateApp` | 加载模板文件 |
-| 2. 编译 | 规则配置工作表 | 编译后的规则 | 解析 mergeCell/cell/rowCell 规则 |
-| 3. 替换 | 数据对象 | 渲染后的工作表 | 替换 `${...}` 占位符 |
-| 4. 生成 | - | `output.xlsx` Buffer | 最终输出文件 |
+| 步骤 | 输入                    | 输出 | 说明 |
+|:-----|:----------------------|:-----|:-----|
+| 1. 加载 | `template.zip` Buffer | `ZipXlsxTemplateApp` | 加载模板文件 |
+| 2. 编译 | 规则配置工作表               | 编译后的规则 | 解析 mergeCell/cell/rowCell 规则 |
+| 3. 替换 | 数据对象                  | 渲染后的工作表 | 替换 `${...}` 占位符 |
+| 4. 生成 | -                     | `output.xlsx` Buffer | 最终输出文件 |
 
 ```typescript
 import { ZipXlsxTemplateApp, AddCommand } from '@vdhewei/xlsx-template-lib';
@@ -1021,7 +1033,7 @@ AddCommand('calculateTotal', (obj, args) => {
 
 // 主处理流程
 async function processTemplate() {
-  const templateBuffer = await fs.readFile('template.xlsx');
+  const templateBuffer = await fs.readFile('template.zip');
   
   const app = new ZipXlsxTemplateApp(templateBuffer);