@comate/zulu 1.3.5 → 1.3.6

package/comate-engine/assets/skills/auto-commit/scripts/logger.py

@@ -1,32 +0,0 @@
-"""smart-commit 统一日志模块
-
-日志写入 ~/.comate-engine/log/kernel-yyyy-mm-dd.log
-"""
-
-import logging
-from datetime import date
-from pathlib import Path
-
-
-def get_logger(name: str = "smart-commit") -> logging.Logger:
-    """获取 smart-commit 日志实例
-
-    Args:
-        name: 日志名称，默认 "smart-commit"
-
-    Returns:
-        配置好的 Logger 实例，写入 ~/.comate-engine/log/kernel-yyyy-mm-dd.log
-    """
-    logger = logging.getLogger(f"comate.{name}")
-    if not logger.handlers:
-        log_dir = Path.home() / ".comate-engine" / "log"
-        log_dir.mkdir(parents=True, exist_ok=True)
-        log_file = log_dir / f"kernel-{date.today().isoformat()}.log"
-        handler = logging.FileHandler(log_file, encoding="utf-8")
-        handler.setFormatter(logging.Formatter(
-            "[%(asctime)s] [smart-commit] [%(levelname)s] %(message)s",
-            datefmt="%Y-%m-%d %H:%M:%S"
-        ))
-        logger.addHandler(handler)
-        logger.setLevel(logging.DEBUG)
-    return logger

package/comate-engine/assets/skills/auto-commit/scripts/match_card_cli.py

@@ -1,37 +0,0 @@
-"""命令行工具：查询 iCafe 匹配卡片
-
-用法:
-    python3 match_card_cli.py --username "dongkexin01"
-
-输出:
-    JSON 格式的匹配结果，包含 cards、space_prefix、available_types 等字段。
-    失败时输出 {"error": "错误信息"} 或 {"disabled": true, "message": "..."}。
-"""
-
-import argparse
-import json
-import os
-import sys
-
-sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
-
-from icafe.matching import find_matching_card
-
-
-def main():
-    """解析命令行参数并查询匹配卡片。"""
-    parser = argparse.ArgumentParser(description="查询 iCafe 匹配卡片")
-    parser.add_argument("--username", default=None, help="用户名，如 dongkexin01")
-    args = parser.parse_args()
-
-    try:
-        username = args.username or os.environ.get("COMATE_USERNAME")
-        result = find_matching_card(current_user=username)
-        print(json.dumps(result, ensure_ascii=False))
-    except Exception as e:
-        print(json.dumps({"error": f"查询匹配卡片异常: {type(e).__name__}: {e}"}))
-        sys.exit(1)
-
-
-if __name__ == "__main__":
-    main()

package/comate-engine/assets/skills/auto-commit/scripts/recognize_card_cli.py

@@ -1,63 +0,0 @@
-"""命令行工具：通过链接或卡片 ID 识别并获取 iCafe 卡片详情
-
-用法:
-    python3 recognize_card_cli.py --link "DevOps-iScan-35835"
-    python3 recognize_card_cli.py --link "https://console.cloud.baidu-int.com/devops/icafe/issue/xxxx/show"
-
-输出:
-    JSON 格式的卡片详情，包含 sequence、title、type、status、spacePrefix 等字段。
-    失败时输出 {"error": "错误信息"}。
-"""
-
-import argparse
-import json
-import os
-import sys
-
-sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
-
-from icafe.client import ICafeQueryClient
-from icafe.matching import parse_card_id_from_link
-
-
-def main():
-    """识别 iCafe 卡片的主函数"""
-    parser = argparse.ArgumentParser(description="识别 iCafe 卡片")
-    parser.add_argument("--link", required=True,
-                        help="卡片链接或卡片 ID，示例: "
-                        "'DevOps-iScan-35835' 或 "
-                        "'https://console.cloud.baidu-int.com/devops/icafe/issue/DevOps-iScan-35835/show'")
-    args = parser.parse_args()
-
-    try:
-        parsed = parse_card_id_from_link(args.link)
-        if not parsed:
-            print(json.dumps({"error": "无法解析卡片链接或 ID，请检查格式"}))
-            sys.exit(1)
-
-        space_prefix = parsed["space_prefix"]
-        card_id = parsed["card_id"]
-
-        client = ICafeQueryClient()
-        card_detail = client.get_card_by_id(space_id=space_prefix, card_id=card_id)
-
-        if card_detail and card_detail.get("cards"):
-            card = card_detail["cards"][0]
-            print(json.dumps({
-                "success": True,
-                "sequence": card_id,
-                "title": card.get("title", ""),
-                "type": card.get("type", ""),
-                "status": card.get("status", ""),
-                "spacePrefix": space_prefix,
-            }))
-        else:
-            print(json.dumps({"error": "无法获取卡片信息，请检查链接或 ID 是否正确"}))
-            sys.exit(1)
-    except Exception as e:
-        print(json.dumps({"error": f"识别卡片异常: {type(e).__name__}: {e}"}))
-        sys.exit(1)
-
-
-if __name__ == "__main__":
-    main()

