cicy-desktop 2.1.237 → 2.1.239

package/docs/yaml.md

@@ -1,255 +0,0 @@
-# YAML 支持文档
-
-## 概述
-
-CiCy Desktop 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/generate-openapi.js

@@ -1,162 +0,0 @@
-#!/usr/bin/env node
-// Copyright 2026 CiCy AI
-// SPDX-License-Identifier: Apache-2.0
-
-
-const fs = require('fs');
-const path = require('path');
-const yaml = require('js-yaml');
-
-// 从服务器获取工具列表和 schemas
-async function getToolsWithSchemas() {
-  const http = require('http');
-  const tokenPath = path.join(require('os').homedir(), 'cicy-ai', 'global.json');
-  const config = JSON.parse(fs.readFileSync(tokenPath, 'utf8'));
-  const token = config.api_token || '';
-  
-  // 获取工具列表
-  const tools = await new Promise((resolve, reject) => {
-    http.get('http://localhost:8101/rpc/tools', {
-      headers: { Authorization: `Bearer ${token}` }
-    }, (res) => {
-      let data = '';
-      res.on('data', chunk => data += chunk);
-      res.on('end', () => resolve(JSON.parse(data).tools));
-    }).on('error', reject);
-  });
-  
-  // 获取 schemas
-  const schemas = await new Promise((resolve, reject) => {
-    http.get('http://localhost:8101/rpc/schemas', {
-      headers: { Authorization: `Bearer ${token}` }
-    }, (res) => {
-      let data = '';
-      res.on('data', chunk => data += chunk);
-      res.on('end', () => resolve(JSON.parse(data).schemas));
-    }).on('error', reject);
-  });
-  
-  return tools.map(tool => ({
-    ...tool,
-    schema: schemas[tool.name] || { type: 'object' }
-  }));
-}
-
-async function generateOpenAPI() {
-  const tools = await getToolsWithSchemas();
-  
-  const openapi = {
-    openapi: '3.0.0',
-    info: {
-      title: 'CiCy Desktop REST API',
-      version: '1.0.0',
-      description: `REST API for CiCy Desktop tools - ${tools.length} tools available`,
-    },
-    servers: [
-      {
-        url: 'http://localhost:8101',
-        description: 'Local server',
-      },
-      {
-        url: 'https://gcp-8101.cicy.de5.net',
-        description: 'Remote server',
-      },
-    ],
-    components: {
-      securitySchemes: {
-        bearerAuth: {
-          type: 'http',
-          scheme: 'bearer',
-          bearerFormat: 'token',
-        },
-      },
-    },
-    security: [{ bearerAuth: [] }],
-    paths: {}
-  };
-
-  // 添加 /rpc/tools 端点
-  openapi.paths['/rpc/tools'] = {
-    get: {
-      summary: 'List all available tools',
-      tags: ['Tools'],
-      security: [{ bearerAuth: [] }],
-      responses: {
-        200: {
-          description: 'List of tools',
-          content: {
-            'application/json': {
-              schema: {
-                type: 'object',
-                properties: {
-                  tools: {
-                    type: 'array',
-                    items: {
-                      type: 'object',
-                      properties: {
-                        name: { type: 'string' },
-                        description: { type: 'string' }
-                      }
-                    }
-                  }
-                }
-              }
-            }
-          }
-        }
-      }
-    }
-  };
-
-  // 为每个工具生成端点
-  for (const tool of tools) {
-    openapi.paths[`/rpc/${tool.name}`] = {
-      post: {
-        description: tool.description,
-        tags: ['Tools'],
-        security: [{ bearerAuth: [] }],
-        requestBody: {
-          required: true,
-          content: {
-            'application/json': {
-              schema: tool.schema
-            }
-          }
-        },
-        responses: {
-          200: {
-            description: 'Tool execution result',
-            content: {
-              'application/json': {
-                schema: {
-                  type: 'object',
-                  properties: {
-                    content: {
-                      type: 'array',
-                      items: {
-                        type: 'object',
-                        properties: {
-                          type: { type: 'string' },
-                          text: { type: 'string' }
-                        }
-                      }
-                    }
-                  }
-                }
-              }
-            }
-          },
-          404: { description: 'Tool not found' },
-          500: { description: 'Execution error' }
-        }
-      }
-    };
-  }
-
-  // 保存为 YAML
-  const yamlContent = yaml.dump(openapi, { lineWidth: -1 });
-  fs.writeFileSync('openapi.yml', yamlContent);
-  console.log('✅ Generated: openapi.yml');
-}
-
-generateOpenAPI().catch(console.error);

