vg-print 1.1.304 → 1.1.306

package/README.en.md

@@ -32,6 +32,20 @@ https://download.csdn.net/download/github_38400706/92538739
 ```bash
 npm i vg-print
 ```
+If you need client direct printing (`hiwebSocket`), install the optional dependency in your host app:
+
+```bash
+npm i socket.io-client
+```
+
+In your main entry file (e.g., `main.ts`):
+
+```js
+import { io } from 'socket.io-client'
+import { setSocketIo } from 'vg-print'
+
+setSocketIo(io)
+```
 
 ## Header Component
 

package/README.md

@@ -88,8 +88,6 @@ hiprint.register({
 
 ## 静默打印客户端工具安装包
 
-![静默打印客户端工具](https://gitee.com/gao111/electron-vg-print/raw/master/electron-hiprint.png)
-
 [客户端工具下载](https://download.csdn.net/download/github_38400706/92538739)
 
 ## 特性
@@ -106,6 +104,46 @@ hiprint.register({
 npm i vg-print
 ```
 
+### 可选依赖：直连打印/客户端连接（socket.io-client）
+
+- 本库默认不内置 `socket.io-client`，以减少默认安装体积。
+- 仅当你需要“直连打印/客户端连接（hiwebSocket）”能力（如 `print()` / `print2()` / 自动连接）时，才需要安装并注入：
+
+```bash
+npm i socket.io-client
+```
+
+在项目入口（如 `main.ts`）注入：
+
+```js
+import { io } from 'socket.io-client'
+import { setSocketIo } from 'vg-print'
+
+setSocketIo(io)
+```
+
+也可直接使用 `window.io = io`（等价）。
+
+### 可选依赖：数据源（axios）
+
+- 本库默认不内置 `axios`，以减少默认安装体积。
+- 仅当你需要“数据源管理/接口取数/字段联动”能力时，才需要安装并注入：
+
+```bash
+npm i axios
+```
+
+在项目入口（如 `main.ts`）注入：
+
+```js
+import axios from 'axios'
+import { setHttpClient } from 'vg-print'
+
+setHttpClient(axios)
+```
+
+未安装/未注入时，“数据源”入口会自动禁用；即使误触发也不会导致项目报错。
+
 ## Header 顶部工具栏组件
 
 - 用于页面一级头部区域，内置常用操作按钮与打印机设置；支持通过 `props` 与 `slots` 定制。
@@ -765,6 +803,8 @@ return (result.data || []).map(item => ({
 
 本库导出 `hiprint`，可直接创建与操作模板对象（`hiprint.PrintTemplate`）：
 
+若需要使用“直连打印/客户端连接（hiwebSocket）”相关能力，请先按上文注入 `io`；否则会提示缺失并导致连接失败。
+
 ```js
 import { hiprint, defaultElementTypeProvider } from 'vg-print'
 // 全局配置