package/comate-engine/assets/skills/auto-commit-comate/references/new_version_instruction.md

@@ -1,209 +0,0 @@
-# 新版本 IDE 交互指南
-
-本文档适用于**新版本 IDE**（IDE 名称占位符已替换、插件版本 ≥ 4.1.0）的交互方式。
-
----
-
-## 全局规则
-
-**⚠️ 全局静默要求：整个流程中 Agent 仅通过 `__interactive:` UI 组件与用户交互。除步骤 9 的最终结果文字外，Agent 禁止向用户输出任何文字内容，包括但不限于：**
-- **过渡性话语**：如 "Now I have the data"、"Let me perform matching"、"让我分析一下"
-- **内部分析过程**：如 "Card 26: xxx - Score: 95"、"Matching analysis:"、匹配评分细节
-- **状态说明**：如 "has_good_match: true"、"Cards sorted by score"
-- **JSON 数据或代码片段**
-
-**Agent 应在内部完成所有思考后，直接调用对应的 `run_command`，不在工具调用之间输出任何文字。**
-
-**⚠️ 重要：所有 `run_command` 调用（`__interactive:` 除外）必须加 `__silent:` 前缀。唯一例外是步骤 9 的 git commit 命令，需要展示提交结果给用户。**
-
-**⚠️ 禁止额外命令：Agent 不得在流程步骤之外自行执行任何 shell 命令（如 `git status`、`ls` 等）。iCafe 数据由步骤 1 的 Python 脚本获取，git diff 由步骤 2 中 Agent 按规定命令获取。**
-
-**⚠️ 工作目录规则：Skill 执行时的工作目录可能不是用户项目目录。当命令需要在用户项目目录下执行时（如 git 操作、Python 脚本），必须在命令中加 `cd <用户项目目录> &&` 切换目录。但 `__silent:` 或 `__interactive:` 前缀必须始终在命令最开头。**
-
-**⚠️ 多 Workspace 规则：用户可能打开了多个代码库（multi-root workspace）。环境上下文中的 `Workspace Path` 会列出所有 workspace 路径。在步骤 2 和步骤 8 中，Agent 必须对每个 workspace 分别执行 git 命令，不可只处理第一个 workspace 后忽略其余的。**
-
-正确格式：
-```
-__silent: cd /path/to/project && git add .
-__interactive:icafe-cards {...}
-```
-
-错误格式（禁止）：
-```
-cd /path/to/project && __silent: git add .
-cd /path/to/project && __interactive:icafe-cards {...}
-```
-
----
-
-## 步骤 1：获取 iCafe 数据（新版本命令）
-
-使用 SKILL.md 步骤 1 中定义的命令模板，**加 `__silent:` 前缀**执行。
-
----
-
-## 步骤 2：获取 git diff（新版本命令）
-
-使用 SKILL.md 步骤 2 中定义的命令模板，**加 `__silent:` 前缀**执行。
-
----
-
-## 步骤 4：展示卡片选择（交互式 UI）
-
-调用 `run_command` 展示卡片选择/新建 UI，**禁止在调用前输出任何文字**：
-
-```
-run_command(command="__interactive:icafe-cards <payload JSON>")
-```
-
-payload 构造方法 — 用 `result` 中的字段和匹配结果拼接 JSON：
-```python
-import json
-payload = json.dumps({
-    "cards": result["cards"],        # 已按匹配度排序
-    "spacePrefix": result["space_prefix"],
-    "spaceId": result["space_id"],
-    "spaceName": result["space_name"],
-    "availableSpaces": result["available_spaces"],
-    "viewMode": viewMode,  # "list" 或 "create"
-    "defaults": {
-        "title": result["defaults"]["title"],
-        "typeId": result["defaults"]["type_id"],
-        "typeName": result["defaults"]["type_name"],
-        "spaceId": result["space_id"]
-    }
-})
-command = f"__interactive:icafe-cards {payload}"
-```
-
-完整示例 command 值：
-```
-__interactive:icafe-cards {"cards":[{"sequence":"200","title":"修复登录问题","type":"Bug","status":"开发中"}],"spacePrefix":"dkx","spaceId":12345,"spaceName":"测试空间","viewMode":"list","availableSpaces":[{"id":12345,"prefix":"dkx","name":"测试空间","types":[{"id":"5009","name":"Bug"},{"id":"5007","name":"Story"}]}],"defaults":{"title":"修复登录验证码刷新问题","typeId":"5009","typeName":"Bug","spaceId":12345}}
-```
-
----
-
-## 步骤 5：处理用户操作（新版本 IDE）
-
-UI 组件返回 JSON，可能的 action 值：
-
-| action | 含义 | 处理方式 |
-|--------|------|----------|
-| `select` | 选择已有卡片 | 保存 `card` 中的卡片信息，继续步骤 7 |
-| `recognize` | 链接或卡片 ID 识别 | 调用 `recognize_card_cli.py` 获取卡片详情，继续步骤 7 |
-| `create` | 新建卡片 | 调用 `create_card_cli.py` 创建卡片，继续步骤 7 |
-| `skip` | 跳过 | 输出"已跳过卡片绑定和代码提交。"，**结束 skill** |
-| `do_not_show_again` | 不再提示 | 输出"已关闭推荐卡片提示。"，**结束 skill** |
-
-**recognize 处理：**
-```
-__silent: cd <用户项目目录> && python3 <skill_directory>/scripts/recognize_card_cli.py --link "<用户返回的link>"
-```
-
-**create 处理：**
-
-使用 SKILL.md 步骤 5 中定义的「创建卡片命令模板」，**加 `__silent:` 前缀**执行。
-
----
-
-## 步骤 8：展示提交确认（交互式 UI）
-
-调用 `run_command` 展示提交确认 UI：
-
-```
-run_command(command="__interactive:git-commit <payload JSON>")
-```
-
-Agent 仅对 **`hasChanges: true` 的 workspace** 执行 `git branch -vv` + `git branch -r --sort=-committerdate`（使用 `__silent:` 前缀）。**无变更的 workspace 跳过分支查询，`currentBranch` 和 `remoteBranches` 使用空值。** 多 workspace 时，不同 workspace 的分支查询命令必须在同一次响应中并行发出。然后构造 payload：
-
-**⚠️ 重要：`workspaces` 数组必须包含环境上下文 `Workspace Path` 中列出的所有 workspace，不可遗漏。** 即使某个 workspace 没有变更（`hasChanges: false`），也必须包含在数组中。
-
-**⚠️ payload 顶层结构强约束（必须严格遵守）：**
-- 顶层有且仅有 3 个字段：`commitMessage`、`boundCard`、`workspaces`
-- **`workspaces` 是复数（数组），不是单数 `workspace`（字符串）**——即使只有 1 个 workspace 也必须用数组
-- 使用 camelCase 命名：`commitMessage` 不是 `commit_message`，`boundCard` 不是 `icafe_card`
-- `changed_files` 必须嵌套在 `workspaces[].diffSummary` 内，禁止放在顶层
-
-**❌ 禁止生成的扁平化结构：**
-```json
-{"commit_message":"xxx","workspace":"/path","changed_files":[...],"icafe_card":{...}}
-```
-
-payload 结构（多 workspace 格式）：
-```json
-{
-    "commitMessage": "dkx-200 修复登录问题",
-    "boundCard": {"sequence": "200", "title": "修复登录问题", "type": "Bug", "status": "开发中", "spacePrefix": "dkx"},
-    "workspaces": [
-        {
-            "workspace": "/path/to/frontend-app",
-            "repoName": "frontend-app",
-            "currentBranch": "feature/xxx",
-            "remoteBranches": [{"name": "feature/xxx", "isCurrent": true}, {"name": "main", "isCurrent": false}],
-            "hasChanges": true,
-            "diffSummary": {
-                "changed_files": [{"file": "src/App.tsx", "insertions": 76, "deletions": 66}],
-                "stat_summary": "2 files, +100, -78"
-            }
-        },
-        {
-            "workspace": "/path/to/shared-utils",
-            "repoName": "shared-utils",
-            "currentBranch": "",
-            "remoteBranches": [],
-            "hasChanges": false,
-            "diffSummary": null
-        }
-    ]
-}
-```
-
-**构造规则：**
-- `commitMessage`：基于 diff 和绑定卡片生成的 commit message。iCode 仓库格式为 `"<spacePrefix>-<sequence> <brief_description>"`；非 iCode 仓库不带卡片 ID 前缀，仅生成描述性 message
-- `boundCard`：步骤 5 中选定的卡片信息。非 iCode 仓库或无卡片时为 `null`
-- `workspaces`：对每个 workspace 目录，使用步骤 2 中构建的 `workspace_diffs` 数据：
-  - `workspace`：绝对路径
-  - `repoName`：路径的最后一段
-  - `currentBranch`：有变更时从 `git branch -vv` 解析当前分支名，无变更时为空字符串
-  - `remoteBranches`：有变更时从 `git branch -r` 解析远程分支列表；无变更时为空数组。解析规则：
-    1. 跳过包含 `->` 的行（如 `origin/HEAD -> origin/master`，这是 HEAD 指针，不是分支）
-    2. 对每一行 trim 后去掉 `origin/` 前缀，得到分支名
-    3. 从 `git branch -vv` 输出中解析当前分支的远程追踪分支名，将匹配的分支标记为 `isCurrent: true`，其余为 `false`
-    4. 最多取 10 个分支（当前追踪分支必须包含在内），按最近活跃排序
-  - `hasChanges`：该 workspace 是否有变更（`workspace_diffs[path].has_changes`）
-  - `diffSummary`：有变更时为 `workspace_diffs[path]` 中的 `changed_files` + `stat_summary`，无变更时为 `null`
-
-**顶层不再有旧的 `currentBranch`/`remoteBranches`/`diffSummary` 字段。**
-
-完整示例 command 值：
-```
-__interactive:git-commit {"commitMessage":"dkx-200 修复登录验证码刷新问题","boundCard":{"sequence":"200","title":"修复登录问题","type":"Bug","status":"开发中","spacePrefix":"dkx"},"workspaces":[{"workspace":"/home/user/frontend-app","repoName":"frontend-app","currentBranch":"feature/login-fix","remoteBranches":[{"name":"feature/login-fix","isCurrent":true},{"name":"main","isCurrent":false}],"hasChanges":true,"diffSummary":{"changed_files":[{"file":"src/login.ts","insertions":15,"deletions":3}],"stat_summary":"1 file, +15, -3"}}]}
-```
-
-用户操作后，tool output 返回 JSON：
-- 确认提交：`{"action": "submit", "repos": [{"workspace": "...", "commitMessage": "...", "branch": "..."}]}`
-- 取消提交：`{"action": "cancel"}`
-
----
-
-## 步骤 9：执行提交（新版本 IDE）
-
-从 tool output 解析用户操作：
-
-**如果是 action === "submit"：**
-
-UI 返回的结果格式：
-```json
-{"action": "submit", "repos": [{"workspace": "/path/to/repo", "commitMessage": "dkx-200 修复...", "branch": "feature/xxx"}]}
-```
-
-Agent 收到后，对 `repos` 数组中的每个仓库自主决定执行方式：
-- `cd` 到对应 workspace 目录
-- 执行 `git add .`、`git commit -m "<commitMessage>"`（git commit 命令不使用 `__silent:`，展示提交结果给用户）
-- 如果用户选择了特定分支且不是当前分支，先 `git checkout` 切换
-- **推送方式根据仓库类型区分：**
-  - 统一使用 `git push origin HEAD:refs/for/<branch>` 推送到 Gerrit 代码评审
-- 多仓库时逐个执行，每个仓库独立处理
-
-**如果是 action === "cancel"：**
-- 输出"已取消提交"

