agentlink-sdk 1.0.10 → 1.1.0

package/README.md

@@ -71,7 +71,9 @@ client.receiveData((data, type, senderInfo) => {
   - 使用默认服务端（如 `https://www.mixlab.top`）时，需在对应后台将你的域名加入白名单。  
   - 使用自建服务端时，请在自己的 AgentLink 管理后台添加域名。
 
-总结：只要你的域名已在所用 AgentLink 服务端的白名单中，即可正常跨域调用、发送数据，无需担心浏览器跨域限制。
+- **能力接口**：`fetchCapabilities`、`fetchStructureData` 调用服务端的 `/api/capabilities`、`/api/structureData` 时，服务端会校验请求的 **Origin/Referer**，仅**白名单域名**或 **server 自身**可调用；非白名单会返回 403（域名不在白名单中）。
+
+总结：只要你的域名已在所用 AgentLink 服务端的白名单中，即可正常跨域调用、发送数据及使用能力接口，无需担心浏览器跨域限制。
 
 ## API 文档
 
@@ -123,6 +125,50 @@ await client.sendData(
 );
 ```
 
+##### prepareSendData（预编码）
+
+在用户点击前完成 Token、白名单校验与 URL 编码，返回可用于打开的 URL。适用于 **iOS Safari** 等会拦截“异步后再 `window.open`”的环境：在点击前调用 `prepareSendData`，在点击回调中**同步**调用 `openEncodedUrl`，避免弹窗被拦截。
+
+```typescript
+prepareSendData(
+  targetUrl: string,
+  data: any,
+  type: string,
+  windowName?: string
+): Promise<string>
+```
+
+**参数：** 与 `sendData` 相同。
+
+**返回值：** 编码后的完整 URL（可传入 `openEncodedUrl` 或 `window.open(url, windowName)`）。
+
+**示例（iOS Safari 推荐）：**
+
+```typescript
+let encodedUrl: string | null = null;
+
+// 在页面加载或 hover 时预编码（可提前调用）
+client.prepareSendData(targetUrl, data, type).then((url) => {
+  encodedUrl = url;
+}).catch(console.error);
+
+// 在点击处理器中同步打开，不包含 await
+sendButton.addEventListener('click', () => {
+  if (encodedUrl) client.openEncodedUrl(encodedUrl);
+});
+```
+
+##### openEncodedUrl（同步打开）
+
+使用 `prepareSendData` 返回的 URL 同步打开目标窗口。**必须在用户手势的同步回调中调用**（如 click 内直接调用），否则可能被弹窗拦截。
+
+```typescript
+openEncodedUrl(encodedUrl: string, windowName?: string): void
+```
+
+- `encodedUrl`: 由 `prepareSendData` 返回的 URL
+- `windowName`: 与 `prepareSendData` 时一致，默认为 `DEFAULT_WINDOW_NAME`（`'agentlink-window'`）
+
 ##### receiveData
 
 监听来自 URL hash 的数据。
@@ -324,7 +370,7 @@ const images = extractImages(rawData);
 
 ### fetchCapabilities
 
-请求服务端的 GET /api/capabilities，返回当前实例是否提供 structureData 等能力。不传 `serverUrl` 时使用默认地址 `https://www.mixlab.top`。
+请求服务端的 GET /api/capabilities，返回当前实例是否提供 structureData 等能力。不传 `serverUrl` 时使用默认地址 `https://www.mixlab.top`。**白名单**：服务端会校验请求的 Origin/Referer，仅白名单域名或 server 自身可调用，否则返回 403。
 
 ```typescript
 import { fetchCapabilities } from 'agentlink-sdk';
@@ -341,24 +387,31 @@ const cap2 = await fetchCapabilities('https://your-agentlink-server.com');
 
 ### fetchStructureData
 
-请求服务端的 POST /api/structureData，传入 schema，由服务端 LLM 返回结构化结果（source、category、content、tags 等）。第一个参数 `serverUrl` 可选，不传时使用默认地址 `https://www.mixlab.top`；同源时可传 `''`。
+请求服务端的 POST /api/structureData，传入 schema，由服务端 LLM 返回结构化结果（source、category、content、tags 等）。第一个参数 `serverUrl` 可选，不传时使用默认地址 `https://www.mixlab.top`；同源时可传 `''`。**白名单**：服务端会校验请求的 Origin/Referer，仅白名单域名或 server 自身可调用，否则返回 403。
+
+**可选参数（第三个参数 `options`）：**
 
+- **systemPrompt**（可选）：自定义系统提示词。传入后，服务端会将该字符串作为 LLM 的 system 消息，用于控制结构化方式（如正文压缩程度、概括风格、输出语言等）。不传则使用服务端默认提示词。
+- **temperature**（可选）：LLM 采样温度，默认由服务端决定（如 0.7）。
 - **stream**（可选，默认 `false`）：为 `true` 时按 SSE 流式消费，需同时传 **onChunk**，每收到一段 LLM 输出会调用 `onChunk(chunk, accumulated)`，最终仍返回 `StructureDataResult`。
 - **onChunk**（可选）：`stream: true` 时必传，用于流式展示或预览。
 
+**自定义 prompt 的典型用法**：在已加入白名单的外部站点中，可直接调用 `fetchStructureData` 并传入 `systemPrompt`，让服务端按你的要求生成正文与分类，例如要求「正文压缩到 300 字以内」「用英文输出」等。注意：通过 `sendData` 把数据发往接收方时，结构化由接收方（如 Memory）用其自身设置完成，发送方无法指定 prompt；只有在**当前页面自己调用** `fetchStructureData` 时才能使用自定义 prompt。
+
 ```typescript
 import { inferSchema, fetchStructureData, extractImages } from 'agentlink-sdk';
 
 const schema = inferSchema(rawData);
 
-// 非流式（默认）
+// 非流式，使用自定义 prompt
 const result = await fetchStructureData(undefined, schema, {
-  systemPrompt: '可选',
-  temperature: 0.7,
+  systemPrompt: '你是一个信息整理助手。请将正文压缩、概括、精简到 300 字以内，并提炼要点。',
+  temperature: 0.5,
 });
 
 // 流式：边收边回调，最后仍返回完整结果
 const resultStream = await fetchStructureData(undefined, schema, {
+  systemPrompt: '可选：自定义系统提示词',
   stream: true,
   onChunk(chunk, accumulated) {
     console.log('增量:', chunk, '已累积:', accumulated);
@@ -389,7 +442,8 @@ const resultStream = await fetchStructureData(undefined, schema, {
 - ✅ **数据压缩**: 自动压缩大型数据，优化 URL 长度
 - ✅ **缓存优化**: Token 和白名单验证结果缓存，减少服务器请求
 - ✅ **LLM 工具**: `inferSchema`、`extractAndReplaceBase64`、`restoreBase64`、`extractImages` 便于与 LLM 流程集成
-- ✅ **服务端能力**: `fetchCapabilities`、`fetchStructureData` 调用 AgentLink 服务端的 /api/capabilities、/api/structureData（不传 serverUrl 时使用默认 `https://www.mixlab.top`）
+- ✅ **服务端能力**: `fetchCapabilities`、`fetchStructureData` 调用 AgentLink 服务端的 /api/capabilities、/api/structureData（不传 serverUrl 时使用默认 `https://www.mixlab.top`；仅白名单域名或 server 自身可调用）
+- ✅ **自定义 prompt**: 调用 `fetchStructureData` 时可传 `options.systemPrompt`，由服务端按你的提示词进行结构化（如正文压缩、概括风格等）；仅在你当前页面直接调用时生效，通过 `sendData` 发往接收方时由接收方设置决定
 - ✅ **自动化测试**: Vitest 单元测试（base64 / schema / compression / url / capabilities / structureData），可选 LLM Schema 集成测试
 - ✅ **TypeScript 支持**: 完整的 TypeScript 类型定义
 - ✅ **窗口复用**: 支持复用窗口，避免频繁打开新窗口
@@ -463,8 +517,8 @@ client.receiveData((data, type, senderInfo, verification) => {
 
 ## 注意事项
 
-1. **域名白名单**: 发送数据前，请确认当前站点域名已在 AgentLink 服务端的白名单中，否则无法获取 Token。详见上文「跨域与白名单说明」。
-2. **弹窗拦截**: 某些浏览器可能会拦截 `window.open`，确保在用户交互事件（如点击）中调用 `sendData`
+1. **域名白名单**: 发送数据前，请确认当前站点域名已在 AgentLink 服务端的白名单中，否则无法获取 Token；`fetchCapabilities`、`fetchStructureData` 同样仅对白名单域名或 server 自身有效。详见上文「跨域与白名单说明」。
+2. **弹窗拦截**: 某些浏览器（尤其 **iOS Safari**）会拦截在 `await` 之后才执行的 `window.open`。推荐在 iOS 上使用 **预编码**：在点击前调用 `prepareSendData`，在点击回调中**同步**调用 `openEncodedUrl(encodedUrl)`；或在桌面端确保在用户点击等交互中直接调用 `sendData`。
 3. **URL 长度限制**: 虽然 SDK 会自动压缩数据，但过大的数据仍可能超出浏览器 URL 长度限制
 4. **HTTPS 要求**: 生产环境建议使用 HTTPS，确保数据传输安全
 5. **Token 缓存**: Token 在实例级别缓存，同一实例的多次调用会复用 Token

package/dist/index.d.mts

@@ -23,6 +23,8 @@ interface SenderInfo {
 /**
  * AgentLink 客户端 SDK (URL Hash + Token 方案)
  */
+/** 默认窗口名称，用于 sendData / openEncodedUrl 复用同一窗口 */
+declare const DEFAULT_WINDOW_NAME = "agentlink-window";
 declare class AgentLinkClient {
     private serverUrl;
     private static DEFAULT_WINDOW_NAME;
@@ -48,6 +50,23 @@ declare class AgentLinkClient {
      * 验证发送端的 Token 和 Origin
      */
     private verifySender;
+    /**
+     * 预编码：完成 Token、白名单校验与 URL 编码，返回可用于 window.open 的 URL。
+     * 用于 iOS Safari 等严格限制弹窗的环境：在用户点击前调用此方法，在点击回调中同步执行 openEncodedUrl(url)。
+     * @param targetUrl 目标应用的地址
+     * @param data 要发送的数据
+     * @param type 数据类型标识
+     * @param windowName 窗口名称，与 openEncodedUrl 一致以便复用窗口（默认: DEFAULT_WINDOW_NAME）
+     * @returns 编码后的完整 URL，可直接传入 openEncodedUrl 或 window.open(encodedUrl, windowName)
+     */
+    prepareSendData(targetUrl: string, data: any, type: string, windowName?: string): Promise<string>;
+    /**
+     * 使用预编码的 URL 同步打开目标窗口（不包含任何 await）。
+     * 必须在用户手势的同步回调中调用（如 click 处理器内直接调用），否则可能被弹窗拦截。
+     * @param encodedUrl 由 prepareSendData 返回的 URL
+     * @param windowName 与 prepareSendData 时使用的窗口名一致，默认: DEFAULT_WINDOW_NAME
+     */
+    openEncodedUrl(encodedUrl: string, windowName?: string): void;
     /**
      * 发送数据到目标应用
      * @param targetUrl 目标应用的地址
@@ -171,6 +190,13 @@ interface StructureDataResult {
     images?: string[];
     metadata?: Record<string, unknown>;
 }
+/** 可选：传给服务端 /api/structureData 的 body.llm，有则用设置 LLM，无则用内置 */
+interface RequestLlm {
+    apiUrl: string;
+    apiKey: string;
+    model?: string;
+    temperature?: number;
+}
 interface FetchStructureDataOptions {
     systemPrompt?: string;
     temperature?: number;
@@ -181,6 +207,8 @@ interface FetchStructureDataOptions {
     stream?: boolean;
     /** stream 为 true 时，每收到一段 LLM 输出会调用 onChunk(chunk, accumulated) */
     onChunk?: (chunk: string, accumulated: string) => void;
+    /** 可选：服务端有则用该 LLM，无则用内置 */
+    llm?: RequestLlm;
 }
 /**
  * 从 SSE 响应文本中解析最后一条 result 或 error
@@ -219,4 +247,4 @@ declare function restoreBase64(data: any, replacements: Map<string, string>): an
  */
 declare function extractImages(data: any): string[];
 
-export { AgentLinkClient, type AgentLinkClientOptions, type CapabilitiesResponse, DEFAULT_SERVER_URL, type FetchStructureDataOptions, type InferSchemaOptions, type InferredSchema, type SenderInfo, type StructureDataResult, type URLData, type WhitelistInfo, type WhitelistResponse, base64ToUint8Array, compress, decodeDataFromUrl, decompress, encodeDataToUrl, extractAndReplaceBase64, extractImages, fetchCapabilities, fetchStructureData, fetchWhitelistInfo, inferSchema, parseSSEResult, restoreBase64, uint8ArrayToBase64, verifyWhitelist };
+export { AgentLinkClient, type AgentLinkClientOptions, type CapabilitiesResponse, DEFAULT_SERVER_URL, DEFAULT_WINDOW_NAME, type FetchStructureDataOptions, type InferSchemaOptions, type InferredSchema, type RequestLlm, type SenderInfo, type StructureDataResult, type URLData, type WhitelistInfo, type WhitelistResponse, base64ToUint8Array, compress, decodeDataFromUrl, decompress, encodeDataToUrl, extractAndReplaceBase64, extractImages, fetchCapabilities, fetchStructureData, fetchWhitelistInfo, inferSchema, parseSSEResult, restoreBase64, uint8ArrayToBase64, verifyWhitelist };

package/dist/index.d.ts

@@ -23,6 +23,8 @@ interface SenderInfo {
 /**
  * AgentLink 客户端 SDK (URL Hash + Token 方案)
  */
+/** 默认窗口名称，用于 sendData / openEncodedUrl 复用同一窗口 */
+declare const DEFAULT_WINDOW_NAME = "agentlink-window";
 declare class AgentLinkClient {
     private serverUrl;
     private static DEFAULT_WINDOW_NAME;
@@ -48,6 +50,23 @@ declare class AgentLinkClient {
      * 验证发送端的 Token 和 Origin
      */
     private verifySender;
+    /**
+     * 预编码：完成 Token、白名单校验与 URL 编码，返回可用于 window.open 的 URL。
+     * 用于 iOS Safari 等严格限制弹窗的环境：在用户点击前调用此方法，在点击回调中同步执行 openEncodedUrl(url)。
+     * @param targetUrl 目标应用的地址
+     * @param data 要发送的数据
+     * @param type 数据类型标识
+     * @param windowName 窗口名称，与 openEncodedUrl 一致以便复用窗口（默认: DEFAULT_WINDOW_NAME）
+     * @returns 编码后的完整 URL，可直接传入 openEncodedUrl 或 window.open(encodedUrl, windowName)
+     */
+    prepareSendData(targetUrl: string, data: any, type: string, windowName?: string): Promise<string>;
+    /**
+     * 使用预编码的 URL 同步打开目标窗口（不包含任何 await）。
+     * 必须在用户手势的同步回调中调用（如 click 处理器内直接调用），否则可能被弹窗拦截。
+     * @param encodedUrl 由 prepareSendData 返回的 URL
+     * @param windowName 与 prepareSendData 时使用的窗口名一致，默认: DEFAULT_WINDOW_NAME
+     */
+    openEncodedUrl(encodedUrl: string, windowName?: string): void;
     /**
      * 发送数据到目标应用
      * @param targetUrl 目标应用的地址
@@ -171,6 +190,13 @@ interface StructureDataResult {
     images?: string[];
     metadata?: Record<string, unknown>;
 }
+/** 可选：传给服务端 /api/structureData 的 body.llm，有则用设置 LLM，无则用内置 */
+interface RequestLlm {
+    apiUrl: string;
+    apiKey: string;
+    model?: string;
+    temperature?: number;
+}
 interface FetchStructureDataOptions {
     systemPrompt?: string;
     temperature?: number;
@@ -181,6 +207,8 @@ interface FetchStructureDataOptions {
     stream?: boolean;
     /** stream 为 true 时，每收到一段 LLM 输出会调用 onChunk(chunk, accumulated) */
     onChunk?: (chunk: string, accumulated: string) => void;
+    /** 可选：服务端有则用该 LLM，无则用内置 */
+    llm?: RequestLlm;
 }
 /**
  * 从 SSE 响应文本中解析最后一条 result 或 error
@@ -219,4 +247,4 @@ declare function restoreBase64(data: any, replacements: Map<string, string>): an
  */
 declare function extractImages(data: any): string[];
 
-export { AgentLinkClient, type AgentLinkClientOptions, type CapabilitiesResponse, DEFAULT_SERVER_URL, type FetchStructureDataOptions, type InferSchemaOptions, type InferredSchema, type SenderInfo, type StructureDataResult, type URLData, type WhitelistInfo, type WhitelistResponse, base64ToUint8Array, compress, decodeDataFromUrl, decompress, encodeDataToUrl, extractAndReplaceBase64, extractImages, fetchCapabilities, fetchStructureData, fetchWhitelistInfo, inferSchema, parseSSEResult, restoreBase64, uint8ArrayToBase64, verifyWhitelist };
+export { AgentLinkClient, type AgentLinkClientOptions, type CapabilitiesResponse, DEFAULT_SERVER_URL, DEFAULT_WINDOW_NAME, type FetchStructureDataOptions, type InferSchemaOptions, type InferredSchema, type RequestLlm, type SenderInfo, type StructureDataResult, type URLData, type WhitelistInfo, type WhitelistResponse, base64ToUint8Array, compress, decodeDataFromUrl, decompress, encodeDataToUrl, extractAndReplaceBase64, extractImages, fetchCapabilities, fetchStructureData, fetchWhitelistInfo, inferSchema, parseSSEResult, restoreBase64, uint8ArrayToBase64, verifyWhitelist };

package/dist/index.js

@@ -22,6 +22,7 @@ var index_exports = {};
 __export(index_exports, {
   AgentLinkClient: () => AgentLinkClient,
   DEFAULT_SERVER_URL: () => DEFAULT_SERVER_URL,
+  DEFAULT_WINDOW_NAME: () => DEFAULT_WINDOW_NAME,
   base64ToUint8Array: () => base64ToUint8Array,
   compress: () => compress,
   decodeDataFromUrl: () => decodeDataFromUrl,
@@ -182,6 +183,7 @@ async function fetchWhitelistInfo(serverUrl, includeAll = false) {
 
 // src/client.ts
 var DEFAULT_SERVER_URL = "https://www.mixlab.top";
+var DEFAULT_WINDOW_NAME = "agentlink-window";
 var _AgentLinkClient = class _AgentLinkClient {
   constructor(options = {}) {
     // 发送端 Token 缓存（实例级别）
@@ -259,24 +261,45 @@ var _AgentLinkClient = class _AgentLinkClient {
     return { domain: data.domain, description: data.description };
   }
   /**
-   * 发送数据到目标应用
+   * 预编码：完成 Token、白名单校验与 URL 编码，返回可用于 window.open 的 URL。
+   * 用于 iOS Safari 等严格限制弹窗的环境：在用户点击前调用此方法，在点击回调中同步执行 openEncodedUrl(url)。
    * @param targetUrl 目标应用的地址
    * @param data 要发送的数据
    * @param type 数据类型标识
-   * @param windowName 窗口名称，用于复用（默认: 'agentlink-window'）
+   * @param windowName 窗口名称，与 openEncodedUrl 一致以便复用窗口（默认: DEFAULT_WINDOW_NAME）
+   * @returns 编码后的完整 URL，可直接传入 openEncodedUrl 或 window.open(encodedUrl, windowName)
    */
-  async sendData(targetUrl, data, type, windowName = _AgentLinkClient.DEFAULT_WINDOW_NAME) {
+  async prepareSendData(targetUrl, data, type, windowName = _AgentLinkClient.DEFAULT_WINDOW_NAME) {
     const token = await this.ensureToken();
     const origin = window.location.origin;
     const isWhitelisted = await this.checkWhitelist(origin);
     const verification = isWhitelisted ? "mixlab launchpad\u52A0\u901F\u8BA1\u5212" : "\u672A\u9A8C\u8BC1";
-    const encodedUrl = await encodeDataToUrl(data, type, token, origin, targetUrl, verification);
+    return encodeDataToUrl(data, type, token, origin, targetUrl, verification);
+  }
+  /**
+   * 使用预编码的 URL 同步打开目标窗口（不包含任何 await）。
+   * 必须在用户手势的同步回调中调用（如 click 处理器内直接调用），否则可能被弹窗拦截。
+   * @param encodedUrl 由 prepareSendData 返回的 URL
+   * @param windowName 与 prepareSendData 时使用的窗口名一致，默认: DEFAULT_WINDOW_NAME
+   */
+  openEncodedUrl(encodedUrl, windowName = _AgentLinkClient.DEFAULT_WINDOW_NAME) {
     const targetWindow = window.open(encodedUrl, windowName);
     if (!targetWindow) {
       throw new Error("[AgentLink] Failed to open target window. It might be blocked by a popup blocker.");
     }
     targetWindow.focus();
   }
+  /**
+   * 发送数据到目标应用
+   * @param targetUrl 目标应用的地址
+   * @param data 要发送的数据
+   * @param type 数据类型标识
+   * @param windowName 窗口名称，用于复用（默认: 'agentlink-window'）
+   */
+  async sendData(targetUrl, data, type, windowName = _AgentLinkClient.DEFAULT_WINDOW_NAME) {
+    const encodedUrl = await this.prepareSendData(targetUrl, data, type, windowName);
+    this.openEncodedUrl(encodedUrl, windowName);
+  }
   /**
    * 监听来自 URL 的数据
    * @param callback 接收到数据时的回调函数，现在包含验证信息
@@ -338,7 +361,7 @@ var _AgentLinkClient = class _AgentLinkClient {
     return fetchWhitelistInfo(this.serverUrl, includeAll);
   }
 };
-_AgentLinkClient.DEFAULT_WINDOW_NAME = "agentlink-window";
+_AgentLinkClient.DEFAULT_WINDOW_NAME = DEFAULT_WINDOW_NAME;
 // 接收端验证结果缓存（静态，跨实例共享）
 _AgentLinkClient.tokenCache = /* @__PURE__ */ new Map();
 // 白名单验证缓存（避免重复请求）
@@ -394,6 +417,7 @@ async function fetchStructureData(serverUrl = DEFAULT_SERVER_URL, schema, option
   const body = { schema };
   if (options?.systemPrompt != null) body.systemPrompt = options.systemPrompt;
   if (options?.temperature != null) body.temperature = options.temperature;
+  if (options?.llm != null) body.llm = options.llm;
   const res = await fetch(`${base}/api/structureData`, {
     method: "POST",
     headers: { "Content-Type": "application/json" },

package/dist/index.mjs

@@ -140,6 +140,7 @@ async function fetchWhitelistInfo(serverUrl, includeAll = false) {
 
 // src/client.ts
 var DEFAULT_SERVER_URL = "https://www.mixlab.top";
+var DEFAULT_WINDOW_NAME = "agentlink-window";
 var _AgentLinkClient = class _AgentLinkClient {
   constructor(options = {}) {
     // 发送端 Token 缓存（实例级别）
@@ -217,24 +218,45 @@ var _AgentLinkClient = class _AgentLinkClient {
     return { domain: data.domain, description: data.description };
   }
   /**
-   * 发送数据到目标应用
+   * 预编码：完成 Token、白名单校验与 URL 编码，返回可用于 window.open 的 URL。
+   * 用于 iOS Safari 等严格限制弹窗的环境：在用户点击前调用此方法，在点击回调中同步执行 openEncodedUrl(url)。
    * @param targetUrl 目标应用的地址
    * @param data 要发送的数据
    * @param type 数据类型标识
-   * @param windowName 窗口名称，用于复用（默认: 'agentlink-window'）
+   * @param windowName 窗口名称，与 openEncodedUrl 一致以便复用窗口（默认: DEFAULT_WINDOW_NAME）
+   * @returns 编码后的完整 URL，可直接传入 openEncodedUrl 或 window.open(encodedUrl, windowName)
    */
-  async sendData(targetUrl, data, type, windowName = _AgentLinkClient.DEFAULT_WINDOW_NAME) {
+  async prepareSendData(targetUrl, data, type, windowName = _AgentLinkClient.DEFAULT_WINDOW_NAME) {
     const token = await this.ensureToken();
     const origin = window.location.origin;
     const isWhitelisted = await this.checkWhitelist(origin);
     const verification = isWhitelisted ? "mixlab launchpad\u52A0\u901F\u8BA1\u5212" : "\u672A\u9A8C\u8BC1";
-    const encodedUrl = await encodeDataToUrl(data, type, token, origin, targetUrl, verification);
+    return encodeDataToUrl(data, type, token, origin, targetUrl, verification);
+  }
+  /**
+   * 使用预编码的 URL 同步打开目标窗口（不包含任何 await）。
+   * 必须在用户手势的同步回调中调用（如 click 处理器内直接调用），否则可能被弹窗拦截。
+   * @param encodedUrl 由 prepareSendData 返回的 URL
+   * @param windowName 与 prepareSendData 时使用的窗口名一致，默认: DEFAULT_WINDOW_NAME
+   */
+  openEncodedUrl(encodedUrl, windowName = _AgentLinkClient.DEFAULT_WINDOW_NAME) {
     const targetWindow = window.open(encodedUrl, windowName);
     if (!targetWindow) {
       throw new Error("[AgentLink] Failed to open target window. It might be blocked by a popup blocker.");
     }
     targetWindow.focus();
   }
+  /**
+   * 发送数据到目标应用
+   * @param targetUrl 目标应用的地址
+   * @param data 要发送的数据
+   * @param type 数据类型标识
+   * @param windowName 窗口名称，用于复用（默认: 'agentlink-window'）
+   */
+  async sendData(targetUrl, data, type, windowName = _AgentLinkClient.DEFAULT_WINDOW_NAME) {
+    const encodedUrl = await this.prepareSendData(targetUrl, data, type, windowName);
+    this.openEncodedUrl(encodedUrl, windowName);
+  }
   /**
    * 监听来自 URL 的数据
    * @param callback 接收到数据时的回调函数，现在包含验证信息
@@ -296,7 +318,7 @@ var _AgentLinkClient = class _AgentLinkClient {
     return fetchWhitelistInfo(this.serverUrl, includeAll);
   }
 };
-_AgentLinkClient.DEFAULT_WINDOW_NAME = "agentlink-window";
+_AgentLinkClient.DEFAULT_WINDOW_NAME = DEFAULT_WINDOW_NAME;
 // 接收端验证结果缓存（静态，跨实例共享）
 _AgentLinkClient.tokenCache = /* @__PURE__ */ new Map();
 // 白名单验证缓存（避免重复请求）
@@ -352,6 +374,7 @@ async function fetchStructureData(serverUrl = DEFAULT_SERVER_URL, schema, option
   const body = { schema };
   if (options?.systemPrompt != null) body.systemPrompt = options.systemPrompt;
   if (options?.temperature != null) body.temperature = options.temperature;
+  if (options?.llm != null) body.llm = options.llm;
   const res = await fetch(`${base}/api/structureData`, {
     method: "POST",
     headers: { "Content-Type": "application/json" },
@@ -612,6 +635,7 @@ function inferSchema(rawData, options) {
 export {
   AgentLinkClient,
   DEFAULT_SERVER_URL,
+  DEFAULT_WINDOW_NAME,
   base64ToUint8Array,
   compress,
   decodeDataFromUrl,

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "agentlink-sdk",
-    "version": "1.0.10",
+    "version": "1.1.0",
     "description": "AgentLink client SDK for cross-domain data synchronization via URL hash",
     "main": "dist/index.js",
     "module": "dist/index.esm.js",