@agentunion/kite 1.3.1 → 1.4.0

package/kite_cli/main.py

@@ -0,0 +1,289 @@
+#!/usr/bin/env python3
+"""Kite CLI 主入口"""
+import sys
+import argparse
+from kite_cli import __version__
+from kite_cli.utils.i18n import t
+
+
+KNOWN_COMMANDS = ["install", "uninstall", "update", "list", "search", "info", "log", "rollback", "clean", "doctor", "history"]
+
+
+class SilentArgumentParser(argparse.ArgumentParser):
+    """覆盖默认错误处理，输出友好提示"""
+    def error(self, message):
+        cmd = self.prog.replace("kite ", "").strip()
+        if cmd == "kite":
+            # 顶层命令错误
+            bad = sys.argv[1] if len(sys.argv) > 1 else ""
+            print(t('error_unknown_command', cmd=bad))
+            print(t('run_help'))
+        else:
+            # 子命令参数错误
+            bad_args = [a for a in sys.argv[2:] if a.startswith("-") and a not in self._option_string_actions]
+            if bad_args:
+                print(t('error_invalid_args', args=' '.join(bad_args)))
+            else:
+                print(f"{t('error_invalid_args', args='')}: {message}")
+            print(t('run_cmd_help', cmd=cmd))
+        sys.exit(1)
+
+HELP_TEXT = f"""
+Kite CLI v{__version__} — 模块安装管理工具
+
+用法:
+  kite <命令> [参数] [选项]
+
+命令:
+  install   <source>    安装模块
+  uninstall <name>      卸载模块
+  update    <name>      更新模块（使用安装时记录的来源）
+  list                  列出已安装的模块
+  search    <keyword>   搜索可用模块
+  info      <name>      显示模块详细信息
+  log                   查看操作日志
+  history               查看最近安装的模块
+  rollback              回滚最后一次操作
+  clean                 清理临时文件和缓存
+  doctor                检查下载工具状态
+
+全局选项:
+  -h, -H, --help        显示此帮助信息
+  -v, -V, --version     显示版本号
+
+安装位置 (-l):
+  dev       开发环境，安装到 {{KITE_PROJECT}}/extensions/
+  local     本地实例，安装到 {{KITE_INSTANCE_DIR}}/extensions/
+  global    全局共享，安装到 {{KITE_MODULES}}（默认 ~/.kite/modules/）
+
+来源平台 (-f):
+  pypi      从 PyPI 下载（pip download）
+  npm       从 npm 下载（npm pack）
+  git       从 Git 仓库克隆
+  local     从本地路径复制
+
+详细用法:
+
+  kite install <source> [选项]
+    -l, --location <dev|local|global>   安装位置（未指定则交互选择）
+    -f, --from <pypi|npm|git|local>     指定平台（未指定则自动检测所有平台）
+    -y, --yes                           跳过确认提示
+    --no-deps                           不安装依赖
+
+    <source> 可以是:
+      - 模块名（如 watchdog-plus）
+      - 模块名@版本（如 requests@2.28.0）
+      - Git URL（如 https://github.com/user/mod.git）
+      - 本地路径（如 ./my-module 或 .）
+      - 省略（在模块目录下自动安装当前目录）
+
+    示例:
+      kite install                                  # 在模块目录下安装当前目录
+      kite install watchdog-plus                    # 自动搜索所有平台
+      kite install requests@2.28.0                  # 安装指定版本
+      kite install watchdog-plus -l global          # 安装到全局
+      kite install watchdog-plus -f pypi -l global  # 指定平台和位置
+      kite install https://github.com/user/mod.git -f git
+      kite install ./my-module -f local -l dev
+      kite install . -l global                      # 安装当前目录到全局
+
+  kite uninstall <name> [选项]
+    -l, --location <dev|local|global>   指定位置（未指定则自动查找）
+    --all                               卸载所有位置的同名模块
+    -y, --yes                           跳过确认提示
+
+    示例:
+      kite uninstall watchdog-plus
+      kite uninstall watchdog-plus -l global
+      kite uninstall watchdog-plus --all
+
+  kite update <name> [选项]
+    -l, --location <dev|local|global>   指定位置
+    --to <version>                      更新到指定版本
+    --all                               更新所有已安装模块
+    -y, --yes                           跳过确认提示
+
+    示例:
+      kite update watchdog-plus
+      kite update watchdog-plus --to 2.0.0
+      kite update --all
+
+  kite list [选项]
+    -l, --location <dev|local|global>   只显示指定位置
+    --all                               显示所有位置（默认）
+    -v, --verbose                       显示详细信息（路径、来源）
+
+    示例:
+      kite list
+      kite list -l global -v
+
+  kite search <keyword> [选项]
+    -f, --from <pypi|npm|git>           只在指定平台搜索
+
+    示例:
+      kite search watchdog
+      kite search backup -f pypi
+
+  kite info <name> [选项]
+    -l, --location <dev|local|global>   指定位置
+
+    示例:
+      kite info watchdog-plus
+"""
+
+
+def print_help():
+    print(HELP_TEXT)
+
+
+def main():
+    # 手动处理 -H / -h / --help / -V / --version，在 argparse 之前
+    if len(sys.argv) > 1 and sys.argv[1] in ("-H", "-h", "--help", "help"):
+        print_help()
+        return 0
+
+    if len(sys.argv) > 1 and sys.argv[1] in ("-V", "-v", "--version", "version"):
+        print(f"kite-cli {__version__}")
+        return 0
+
+    parser = SilentArgumentParser(
+        prog="kite",
+        description="Kite 模块安装管理工具",
+        add_help=False  # 禁用默认 help，使用自定义
+    )
+
+    parser.add_argument("-h", "-H", "--help", action="store_true", help="显示帮助信息")
+    parser.add_argument("-v", "-V", "--version", action="store_true", help="显示版本号")
+
+    subparsers = parser.add_subparsers(dest="command", parser_class=SilentArgumentParser)
+
+    # install 命令
+    install_parser = subparsers.add_parser("install", help="安装模块", add_help=True)
+    install_parser.add_argument("source", nargs="?", help="模块名或下载源（省略则安装当前目录）")
+    install_parser.add_argument("-l", "--location", choices=["dev", "local", "global"], help="安装位置")
+    install_parser.add_argument("-f", "--from", dest="from_platform", choices=["pypi", "npm", "git", "local"], help="指定平台")
+    install_parser.add_argument("-y", "--yes", action="store_true", help="跳过确认")
+    install_parser.add_argument("--no-deps", action="store_true", help="不安装依赖")
+
+    # uninstall 命令
+    uninstall_parser = subparsers.add_parser("uninstall", help="卸载模块", add_help=True)
+    uninstall_parser.add_argument("name", help="模块名")
+    uninstall_parser.add_argument("-l", "--location", choices=["dev", "local", "global"], help="安装位置")
+    uninstall_parser.add_argument("--all", action="store_true", help="卸载所有位置")
+    uninstall_parser.add_argument("-y", "--yes", action="store_true", help="跳过确认")
+
+    # list 命令
+    list_parser = subparsers.add_parser("list", help="列出已安装模块", add_help=True)
+    list_parser.add_argument("-l", "--location", choices=["dev", "local", "global"], help="筛选位置")
+    list_parser.add_argument("--all", action="store_true", help="所有位置")
+    list_parser.add_argument("-v", "--verbose", action="store_true", help="详细信息")
+
+    # search 命令
+    search_parser = subparsers.add_parser("search", help="搜索可用模块", add_help=True)
+    search_parser.add_argument("keyword", help="搜索关键词")
+    search_parser.add_argument("-f", "--from", dest="from_platform", choices=["pypi", "npm", "git"], help="指定平台")
+
+    # update 命令
+    update_parser = subparsers.add_parser("update", help="更新模块", add_help=True)
+    update_parser.add_argument("name", nargs="?", help="模块名")
+    update_parser.add_argument("-l", "--location", choices=["dev", "local", "global"], help="安装位置")
+    update_parser.add_argument("--to", dest="to_version", help="更新到指定版本")
+    update_parser.add_argument("--all", action="store_true", help="更新所有模块")
+    update_parser.add_argument("-y", "--yes", action="store_true", help="跳过确认")
+
+    # info 命令
+    info_parser = subparsers.add_parser("info", help="显示模块详细信息", add_help=True)
+    info_parser.add_argument("name", help="模块名")
+    info_parser.add_argument("-l", "--location", choices=["dev", "local", "global"], help="指定位置")
+
+    # log 命令
+    log_parser = subparsers.add_parser("log", help="查看操作日志", add_help=True)
+    log_parser.add_argument("-n", "--limit", type=int, default=20, help="显示条数（默认 20）")
+    log_parser.add_argument("--path", action="store_true", help="显示日志文件路径")
+
+    # history 命令
+    history_parser = subparsers.add_parser("history", help="查看最近安装的模块", add_help=True)
+    history_parser.add_argument("-n", "--limit", type=int, default=6, help="显示条数（默认 6）")
+    history_parser.add_argument("--all", action="store_true", help="显示所有记录(包括已卸载)")
+
+    # rollback 命令
+    rollback_parser = subparsers.add_parser("rollback", help="回滚最后一次操作", add_help=True)
+    rollback_parser.add_argument("-y", "--yes", action="store_true", help="跳过确认")
+
+    # clean 命令
+    clean_parser = subparsers.add_parser("clean", help="清理临时文件和缓存", add_help=True)
+    clean_parser.add_argument("--all", action="store_true", help="清理所有模块依赖环境")
+    clean_parser.add_argument("-y", "--yes", action="store_true", help="跳过确认")
+
+    # doctor 命令
+    doctor_parser = subparsers.add_parser("doctor", help="检查下载工具状态", add_help=True)
+
+    args, unknown = parser.parse_known_args()
+
+    # 处理全局 --help / --version
+    if args.help:
+        print_help()
+        return 0
+    if args.version:
+        print(f"kite-cli {__version__}")
+        return 0
+
+    # 没有命令 → 显示帮助
+    if not args.command:
+        # 如果有未知参数，说明用户输入了非法命令
+        if unknown:
+            bad = " ".join(unknown)
+            print(f"错误: 未知命令或参数 '{bad}'")
+            print(f"运行 'kite -h' 查看可用命令")
+            return 1
+        print_help()
+        return 0
+
+    # 子命令有未识别参数
+    if unknown:
+        bad = " ".join(unknown)
+        print(f"错误: 无效参数 '{bad}'")
+        print(f"运行 'kite {args.command} --help' 查看用法")
+        return 1
+
+    # 路由到具体命令
+    if args.command == "install":
+        from kite_cli.commands.install import run_install
+        return run_install(args)
+    elif args.command == "uninstall":
+        from kite_cli.commands.uninstall import run_uninstall
+        return run_uninstall(args)
+    elif args.command == "list":
+        from kite_cli.commands.list import run_list
+        return run_list(args)
+    elif args.command == "search":
+        from kite_cli.commands.search import run_search
+        return run_search(args)
+    elif args.command == "update":
+        from kite_cli.commands.update import run_update
+        return run_update(args)
+    elif args.command == "info":
+        from kite_cli.commands.info import run_info
+        return run_info(args)
+    elif args.command == "log":
+        from kite_cli.commands.log import run_log
+        return run_log(args)
+    elif args.command == "history":
+        from kite_cli.commands.history import run_history
+        return run_history(args)
+    elif args.command == "rollback":
+        from kite_cli.commands.rollback import run_rollback
+        return run_rollback(args)
+    elif args.command == "clean":
+        from kite_cli.commands.clean import run_clean
+        return run_clean(args)
+    elif args.command == "doctor":
+        from kite_cli.commands.doctor import run_doctor
+        return run_doctor(args)
+    else:
+        print(f"未知命令: {args.command}")
+        return 1
+
+
+if __name__ == "__main__":
+    sys.exit(main())