package/comate-engine/assets/skills/auto-commit-comate/references/old_version_instruction.md

@@ -1,208 +0,0 @@
-# 旧版本 IDE 交互指南
-
-本文档适用于**旧版本 IDE**（IDE 名称占位符未替换、或插件版本 < 4.1.0）的交互方式。旧版本不支持 `__silent:` 和 `__interactive:` 前缀。
-
----
-
-## 步骤 1：获取 iCafe 数据（旧版本命令）
-
-使用 SKILL.md 步骤 1 中定义的命令模板，**不加 `__silent:` 前缀**直接执行。
-
----
-
-## 步骤 2：获取 git diff（旧版本命令）
-
-使用 SKILL.md 步骤 2 中定义的命令模板，**不加 `__silent:` 前缀**直接执行。
-
----
-
-## 步骤 4：展示卡片选择（文本交互）
-
-根据 `viewMode` 输出文本列表。
-
-**当 `viewMode == "list"`（有高匹配卡片）时：**
-
-先展示卡片列表（已按匹配度排序，标注匹配理由），再展示新建选项：
-
-```
-📋 根据代码变更，找到以下匹配的 iCafe 卡片：
-
-1. ⭐ [${spacePrefix}-${card1.sequence}] ${card1.title}
-   类型: ${card1.type} | 状态: ${card1.status}
-   匹配理由: ${reason}
-
-2. [${spacePrefix}-${card2.sequence}] ${card2.title}
-   类型: ${card2.type} | 状态: ${card2.status}
-
-（最多显示 10 张卡片，⭐ 标记匹配度较高的卡片）
-
----
-🆕 如需新建卡片，为你推荐以下信息：
-- 推荐标题：${result.defaults.title}
-- 推荐空间：${spaceName} (${spacePrefix})
-- 推荐类型：${推荐的类型名称}（类型 ID: ${result.defaults.type_id}）
-
----
-请回复：
-- 输入序号（如 "1"）选择对应卡片
-- 输入卡片 ID（如 "DevOps-iScan-35835"）直接关联
-- 输入 "new" 使用推荐信息直接新建卡片
-- 输入 "new 自定义标题" 使用推荐空间和类型、但自定义标题新建
-- 输入 "new?" 查看所有可选空间和类型枚举
-```
-
-**当 `viewMode == "create"`（无高匹配卡片）时：**
-
-先展示新建卡片推荐（突出位置），再附上已有卡片作为备选：
-
-```
-💡 当前代码变更与已有卡片匹配度较低，建议新建卡片：
-
-🆕 推荐新建卡片信息：
-- 推荐标题：${result.defaults.title}
-- 推荐空间：${spaceName} (${spacePrefix})
-- 推荐类型：${推荐的类型名称}（类型 ID: ${result.defaults.type_id}）
-
----
-📋 以下是你当前活跃的卡片（供参考）：
-
-1. [${spacePrefix}-${card1.sequence}] ${card1.title}
-   类型: ${card1.type} | 状态: ${card1.status}
-
-（最多显示 10 张卡片）
-
----
-请回复：
-- 输入 "new" 使用推荐信息直接新建卡片
-- 输入 "new 自定义标题" 使用推荐空间和类型、但自定义标题新建
-- 输入序号（如 "1"）选择对应卡片
-- 输入卡片 ID（如 "DevOps-iScan-35835"）直接关联
-- 输入 "new?" 查看所有可选空间和类型枚举
-```
-
-如果没有找到卡片，输出：
-
-```
-📋 未找到可关联的 iCafe 卡片
-
-🆕 为你推荐以下建卡信息：
-- 推荐标题：${result.defaults.title}
-- 推荐空间：${spaceName} (${spacePrefix})
-- 推荐类型：${推荐的类型名称}
-
----
-请回复：
-- 输入卡片 ID（如 "DevOps-iScan-35835"）直接关联
-- 输入 "new" 使用推荐信息直接新建卡片
-- 输入 "new 自定义标题" 使用推荐空间和类型、但自定义标题新建
-- 输入 "new?" 查看所有可选空间和类型枚举
-```
-
-**推荐类型名称的获取方式：** 优先使用 `result.defaults.type_name`（由 Agent 在步骤 2 中根据 diff 语义推断）。如果为空，从 `result.available_spaces` 中找到当前空间（匹配 `space_prefix`），取其 `types` 列表中 `id` 等于 `result.defaults.type_id` 的类型的 `name`。如果仍然找不到，取该空间 `types` 列表第一个的 `name`。
-
----
-
-## 步骤 5：处理用户操作（旧版本 IDE）
-
-根据用户在对话中的文本回复：
-
-**如果用户输入序号（如 "1"、"2"）：**
-- 解析用户选择的卡片，保存 `selected_card` 信息，继续步骤 7
-
-**如果用户输入卡片 ID（如 "DevOps-iScan-35835"）：**
-- 调用 `recognize_card_cli.py` 获取卡片详情：
-  ```
-  cd <用户项目目录> && python3 <skill_directory>/scripts/recognize_card_cli.py --link "<卡片ID>"
-  ```
-- 保存 `selected_card` 信息，继续步骤 7
-
-**如果用户输入 "new"（使用推荐信息直接新建）：**
-- 使用 `result` 中的推荐信息调用 `create_card_cli.py` 创建卡片
-- 标题 = `result.defaults.title`，空间 = `result.space_prefix`
-- 类型 = 从 `result.available_spaces` 中匹配当前空间，取 `types` 中 `id` 等于 `result.defaults.type_id` 的类型名称
-
-**如果用户输入 "new 自定义标题"：**
-- 与 "new" 逻辑相同，但标题使用用户输入的自定义标题（去掉 "new " 前缀后的部分）
-
-**如果用户输入 "new?"（查看空间和类型枚举）：**
-
-从 `result.available_spaces` 输出完整枚举：
-
-```
-📋 可选空间和类型：
-
-空间 1: ${space1.name} (${space1.prefix})
-  可选类型：
-  - ${type1.name} (ID: ${type1.id})
-  - ${type2.name} (ID: ${type2.id})
-
----
-请回复以下格式新建卡片：
-  new [标题] | [空间前缀] | [类型名称]
-  例如：new 修复登录问题 | dkx | Bug
-
-也可以只指定部分：
-  new 修复登录问题 | dkx       → 使用指定空间 + 该空间默认类型
-  new 修复登录问题 | | Story   → 使用推荐空间 + 指定类型
-```
-
-**如果用户输入 "new 标题 | 空间 | 类型"（完整指定）：**
-- 按 `|` 分割解析，第一段为标题，第二段（可选）为空间前缀，第三段（可选）为类型名称
-- 为空的部分使用推荐值，调用 `create_card_cli.py` 创建卡片
-
----
-
-## 步骤 8：展示提交确认（文本确认）
-
-**当 `is_icode_repo = true` 且有绑定卡片时：**
-
-输出：
-
-```
-✅ 已关联卡片: ${spacePrefix}-${sequence}
-   标题: ${title}
-   类型: ${type} | 状态: ${status}
-
----
-📝 建议的 commit message：
-
-${spacePrefix}-${sequence} ${brief_description}
-
----
-请确认：
-- 回复 "ok" 或 "确认" 使用此 message 提交
-- 回复 "edit: <新message>" 修改后提交（如 "edit: dkx-200 修复登录bug"）
-- 回复 "no" 或 "取消" 放弃提交
-```
-
-**当 `is_icode_repo = false` 或无绑定卡片时：**
-
-输出：
-
-```
-📝 建议的 commit message：
-
-${brief_description}
-
----
-请确认：
-- 回复 "ok" 或 "确认" 使用此 message 提交
-- 回复 "edit: <新message>" 修改后提交
-- 回复 "no" 或 "取消" 放弃提交
-```
-
----
-
-## 步骤 9：执行提交（旧版本 IDE）
-
-**如果用户确认提交（回复 "ok"、"确认"、"yes"）：**
-- 执行 `git add . && git commit -m "${commit_message}"`
-
-**如果用户修改后提交（回复 "edit: <新message>"）：**
-- 使用用户提供的新 message 执行提交
-
-**如果用户取消（回复 "no"、"取消"）：**
-- 输出取消信息
-
-旧版本 IDE 提交成功后额外提示：
-- `如需推送到远程，请执行：git push origin HEAD:refs/for/<branch>`