package/jest.config.js

@@ -1,13 +0,0 @@
-// Copyright 2026 CiCy AI
-// SPDX-License-Identifier: Apache-2.0
-
-module.exports = {
-  testEnvironment: "node",
-  testMatch: ["<rootDir>/tests/**/*.test.js"],
-  testTimeout: 30000,
-  maxWorkers: 1,
-  globalSetup: "<rootDir>/jest.setup.global.js",
-  globalTeardown: "<rootDir>/jest.teardown.global.js",
-  forceExit: true,
-  detectOpenHandles: false,
-};

package/jest.setup.global.js

@@ -1,16 +0,0 @@
-// Copyright 2026 CiCy AI
-// SPDX-License-Identifier: Apache-2.0
-
-const { startTestServer } = require('./tests/mcp/setup-test-server');
-
-module.exports = async () => {
-  console.log('\n🚀 Starting test server...\n');
-  try {
-    await startTestServer();
-    console.log('\n✅ Test server ready\n');
-  } catch (error) {
-    console.error('\n❌ Failed to start test server:', error.message);
-    console.log('\n⚠️  Continuing without SSE connection...\n');
-    // 不抛出错误，让测试继续（服务器已启动，只是 SSE 连接失败）
-  }
-};

package/jest.teardown.global.js

@@ -1,10 +0,0 @@
-// Copyright 2026 CiCy AI
-// SPDX-License-Identifier: Apache-2.0
-
-const { stopTestServer } = require('./tests/mcp/setup-test-server');
-
-module.exports = async () => {
-  console.log('\n🛑 Stopping test server...\n');
-  await stopTestServer();
-  console.log('\n✅ Test server stopped\n');
-};

package/service.sh

