$appKey    = "your-app-key"
$appSecret = "your-app-secret"
$timestamp = [DateTimeOffset]::UtcNow.ToUnixTimeSeconds()
$nonce     = [Guid]::NewGuid().ToString("N")
$method    = "GET"
$path      = "/api/open/transfer/strategy"

# GET 请求无请求体，bodyHash 为空字符串，直接裸拼接后做 HMAC-SHA256
$stringToSign = $appKey + $timestamp + $nonce + $method + $path
$hmac       = New-Object System.Security.Cryptography.HMACSHA256
$hmac.Key   = [Text.Encoding]::UTF8.GetBytes($appSecret)
$signature  = -join ($hmac.ComputeHash([Text.Encoding]::UTF8.GetBytes($stringToSign)) | ForEach-Object { $_.ToString("x2") })

Invoke-RestMethod -Uri "https://www.wringcloud.com$path" -Headers @{
  "X-App-Key"   = $appKey
  "X-Timestamp" = $timestamp
  "X-Nonce"     = $nonce
  "X-Algorithm" = "SHA-256"
  "X-Signature" = $signature
}

// 方式一：本地引入（下载 SDK 文件后放置到项目中）
import { IceShuttle, downloadBlob } from './sdk/iceshuttle.esm.js';

// 方式二：官网下载引入（适合无构建工具的项目）
// 下载地址：https://www.wringcloud.com/sdk/iceshuttle-js/dist/iceshuttle.min.js
<script src="./sdk/iceshuttle.min.js"></script>
<script>
  const { IceShuttle, downloadBlob } = window.IceShuttle;
</script>

import { IceShuttle } from 'iceshuttle-js';

const client = new IceShuttle({
  appKey: 'your-app-key',         // 必填：应用 Key
  appSecret: 'your-app-secret',   // 必填：应用 Secret
  serverDomain: 'https://www.wringcloud.com',  // 可选：服务器地址
  debug: false                       // 可选：是否开启调试日志
});

// 高层 API：自动断点续传 + 并发上传（默认 3 并发，可调 1-8）
const result = await client.uploadFile(file, {
  bizType: 'drive',            // drive=文件库 / project=项目 / collect=收集链接
  bizRef: { folderId: 0 },     // 按 bizType 传入：目录 ID / 项目 ID / 收集 token
  onProgress: (p) => console.log(p + '%')
});
// result：drive 返回 { transferId }；project 返回 { transferId, fileId, projectId }；
// collect 返回 { fileName, fileSize, autoAccepted }

// 需要自行控制 complete 时机（或中途取消）时，使用低层 API
//（createUploader 需完整会话参数，fileHash 可用 SDK 导出的 sha256Hex(file) 计算）
const uploader = await client.createUploader({
  bizType: 'drive', bizRef: { folderId: 0 },
  fileName: file.name, fileSize: file.size,
  fileHash: await sha256Hex(file), concurrency: 4
});
try {
  await uploader.upload(file);          // 仅完成分块直传与回执
  const landed = await client.completeUploadSession(uploader.sessionKey);
} catch (e) {
  await uploader.abort();   // 清理会话与已传分块
}

# 0. 准备参数（时间戳为秒级）
$appKey    = "your-app-key"
$appSecret = "your-app-secret"
$timestamp = [DateTimeOffset]::UtcNow.ToUnixTimeSeconds()
$nonce     = [Guid]::NewGuid().ToString("N")
$method    = "POST"
$path      = "/api/open/workspace/members/invite"
$body      = '{"contact":"dev@example.com","roleId":2,"expireDays":7}'

# 1. 请求体哈希（X-Algorithm=SHA-256；SM3 需国密库）
$sha      = [System.Security.Cryptography.SHA256]::Create()
$bodyHash = -join ($sha.ComputeHash([Text.Encoding]::UTF8.GetBytes($body)) | ForEach-Object { $_.ToString("x2") })

# 2. 签名串裸拼接 + HMAC-SHA256
$stringToSign = $appKey + $timestamp + $nonce + $method + $path + $bodyHash
$hmac       = New-Object System.Security.Cryptography.HMACSHA256
$hmac.Key   = [Text.Encoding]::UTF8.GetBytes($appSecret)
$signature  = -join ($hmac.ComputeHash([Text.Encoding]::UTF8.GetBytes($stringToSign)) | ForEach-Object { $_.ToString("x2") })

# 3. 携带五个认证头发起请求
Invoke-RestMethod -Method Post -Uri "https://www.wringcloud.com$path" -Body $body -ContentType "application/json" -Headers @{
  "X-App-Key"   = $appKey
  "X-Timestamp" = $timestamp
  "X-Nonce"     = $nonce
  "X-Algorithm" = "SHA-256"
  "X-Signature" = $signature
}

// 1. 创建 P2P 发送任务
const sender = await client.createP2PSender({
  fileName: file.name,             // 必填：文件名
  fileSize: file.size,             // 必填：文件大小（字节）
  password: '可选密码',            // 可选：传输密码
  maxReceiveCount: 1              // 可选：最大接收次数
});

// 2. 获取接收链接，分享给接收方
const receiveLink = sender.getReceiveLink();
console.log('接收链接:', receiveLink);