package/comate-engine/assets/skills/auto-commit-comate/scripts/compat.py

@@ -1,86 +0,0 @@
-"""
-版本兼容性检测模块
-
-用于检测当前 IDE 版本是否支持自定义交互式 UI
-"""
-
-# 支持自定义 UI 的最低版本
-MIN_INTERACTIVE_VERSION = '1.2.0'
-
-
-def parse_version(version_str: str) -> tuple:
-    """
-    解析版本号字符串为可比较的元组
-
-    Args:
-        version_str: 版本号字符串，如 "1.2.3"
-
-    Returns:
-        版本号元组，如 (1, 2, 3)
-    """
-    try:
-        parts = version_str.split('.')
-        return tuple(int(p) for p in parts[:3])
-    except (ValueError, AttributeError):
-        return (0, 0, 0)
-
-
-def is_interactive_ui_supported(ide_name: str, plugin_version: str) -> bool:
-    """
-    检测当前 IDE 版本是否支持自定义交互式 UI
-
-    Args:
-        ide_name: 从 ${COMATE_IDE_NAME} 获取的值
-        plugin_version: 从 ${COMATE_PLUGIN_VERSION} 获取的值
-
-    Returns:
-        True 如果支持自定义 UI，否则 False
-    """
-    # 1. 检测占位符是否被替换
-    # 旧版本 CLI 不支持这些占位符，值仍为 "${...}" 原样
-    if not ide_name or ide_name.startswith('${'):
-        return False
-    if not plugin_version or plugin_version.startswith('${'):
-        return False
-
-    # 2. 版本号比较
-    current = parse_version(plugin_version)
-    minimum = parse_version(MIN_INTERACTIVE_VERSION)
-
-    return current >= minimum
-
-
-def check_interactive_support(ide_name: str, plugin_version: str) -> str:
-    """
-    检测并返回应使用的流程模式
-
-    Args:
-        ide_name: 从 ${COMATE_IDE_NAME} 获取的值
-        plugin_version: 从 ${COMATE_PLUGIN_VERSION} 获取的值
-
-    Returns:
-        "INTERACTIVE_MODE" 或 "FALLBACK_MODE"
-    """
-    if is_interactive_ui_supported(ide_name, plugin_version):
-        return "INTERACTIVE_MODE"
-    return "FALLBACK_MODE"
-
-
-if __name__ == "__main__":
-    # 测试用例
-    test_cases = [
-        ("vscode", "1.2.0", "INTERACTIVE_MODE"),
-        ("vscode", "1.3.5", "INTERACTIVE_MODE"),
-        ("vscode", "1.1.9", "FALLBACK_MODE"),
-        ("vscode", "0.9.0", "FALLBACK_MODE"),
-        ("${COMATE_IDE_NAME}", "1.2.0", "FALLBACK_MODE"),
-        ("vscode", "${COMATE_PLUGIN_VERSION}", "FALLBACK_MODE"),
-        ("", "1.2.0", "FALLBACK_MODE"),
-        ("vscode", "", "FALLBACK_MODE"),
-    ]
-
-    print("Running compatibility check tests...")
-    for ide, version, expected in test_cases:
-        result = check_interactive_support(ide, version)
-        status = "PASS" if result == expected else "FAIL"
-        print(f"[{status}] ide={ide!r}, version={version!r} -> {result} (expected: {expected})")