@zzp123/mcp-zentao 1.2.1 → 1.3.0

package/dist/index.js

@@ -989,6 +989,51 @@ server.tool("uploadFile", {
     }
     return { content: [{ type: "text", text: JSON.stringify(response, null, 2) }] };
 });
+server.tool("uploadImageFromClipboard", {
+    base64Data: z.string(),
+    filename: z.string().optional(),
+    uid: z.string().optional()
+}, async ({ base64Data, filename, uid }) => {
+    if (!zentaoApi)
+        throw new Error("Please initialize Zentao API first");
+    const fs = await import('fs');
+    const path = await import('path');
+    // 创建 img 文件夹（如果不存在）
+    const imgDir = path.join(process.cwd(), 'img');
+    if (!fs.existsSync(imgDir)) {
+        fs.mkdirSync(imgDir, { recursive: true });
+    }
+    let fileBuffer;
+    let finalFilename;
+    // 处理 base64 数据
+    const matches = base64Data.match(/^data:image\/(\w+);base64,(.+)$/);
+    if (matches) {
+        const ext = matches[1];
+        const data = matches[2];
+        fileBuffer = Buffer.from(data, 'base64');
+        finalFilename = filename || `clipboard_${Date.now()}.${ext}`;
+    }
+    else {
+        // 直接的 base64 数据，没有 data URL 前缀
+        fileBuffer = Buffer.from(base64Data, 'base64');
+        finalFilename = filename || `clipboard_${Date.now()}.png`;
+    }
+    // 保存到 img 文件夹
+    const savedPath = path.join(imgDir, finalFilename);
+    fs.writeFileSync(savedPath, fileBuffer);
+    // 上传到禅道
+    const result = await zentaoApi.uploadFile({
+        file: fileBuffer,
+        filename: finalFilename,
+        uid
+    });
+    const response = {
+        upload: result,
+        savedPath: savedPath,
+        message: `图片已保存到本地并上传到禅道`
+    };
+    return { content: [{ type: "text", text: JSON.stringify(response, null, 2) }] };
+});
 server.tool("downloadFile", {
     fileId: z.number(),
     savePath: z.string()

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@zzp123/mcp-zentao",
-    "version": "1.2.1",
+    "version": "1.3.0",
     "description": "禅道项目管理系统的高级API集成包，提供任务管理、Bug跟踪等功能的完整封装，专为Cursor IDE设计的MCP扩展",
     "main": "dist/index.js",
     "type": "module",
@@ -11,7 +11,8 @@
     "files": [
         "dist",
         "README.md",
-        "json-args.js"
+        "json-args.js",
+        "scripts"
     ],
     "scripts": {
         "build": "tsc",
@@ -21,7 +22,9 @@
         "test:watch": "jest --watch",
         "test:manual": "ts-node test/manual-test.ts",
         "prepublishOnly": "npm run test && npm run build",
-        "start": "node json-args.js"
+        "start": "node json-args.js",
+        "upload:clipboard": "node scripts/upload-clipboard-image.js",
+        "upload:clipboard:py": "python scripts/upload-clipboard-image.py"
     },
     "keywords": [
         "mcp",
@@ -42,7 +45,7 @@
     },
     "dependencies": {
         "@modelcontextprotocol/sdk": "^1.6.1",
-        "@zzp123/mcp-zentao": "^1.2.0",
+        "@zzp123/mcp-zentao": "^1.2.1",
         "axios": "^1.6.7",
         "chalk": "^4.1.2",
         "form-data": "^4.0.4",

package/scripts/MCP-INTEGRATION.md

@@ -0,0 +1,298 @@
+# MCP 集成说明
+
+## 🔗 与 MCP 工具联动
+
+本项目提供了两种方式来上传剪贴板图片到禅道：
+
+### 方式1: 通过 MCP 工具（在 Claude Code 中使用）
+
+**适用场景：** 在 Claude Code 对话中直接上传图片
+
+**已有的 MCP 工具：**
+
+1. **uploadImageFromClipboard** - 专门用于上传剪贴板图片
+   ```json
+   {
+     "base64Data": "data:image/png;base64,...",
+     "filename": "optional-name.png",
+     "uid": "optional-uid"
+   }
+   ```
+
+2. **uploadFile** - 通用文件上传（支持路径或 base64）
+   ```json
+   {
+     "filePath": "/path/to/file.png",
+     "base64Data": "data:image/png;base64,...",
+     "filename": "optional-name.png",
+     "uid": "optional-uid"
+   }
+   ```
+
+**使用方法：**
+
+在 Claude Code 中：
+```
+你：复制一张图片后，对 Claude 说：
+"上传这张图片到禅道"
+
+Claude 会自动：
+1. 获取剪贴板中的图片 base64 数据
+2. 调用 uploadImageFromClipboard 工具
+3. 保存图片到 ./img/ 文件夹
+4. 上传到禅道
+5. 返回文件 ID 和 URL
+```
+
+---
+
+### 方式2: 通过命令行脚本（独立使用）
+
+**适用场景：** 在终端/命令行中快速上传图片，不需要启动 Claude Code
+
+**提供的脚本：**
+
+1. **Node.js 脚本** - `scripts/upload-clipboard-image.js`
+2. **PowerShell 脚本** - `scripts/upload-clipboard-image.ps1`
+3. **Python 脚本** - `scripts/upload-clipboard-image.py`
+
+**使用方法：**
+
+```bash
+# 方式1: 使用 npm scripts
+npm run upload:clipboard
+
+# 方式2: 直接运行脚本
+node scripts/upload-clipboard-image.js
+python scripts/upload-clipboard-image.py
+.\scripts\upload-clipboard-image.ps1 -ZentaoUrl "..." -Username "..." -Password "..."
+```
+
+---
+
+## 🔄 两种方式的区别
+
+| 对比项 | MCP 工具 | 命令行脚本 |
+|--------|---------|-----------|
+| **使用场景** | 在 Claude Code 对话中 | 独立在终端使用 |
+| **启动方式** | 告诉 Claude 上传图片 | 运行命令 |
+| **配置方式** | MCP 工具自动获取配置 | 需要设置环境变量 |
+| **图片来源** | Claude 自动获取剪贴板 | 脚本读取剪贴板 |
+| **适合人群** | 使用 Claude Code 的用户 | 喜欢命令行的开发者 |
+| **优势** | 无缝集成，对话式操作 | 快速、独立、可自动化 |
+
+---
+
+## 💡 推荐使用场景
+
+### 场景1: 在编写需求/Bug时上传截图
+
+**使用 MCP 工具：**
+```
+你：我要创建一个Bug
+Claude：好的，请提供Bug的详细信息
+你：[复制截图] 上传这张截图
+Claude：✓ 图片已上传，文件ID: 123, URL: /zentao/file-read-123.png
+你：创建Bug，标题是"登录页面样式错误"，把刚才的图片加到描述里
+Claude：✓ Bug已创建，ID: 456
+```
+
+### 场景2: 批量处理图片
+
+**使用命令行脚本：**
+```bash
+# 创建一个循环脚本
+while true; do
+    echo "按任意键上传当前剪贴板图片..."
+    read
+    npm run upload:clipboard
+done
+```
+
+### 场景3: 与其他工具集成
+
+**使用命令行脚本：**
+```bash
+# 截图后自动上传
+# Mac Automator / Windows Task Scheduler
+
+# 1. 截图工具保存图片
+screencapture -c
+
+# 2. 自动上传
+npm run upload:clipboard
+
+# 3. 将URL复制到剪贴板
+# (脚本可修改为返回URL到剪贴板)
+```
+
+---
+
+## 🛠️ 高级集成
+
+### 1. 添加为 MCP 子命令
+
+可以创建一个 MCP 工具来调用命令行脚本：
+
+```typescript
+// 在 src/index.ts 中添加
+server.tool("uploadClipboardViaCLI", {
+    method: z.enum(['node', 'python', 'powershell']).optional()
+}, async ({ method = 'node' }) => {
+    const { exec } = await import('child_process');
+    const { promisify } = await import('util');
+    const execAsync = promisify(exec);
+
+    const command = method === 'python'
+        ? 'python scripts/upload-clipboard-image.py'
+        : method === 'powershell'
+        ? 'powershell -File scripts/upload-clipboard-image.ps1 ...'
+        : 'node scripts/upload-clipboard-image.js';
+
+    const { stdout, stderr } = await execAsync(command);
+    return { content: [{ type: "text", text: stdout || stderr }] };
+});
+```
+
+### 2. 创建快捷命令
+
+**package.json:**
+```json
+{
+  "scripts": {
+    "zentao:upload": "npm run upload:clipboard",
+    "zentao:upload:watch": "nodemon --watch clipboard --exec 'npm run upload:clipboard'"
+  }
+}
+```
+
+### 3. 集成到 Git Hooks
+
+**.git/hooks/pre-commit:**
+```bash
+#!/bin/bash
+# 在提交前自动上传截图到禅道
+
+if git diff --cached --name-only | grep -q "screenshots/"; then
+    echo "检测到新截图，自动上传到禅道..."
+    npm run upload:clipboard
+fi
+```
+
+### 4. VS Code Task 集成
+
+**.vscode/tasks.json:**
+```json
+{
+  "version": "2.0.0",
+  "tasks": [
+    {
+      "label": "Upload Clipboard to Zentao",
+      "type": "npm",
+      "script": "upload:clipboard",
+      "problemMatcher": [],
+      "presentation": {
+        "reveal": "always",
+        "panel": "new"
+      }
+    }
+  ]
+}
+```
+
+然后使用 `Ctrl+Shift+B` 选择任务运行。
+
+---
+
+## 📊 完整工作流示例
+
+### 工作流1: 使用 MCP（推荐）
+
+```mermaid
+graph LR
+    A[复制图片] --> B[告诉Claude上传]
+    B --> C[Claude调用MCP工具]
+    C --> D[自动保存到img/]
+    D --> E[上传到禅道]
+    E --> F[返回ID和URL]
+    F --> G[在对话中使用]
+```
+
+**优点：**
+- ✅ 无需离开对话界面
+- ✅ 自动化程度高
+- ✅ 与其他操作串联
+- ✅ 无需配置环境变量
+
+### 工作流2: 使用命令行
+
+```mermaid
+graph LR
+    A[复制图片] --> B[运行脚本]
+    B --> C[读取剪贴板]
+    C --> D[保存到img/]
+    D --> E[上传到禅道]
+    E --> F[显示结果]
+    F --> G[手动复制URL]
+```
+
+**优点：**
+- ✅ 快速独立
+- ✅ 可自动化
+- ✅ 可集成到其他工具
+- ✅ 不依赖 Claude Code
+
+---
+
+## 🎯 最佳实践
+
+### 1. 选择合适的方式
+
+- **日常使用** → MCP 工具（在 Claude Code 中）
+- **批量处理** → 命令行脚本
+- **自动化集成** → 命令行脚本 + 系统工具
+
+### 2. 配置管理
+
+**MCP 方式：**
+- 使用 `.zentao/config.json` 存储配置
+- 通过 `initZentao` 工具初始化
+
+**命令行方式：**
+- 创建 `.env` 文件
+- 或创建 `upload.bat` / `upload.sh` 包含配置
+- 不要将密码提交到版本控制
+
+### 3. 图片管理
+
+- 所有图片统一保存到 `./img/` 文件夹
+- 文件名格式：`clipboard_时间戳.png` 或 `image_时间戳.png`
+- 可在 `.gitignore` 中添加 `img/` 避免提交
+
+### 4. 错误处理
+
+- 检查剪贴板是否有图片
+- 验证禅道连接
+- 记录上传日志
+- 自动重试机制（可选）
+
+---
+
+## 📚 相关文档
+
+- [脚本使用说明](./README.md)
+- [MCP 工具列表](../README.md#api-tools)
+- [禅道API文档](../禅道API文档.md)
+
+---
+
+## 🤝 贡献
+
+如果您有更好的集成方案，欢迎提交 PR！
+
+可能的改进方向：
+- 监听剪贴板变化自动上传
+- 支持拖拽上传
+- 批量上传多张图片
+- 图片压缩/优化
+- 上传历史记录

package/scripts/README.md

@@ -0,0 +1,315 @@
+# 剪贴板图片上传脚本
+
+提供三种方案来获取剪贴板图片并上传到禅道系统。
+
+## 📋 方案对比
+
+| 方案 | 平台 | 优点 | 缺点 |
+|-----|------|------|------|
+| Node.js | 跨平台 | 与项目集成，无需额外配置 | 需要Node环境 |
+| PowerShell | Windows | 原生支持，无需安装依赖 | 仅Windows |
+| Python | 跨平台 | 简单易用，代码清晰 | 需要Python环境 |
+
+## 🚀 快速开始
+
+### 方案1: Node.js 脚本（推荐）
+
+**优点：** 跨平台，与项目无缝集成
+
+**依赖：**
+```bash
+# 安装 clipboardy（可选，用于跨平台剪贴板支持）
+npm install -g clipboardy
+```
+
+**使用方法：**
+
+**Windows:**
+```batch
+set ZENTAO_URL=https://your-zentao-url
+set ZENTAO_USERNAME=your-username
+set ZENTAO_PASSWORD=your-password
+set ZENTAO_UID=optional-uid
+
+node scripts/upload-clipboard-image.js
+```
+
+**Mac/Linux:**
+```bash
+export ZENTAO_URL=https://your-zentao-url
+export ZENTAO_USERNAME=your-username
+export ZENTAO_PASSWORD=your-password
+export ZENTAO_UID=optional-uid
+
+node scripts/upload-clipboard-image.js
+```
+
+**特性：**
+- ✅ 自动检测操作系统
+- ✅ Windows: 使用 PowerShell 读取剪贴板
+- ✅ macOS: 使用 pngpaste (需要安装: `brew install pngpaste`)
+- ✅ Linux: 使用 xclip (需要安装: `sudo apt-get install xclip`)
+- ✅ 自动保存到 img 文件夹
+- ✅ 返回禅道文件ID和URL
+
+---
+
+### 方案2: PowerShell 脚本（Windows专用）
+
+**优点：** 原生支持，无需安装额外依赖
+
+**使用方法：**
+```powershell
+.\scripts\upload-clipboard-image.ps1 `
+    -ZentaoUrl "https://your-zentao-url" `
+    -Username "your-username" `
+    -Password "your-password" `
+    -Uid "optional-uid"
+```
+
+**或者创建批处理文件 `upload.bat`：**
+```batch
+@echo off
+powershell -ExecutionPolicy Bypass -File "%~dp0scripts\upload-clipboard-image.ps1" ^
+    -ZentaoUrl "https://your-zentao-url" ^
+    -Username "your-username" ^
+    -Password "your-password"
+```
+
+**特性：**
+- ✅ Windows原生支持
+- ✅ 无需安装额外工具
+- ✅ 支持所有图片格式
+- ✅ 自动转换为PNG
+- ✅ 显示图片尺寸
+
+---
+
+### 方案3: Python 脚本（跨平台）
+
+**优点：** 简单易用，代码清晰
+
+**依赖安装：**
+```bash
+pip install pillow requests
+```
+
+**使用方法：**
+
+**Windows:**
+```batch
+set ZENTAO_URL=https://your-zentao-url
+set ZENTAO_USERNAME=your-username
+set ZENTAO_PASSWORD=your-password
+set ZENTAO_UID=optional-uid
+
+python scripts/upload-clipboard-image.py
+```
+
+**Mac/Linux:**
+```bash
+export ZENTAO_URL=https://your-zentao-url
+export ZENTAO_USERNAME=your-username
+export ZENTAO_PASSWORD=your-password
+export ZENTAO_UID=optional-uid
+
+python scripts/upload-clipboard-image.py
+```
+
+**特性：**
+- ✅ 跨平台支持
+- ✅ 使用 PIL/Pillow 处理图片
+- ✅ 支持剪贴板中的图片或图片文件路径
+- ✅ 显示图片尺寸
+- ✅ 详细的错误提示
+
+---
+
+## 📝 环境变量说明
+
+| 变量名 | 必需 | 说明 | 示例 |
+|--------|------|------|------|
+| ZENTAO_URL | 是 | 禅道系统URL | https://zentao.example.com |
+| ZENTAO_USERNAME | 是 | 登录用户名 | admin |
+| ZENTAO_PASSWORD | 是 | 登录密码 | your-password |
+| ZENTAO_UID | 否 | 富文本编辑器关联ID | editor-123 |
+
+## 💡 使用技巧
+
+### 1. 创建快捷命令
+
+**Windows (创建 `upload.bat`):**
+```batch
+@echo off
+REM 设置禅道配置
+set ZENTAO_URL=https://your-zentao-url
+set ZENTAO_USERNAME=your-username
+set ZENTAO_PASSWORD=your-password
+
+REM 运行上传脚本
+node "%~dp0scripts\upload-clipboard-image.js"
+pause
+```
+
+**Mac/Linux (创建 `upload.sh`):**
+```bash
+#!/bin/bash
+# 设置禅道配置
+export ZENTAO_URL=https://your-zentao-url
+export ZENTAO_USERNAME=your-username
+export ZENTAO_PASSWORD=your-password
+
+# 运行上传脚本
+node "$(dirname "$0")/scripts/upload-clipboard-image.js"
+```
+
+然后：
+```bash
+chmod +x upload.sh
+./upload.sh
+```
+
+### 2. 配置文件方式
+
+创建 `.env` 文件：
+```env
+ZENTAO_URL=https://your-zentao-url
+ZENTAO_USERNAME=your-username
+ZENTAO_PASSWORD=your-password
+ZENTAO_UID=
+```
+
+然后加载环境变量：
+```bash
+# Linux/Mac
+source .env
+
+# Windows (使用 PowerShell)
+Get-Content .env | ForEach-Object {
+    $name, $value = $_.split('=')
+    Set-Content env:\$name $value
+}
+```
+
+### 3. 快捷键绑定
+
+可以将脚本绑定到系统快捷键，实现：
+1. 截图/复制图片
+2. 按快捷键
+3. 自动上传到禅道
+
+**Windows AutoHotkey 示例：**
+```ahk
+; Ctrl+Shift+U 上传剪贴板图片
+^+u::
+Run, cmd /c "cd /d C:\path\to\project && upload.bat"
+return
+```
+
+**Mac Automator 示例：**
+1. 打开 Automator
+2. 创建"快速操作"
+3. 添加"运行Shell脚本"
+4. 输入上传命令
+5. 在系统偏好设置中设置快捷键
+
+## 🔍 故障排查
+
+### Node.js 方案
+
+**问题：** `Error: Cannot find module 'form-data'`
+```bash
+npm install
+```
+
+**问题：** macOS 提示 `pngpaste: command not found`
+```bash
+brew install pngpaste
+```
+
+**问题：** Linux 提示 `xclip: command not found`
+```bash
+# Ubuntu/Debian
+sudo apt-get install xclip
+
+# CentOS/RHEL
+sudo yum install xclip
+```
+
+### PowerShell 方案
+
+**问题：** 脚本无法运行
+```powershell
+# 临时允许脚本执行
+Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
+
+# 或使用 -ExecutionPolicy 参数
+powershell -ExecutionPolicy Bypass -File upload-clipboard-image.ps1
+```
+
+### Python 方案
+
+**问题：** `ModuleNotFoundError: No module named 'PIL'`
+```bash
+pip install pillow
+```
+
+**问题：** `ModuleNotFoundError: No module named 'requests'`
+```bash
+pip install requests
+```
+
+## 📸 完整工作流示例
+
+1. **截图或复制图片**
+   - Windows: Win+Shift+S 或 PrintScreen
+   - Mac: Cmd+Shift+Ctrl+4
+   - 或从任意应用复制图片
+
+2. **运行上传脚本**
+   ```bash
+   # 使用你选择的方案
+   node scripts/upload-clipboard-image.js
+   # 或
+   .\scripts\upload-clipboard-image.ps1 -ZentaoUrl ... -Username ... -Password ...
+   # 或
+   python scripts/upload-clipboard-image.py
+   ```
+
+3. **获取结果**
+   ```
+   ========================================
+   ✓ 上传成功！
+   ========================================
+   文件ID: 123
+   访问URL: /zentao/file-read-123.png
+   本地路径: C:\project\img\clipboard_1234567890.png
+   ========================================
+   ```
+
+4. **在禅道中使用**
+   - 复制返回的URL
+   - 在需求/Bug/任务描述中插入图片
+   - 使用 `![图片](/zentao/file-read-123.png)` 或直接粘贴URL
+
+## 🎯 高级用法
+
+### 批量上传
+
+创建一个循环脚本，持续监听剪贴板变化并自动上传。
+
+### 与富文本编辑器集成
+
+设置 `ZENTAO_UID` 环境变量，将上传的图片关联到特定的编辑器会话。
+
+### 自定义保存路径
+
+修改脚本中的 `imgDir` 变量，将图片保存到自定义位置。
+
+## 📄 许可证
+
+MIT
+
+## 🤝 贡献
+
+欢迎提交 Issue 和 Pull Request！

package/scripts/upload-clipboard-image.js

@@ -0,0 +1,200 @@
+#!/usr/bin/env node
+
+/**
+ * 从剪贴板获取图片并上传到禅道
+ * 使用方法: node upload-clipboard-image.js
+ *
+ * 环境变量:
+ * - ZENTAO_URL: 禅道系统URL
+ * - ZENTAO_USERNAME: 用户名
+ * - ZENTAO_PASSWORD: 密码
+ * - ZENTAO_UID: 可选的UID参数
+ */
+
+import clipboardy from 'clipboardy';
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { dirname } from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// 动态导入 ZentaoAPI
+async function uploadClipboardImage() {
+    try {
+        console.log('正在读取剪贴板内容...');
+
+        // 检查环境变量
+        const zentaoUrl = process.env.ZENTAO_URL;
+        const username = process.env.ZENTAO_USERNAME;
+        const password = process.env.ZENTAO_PASSWORD;
+        const uid = process.env.ZENTAO_UID;
+
+        if (!zentaoUrl || !username || !password) {
+            console.error('错误: 请设置环境变量 ZENTAO_URL, ZENTAO_USERNAME, ZENTAO_PASSWORD');
+            console.error('');
+            console.error('Windows示例:');
+            console.error('  set ZENTAO_URL=https://your-zentao-url');
+            console.error('  set ZENTAO_USERNAME=your-username');
+            console.error('  set ZENTAO_PASSWORD=your-password');
+            console.error('  node upload-clipboard-image.js');
+            console.error('');
+            console.error('Mac/Linux示例:');
+            console.error('  export ZENTAO_URL=https://your-zentao-url');
+            console.error('  export ZENTAO_USERNAME=your-username');
+            console.error('  export ZENTAO_PASSWORD=your-password');
+            console.error('  node upload-clipboard-image.js');
+            process.exit(1);
+        }
+
+        // 尝试读取剪贴板图片
+        let imageData;
+
+        // Windows: 使用 PowerShell 读取剪贴板图片
+        if (process.platform === 'win32') {
+            const { execSync } = await import('child_process');
+            try {
+                const psScript = `
+                    Add-Type -AssemblyName System.Windows.Forms
+                    $img = [System.Windows.Forms.Clipboard]::GetImage()
+                    if ($img -ne $null) {
+                        $ms = New-Object System.IO.MemoryStream
+                        $img.Save($ms, [System.Drawing.Imaging.ImageFormat]::Png)
+                        [Convert]::ToBase64String($ms.ToArray())
+                    }
+                `;
+                const base64 = execSync(`powershell -Command "${psScript.replace(/\n/g, ' ')}"`, {
+                    encoding: 'utf8',
+                    maxBuffer: 10 * 1024 * 1024
+                }).trim();
+
+                if (base64) {
+                    imageData = `data:image/png;base64,${base64}`;
+                    console.log('✓ 从剪贴板读取图片成功 (Windows)');
+                } else {
+                    console.error('错误: 剪贴板中没有图片');
+                    process.exit(1);
+                }
+            } catch (error) {
+                console.error('错误: 无法读取剪贴板图片', error.message);
+                process.exit(1);
+            }
+        }
+        // macOS: 使用 pngpaste
+        else if (process.platform === 'darwin') {
+            const { execSync } = await import('child_process');
+            try {
+                // 检查是否安装了 pngpaste
+                try {
+                    execSync('which pngpaste', { stdio: 'ignore' });
+                } catch {
+                    console.error('错误: 请先安装 pngpaste');
+                    console.error('运行: brew install pngpaste');
+                    process.exit(1);
+                }
+
+                const tempFile = path.join(__dirname, 'temp_clipboard.png');
+                execSync(`pngpaste "${tempFile}"`);
+                const buffer = fs.readFileSync(tempFile);
+                const base64 = buffer.toString('base64');
+                imageData = `data:image/png;base64,${base64}`;
+                fs.unlinkSync(tempFile);
+                console.log('✓ 从剪贴板读取图片成功 (macOS)');
+            } catch (error) {
+                console.error('错误: 剪贴板中没有图片或读取失败', error.message);
+                process.exit(1);
+            }
+        }
+        // Linux: 使用 xclip
+        else {
+            const { execSync } = await import('child_process');
+            try {
+                // 检查是否安装了 xclip
+                try {
+                    execSync('which xclip', { stdio: 'ignore' });
+                } catch {
+                    console.error('错误: 请先安装 xclip');
+                    console.error('运行: sudo apt-get install xclip (Ubuntu/Debian)');
+                    console.error('或: sudo yum install xclip (CentOS/RHEL)');
+                    process.exit(1);
+                }
+
+                const buffer = execSync('xclip -selection clipboard -t image/png -o', {
+                    maxBuffer: 10 * 1024 * 1024
+                });
+                const base64 = buffer.toString('base64');
+                imageData = `data:image/png;base64,${base64}`;
+                console.log('✓ 从剪贴板读取图片成功 (Linux)');
+            } catch (error) {
+                console.error('错误: 剪贴板中没有图片或读取失败', error.message);
+                process.exit(1);
+            }
+        }
+
+        // 导入 ZentaoAPI
+        const modulePath = path.join(__dirname, '..', 'dist', 'api', 'zentaoApi.js');
+        const { ZentaoAPI } = await import(modulePath);
+
+        // 创建 API 实例
+        console.log('正在连接禅道系统...');
+        const api = new ZentaoAPI({
+            url: zentaoUrl,
+            username: username,
+            password: password,
+            apiVersion: 'v1'
+        });
+
+        // 创建 img 文件夹
+        const imgDir = path.join(process.cwd(), 'img');
+        if (!fs.existsSync(imgDir)) {
+            fs.mkdirSync(imgDir, { recursive: true });
+        }
+
+        // 解析 base64 数据
+        const matches = imageData.match(/^data:image\/(\w+);base64,(.+)$/);
+        if (!matches) {
+            console.error('错误: 无效的图片数据');
+            process.exit(1);
+        }
+
+        const ext = matches[1];
+        const base64Data = matches[2];
+        const buffer = Buffer.from(base64Data, 'base64');
+        const filename = `clipboard_${Date.now()}.${ext}`;
+
+        // 保存到本地
+        const savedPath = path.join(imgDir, filename);
+        fs.writeFileSync(savedPath, buffer);
+        console.log(`✓ 图片已保存到: ${savedPath}`);
+
+        // 上传到禅道
+        console.log('正在上传到禅道...');
+        const result = await api.uploadFile({
+            file: buffer,
+            filename: filename,
+            uid: uid
+        });
+
+        console.log('');
+        console.log('========================================');
+        console.log('✓ 上传成功！');
+        console.log('========================================');
+        console.log('文件ID:', result.id);
+        console.log('访问URL:', result.url);
+        console.log('本地路径:', savedPath);
+        console.log('========================================');
+
+    } catch (error) {
+        console.error('');
+        console.error('========================================');
+        console.error('✗ 上传失败');
+        console.error('========================================');
+        console.error('错误信息:', error.message);
+        console.error('========================================');
+        process.exit(1);
+    }
+}
+
+// 运行
+uploadClipboardImage();

package/scripts/upload-clipboard-image.ps1

@@ -0,0 +1,128 @@
+# 从剪贴板获取图片并上传到禅道
+# 使用方法: .\upload-clipboard-image.ps1
+#
+# 参数:
+# -ZentaoUrl: 禅道系统URL
+# -Username: 用户名
+# -Password: 密码
+# -Uid: 可选的UID参数
+
+param(
+    [Parameter(Mandatory=$true)]
+    [string]$ZentaoUrl,
+
+    [Parameter(Mandatory=$true)]
+    [string]$Username,
+
+    [Parameter(Mandatory=$true)]
+    [string]$Password,
+
+    [Parameter(Mandatory=$false)]
+    [string]$Uid = ""
+)
+
+# 添加必要的程序集
+Add-Type -AssemblyName System.Windows.Forms
+Add-Type -AssemblyName System.Drawing
+
+Write-Host "正在读取剪贴板图片..." -ForegroundColor Cyan
+
+# 从剪贴板获取图片
+$img = [System.Windows.Forms.Clipboard]::GetImage()
+
+if ($img -eq $null) {
+    Write-Host "错误: 剪贴板中没有图片" -ForegroundColor Red
+    exit 1
+}
+
+Write-Host "✓ 成功读取剪贴板图片 ($($img.Width)x$($img.Height))" -ForegroundColor Green
+
+# 转换为 base64
+$ms = New-Object System.IO.MemoryStream
+$img.Save($ms, [System.Drawing.Imaging.ImageFormat]::Png)
+$base64 = [Convert]::ToBase64String($ms.ToArray())
+$ms.Close()
+
+Write-Host "✓ 图片已转换为 base64" -ForegroundColor Green
+
+# 创建 img 文件夹
+$imgDir = Join-Path (Get-Location) "img"
+if (-not (Test-Path $imgDir)) {
+    New-Item -ItemType Directory -Path $imgDir | Out-Null
+    Write-Host "✓ 创建 img 文件夹: $imgDir" -ForegroundColor Green
+}
+
+# 保存到本地
+$filename = "clipboard_$([DateTimeOffset]::Now.ToUnixTimeMilliseconds()).png"
+$localPath = Join-Path $imgDir $filename
+$bytes = [Convert]::FromBase64String($base64)
+[System.IO.File]::WriteAllBytes($localPath, $bytes)
+Write-Host "✓ 图片已保存到: $localPath" -ForegroundColor Green
+
+# 获取 Token
+Write-Host "正在连接禅道系统..." -ForegroundColor Cyan
+$passwordMd5 = [System.BitConverter]::ToString(
+    [System.Security.Cryptography.MD5]::Create().ComputeHash(
+        [System.Text.Encoding]::UTF8.GetBytes($Password)
+    )
+).Replace("-", "").ToLower()
+
+$tokenUrl = "$ZentaoUrl/zentao/api.php/v1/tokens"
+$tokenBody = @{
+    account = $Username
+    password = $passwordMd5
+} | ConvertTo-Json
+
+try {
+    $tokenResponse = Invoke-RestMethod -Uri $tokenUrl -Method Post -Body $tokenBody -ContentType "application/json"
+    $token = $tokenResponse.token
+    Write-Host "✓ 成功获取 Token" -ForegroundColor Green
+} catch {
+    Write-Host "错误: 无法获取 Token - $($_.Exception.Message)" -ForegroundColor Red
+    exit 1
+}
+
+# 上传文件
+Write-Host "正在上传到禅道..." -ForegroundColor Cyan
+
+$uploadUrl = "$ZentaoUrl/zentao/api.php/v1/files"
+if ($Uid) {
+    $uploadUrl += "?uid=$Uid"
+}
+
+# 创建 multipart/form-data
+$boundary = [System.Guid]::NewGuid().ToString()
+$LF = "`r`n"
+
+$bodyLines = (
+    "--$boundary",
+    "Content-Disposition: form-data; name=`"imgFile`"; filename=`"$filename`"",
+    "Content-Type: image/png$LF",
+    [System.Text.Encoding]::GetEncoding("iso-8859-1").GetString($bytes),
+    "--$boundary--$LF"
+) -join $LF
+
+try {
+    $response = Invoke-RestMethod -Uri $uploadUrl -Method Post `
+        -Headers @{ Token = $token } `
+        -ContentType "multipart/form-data; boundary=$boundary" `
+        -Body $bodyLines
+
+    Write-Host ""
+    Write-Host "========================================" -ForegroundColor Green
+    Write-Host "✓ 上传成功！" -ForegroundColor Green
+    Write-Host "========================================" -ForegroundColor Green
+    Write-Host "文件ID: $($response.id)"
+    Write-Host "访问URL: $($response.url)"
+    Write-Host "本地路径: $localPath"
+    Write-Host "========================================" -ForegroundColor Green
+
+} catch {
+    Write-Host ""
+    Write-Host "========================================" -ForegroundColor Red
+    Write-Host "✗ 上传失败" -ForegroundColor Red
+    Write-Host "========================================" -ForegroundColor Red
+    Write-Host "错误信息: $($_.Exception.Message)" -ForegroundColor Red
+    Write-Host "========================================" -ForegroundColor Red
+    exit 1
+}

package/scripts/upload-clipboard-image.py

@@ -0,0 +1,196 @@
+#!/usr/bin/env python3
+"""
+从剪贴板获取图片并上传到禅道
+
+依赖安装:
+    pip install pillow requests
+
+使用方法:
+    python upload-clipboard-image.py
+
+环境变量:
+    ZENTAO_URL: 禅道系统URL
+    ZENTAO_USERNAME: 用户名
+    ZENTAO_PASSWORD: 密码
+    ZENTAO_UID: 可选的UID参数
+"""
+
+import os
+import sys
+import hashlib
+import requests
+import base64
+from io import BytesIO
+from pathlib import Path
+from datetime import datetime
+
+try:
+    from PIL import ImageGrab, Image
+except ImportError:
+    print("错误: 请先安装 Pillow 库")
+    print("运行: pip install pillow")
+    sys.exit(1)
+
+
+def get_clipboard_image():
+    """从剪贴板获取图片"""
+    print("正在读取剪贴板图片...")
+
+    try:
+        # 尝试获取剪贴板图片
+        img = ImageGrab.grabclipboard()
+
+        if img is None:
+            print("错误: 剪贴板中没有图片")
+            sys.exit(1)
+
+        # 如果是文件路径列表，读取第一个图片文件
+        if isinstance(img, list):
+            img_path = img[0]
+            if os.path.isfile(img_path):
+                img = Image.open(img_path)
+            else:
+                print(f"错误: 无法打开文件 {img_path}")
+                sys.exit(1)
+
+        print(f"✓ 成功读取剪贴板图片 ({img.width}x{img.height})")
+        return img
+
+    except Exception as e:
+        print(f"错误: 无法读取剪贴板图片 - {e}")
+        sys.exit(1)
+
+
+def image_to_base64(img):
+    """将图片转换为 base64"""
+    buffer = BytesIO()
+    img.save(buffer, format='PNG')
+    img_bytes = buffer.getvalue()
+    return base64.b64encode(img_bytes).decode('utf-8'), img_bytes
+
+
+def get_zentao_token(url, username, password):
+    """获取禅道 Token"""
+    print("正在连接禅道系统...")
+
+    # MD5 加密密码
+    password_md5 = hashlib.md5(password.encode()).hexdigest()
+
+    token_url = f"{url}/zentao/api.php/v1/tokens"
+    data = {
+        "account": username,
+        "password": password_md5
+    }
+
+    try:
+        response = requests.post(token_url, json=data)
+        response.raise_for_status()
+        token = response.json().get('token')
+
+        if not token:
+            print("错误: 无法获取 Token")
+            sys.exit(1)
+
+        print("✓ 成功获取 Token")
+        return token
+
+    except requests.exceptions.RequestException as e:
+        print(f"错误: 无法连接禅道系统 - {e}")
+        sys.exit(1)
+
+
+def upload_to_zentao(url, token, img_bytes, filename, uid=None):
+    """上传图片到禅道"""
+    print("正在上传到禅道...")
+
+    upload_url = f"{url}/zentao/api.php/v1/files"
+    if uid:
+        upload_url += f"?uid={uid}"
+
+    headers = {
+        "Token": token
+    }
+
+    files = {
+        'imgFile': (filename, img_bytes, 'image/png')
+    }
+
+    try:
+        response = requests.post(upload_url, headers=headers, files=files)
+        response.raise_for_status()
+        result = response.json()
+
+        print("")
+        print("=" * 40)
+        print("✓ 上传成功！")
+        print("=" * 40)
+        print(f"文件ID: {result.get('id')}")
+        print(f"访问URL: {result.get('url')}")
+        print("=" * 40)
+
+        return result
+
+    except requests.exceptions.RequestException as e:
+        print("")
+        print("=" * 40)
+        print("✗ 上传失败")
+        print("=" * 40)
+        print(f"错误信息: {e}")
+        print("=" * 40)
+        sys.exit(1)
+
+
+def main():
+    # 检查环境变量
+    zentao_url = os.environ.get('ZENTAO_URL')
+    username = os.environ.get('ZENTAO_USERNAME')
+    password = os.environ.get('ZENTAO_PASSWORD')
+    uid = os.environ.get('ZENTAO_UID')
+
+    if not all([zentao_url, username, password]):
+        print("错误: 请设置环境变量 ZENTAO_URL, ZENTAO_USERNAME, ZENTAO_PASSWORD")
+        print("")
+        print("Windows示例:")
+        print("  set ZENTAO_URL=https://your-zentao-url")
+        print("  set ZENTAO_USERNAME=your-username")
+        print("  set ZENTAO_PASSWORD=your-password")
+        print("  python upload-clipboard-image.py")
+        print("")
+        print("Mac/Linux示例:")
+        print("  export ZENTAO_URL=https://your-zentao-url")
+        print("  export ZENTAO_USERNAME=your-username")
+        print("  export ZENTAO_PASSWORD=your-password")
+        print("  python upload-clipboard-image.py")
+        sys.exit(1)
+
+    # 获取剪贴板图片
+    img = get_clipboard_image()
+
+    # 转换为 base64
+    base64_str, img_bytes = image_to_base64(img)
+    print("✓ 图片已转换为 base64")
+
+    # 创建 img 文件夹
+    img_dir = Path.cwd() / 'img'
+    img_dir.mkdir(exist_ok=True)
+
+    # 保存到本地
+    timestamp = int(datetime.now().timestamp() * 1000)
+    filename = f"clipboard_{timestamp}.png"
+    local_path = img_dir / filename
+
+    with open(local_path, 'wb') as f:
+        f.write(img_bytes)
+
+    print(f"✓ 图片已保存到: {local_path}")
+
+    # 获取 Token
+    token = get_zentao_token(zentao_url, username, password)
+
+    # 上传到禅道
+    result = upload_to_zentao(zentao_url, token, img_bytes, filename, uid)
+    print(f"本地路径: {local_path}")
+
+
+if __name__ == '__main__':
+    main()

package/scripts/upload.bat.example

@@ -0,0 +1,41 @@
+@echo off
+REM ========================================
+REM 剪贴板图片上传到禅道 - 配置示例
+REM ========================================
+REM
+REM 使用方法:
+REM 1. 复制此文件为 upload.bat
+REM 2. 修改下面的配置信息
+REM 3. 双击运行或在命令行运行
+REM
+
+REM ========================================
+REM 配置区域 - 请修改为你的禅道信息
+REM ========================================
+
+set ZENTAO_URL=https://your-zentao-url
+set ZENTAO_USERNAME=your-username
+set ZENTAO_PASSWORD=your-password
+set ZENTAO_UID=
+
+REM ========================================
+REM 选择上传方式
+REM ========================================
+
+REM 方式1: 使用 Node.js (推荐)
+node "%~dp0upload-clipboard-image.js"
+
+REM 方式2: 使用 PowerShell (Windows)
+REM powershell -ExecutionPolicy Bypass -File "%~dp0upload-clipboard-image.ps1" ^
+REM     -ZentaoUrl "%ZENTAO_URL%" ^
+REM     -Username "%ZENTAO_USERNAME%" ^
+REM     -Password "%ZENTAO_PASSWORD%" ^
+REM     -Uid "%ZENTAO_UID%"
+
+REM 方式3: 使用 Python
+REM python "%~dp0upload-clipboard-image.py"
+
+REM ========================================
+REM 按任意键退出
+REM ========================================
+pause