@agentunion/kite 1.5.0 → 1.6.0

package/main.py

@@ -12,6 +12,12 @@ from pathlib import Path
 project_root = Path(__file__).parent
 sys.path.insert(0, str(project_root))
 
+# --stop: 停止运行中的 Kite 实例，跳过正常启动流程
+if "--stop" in sys.argv:
+    from launcher.entry import stop_instances
+    stop_instances()
+    sys.exit(0)
+
 # 1. Run code stats
 from launcher.count_lines import run_stats
 run_stats()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentunion/kite",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "description": "Kite framework launcher — start Kite from anywhere",
   "bin": {
     "kite": "./cli.js"
@@ -20,6 +20,9 @@
     "kite_cli/**",
     "scripts/**",
     "core/**",
+    "docs/*.md",
+    "docs/Kite框架设计/**",
+    ".claude/skills/kite/**",
     "CHANGELOG.md",
     "!**/__pycache__",
     "!**/__pycache__/**",

package/requirements.txt

@@ -1,38 +1,41 @@
-# Kite 框架核心依赖
-# 安装方法：pip install -r requirements.txt
-
-# Web 框架
-fastapi>=0.115.0
-uvicorn>=0.32.0
-starlette>=0.41.0
-
-# WebSocket
-websockets>=13.0
-
-# HTTP 客户端
-httpx>=0.27.0
-aiohttp>=3.10.0
-requests>=2.32.0
-
-# 配置解析
-json5>=0.9.25
-pyyaml>=6.0.2
-python-dotenv>=1.0.0
-
-# 数据验证
-pydantic>=2.9.0
-
-# 异步 IO
-aiofiles>=24.1.0
-
-# 进程管理
-psutil>=6.1.0
-
-# 加密
-cryptography>=43.0.0
-
-# 进度条
-tqdm>=4.66.0
-
-# 类型扩展
-typing-extensions>=4.12.0
+# Kite 框架核心依赖
+# 安装方法：pip install -r requirements.txt
+
+# Web 框架
+fastapi>=0.115.0
+uvicorn>=0.32.0
+starlette>=0.41.0
+
+# WebSocket
+websockets>=13.0
+
+# HTTP 客户端
+httpx>=0.27.0
+aiohttp>=3.10.0
+requests>=2.32.0
+
+# 配置解析
+json5>=0.9.25
+pyyaml>=6.0.2
+python-dotenv>=1.0.0
+
+# 数据验证
+pydantic>=2.9.0
+
+# 异步 IO
+aiofiles>=24.1.0
+
+# 进程管理
+psutil>=6.1.0
+
+# SSL 证书
+certifi>=2023.7.22
+
+# 加密
+cryptography>=43.0.0
+
+# 进度条
+tqdm>=4.66.0
+
+# 类型扩展
+typing-extensions>=4.12.0

package/scripts/auto-fix-deps.py

@@ -0,0 +1,128 @@
+#!/usr/bin/env python3
+"""
+依赖自动修复模块
+捕获 ModuleNotFoundError 并自动安装缺失的依赖
+"""
+
+import sys
+import subprocess
+import importlib
+from typing import Optional
+
+
+class AutoFixImporter:
+    """自动修复缺失依赖的导入钩子"""
+
+    def __init__(self, pip_index: Optional[str] = None):
+        """
+        Args:
+            pip_index: PyPI 镜像源 URL，如 https://mirrors.aliyun.com/pypi/simple
+        """
+        self.pip_index = pip_index or "https://mirrors.aliyun.com/pypi/simple"
+        self.installed_packages = set()
+        self.failed_packages = set()
+
+    def find_spec(self, fullname, path, target=None):
+        """importlib 钩子：在模块找不到时触发"""
+        # 只处理顶级包名
+        package_name = fullname.split('.')[0]
+
+        # 跳过已安装或已失败的包
+        if package_name in self.installed_packages or package_name in self.failed_packages:
+            return None
+
+        # 跳过内置模块和标准库
+        if package_name in sys.builtin_module_names:
+            return None
+
+        # 尝试自动安装
+        if self._auto_install(package_name):
+            self.installed_packages.add(package_name)
+            # 重新加载模块
+            try:
+                return importlib.util.find_spec(fullname)
+            except (ImportError, ModuleNotFoundError):
+                pass
+        else:
+            self.failed_packages.add(package_name)
+
+        return None
+
+    def _auto_install(self, package_name: str) -> bool:
+        """
+        自动安装缺失的包
+
+        Args:
+            package_name: 包名
+
+        Returns:
+            是否安装成功
+        """
+        # 包名映射（import 名 → pip 包名）
+        package_mapping = {
+            'cv2': 'opencv-python',
+            'PIL': 'Pillow',
+            'sklearn': 'scikit-learn',
+            'yaml': 'PyYAML',
+        }
+
+        pip_package = package_mapping.get(package_name, package_name)
+
+        print(f"[AutoFix] 检测到缺失依赖: {package_name}", file=sys.stderr)
+        print(f"[AutoFix] 正在安装: {pip_package}", file=sys.stderr)
+
+        try:
+            subprocess.check_call(
+                [sys.executable, '-m', 'pip', 'install', pip_package, '-i', self.pip_index],
+                stdout=subprocess.DEVNULL,
+                stderr=subprocess.PIPE,
+                timeout=120
+            )
+            print(f"[AutoFix] ✓ 安装成功: {pip_package}", file=sys.stderr)
+            return True
+        except subprocess.CalledProcessError as e:
+            print(f"[AutoFix] ✗ 安装失败: {pip_package}", file=sys.stderr)
+            if e.stderr:
+                print(f"[AutoFix] 错误: {e.stderr.decode('utf-8', errors='ignore')}", file=sys.stderr)
+            return False
+        except subprocess.TimeoutExpired:
+            print(f"[AutoFix] ✗ 安装超时: {pip_package}", file=sys.stderr)
+            return False
+        except Exception as e:
+            print(f"[AutoFix] ✗ 安装异常: {e}", file=sys.stderr)
+            return False
+
+
+def enable_auto_fix(pip_index: Optional[str] = None):
+    """
+    启用依赖自动修复
+
+    Args:
+        pip_index: PyPI 镜像源 URL
+
+    Example:
+        >>> from scripts.auto_fix_deps import enable_auto_fix
+        >>> enable_auto_fix()
+        >>> import some_missing_package  # 会自动安装
+    """
+    importer = AutoFixImporter(pip_index)
+    sys.meta_path.insert(0, importer)
+    print("[AutoFix] 依赖自动修复已启用", file=sys.stderr)
+
+
+def disable_auto_fix():
+    """禁用依赖自动修复"""
+    sys.meta_path = [imp for imp in sys.meta_path if not isinstance(imp, AutoFixImporter)]
+    print("[AutoFix] 依赖自动修复已禁用", file=sys.stderr)
+
+
+if __name__ == '__main__':
+    # 测试
+    enable_auto_fix()
+
+    # 尝试导入一个不存在的包
+    try:
+        import requests  # 如果没安装会自动安装
+        print("requests 版本:", requests.__version__)
+    except ImportError as e:
+        print("导入失败:", e)

package/scripts/env-manager.js

@@ -40,6 +40,29 @@ function getEnvStatusPath() {
   return path.join(getKiteDataPath(), 'env_status.json');
 }
 
+/**
+ * 获取 Python 命令路径
+ * Windows 下优先使用自管理的 Python 完整路径，避免 App Execution Aliases 劫持
+ */
+function getPythonCommand() {
+  if (process.platform === 'win32') {
+    // Windows: 优先使用 ~/.kite/python/Scripts/python.exe（虚拟环境）
+    const venvPython = path.join(getKiteDataPath(), 'python', 'Scripts', 'python.exe');
+    if (fs.existsSync(venvPython)) {
+      return venvPython;
+    }
+
+    // 降级：~/.kite/python/python.exe（embed 或 official 安装）
+    const kitePython = path.join(getKiteDataPath(), 'python', 'python.exe');
+    if (fs.existsSync(kitePython)) {
+      return kitePython;
+    }
+
+    return 'python';
+  }
+  return 'python3';
+}
+
 /**
  * 读取环境状态
  */
@@ -175,7 +198,7 @@ function needsDepsInstall(status) {
 function setupVenv(versionDir) {
   log('准备虚拟环境...', 'cyan');
 
-  const pythonCmd = process.platform === 'win32' ? 'python' : 'python3';
+  const pythonCmd = getPythonCommand();
 
   try {
     const result = spawnSync(
@@ -205,7 +228,7 @@ function setupVenv(versionDir) {
 function installDeps(versionDir) {
   log('安装依赖库...', 'cyan');
 
-  const pythonCmd = process.platform === 'win32' ? 'python' : 'python3';
+  const pythonCmd = getPythonCommand();
 
   try {
     const result = spawnSync(

package/scripts/final-test.js

@@ -0,0 +1,78 @@
+const { execSync } = require('child_process');
+const path = require('path');
+const os = require('os');
+const fs = require('fs');
+
+const installerPath = path.join(os.tmpdir(), 'python-3.13.12-amd64.exe');
+const installPath = path.join(os.homedir(), '.kite', 'python');
+const logPath = path.join(os.tmpdir(), 'python-final-test.log');
+
+console.log('=== 最终测试：先卸载再安装 ===\n');
+
+// 步骤1：卸载
+console.log('步骤1：卸载旧版本（清理注册表）');
+try {
+  execSync(`"${installerPath}" /uninstall /quiet`, {
+    stdio: 'pipe',
+    timeout: 60000,
+    shell: 'cmd.exe'
+  });
+  console.log('卸载命令执行完成');
+} catch (e) {
+  console.log('卸载失败或无旧版本:', e.message);
+}
+
+// 等待2秒
+console.log('等待2秒...\n');
+execSync('node -e "setTimeout(() => {}, 2000)"', { stdio: 'pipe' });
+
+// 步骤2：安装
+console.log('步骤2：安装到指定目录');
+console.log('目标:', installPath);
+
+const installArgs = [
+  '/quiet',
+  '/log', logPath,
+  'InstallAllUsers=0',
+  `TargetDir=${installPath}`,
+  'PrependPath=0',
+  'Include_pip=1',
+  'Include_test=0'
+].join(' ');
+
+console.log('命令:', `"${installerPath}" ${installArgs}\n`);
+
+try {
+  execSync(`"${installerPath}" ${installArgs}`, {
+    stdio: 'inherit',
+    timeout: 180000,
+    shell: 'cmd.exe'
+  });
+  console.log('安装命令执行完成');
+} catch (e) {
+  console.error('安装失败:', e.message);
+}
+
+// 等待10秒
+console.log('\n等待10秒...');
+execSync('node -e "setTimeout(() => {}, 10000)"', { stdio: 'pipe' });
+
+// 检查结果
+console.log('\n=== 检查结果 ===');
+const pythonExe = path.join(installPath, 'python.exe');
+console.log('python.exe 存在:', fs.existsSync(pythonExe));
+
+// 检查日志中的关键信息
+if (fs.existsSync(logPath)) {
+  const log = fs.readFileSync(logPath, 'utf-8');
+  const lines = log.split('\n');
+  
+  console.log('\n=== 关键日志 ===');
+  lines.forEach(line => {
+    if (line.includes('WixBundleAction') || 
+        line.includes('WixBundleInstalled') ||
+        line.includes('Exit code')) {
+      console.log(line);
+    }
+  });
+}