@agentunion/kite 1.3.2 → 1.5.0

package/kite_cli/commands/env_check.py

@@ -0,0 +1,45 @@
+"""
+kite env-check 命令
+
+环境检查和准备：
+1. 检查虚拟环境是否存在
+2. 检查依赖库是否安装且版本一致
+3. 创建虚拟环境（如果需要）
+4. 安装依赖库（如果需要）
+"""
+
+import sys
+from pathlib import Path
+
+
+def run_env_check(args):
+    """执行环境检查"""
+    # 导入环境检查器
+    project_root = Path(__file__).parent.parent.parent
+
+    # 添加到 sys.path
+    sys.path.insert(0, str(project_root))
+
+    # 导入并执行环境检查
+    from core.env_checker import check_environment
+
+    print("=" * 60)
+    print("  Kite 环境检查")
+    print("=" * 60)
+    print()
+
+    try:
+        success = check_environment()
+
+        if success:
+            print("\n✓ 环境检查通过")
+            return 0
+        else:
+            print("\n✗ 环境检查失败")
+            return 1
+
+    except Exception as e:
+        print(f"\n✗ 环境检查异常: {e}")
+        import traceback
+        traceback.print_exc()
+        return 1

package/kite_cli/commands/history.py

@@ -0,0 +1,111 @@
+"""history 命令实现 - 显示最近安装的模块"""
+from kite_cli.utils.operation_log import read_operations
+from kite_cli.utils.i18n import t
+
+
+def run_history(args):
+    """执行历史查看命令"""
+    limit = args.limit if hasattr(args, 'limit') else 6
+    show_all = args.all if hasattr(args, 'all') else False
+
+    # 读取操作日志
+    operations = read_operations(limit=100)  # 读取更多记录用于过滤
+
+    if not operations:
+        print("[Info] 暂无安装记录")
+        return 0
+
+    # 只保留成功的 install 操作
+    install_ops = []
+    seen_modules = set()  # 用于去重
+
+    for op in reversed(operations):  # 从最新到最旧
+        if op.get("operation") == "install" and op.get("success"):
+            details = op.get("details", {})
+            module_name = details.get("module")
+
+            if not module_name:
+                continue
+
+            # 检查是否已被卸载(在此操作之后)
+            is_uninstalled = False
+            for later_op in operations:
+                if later_op.get("timestamp") > op.get("timestamp"):
+                    if later_op.get("operation") == "uninstall" and later_op.get("success"):
+                        uninstall_details = later_op.get("details", {})
+                        if uninstall_details.get("module") == module_name:
+                            is_uninstalled = True
+                            break
+
+            # 如果 show_all=False,只显示未卸载的;如果 show_all=True,显示所有
+            if show_all or not is_uninstalled:
+                # 去重:同一个模块只显示最近一次安装
+                if module_name not in seen_modules:
+                    seen_modules.add(module_name)
+                    install_ops.append({
+                        "timestamp": op.get("timestamp"),
+                        "module": module_name,
+                        "version": details.get("version", "unknown"),
+                        "location": details.get("location", "unknown"),
+                        "source_type": details.get("source", {}).get("type", "unknown"),
+                        "path": details.get("path", ""),
+                        "is_uninstalled": is_uninstalled
+                    })
+
+                    if len(install_ops) >= limit:
+                        break
+
+    if not install_ops:
+        print("[Info] 暂无安装记录")
+        return 0
+
+    print(f"\n[History] 最近安装的 {len(install_ops)} 个模块:\n")
+
+    for i, op in enumerate(install_ops, 1):
+        timestamp = op["timestamp"][:19].replace("T", " ")
+        module = op["module"]
+        version = op["version"]
+        location = op["location"]
+        source_type = op["source_type"]
+        is_uninstalled = op["is_uninstalled"]
+
+        # 状态标记
+        status = "[已卸载]" if is_uninstalled else "[已安装]"
+
+        # 位置标记
+        location_map = {
+            "dev": "开发",
+            "local": "本地",
+            "global": "全局"
+        }
+        location_str = location_map.get(location, location)
+
+        print(f"{i}. {module} v{version}")
+        print(f"   时间: {timestamp}")
+        print(f"   位置: {location_str} ({location})")
+        print(f"   来源: {source_type}")
+        print(f"   状态: {status}")
+
+        # 如果未卸载,显示卸载命令
+        if not is_uninstalled:
+            print(f"   卸载: kite uninstall {module}")
+            if location != "global":
+                print(f"         kite uninstall {module} -l {location}")
+
+        print()
+
+    # 显示快速卸载提示
+    if not show_all:
+        active_modules = [op["module"] for op in install_ops if not op["is_uninstalled"]]
+        if active_modules:
+            print("[Tip] 快速卸载最近安装的模块:")
+            for module in active_modules[:3]:  # 只显示前3个
+                print(f"  kite uninstall {module}")
+            print()
+
+    # 显示查看所有历史的提示
+    if not show_all and len(operations) > limit:
+        print("[Tip] 查看所有历史记录(包括已卸载): kite history --all")
+        print("[Tip] 查看更多记录: kite history -n 20")
+
+    return 0