package/kite_cli/utils/__init__.py

@@ -0,0 +1 @@
+"""工具函数模块"""

package/kite_cli/utils/i18n.py

@@ -0,0 +1,252 @@
+"""国际化支持 - 根据系统语言自动切换"""
+import os
+import locale
+
+
+def get_system_language():
+    """获取系统语言"""
+    try:
+        # 尝试从环境变量获取
+        lang = os.environ.get('LANG', '')
+        if lang:
+            return lang.split('.')[0].split('_')[0].lower()
+
+        # 尝试从 locale 获取
+        lang, _ = locale.getdefaultlocale()
+        if lang:
+            return lang.split('_')[0].lower()
+    except Exception:
+        pass
+
+    return 'en'
+
+
+# 当前语言
+CURRENT_LANG = get_system_language()
+
+
+# 翻译字典
+TRANSLATIONS = {
+    'en': {
+        'help_title': 'Kite CLI v{version} — Module Installation Manager',
+        'usage': 'Usage',
+        'commands': 'Commands',
+        'global_options': 'Global Options',
+        'install_locations': 'Install Locations',
+        'source_platforms': 'Source Platforms',
+        'detailed_usage': 'Detailed Usage',
+        'examples': 'Examples',
+        'show_help': 'Show this help message',
+        'show_version': 'Show version number',
+        'error_unknown_command': "Error: Unknown command '{cmd}'",
+        'error_invalid_args': "Error: Invalid argument '{args}'",
+        'run_help': "Run 'kite -h' to see available commands",
+        'run_cmd_help': "Run 'kite {cmd} --help' for usage",
+        'searching_module': '[Search] Searching for module: {name}',
+        'module_not_found': '[Error] Module not found: {name}',
+        'select_source': '[Select] Selected source: {platform} - {name}',
+        'downloading': '[Download] Downloading...',
+        'download_complete': '[Done] Download complete: {path}',
+        'download_failed': '[Error] Download failed',
+        'validating': '[Validate] Validating module.md...',
+        'validation_failed': '[Error] Validation failed: {error}',
+        'validation_passed': '[Done] Validation passed: {name} v{version}',
+        'installing_deps': '[Install] Installing dependencies...',
+        'deps_failed': '[Error] Dependency installation failed',
+        'installing_to': '[Install] Installing to: {path}',
+        'install_complete': '[Done] Installation complete!',
+        'restart_hint': '[Info] Restart Kite to load the new module: python main.py',
+        'uninstalling': '[Uninstall] Uninstalling module: {name}',
+        'uninstalled': '[Done] Uninstalled: {location} - {path}',
+        'uninstall_complete': '[Done] Uninstall complete! Uninstalled {count} location(s)',
+        'uninstall_none': '[Error] No modules uninstalled',
+        'installed_modules': '[List] Installed modules:',
+        'total_modules': 'Total {count} module(s)',
+        'no_modules': '  (No installed modules)',
+        'location_dev': 'Development',
+        'location_local': 'Local Instance',
+        'location_global': 'Global Shared',
+        'module_info': '[Info] Module info: {name}',
+        'searching_for': '[Search] Searching for: {keyword}',
+        'found_results': 'Found {count} result(s)',
+        'no_results': '  No modules found',
+        'updating_module': '[Update] Updating module: {name}',
+        'reinstalling': '[Install] Reinstalling {name}...',
+        'skip_deps_warning': '[Warning] Skipping dependency installation (--no-deps)',
+        'no_deps': '[Info] No dependencies to install',
+        'reserved_name_error': "[Error] Cannot install '{name}' as a module",
+        'reserved_name_hint': "[Info] '{name}' is a reserved name for Kite framework",
+        'update_framework_hint': "[Info] To update Kite framework, use: npm update -g @kite/cli",
+        'category_kernel': 'Kernel Modules',
+        'category_builtin': 'Built-in Modules',
+        'category_external': 'External Modules',
+        'type_kernel': 'Kernel',
+        'type_infrastructure': 'Infrastructure',
+        'type_channel': 'Channel',
+        'type_agent': 'Agent',
+        'type_service': 'Service',
+        'type_tool': 'Tool',
+        'stats_breakdown': 'Kernel: {kernel} | Built-in: {builtin} | External: {external}',
+        'info_location_dev': 'Development Environment',
+        'info_location_local': 'Local Instance',
+        'info_location_global': 'Global Shared',
+        'info_path': 'Path',
+        'info_name': 'Name',
+        'info_display_name': 'Display Name',
+        'info_version': 'Version',
+        'info_type': 'Type',
+        'info_runtime': 'Runtime',
+        'info_entry': 'Entry',
+        'info_state': 'State',
+        'info_dependencies': 'Dependencies',
+        'info_install_info': 'Installation Info',
+        'info_source': 'Source',
+        'info_package': 'Package',
+        'info_url': 'URL',
+        'info_installed_at': 'Installed At',
+        'info_no_module_md': '[Warning] module.md not found',
+        'info_parse_failed': '[Warning] Failed to parse module.md',
+        'search_pypi': 'PyPI',
+        'search_npm': 'npm',
+        'search_git': 'Git / GitHub',
+        'search_latest_version': 'Latest Version',
+        'search_available_versions': 'Available Versions',
+        'search_version': 'Version',
+        'update_not_implemented': '[Warning] Update all modules feature not implemented yet',
+        'update_specify_name': '[Error] Please specify module name',
+        'update_not_found': '[Error] Module not found: {name}',
+        'update_no_install_info': '[Error] Installation info not found, cannot update',
+        'update_manual_reinstall': '[Info] Please reinstall manually: kite install {name} -l {location}',
+        'update_incomplete_info': '[Error] Installation info incomplete, cannot update',
+        'update_local_no_auto': '[Error] Locally installed modules cannot be auto-updated',
+        'update_unknown_source': '[Error] Unknown source type: {type}',
+        'update_confirm': 'Confirm update {name} (source: {source})?',
+        'update_cancelled': '[Cancelled] Cancelled',
+        'update_failed': '[Error] Update failed: {error}',
+        'tool_installing': '[Install] {tool} not installed, installing...',
+        'tool_install_success': '[Done] {tool} installed successfully',
+        'tool_install_failed': '[Error] {tool} installation failed',
+        'tool_manual_install': '[Info] Please install {tool} manually',
+        'tool_install_url': '[Info] Visit: {url}',
+        'tool_install_cmd': '[Info] Or use: {cmd}',
+    },
+    'zh': {
+        'help_title': 'Kite CLI v{version} — 模块安装管理工具',
+        'usage': '用法',
+        'commands': '命令',
+        'global_options': '全局选项',
+        'install_locations': '安装位置',
+        'source_platforms': '来源平台',
+        'detailed_usage': '详细用法',
+        'examples': '示例',
+        'show_help': '显示此帮助信息',
+        'show_version': '显示版本号',
+        'error_unknown_command': "错误: 未知命令 '{cmd}'",
+        'error_invalid_args': "错误: 无效参数 '{args}'",
+        'run_help': "运行 'kite -h' 查看可用命令",
+        'run_cmd_help': "运行 'kite {cmd} --help' 查看用法",
+        'searching_module': '[搜索] 正在搜索模块: {name}',
+        'module_not_found': '[错误] 未找到模块: {name}',
+        'select_source': '[选择] 选择来源: {platform} - {name}',
+        'downloading': '[下载] 正在下载...',
+        'download_complete': '[完成] 下载完成: {path}',
+        'download_failed': '[错误] 下载失败',
+        'validating': '[验证] 验证 module.md...',
+        'validation_failed': '[错误] 验证失败: {error}',
+        'validation_passed': '[完成] 验证通过: {name} v{version}',
+        'installing_deps': '[安装] 安装依赖...',
+        'deps_failed': '[错误] 依赖安装失败',
+        'installing_to': '[安装] 安装到: {path}',
+        'install_complete': '[完成] 安装完成！',
+        'restart_hint': '[提示] 重启 Kite 以加载新模块: python main.py',
+        'uninstalling': '[卸载] 卸载模块: {name}',
+        'uninstalled': '[完成] 已卸载: {location} - {path}',
+        'uninstall_complete': '[完成] 卸载完成！共卸载 {count} 个位置',
+        'uninstall_none': '[错误] 未卸载任何模块',
+        'installed_modules': '[列表] 已安装的模块:',
+        'total_modules': '共 {count} 个模块',
+        'no_modules': '  (无已安装模块)',
+        'location_dev': '开发环境',
+        'location_local': '本地实例',
+        'location_global': '全局共享',
+        'module_info': '[信息] 模块信息: {name}',
+        'searching_for': '[搜索] 搜索模块: {keyword}',
+        'found_results': '共找到 {count} 个结果',
+        'no_results': '  未找到相关模块',
+        'updating_module': '[更新] 更新模块: {name}',
+        'reinstalling': '[安装] 重新安装 {name}...',
+        'skip_deps_warning': '[警告] 跳过依赖安装 (--no-deps)',
+        'no_deps': '[提示] 无依赖需要安装',
+        'reserved_name_error': "[错误] 不能将 '{name}' 作为模块安装",
+        'reserved_name_hint': "[提示] '{name}' 是 Kite 框架的保留名称",
+        'update_framework_hint': "[提示] 如需更新 Kite 框架，请使用: npm update -g @kite/cli",
+        'category_kernel': '内核模块',
+        'category_builtin': '内置模块',
+        'category_external': '外置模块',
+        'type_kernel': '核心',
+        'type_infrastructure': '基础',
+        'type_channel': '通道',
+        'type_agent': '代理',
+        'type_service': '服务',
+        'type_tool': '工具',
+        'stats_breakdown': '内核: {kernel} | 内置: {builtin} | 外置: {external}',
+        'info_location_dev': '开发环境',
+        'info_location_local': '本地实例',
+        'info_location_global': '全局共享',
+        'info_path': '路径',
+        'info_name': '名称',
+        'info_display_name': '显示名',
+        'info_version': '版本',
+        'info_type': '类型',
+        'info_runtime': '运行时',
+        'info_entry': '入口',
+        'info_state': '状态',
+        'info_dependencies': '依赖',
+        'info_install_info': '安装信息',
+        'info_source': '来源',
+        'info_package': '包名',
+        'info_url': 'URL',
+        'info_installed_at': '安装时间',
+        'info_no_module_md': '[警告] 未找到 module.md',
+        'info_parse_failed': '[警告] 无法解析 module.md',
+        'search_pypi': 'PyPI',
+        'search_npm': 'npm',
+        'search_git': 'Git / GitHub',
+        'search_latest_version': '最新版本',
+        'search_available_versions': '可用版本',
+        'search_version': '版本',
+        'update_not_implemented': '[警告] 更新所有模块功能尚未实现',
+        'update_specify_name': '[错误] 请指定模块名',
+        'update_not_found': '[错误] 未找到模块: {name}',
+        'update_no_install_info': '[错误] 未找到安装信息，无法更新',
+        'update_manual_reinstall': '[提示] 请手动重新安装: kite install {name} -l {location}',
+        'update_incomplete_info': '[错误] 安装信息不完整，无法更新',
+        'update_local_no_auto': '[错误] 本地安装的模块无法自动更新',
+        'update_unknown_source': '[错误] 未知的来源类型: {type}',
+        'update_confirm': '确认更新 {name} (来源: {source})？',
+        'update_cancelled': '[取消] 已取消',
+        'update_failed': '[错误] 更新失败: {error}',
+        'tool_installing': '[安装] {tool} 未安装，正在安装...',
+        'tool_install_success': '[完成] {tool} 安装成功',
+        'tool_install_failed': '[错误] {tool} 安装失败',
+        'tool_manual_install': '[提示] 请手动安装 {tool}',
+        'tool_install_url': '[提示] 访问: {url}',
+        'tool_install_cmd': '[提示] 或使用: {cmd}',
+    }
+}
+
+
+def t(key, **kwargs):
+    """翻译函数"""
+    lang = CURRENT_LANG if CURRENT_LANG in TRANSLATIONS else 'en'
+    text = TRANSLATIONS[lang].get(key, TRANSLATIONS['en'].get(key, key))
+    if kwargs:
+        return text.format(**kwargs)
+    return text
+
+
+def set_language(lang):
+    """手动设置语言"""
+    global CURRENT_LANG
+    if lang in TRANSLATIONS:
+        CURRENT_LANG = lang

