vg-print 1.0.302 → 1.0.303

package/README.md

@@ -162,7 +162,12 @@ hiprint.setConfig({ showAdsorbLine: true, showPosition: true, showSizeBox: true
 // 注册插件
 hiprint.register({ authKey: '', plugins: [] })
 // 初始化元素提供器 （默认元素提供器）
-hiprint.init({ providers: [new defaultElementTypeProvider()] })
+hiprint.init({ 
+  providers: [new defaultElementTypeProvider()],
+  host: 'http://localhost:17521',
+  token: '',
+  lang: 'en'
+})
 // 创建模板对象
 const tpl = new hiprint.PrintTemplate({ template: {} })
 // 设计模板
@@ -177,14 +182,14 @@ tpl.toPdf({ name: '示例' }, '打印预览pdf', { paperWidth: 210, paperHeight:
 tpl.toImage({ name: '示例' }, { isDownload: true, name: '图片', limit: 1, type: 'image/jpeg', pixelRatio: 2 })
 ```
 
-在任何场景（完整设计器、轻量 API、直接 `new`）只要在应用初始化阶段先调用这行注册，默认水印就会自动移除。
+水印与授权行为说明：设计态与运行态分离。设计态始终显示默认水印；运行态由授权控制。
 
 ### 授权密钥（authKey）与默认水印
 
 - 行为说明：
-  - 未配置`authKey`时，库会为每个模板默认注入水印：`{ content: 'vg-print', timestamp: true }`。
-  - 配置了`authKey`时，库不再注入默认水印；如需自定义，可自行传入`watermarkOptions`。
-  - 适用于所有入口：完整设计器组件、直接`new hiprint.PrintTemplate(...)`、以及轻量运行时 API（`createTemplate`）。
+  - 设计态（FullDesigner 设计界面）：始终显示默认水印 `{ content: 'vg-print', timestamp: true }`，不受 `authKey` 控制。
+  - 运行态（预览、浏览器打印、导出 PDF/图片、直连打印）：未注册 `authKey` 时显示默认水印；注册有效 `authKey` 后默认水印移除。
+  - 适用于所有入口：完整设计器组件、直接 `new hiprint.PrintTemplate(...)`、以及轻量运行时 API（`createTemplate`）。
 
 - 全局注册授权密钥：
 
@@ -192,23 +197,12 @@ tpl.toImage({ name: '示例' }, { isDownload: true, name: '图片', limit: 1, ty
 import { hiprint } from 'vg-print'
 
 // 注册授权 key（建议在应用启动时调用）
-hiprint.register({ authKey: 'YOUR_AUTH_KEY' })
+hiprint.register({ authKey: '你的key' })
 
-// 有授权 key → 默认水印移除
+// 有授权 key → 运行态默认水印移除（设计态仍显示）
 const tpl = new hiprint.PrintTemplate({ template: {} })
 ```
 
-- 加密用法（可选）：
-
-  - Base64 轻度加密（无需 AES 参数；库端自动 Base64 解码）：
-
-  ```js
-  import { hiprint } from 'vg-print'
-
-  await hiprint.register({ authKey: '你的key' })
-  // 解密成功 → 默认水印移除
-  ```
-
 - 轻量运行时 API 使用授权：
 
 ```js
@@ -228,13 +222,14 @@ const tpl = new hiprint.PrintTemplate({
   watermarkOptions: { content: 'your-brand', timestamp: true, rotate: 20 }
 })
 
-// 有授权时，库不会注入默认水印；若仍需水印，请显式传入
+// 有授权时，运行态不会注入默认水印；若仍需水印，请显式传入
 const tpl2 = createTemplate(tmplJson, {
   watermarkOptions: { content: 'your-brand', timestamp: true }
 })
 
-// 注意：若想在无授权时也不显示默认水印，可显式传入空对象
-const tpl3 = new hiprint.PrintTemplate({ template: {}, watermarkOptions: {} })
+// 设计态不可关闭默认水印。
+// 运行态的默认水印由授权控制，不建议通过传入空对象取消；如需取消，请注册有效 authKey。
+const tpl3 = new hiprint.PrintTemplate({ template: {}, watermarkOptions: { content: 'your-brand', timestamp: true } })
 ```
 
 - 插件注册（可选）：