package/kite_cli/commands/info.py

@@ -0,0 +1,96 @@
+"""info 命令实现"""
+from pathlib import Path
+from kite_cli.utils.paths import get_install_path
+from kite_cli.core.validator import Validator
+from kite_cli.core.install_info import read_install_info
+from kite_cli.utils.i18n import t
+
+
+def run_info(args):
+    """执行 info 命令"""
+    module_name = args.name
+    location = args.location if hasattr(args, 'location') else None
+
+    print(t('module_info', name=module_name) + "\n")
+
+    # 查找模块
+    if location:
+        locations = [location]
+    else:
+        locations = find_module_locations(module_name)
+        if not locations:
+            print(t('module_not_found', name=module_name))
+            return 1
+
+    # 显示所有找到的位置
+    for loc in locations:
+        module_path = get_install_path(loc, module_name)
+        show_module_info(module_path, loc)
+        print()
+
+    return 0
+
+
+def show_module_info(module_path: Path, location: str):
+    """显示模块详细信息"""
+    location_key = f"info_location_{location}"
+    location_name = t(location_key)
+
+    print(f"【{location_name}】")
+    print(f"{t('info_path')}: {module_path}")
+
+    # 读取 module.md
+    module_md = Validator.find_module_md(module_path)
+    if not module_md:
+        print(t('info_no_module_md'))
+        return
+
+    module_data = Validator.parse_module_md(module_md)
+    if not module_data:
+        print(t('info_parse_failed'))
+        return
+
+    # 基本信息
+    print(f"{t('info_name')}: {module_data.get('name', 'unknown')}")
+    print(f"{t('info_display_name')}: {module_data.get('display_name', module_data.get('name', 'unknown'))}")
+    print(f"{t('info_version')}: {module_data.get('version', 'unknown')}")
+    print(f"{t('info_type')}: {module_data.get('type', 'unknown')}")
+    print(f"{t('info_runtime')}: {module_data.get('runtime', 'unknown')}")
+    print(f"{t('info_entry')}: {module_data.get('entry', 'unknown')}")
+    print(f"{t('info_state')}: {module_data.get('state', 'unknown')}")
+
+    # 依赖信息
+    dependencies = module_data.get("dependencies", {})
+    if dependencies:
+        print(f"\n{t('info_dependencies')}:")
+        if dependencies.get("python"):
+            print(f"  Python: {', '.join(dependencies['python'])}")
+        if dependencies.get("npm"):
+            print(f"  npm: {', '.join(dependencies['npm'])}")
+        if dependencies.get("kite"):
+            print(f"  Kite: {', '.join(dependencies['kite'])}")
+
+    # 安装信息
+    install_info = read_install_info(module_path)
+    if install_info:
+        print(f"\n{t('info_install_info')}:")
+        source = install_info.get("source", {})
+        print(f"  {t('info_source')}: {source.get('type', 'unknown')}")
+        if source.get("package"):
+            print(f"  {t('info_package')}: {source['package']}")
+        if source.get("url"):
+            print(f"  {t('info_url')}: {source['url']}")
+        print(f"  {t('info_installed_at')}: {install_info.get('installed_at', 'unknown')}")
+
+
+def find_module_locations(module_name: str):
+    """查找模块在哪些位置存在"""
+    locations = []
+    for loc in ["dev", "local", "global"]:
+        try:
+            module_path = get_install_path(loc, module_name)
+            if module_path.exists():
+                locations.append(loc)
+        except Exception:
+            pass
+    return locations

package/kite_cli/commands/install.py