// 3. 发送文件（SDK 自动并传输）
await sender.sendFile(file, {
  onProgress: (percent) => {
    console.log(`传输进度: ${percent.toFixed(1)}%`);
  },
  onComplete: (info) => {
    console.log('传输完成', info);
  },
  onError: (err) => {
    console.error('传输失败:', err);
  },
  onProcessing: (info) => {
    console.log(info.message); // 如 "正在校验文件..."
  }
});

// 4. 取消传输（可选）
await sender.cancel();

// 从接收链接中解析 transferId 和 token
const receiver = await client.createP2PReceiver(transferId, token);

// 获取文件信息
console.log('文件名:', receiver.getFileName());

// 接收文件
await receiver.receiveFile({
  onProgress: (percent) => {
    console.log(`接收进度: ${percent.toFixed(1)}%`);
  },
  onComplete: ({ blob, fileName, fileSize }) => {
    // 触发浏览器下载
    downloadBlob(blob, fileName);
  },
  onError: (err) => {
    console.error('接收失败:', err);
  }
});

// 1. 创建安全中转任务
const sender = await client.createRelaySender({
  fileName: file.name,             // 必填：文件名
  fileSize: file.size,             // 必填：文件大小（字节）
  password: '可选密码',            // 可选：传输密码
  maxReceiveCount: 5,             // 可选：最大下载次数
  expireHours: 168               // 可选：链接有效期（小时）
});

// 2. 获取下载链接，分享给接收方
const downloadLink = sender.getDownloadLink();
console.log('下载链接:', downloadLink);

// 3. 上传文件（SDK 自动处理分块上传）
await sender.sendFile(file, {
  onProgress: (percent) => {
    console.log(`上传进度: ${percent.toFixed(1)}%`);
  },
  onComplete: (info) => {
    console.log('上传完成，等待接收方下载');
  },
  onError: (err) => {
    console.error('上传失败:', err);
  }
});

// 4. 取消传输（可选）
await sender.cancel();

// 从下载链接中解析 transferId 和 token
const receiver = await client.createRelayReceiver(transferId, token);

// 获取文件信息
console.log('文件名:', receiver.getFileName());

// 下载文件为 Blob
const blob = await receiver.receiveFileAsBlob({
  onProgress: (percent) => {
    console.log(`下载进度: ${percent.toFixed(1)}%`);
  }
});

// 触发浏览器下载
downloadBlob(blob, receiver.getFileName());

// 查询 P2P 传输状态
const p2pStatus = await client.getP2PTransferStatus(transferId);

// 查询安全中转传输状态
const relayStatus = await client.getRelayTransferStatus(transferId);

// 取消 P2P 传输
await client.cancelP2PTransfer(transferId);

// 取消安全中转传输
await client.cancelRelayTransfer(transferId);

// 或直接调用 sender.cancel()
await sender.cancel();

import { downloadBlob } from 'iceshuttle-js';

// 触发浏览器下载
downloadBlob(blob, '文件名.txt');

// P2P 接收链接格式：https://www.wringcloud.com/p2p/{transferId}?token={token}
// 安全中转下载链接格式：https://www.wringcloud.com/r/{transferId}?token={token}

function parseLink(link) {
  const url = new URL(link);
  const transferId = url.pathname.split('/').pop();
  const token = url.searchParams.get('token');
  return { transferId, token };
}

import { IceShuttle, downloadBlob } from 'iceshuttle-js';

// 初始化
const client = new IceShuttle({
  appKey: 'your-app-key',
  appSecret: 'your-app-secret'
});

// ===== P2P 直传 =====
async function p2pSend(file) {
  const sender = await client.createP2PSender({
    fileName: file.name,
    fileSize: file.size
  });
  console.log('接收链接:', sender.getReceiveLink());
  await sender.sendFile(file, {
    onProgress: (p) => console.log(p + '%'),
    onComplete: () => console.log('完成')
  });
}

async function p2pReceive(transferId, token) {
  const receiver = await client.createP2PReceiver(transferId, token);
  await receiver.receiveFile({
    onProgress: (p) => console.log(p + '%'),
    onComplete: ({ blob, fileName }) => downloadBlob(blob, fileName)
  });
}

// ===== 安全中转 =====
async function relaySend(file) {
  const sender = await client.createRelaySender({
    fileName: file.name,
    fileSize: file.size
  });
  console.log('下载链接:', sender.getDownloadLink());
  await sender.sendFile(file, {
    onProgress: (p) => console.log(p + '%'),
    onComplete: () => console.log('上传完成')
  });
}

async function relayReceive(transferId, token) {
  const receiver = await client.createRelayReceiver(transferId, token);
  const blob = await receiver.receiveFileAsBlob({
    onProgress: (p) => console.log(p + '%')
  });
  downloadBlob(blob, receiver.getFileName());
}

// ===== 分块直传（上传到文件库，v2.1.0+）=====
async function directUpload(file) {
  const landed = await client.uploadFile(file, {
    bizType: 'drive',           // drive / project / collect
    bizRef: { folderId: 0 },
    onProgress: (p) => console.log(p + '%')
  });
  console.log('落地结果:', landed);   // { transferId }
}