@@ -1,164 +0,0 @@
-#!/bin/bash
-
-# CiCy Desktop 服务管理脚本
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-PROJECT_DIR="$SCRIPT_DIR"
-PID_FILE="$PROJECT_DIR/.cicy-desktop.pid"
-LOG_FILE="$HOME/logs/cicy-desktop-service.log"
-
-# 创建日志目录
-mkdir -p "$(dirname "$LOG_FILE")"
-
-# 显示帮助信息
-show_help() {
-    echo "CiCy Desktop 服务管理"
-    echo ""
-    echo "用法: $0 {start|stop|restart|status|logs}"
-    echo ""
-    echo "命令:"
-    echo "  start   - 启动服务"
-    echo "  stop    - 停止服务"
-    echo "  restart - 重启服务"
-    echo "  status  - 查看状态"
-    echo "  logs    - 查看日志"
-    echo ""
-}
-
-# 启动服务
-start_service() {
-    if [ -f "$PID_FILE" ]; then
-        local pid=$(cat "$PID_FILE")
-        if ps -p "$pid" > /dev/null 2>&1; then
-            echo "✅ 服务已在运行 (PID: $pid)"
-            return 0
-        else
-            rm -f "$PID_FILE"
-        fi
-    fi
-
-    echo "🚀 正在启动 CiCy Desktop 服务..."
-    
-    cd "$PROJECT_DIR"
-    
-    # 检查依赖
-    if [ ! -d "node_modules" ]; then
-        echo "📦 正在安装依赖..."
-        npm install
-    fi
-    
-    # 后台启动服务
-    nohup npm start > "$LOG_FILE" 2>&1 &
-    local pid=$!
-    
-    # 保存 PID
-    echo "$pid" > "$PID_FILE"
-    
-    # 等待服务启动
-    sleep 3
-    
-    if ps -p "$pid" > /dev/null 2>&1; then
-        echo "✅ 服务启动成功 (PID: $pid)"
-        echo "📋 端口: 8101"
-        echo "📋 日志: $LOG_FILE"
-        echo "📋 MCP 端点: http://localhost:8101/mcp"
-        echo "📋 API 文档: http://localhost:8101/docs"
-    else
-        echo "❌ 服务启动失败"
-        rm -f "$PID_FILE"
-        return 1
-    fi
-}
-
-# 停止服务
-stop_service() {
-    if [ ! -f "$PID_FILE" ]; then
-        echo "⚠️  服务未运行"
-        return 0
-    fi
-    
-    local pid=$(cat "$PID_FILE")
-    
-    if ps -p "$pid" > /dev/null 2>&1; then
-        echo "🛑 正在停止服务 (PID: $pid)..."
-        kill "$pid"
-        
-        # 等待进程结束
-        local count=0
-        while ps -p "$pid" > /dev/null 2>&1 && [ $count -lt 10 ]; do
-            sleep 1
-            count=$((count + 1))
-        done
-        
-        if ps -p "$pid" > /dev/null 2>&1; then
-            echo "⚠️  强制停止服务..."
-            kill -9 "$pid"
-        fi
-        
-        echo "✅ 服务已停止"
-    else
-        echo "⚠️  服务进程不存在"
-    fi
-    
-    rm -f "$PID_FILE"
-}
-
-# 查看状态
-show_status() {
-    if [ -f "$PID_FILE" ]; then
-        local pid=$(cat "$PID_FILE")
-        if ps -p "$pid" > /dev/null 2>&1; then
-            echo "✅ 服务运行中 (PID: $pid)"
-            echo "📋 端口: 8101"
-            echo "📋 日志: $LOG_FILE"
-            
-            # 检查端口是否监听
-            if lsof -i :8101 > /dev/null 2>&1; then
-                echo "📋 端口 8101 正在监听"
-            else
-                echo "⚠️  端口 8101 未监听"
-            fi
-        else
-            echo "❌ 服务进程不存在 (PID 文件存在但进程已死)"
-            rm -f "$PID_FILE"
-        fi
-    else
-        echo "⚠️  服务未运行"
-    fi
-}
-
-# 查看日志
-show_logs() {
-    if [ -f "$LOG_FILE" ]; then
-        echo "📋 日志文件: $LOG_FILE"
-        echo "----------------------------------------"
-        tail -f "$LOG_FILE"
-    else
-        echo "⚠️  日志文件不存在: $LOG_FILE"
-    fi
-}
-
-# 主逻辑
-case "$1" in
-    start)
-        start_service
-        ;;
-    stop)
-        stop_service
-        ;;
-    restart)
-        stop_service
-        sleep 2
-        start_service
-        ;;
-    status)
-        show_status
-        ;;
-    logs)
-        show_logs
-        ;;
-    *)
-        show_help
-        exit 1
-        ;;
-esac

package/update-desktop.sh

@@ -1,33 +0,0 @@
-#!/bin/bash
-
-echo "🔄 更新桌面启动脚本..."
-
-# 设置路径
-DESKTOP_FILE="$HOME/Desktop/cicy-desktop.command"
-SOURCE_FILE="./cicy-desktop-simple.command"
-
-# 备份现有文件
-if [ -f "$DESKTOP_FILE" ]; then
-    echo "📋 备份现有文件..."
-    cp "$DESKTOP_FILE" "$DESKTOP_FILE.old"
-fi
-
-# 复制新文件
-echo "📁 复制新文件..."
-cp "$SOURCE_FILE" "$DESKTOP_FILE"
-
-# 设置权限
-echo "🔐 设置执行权限..."
-chmod +x "$DESKTOP_FILE"
-
-# 验证
-if [ -f "$DESKTOP_FILE" ] && [ -x "$DESKTOP_FILE" ]; then
-    echo "✅ 更新完成！"
-    echo "📁 文件: $DESKTOP_FILE"
-    echo "🔐 权限: $(ls -l "$DESKTOP_FILE" | cut -d' ' -f1)"
-    echo ""
-    echo "现在可以双击桌面上的 cicy-desktop.command 启动服务了！"
-else
-    echo "❌ 更新失败"
-    exit 1
-fi