@@ -0,0 +1,313 @@
+"""install 命令实现"""
+import os
+import tempfile
+import shutil
+from pathlib import Path
+from kite_cli.core.checker import PlatformChecker
+from kite_cli.core.downloader import Downloader
+from kite_cli.core.validator import Validator
+from kite_cli.core.dependency import DependencyInstaller
+from kite_cli.core.install_info import record_install_info
+from kite_cli.utils.interactive import select_source, select_location, confirm_action
+from kite_cli.utils.paths import get_install_path
+from kite_cli.utils.i18n import t
+from kite_cli.utils.operation_log import log_operation
+from kite_cli.utils.version import parse_version_spec, filter_versions, get_latest_version
+
+
+def run_install(args):
+    """执行安装命令"""
+    source = args.source
+    location = args.location
+    from_platform = args.from_platform
+    skip_confirm = args.yes
+    no_deps = args.no_deps
+
+    # 如果没有指定 source，检查当前目录
+    if not source:
+        cwd = Path.cwd()
+        module_md = cwd / "module.md"
+
+        if module_md.exists():
+            print(f"[Info] 检测到当前目录包含 module.md")
+            source = str(cwd)
+            from_platform = "local"
+            print(f"[Info] 将安装当前目录: {source}")
+        else:
+            print("[Error] 缺少参数 <source>")
+            print("[Info] 请指定模块名，或在包含 module.md 的目录下执行")
+            print("[Info] 示例:")
+            print("  kite install requests          # 安装 PyPI/npm 包")
+            print("  kite install ./my-module       # 安装本地模块")
+            print("  kite install                   # 在模块目录下安装当前目录")
+            return 1
+
+    # 解析版本号 (如 pkg@1.2.0)
+    package_name, version_spec = parse_version_spec(source)
+
+    # 保留名称检查 - 防止安装 Kite 框架本身或核心组件
+    RESERVED_NAMES = ['kite', 'launcher', 'kernel', 'core']
+
+    # 提取模块名（去除路径、URL等）
+    module_name = package_name.lower().strip()
+    if '/' in module_name:
+        module_name = module_name.split('/')[-1]
+    if module_name.endswith('.git'):
+        module_name = module_name[:-4]
+
+    # 只检查完全匹配的保留名称
+    if module_name in RESERVED_NAMES:
+        print(t('reserved_name_error', name=source))
+        print(t('reserved_name_hint', name=module_name))
+        print(t('update_framework_hint'))
+        return 1
+
+    if version_spec:
+        print(t('searching_module', name=f"{package_name}@{version_spec}"))
+    else:
+        print(t('searching_module', name=package_name))
+
+    # 步骤 1: 检查各平台
+    if from_platform:
+        # 指定了平台，只检查该平台
+        candidates = check_single_platform(package_name, from_platform, version_spec)
+    else:
+        # 未指定平台，检查所有平台
+        candidates = check_all_platforms(package_name, version_spec)
+
+    if not candidates:
+        print(t('module_not_found', name=source))
+        return 1
+
+    # 步骤 2: 用户选择来源（如果有多个）
+    if len(candidates) > 1:
+        selected = select_source(candidates)
+        if not selected:
+            print("[Cancelled] 已取消")
+            return 1
+    else:
+        selected = candidates[0]
+
+    print(t('select_source', platform=selected['platform'], name=selected.get('name', source)))
+
+    # 步骤 3: 下载到临时目录
+    temp_dir = Path(tempfile.mkdtemp(prefix="kite-install-"))
+    try:
+        print(t('downloading'))
+        downloaded_dir, error = download_module(selected, temp_dir)
+        if not downloaded_dir:
+            print(t('download_failed'))
+            if error:
+                print(f"  {error}")
+            return 1
+
+        print(t('download_complete', path=downloaded_dir))
+
+        # 步骤 4: 验证 module.md
+        print(t('validating'))
+
+        # 对于本地安装，不验证模块名，直接读取 module.md
+        if selected["platform"] == "local":
+            module_md = Validator.find_module_md(downloaded_dir)
+            if not module_md:
+                print(t('validation_failed', error="未找到 module.md"))
+                return 1
+            module_data = Validator.parse_module_md(module_md)
+            if not module_data or not module_data.get("name"):
+                print(t('validation_failed', error="无法解析 module.md 或缺少 name 字段"))
+                return 1
+        else:
+            # 其他平台需要验证模块名匹配
+            valid, error, module_data = Validator.validate_module(downloaded_dir, source)
+            if not valid:
+                print(t('validation_failed', error=error))
+                return 1
+
+        print(t('validation_passed', name=module_data.get('name'), version=module_data.get('version', 'unknown')))
+
+        # 步骤 5: 选择安装位置
+        if not location:
+            location = select_location()
+            if not location:
+                print("[Cancelled] 已取消")
+                return 1
+
+        # 步骤 6: 检查冲突
+        install_path = get_install_path(location, module_data['name'])
+        if install_path.exists():
+            if not skip_confirm:
+                if not confirm_action(f"模块 {module_data['name']} 已存在，是否覆盖？"):
+                    print("[Cancelled] 已取消")
+                    return 1
+            print("[Warning] 删除旧版本...")
+            shutil.rmtree(install_path)
+
+        # 步骤 7: 安装依赖
+        if not no_deps:
+            print(t('installing_deps'))
+            if not DependencyInstaller.install_all_deps(downloaded_dir, module_data, location, no_deps):
+                print(t('deps_failed'))
+                if not skip_confirm:
+                    if not confirm_action("是否继续安装模块（不含依赖）？"):
+                        return 1
+                else:
+                    return 1
+
+        # 步骤 8: 复制到目标位置
+        print(t('installing_to', path=install_path))
+        install_path.parent.mkdir(parents=True, exist_ok=True)
+        shutil.copytree(downloaded_dir, install_path)
+
+        # 步骤 9: 记录安装信息
+        source_info = {
+            "type": selected["platform"],
+            "name": selected.get("name", source),
+        }
+        if selected["platform"] == "pypi":
+            source_info["package"] = selected["name"]
+            source_info["version"] = selected.get("latest")
+        elif selected["platform"] == "npm":
+            source_info["package"] = selected["name"]
+            source_info["version"] = selected.get("latest")
+        elif selected["platform"] == "git":
+            source_info["url"] = selected["url"]
+            source_info["full_name"] = selected.get("full_name")
+        elif selected["platform"] == "local":
+            source_info["path"] = selected["path"]
+
+        record_install_info(install_path, source_info, module_data, location)
+
+        # 记录操作日志
+        log_operation("install", {
+            "module": module_data['name'],
+            "version": module_data.get('version', 'unknown'),
+            "source": source_info,
+            "location": location,
+            "path": str(install_path)
+        }, success=True)
+
+        print(t('install_complete'))
+        print(t('restart_hint'))
+
+        return 0
+
+    except Exception as e:
+        # 记录失败日志
+        log_operation("install", {
+            "source": source,
+            "location": location
+        }, success=False, error=str(e))
+        raise
+
+    finally:
+        # 清理临时目录
+        shutil.rmtree(temp_dir, ignore_errors=True)
+
+
+def check_single_platform(source: str, platform: str, version_spec: str = None):
+    """检查单个平台"""
+    candidates = []
+
+    if platform == "pypi":
+        result = PlatformChecker.check_pypi(source)
+        if result:
+            # 根据版本规范过滤
+            if version_spec:
+                matched_versions = filter_versions(result.get("versions", []), version_spec)
+                if matched_versions:
+                    result["matched_version"] = matched_versions[0]  # 选择最新的匹配版本
+                    result["version_spec"] = version_spec
+                    candidates.append(result)
+            else:
+                candidates.append(result)
+
+    elif platform == "npm":
+        result = PlatformChecker.check_npm(source)
+        if result:
+            # 根据版本规范过滤
+            if version_spec:
+                matched_versions = filter_versions(result.get("versions", []), version_spec)
+                if matched_versions:
+                    result["matched_version"] = matched_versions[0]
+                    result["version_spec"] = version_spec
+                    candidates.append(result)
+            else:
+                candidates.append(result)
+
+    elif platform == "git":
+        results = PlatformChecker.check_git(source)
+        if results:
+            candidates.extend(results)
+
+    elif platform == "local":
+        # 本地路径直接返回
+        if Path(source).exists():
+            candidates.append({
+                "platform": "local",
+                "path": source
+            })
+
+    return candidates
+
+
+def check_all_platforms(source: str, version_spec: str = None):
+    """检查所有平台"""
+    candidates = []
+
+    # 先检查是否是本地路径
+    if Path(source).exists():
+        candidates.append({
+            "platform": "local",
+            "path": source,
+            "name": Path(source).name
+        })
+        return candidates
+
+    # 并行检查 PyPI/npm/Git
+    results = PlatformChecker.check_all(source)
+
+    if results["pypi"]:
+        result = results["pypi"]
+        # 根据版本规范过滤
+        if version_spec:
+            matched_versions = filter_versions(result.get("versions", []), version_spec)
+            if matched_versions:
+                result["matched_version"] = matched_versions[0]
+                result["version_spec"] = version_spec
+                candidates.append(result)
+        else:
+            candidates.append(result)
+
+    if results["npm"]:
+        result = results["npm"]
+        # 根据版本规范过滤
+        if version_spec:
+            matched_versions = filter_versions(result.get("versions", []), version_spec)
+            if matched_versions:
+                result["matched_version"] = matched_versions[0]
+                result["version_spec"] = version_spec
+                candidates.append(result)
+        else:
+            candidates.append(result)
+
+    if results["git"]:
+        candidates.extend(results["git"])
+
+    return candidates
+
+
+def download_module(selected: dict, temp_dir: Path):
+    """根据选择的来源下载模块"""
+    platform = selected["platform"]
+    version = selected.get("matched_version") or selected.get("latest")
+
+    if platform == "pypi":
+        return Downloader.download_pypi(selected["name"], temp_dir, version)
+    elif platform == "npm":
+        return Downloader.download_npm(selected["name"], temp_dir, version)
+    elif platform == "git":
+        return Downloader.download_git(selected["url"], temp_dir)
+    elif platform == "local":
+        return Downloader.download_local(selected["path"], temp_dir)
+
+    return None, "未知的平台类型"