cicy-desktop 1.0.8

package/docs/yaml.md

@@ -0,0 +1,255 @@
+# YAML 支持文档
+
+## 概述
+
+Electron MCP Server 支持 YAML 和 JSON 双格式，**默认使用 YAML** 以节省 token 消耗。
+
+## 为什么选择 YAML？
+
+### Token 节省对比
+
+**JSON 格式（~100 字符）：**
+```json
+{"name":"open_window","arguments":{"url":"https://google.com","reuseWindow":false}}
+```
+
+**YAML 格式（~70 字符）：**
+```yaml
+name: open_window
+arguments:
+  url: https://google.com
+  reuseWindow: false
+```
+
+**节省约 30-45% token！**
+
+### 其他优势
+
+- ✅ 更易读易写
+- ✅ 无需大量引号和逗号
+- ✅ 支持注释（虽然在 API 调用中不常用）
+- ✅ 更自然的缩进结构
+
+## 服务器端支持
+
+### Accept 头控制
+
+服务器根据 `Accept` 头返回相应格式：
+
+```bash
+# 请求 YAML 响应
+curl -H "Accept: application/yaml" http://localhost:8101/rpc
+
+# 请求 JSON 响应（默认）
+curl -H "Accept: application/json" http://localhost:8101/rpc
+```
+
+### 响应格式对比
+
+**YAML 响应（~50 字符）：**
+```yaml
+jsonrpc: '2.0'
+id: 1
+result:
+  content:
+    - type: text
+      text: Pong
+```
+
+**JSON 响应（~90 字符）：**
+```json
+{"jsonrpc":"2.0","id":1,"result":{"content":[{"type":"text","text":"Pong"}]}}
+```
+
+## cicy-rpc 工具
+
+### 默认行为
+
+`cicy-rpc` 默认使用 YAML 格式：
+
+```bash
+# YAML（默认，无需标志）
+cicy-rpc "
+name: ping
+arguments: {}
+"
+
+# JSON（需要 --json 或 -j）
+cicy-rpc --json '{"name":"ping","arguments":{}}'
+```
+
+### 自动处理
+
+工具自动处理格式转换：
+
+1. **输入处理**：
+   - YAML 输入 → 使用 `yq` 转换为 JSON
+   - JSON 输入 → 直接使用
+
+2. **Accept 头**：
+   - YAML 模式 → `Accept: application/yaml`
+   - JSON 模式 → `Accept: application/json`
+
+3. **输出解析**：
+   - YAML 响应 → 使用 `yq` 解析
+   - JSON 响应 → 使用 `jq` 解析
+
+## 依赖安装
+
+### 服务器端
+
+```bash
+npm install js-yaml
+```
+
+### 客户端
+
+```bash
+pip install yq --break-system-packages
+```
+
+## 实际使用示例
+
+### 打开窗口
+
+```bash
+cicy-rpc "
+name: open_window
+arguments:
+  url: https://gemini.google.com
+"
+```
+
+### 设置窗口位置
+
+```bash
+cicy-rpc "
+name: set_window_bounds
+arguments:
+  win_id: 1
+  x: 1320
+  y: 0
+  width: 360
+  height: 720
+"
+```
+
+### 执行 JavaScript
+
+```bash
+cicy-rpc "
+name: exec_js
+arguments:
+  win_id: 1
+  code: document.title
+"
+```
+
+### 复杂参数
+
+```bash
+cicy-rpc "
+name: open_window
+arguments:
+  url: https://example.com
+  accountIdx: 1
+  reuseWindow: false
+  options:
+    width: 1280
+    height: 720
+"
+```
+
+## 性能影响
+
+### Token 消耗
+
+- **YAML**: 平均节省 30-45% 字符
+- **网络传输**: 响应体积减少约 40%
+- **解析速度**: YAML 略慢，但差异可忽略
+
+### 推荐使用场景
+
+- ✅ **AI 对话**: 使用 YAML（节省 token）
+- ✅ **命令行工具**: 使用 YAML（易读易写）
+- ⚠️ **程序化调用**: JSON 或 YAML 均可
+- ⚠️ **性能关键**: JSON（解析更快）
+
+## 故障排除
+
+### yq 未安装
+
+```bash
+❌ Error: yq not found. Install with: pip install yq --break-system-packages
+```
+
+**解决方案：**
+```bash
+pip install yq --break-system-packages
+```
+
+### YAML 语法错误
+
+```bash
+❌ Error: yaml.scanner.ScannerError: mapping values are not allowed here
+```
+
+**解决方案：**
+- 检查缩进（使用空格，不要用 Tab）
+- 确保冒号后有空格
+- 检查特殊字符是否需要引号
+
+### 服务器不支持 YAML
+
+如果服务器版本较旧，使用 JSON 格式：
+
+```bash
+cicy-rpc --json '{"name":"ping","arguments":{}}'
+```
+
+## 技术实现
+
+### 服务器端 (Node.js)
+
+```javascript
+const yaml = require('js-yaml');
+
+app.post("/rpc", async (req, res) => {
+  const acceptHeader = req.get('Accept') || 'application/json';
+  const useYaml = acceptHeader.includes('application/yaml');
+  
+  const response = { /* ... */ };
+  
+  if (useYaml) {
+    res.type('application/yaml').send(yaml.dump(response));
+  } else {
+    res.json(response);
+  }
+});
+```
+
+### 客户端 (Bash)
+
+```bash
+# YAML 转 JSON
+PARAMS=$(echo "$PARAMS_INPUT" | yq -c .)
+
+# 设置 Accept 头
+ACCEPT_HEADER="application/yaml"
+
+# 解析 YAML 响应
+curl ... | yq -r '.result.content[].text'
+```
+
+## 最佳实践
+
+1. **默认使用 YAML** - 节省 token 和带宽
+2. **复杂嵌套使用 JSON** - 避免 YAML 缩进问题
+3. **程序化调用优先 JSON** - 更好的库支持
+4. **命令行优先 YAML** - 更易读易写
+
+## 参考资源
+
+- [YAML 规范](https://yaml.org/)
+- [js-yaml 文档](https://github.com/nodeca/js-yaml)
+- [yq 文档](https://github.com/kislyuk/yq)

package/electron-mcp-fixed.command

@@ -0,0 +1,134 @@
+#!/bin/bash
+
+# Electron MCP 启动脚本 - 修复版本
+# 用于在 macOS 上双击启动 Electron MCP 服务
+
+# 设置错误处理
+set -e
+
+# 获取脚本所在目录
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+
+# 检查是否在项目目录中
+if [ -f "$SCRIPT_DIR/package.json" ]; then
+    PROJECT_DIR="$SCRIPT_DIR"
+elif [ -f "$SCRIPT_DIR/electron-mcp/package.json" ]; then
+    PROJECT_DIR="$SCRIPT_DIR/electron-mcp"
+else
+    # 如果脚本在桌面，尝试找到项目目录
+    if [ -f "/Users/ton/Desktop/electron-mcp/package.json" ]; then
+        PROJECT_DIR="/Users/ton/Desktop/electron-mcp"
+    elif [ -f "$HOME/Desktop/electron-mcp/package.json" ]; then
+        PROJECT_DIR="$HOME/Desktop/electron-mcp"
+    else
+        echo "❌ 错误: 找不到 electron-mcp 项目目录"
+        echo "请确保项目在以下位置之一："
+        echo "- $SCRIPT_DIR/electron-mcp/"
+        echo "- $HOME/Desktop/electron-mcp/"
+        echo ""
+        echo "按任意键退出..."
+        read -n 1
+        exit 1
+    fi
+fi
+
+# 输出启动信息
+clear
+echo "========================================="
+echo "  🚀 Electron MCP 启动脚本"
+echo "  📁 项目目录: $PROJECT_DIR"
+echo "  📅 时间: $(date '+%Y-%m-%d %H:%M:%S')"
+echo "========================================="
+
+# 切换到项目目录
+cd "$PROJECT_DIR"
+
+# 检查 Node.js 是否安装
+if ! command -v node &> /dev/null; then
+    echo "❌ 错误: 未找到 Node.js"
+    echo "请先安装 Node.js: https://nodejs.org/"
+    echo ""
+    echo "按任意键退出..."
+    read -n 1
+    exit 1
+fi
+
+echo "✅ Node.js 版本: $(node --version)"
+
+# 检查 npm 是否安装
+if ! command -v npm &> /dev/null; then
+    echo "❌ 错误: 未找到 npm"
+    echo "请先安装 npm"
+    echo ""
+    echo "按任意键退出..."
+    read -n 1
+    exit 1
+fi
+
+echo "✅ npm 版本: $(npm --version)"
+
+# 检查依赖是否安装
+if [ ! -d "node_modules" ]; then
+    echo ""
+    echo "📦 正在安装依赖..."
+    npm install
+    if [ $? -ne 0 ]; then
+        echo "❌ 依赖安装失败"
+        echo ""
+        echo "按任意键退出..."
+        read -n 1
+        exit 1
+    fi
+    echo "✅ 依赖安装完成"
+fi
+
+# 检查 Electron 是否可用
+if ! command -v electron &> /dev/null && [ ! -f "node_modules/.bin/electron" ]; then
+    echo ""
+    echo "📦 正在安装 Electron..."
+    npm install electron --save-dev
+    if [ $? -ne 0 ]; then
+        echo "❌ Electron 安装失败"
+        echo ""
+        echo "按任意键退出..."
+        read -n 1
+        exit 1
+    fi
+    echo "✅ Electron 安装完成"
+fi
+
+# 设置环境变量
+export NODE_ENV=development
+
+# 显示启动信息
+echo ""
+echo "========================================="
+echo "🚀 正在启动 Electron MCP 服务..."
+echo "📋 端口: 8101"
+echo "📋 调试端口: 9221"
+echo ""
+echo "服务启动后可以访问:"
+echo "- MCP 服务: http://localhost:8101/mcp"
+echo "- API 文档: http://localhost:8101/docs"
+echo "- 远程调试: http://localhost:9221"
+echo ""
+echo "⚠️  关闭此窗口将停止服务"
+echo "   按 Ctrl+C 可以优雅停止服务"
+echo "========================================="
+echo ""
+
+# 启动应用（不使用 exit，让进程保持运行）
+npm start
+
+# 如果 npm start 退出，显示信息
+echo ""
+echo "========================================="
+if [ $? -eq 0 ]; then
+    echo "✅ 服务已正常停止"
+else
+    echo "❌ 服务异常退出"
+    echo "请检查上面的错误信息"
+fi
+echo ""
+echo "按任意键关闭窗口..."
+read -n 1

package/electron-mcp-simple.command

@@ -0,0 +1,135 @@
+#!/bin/bash
+
+# 简化版 Electron MCP 启动脚本
+# 避免复杂的路径检测，直接使用固定路径
+
+# 强制保持终端打开
+exec 2>&1
+
+echo "========================================="
+echo "  🚀 Electron MCP 启动脚本 (简化版)"
+echo "  📅 $(date '+%Y-%m-%d %H:%M:%S')"
+echo "========================================="
+
+# 尝试多个可能的项目路径
+PROJECT_PATHS=(
+    "/Users/ton/Desktop/electron-mcp"
+    "$HOME/Desktop/electron-mcp"
+    "$HOME/Documents/electron-mcp"
+    "$HOME/Projects/electron-mcp"
+)
+
+PROJECT_DIR=""
+
+echo "🔍 正在查找项目目录..."
+
+for path in "${PROJECT_PATHS[@]}"; do
+    echo "检查: $path"
+    if [ -f "$path/package.json" ]; then
+        PROJECT_DIR="$path"
+        echo "✅ 找到项目: $PROJECT_DIR"
+        break
+    fi
+done
+
+if [ -z "$PROJECT_DIR" ]; then
+    echo ""
+    echo "❌ 错误: 找不到 electron-mcp 项目"
+    echo ""
+    echo "请确保项目在以下位置之一："
+    for path in "${PROJECT_PATHS[@]}"; do
+        echo "  - $path"
+    done
+    echo ""
+    echo "或者手动输入项目路径:"
+    read -p "项目路径: " USER_PATH
+    if [ -f "$USER_PATH/package.json" ]; then
+        PROJECT_DIR="$USER_PATH"
+        echo "✅ 使用用户指定路径: $PROJECT_DIR"
+    else
+        echo "❌ 指定路径无效"
+        echo "按回车键退出..."
+        read
+        exit 1
+    fi
+fi
+
+echo ""
+echo "📁 项目目录: $PROJECT_DIR"
+echo "📁 切换到项目目录..."
+
+cd "$PROJECT_DIR" || {
+    echo "❌ 无法切换到项目目录"
+    echo "按回车键退出..."
+    read
+    exit 1
+}
+
+echo "✅ 当前目录: $(pwd)"
+
+# 检查 Node.js
+echo ""
+echo "🔍 检查 Node.js..."
+if command -v node >/dev/null 2>&1; then
+    echo "✅ Node.js: $(node --version)"
+else
+    echo "❌ 未找到 Node.js"
+    echo "请安装 Node.js: https://nodejs.org/"
+    echo "按回车键退出..."
+    read
+    exit 1
+fi
+
+# 检查 npm
+echo "🔍 检查 npm..."
+if command -v npm >/dev/null 2>&1; then
+    echo "✅ npm: $(npm --version)"
+else
+    echo "❌ 未找到 npm"
+    echo "按回车键退出..."
+    read
+    exit 1
+fi
+
+# 检查依赖
+echo ""
+echo "🔍 检查项目依赖..."
+if [ ! -d "node_modules" ]; then
+    echo "📦 安装依赖中..."
+    npm install
+    if [ $? -ne 0 ]; then
+        echo "❌ 依赖安装失败"
+        echo "按回车键退出..."
+        read
+        exit 1
+    fi
+else
+    echo "✅ 依赖已安装"
+fi
+
+# 启动服务
+echo ""
+echo "========================================="
+echo "🚀 启动 Electron MCP 服务"
+echo "📋 端口: 8101"
+echo "📋 API: http://localhost:8101/docs"
+echo ""
+echo "⚠️  关闭此窗口将停止服务"
+echo "   按 Ctrl+C 停止服务"
+echo "========================================="
+echo ""
+
+# 启动并保持运行
+npm start
+
+# 服务停止后的处理
+echo ""
+echo "========================================="
+if [ $? -eq 0 ]; then
+    echo "✅ 服务正常停止"
+else
+    echo "❌ 服务异常退出 (退出码: $?)"
+fi
+echo ""
+echo "按回车键关闭窗口..."
+read

package/electron-mcp.command

@@ -0,0 +1,92 @@
+#!/bin/bash
+
+# Electron MCP 启动脚本
+# 用于在 macOS 上双击启动 Electron MCP 服务
+
+# 设置脚本目录
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_DIR="$SCRIPT_DIR"
+
+# 输出启动信息
+echo "========================================="
+echo "  Electron MCP 启动脚本"
+echo "  项目目录: $PROJECT_DIR"
+echo "========================================="
+
+# 检查是否在正确的项目目录
+if [ ! -f "$PROJECT_DIR/package.json" ]; then
+    echo "❌ 错误: 未找到 package.json 文件"
+    echo "请确保脚本在 electron-mcp 项目根目录中"
+    read -p "按任意键退出..."
+    exit 1
+fi
+
+# 切换到项目目录
+cd "$PROJECT_DIR"
+
+# 检查 Node.js 是否安装
+if ! command -v node &> /dev/null; then
+    echo "❌ 错误: 未找到 Node.js"
+    echo "请先安装 Node.js: https://nodejs.org/"
+    read -p "按任意键退出..."
+    exit 1
+fi
+
+# 检查 npm 是否安装
+if ! command -v npm &> /dev/null; then
+    echo "❌ 错误: 未找到 npm"
+    echo "请先安装 npm"
+    read -p "按任意键退出..."
+    exit 1
+fi
+
+# 检查依赖是否安装
+if [ ! -d "node_modules" ]; then
+    echo "📦 正在安装依赖..."
+    npm install
+    if [ $? -ne 0 ]; then
+        echo "❌ 依赖安装失败"
+        read -p "按任意键退出..."
+        exit 1
+    fi
+fi
+
+# 检查 Electron 是否安装
+if ! command -v electron &> /dev/null && [ ! -f "node_modules/.bin/electron" ]; then
+    echo "❌ 错误: 未找到 Electron"
+    echo "正在安装 Electron..."
+    npm install electron --save-dev
+    if [ $? -ne 0 ]; then
+        echo "❌ Electron 安装失败"
+        read -p "按任意键退出..."
+        exit 1
+    fi
+fi
+
+# 设置环境变量
+export NODE_ENV=development
+
+# 启动服务
+echo "🚀 正在启动 Electron MCP 服务..."
+echo "端口: 8101"
+echo "调试端口: 9221"
+echo ""
+echo "服务启动后可以访问:"
+echo "- MCP 服务: http://localhost:8101/mcp"
+echo "- API 文档: http://localhost:8101/docs"
+echo "- 远程调试: http://localhost:9221"
+echo ""
+echo "按 Ctrl+C 停止服务"
+echo "========================================="
+
+# 启动应用
+npm start
+
+# 如果启动失败，显示错误信息
+if [ $? -ne 0 ]; then
+    echo ""
+    echo "❌ 服务启动失败"
+    echo "请检查错误信息并重试"
+    read -p "按任意键退出..."
+    exit 1
+fi