package/kite_cli/utils/interactive.py

@@ -0,0 +1,63 @@
+"""交互式问答工具"""
+
+
+def select_source(candidates: list) -> dict:
+    """让用户选择来源"""
+    print("\n找到多个来源:")
+    for i, candidate in enumerate(candidates, 1):
+        platform = candidate["platform"]
+        name = candidate.get("name", "")
+        version = candidate.get("latest", candidate.get("version", ""))
+        desc = candidate.get("description", "")
+
+        if platform == "pypi":
+            print(f"  [{i}] PyPI: {name} v{version}")
+        elif platform == "npm":
+            print(f"  [{i}] npm: {name} v{version}")
+        elif platform == "git":
+            full_name = candidate.get("full_name", name)
+            print(f"  [{i}] Git: {full_name}")
+            if desc:
+                print(f"      {desc}")
+        elif platform == "local":
+            print(f"  [{i}] 本地: {candidate.get('path', '')}")
+
+    while True:
+        try:
+            choice = input("\n? 选择来源 [1]: ").strip() or "1"
+            index = int(choice) - 1
+            if 0 <= index < len(candidates):
+                return candidates[index]
+            print("无效选择，请重试")
+        except (ValueError, KeyboardInterrupt):
+            return None
+
+
+def select_location() -> str:
+    """让用户选择安装位置"""
+    print("\n? 选择安装位置:")
+    print("  [1] 开发环境 (Kite/extensions/) — 用于模块开发")
+    print("  [2] 本地实例 (~/.kite/workspace/Kite/extensions/) — 当前实例专用")
+    print("  [3] 全局共享 (~/.kite/modules/) — 所有实例共享")
+
+    while True:
+        try:
+            choice = input("\n选择 [3]: ").strip() or "3"
+            if choice == "1":
+                return "dev"
+            elif choice == "2":
+                return "local"
+            elif choice == "3":
+                return "global"
+            print("无效选择，请重试")
+        except KeyboardInterrupt:
+            return None
+
+
+def confirm_action(message: str) -> bool:
+    """确认操作"""
+    try:
+        answer = input(f"{message} [y/N]: ").strip().lower()
+        return answer in ("y", "yes")
+    except KeyboardInterrupt:
+        return False