@comate/zulu 1.2.1-beta.2 → 1.3.0

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

@@ -0,0 +1,208 @@
+# 旧版本 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/git_diff_cli.py

@@ -0,0 +1,196 @@
+"""命令行工具：获取 workspace 的 git diff 摘要
+
+用法:
+    python3 git_diff_cli.py --workspace /path/to/project
+
+输出:
+    JSON 格式的 diff 摘要，包含 changed_files、stat_summary、diff_content 等字段。
+    失败时输出 {"error": "错误信息"}。
+"""
+
+import argparse
+import json
+import os
+import subprocess
+import sys
+
+# tracked diff 最大行数
+MAX_TRACKED_DIFF_LINES = 300
+# untracked diff 最大行数
+MAX_UNTRACKED_DIFF_LINES = 200
+# 合并后 diff 最大总行数
+MAX_TOTAL_DIFF_LINES = 500
+
+
+def run_git(args, cwd, timeout=10):
+    """执行 git 命令，返回 stdout 字符串。失败返回空字符串。"""
+    try:
+        result = subprocess.run(
+            ["git"] + args,
+            capture_output=True, text=True, encoding="utf-8", errors="replace",
+            timeout=timeout, cwd=cwd
+        )
+        if result.returncode == 0:
+            return result.stdout
+        return ""
+    except (subprocess.TimeoutExpired, FileNotFoundError, OSError):
+        return ""
+
+
+def parse_numstat(cwd):
+    """通过 git diff HEAD --numstat 获取 tracked 文件变更统计。"""
+    output = run_git(["diff", "HEAD", "--numstat"], cwd)
+    files = []
+    for line in output.strip().splitlines():
+        if not line:
+            continue
+        parts = line.split("\t")
+        if len(parts) != 3:
+            continue
+        ins_str, del_str, file_path = parts
+        # binary 文件的 numstat 输出是 - - filename
+        insertions = int(ins_str) if ins_str != "-" else 0
+        deletions = int(del_str) if del_str != "-" else 0
+        files.append({
+            "file": file_path,
+            "insertions": insertions,
+            "deletions": deletions,
+        })
+    return files
+
+
+def get_untracked_files(cwd):
+    """获取 untracked 文件列表。"""
+    output = run_git(["ls-files", "--others", "--exclude-standard"], cwd)
+    return [f for f in output.strip().splitlines() if f]
+
+
+def get_tracked_diff(cwd):
+    """获取 tracked 文件的 diff 内容，截断到 MAX_TRACKED_DIFF_LINES 行。"""
+    output = run_git(["diff", "HEAD"], cwd, timeout=30)
+    lines = output.splitlines()
+    truncated = len(lines) > MAX_TRACKED_DIFF_LINES
+    if truncated:
+        lines = lines[:MAX_TRACKED_DIFF_LINES]
+    return "\n".join(lines), truncated
+
+
+def get_untracked_diff_and_stats(cwd, untracked_files):
+    """获取 untracked 文件的 diff 和变更统计。
+
+    Returns:
+        (changed_files, diff_content, truncated)
+    """
+    changed_files = []
+    diff_lines = []
+    total_lines = 0
+    truncated = False
+
+    for file_path in untracked_files:
+        full_path = os.path.join(cwd, file_path)
+        try:
+            with open(full_path, "r", encoding="utf-8", errors="replace") as f:
+                lines = f.readlines()
+        except (OSError, IOError):
+            continue
+
+        insertions = len(lines)
+        if insertions > 0:
+            changed_files.append({
+                "file": file_path,
+                "insertions": insertions,
+                "deletions": 0,
+            })
+
+        # 构造 unified diff 格式的输出
+        file_diff_lines = [
+            f"diff --git a/{file_path} b/{file_path}",
+            "new file mode 100644",
+            f"--- /dev/null",
+            f"+++ b/{file_path}",
+            f"@@ -0,0 +1,{insertions} @@",
+        ] + [f"+{line.rstrip()}" for line in lines]
+
+        # 检查总行数上限
+        remaining = MAX_UNTRACKED_DIFF_LINES - total_lines
+        if remaining <= 0:
+            truncated = True
+            break
+        if len(file_diff_lines) > remaining:
+            file_diff_lines = file_diff_lines[:remaining]
+            truncated = True
+        diff_lines.extend(file_diff_lines)
+        total_lines += len(file_diff_lines)
+
+    return changed_files, "\n".join(diff_lines), truncated
+
+
+def build_stat_summary(changed_files):
+    """构建统计摘要字符串，如 '3 files, +130, -78'。"""
+    total_ins = sum(f["insertions"] for f in changed_files)
+    total_del = sum(f["deletions"] for f in changed_files)
+    n = len(changed_files)
+    return f"{n} file{'s' if n != 1 else ''}, +{total_ins}, -{total_del}"
+
+
+def main():
+    """解析命令行参数并输出 workspace 的 git diff 摘要 JSON。"""
+    parser = argparse.ArgumentParser(description="获取 workspace 的 git diff 摘要")
+    parser.add_argument("--workspace", required=True, help="workspace 路径")
+    parser.add_argument("--max-diff-lines", type=int, default=MAX_TOTAL_DIFF_LINES,
+                        help="diff 内容最大总行数")
+    args = parser.parse_args()
+
+    workspace = os.path.abspath(args.workspace)
+    if not os.path.isdir(workspace):
+        print(json.dumps({"error": f"workspace 路径不存在: {workspace}"}))
+        sys.exit(1)
+
+    max_total = args.max_diff_lines
+
+    try:
+        # 1. tracked 文件变更统计
+        tracked_files = parse_numstat(workspace)
+
+        # 2. untracked 文件列表
+        untracked_files = get_untracked_files(workspace)
+
+        # 3. tracked diff 内容
+        tracked_diff, tracked_truncated = get_tracked_diff(workspace)
+
+        # 4. untracked diff 和统计
+        untracked_changed, untracked_diff, untracked_truncated = \
+            get_untracked_diff_and_stats(workspace, untracked_files)
+
+        # 5. 合并 changed_files
+        all_changed = tracked_files + untracked_changed
+
+        # 6. 合并 diff 内容，检查总行数上限
+        tracked_lines = tracked_diff.splitlines() if tracked_diff else []
+        untracked_lines = untracked_diff.splitlines() if untracked_diff else []
+        all_lines = tracked_lines + untracked_lines
+        truncated = tracked_truncated or untracked_truncated or len(all_lines) > max_total
+        if len(all_lines) > max_total:
+            all_lines = all_lines[:max_total]
+        diff_content = "\n".join(all_lines)
+
+        # 7. 构建输出
+        has_changes = bool(all_changed) or bool(untracked_files)
+        output = {
+            "workspace": workspace,
+            "changed_files": all_changed,
+            "untracked_files": untracked_files,
+            "stat_summary": build_stat_summary(all_changed) if all_changed else "",
+            "has_changes": has_changes,
+            "diff_content": diff_content,
+            "truncated": truncated,
+        }
+        print(json.dumps(output, ensure_ascii=False))
+
+    except Exception as e:
+        print(json.dumps({"error": f"获取 diff 摘要异常: {type(e).__name__}: {e}"}))
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

package/comate-engine/assets/skills/{smart-commit → auto-commit-comate}/scripts/git_utils.py

@@ -63,7 +63,8 @@ def get_current_user(username: Optional[str] = None) -> Optional[str]:
     try:
         result = subprocess.run(
             ["git", "config", "user.email"],
-            capture_output=True, text=True, timeout=5
+            capture_output=True, text=True, encoding="utf-8", errors="replace",
+            timeout=5
         )
         if result.returncode == 0 and result.stdout.strip():
             username = result.stdout.strip().split("@")[0]
@@ -77,7 +78,8 @@ def get_current_user(username: Optional[str] = None) -> Optional[str]:
     try:
         result = subprocess.run(
             ["git", "config", "user.name"],
-            capture_output=True, text=True, timeout=5
+            capture_output=True, text=True, encoding="utf-8", errors="replace",
+            timeout=5
         )
         if result.returncode == 0 and result.stdout.strip():
             username = result.stdout.strip()
@@ -112,7 +114,8 @@ def get_git_diff_summary(max_diff_lines: int = DEFAULT_MAX_DIFF_LINES) -> Option
     try:
         stat_result = subprocess.run(
             ["git", "diff", "HEAD", "--stat"],
-            capture_output=True, text=True, timeout=10
+            capture_output=True, text=True, encoding="utf-8", errors="replace",
+            timeout=10
         )
         if stat_result.returncode != 0 or not stat_result.stdout.strip():
             logger.info("git diff 无变更")
@@ -136,7 +139,8 @@ def get_git_diff_summary(max_diff_lines: int = DEFAULT_MAX_DIFF_LINES) -> Option
     try:
         diff_result = subprocess.run(
             ["git", "diff", "HEAD"],
-            capture_output=True, text=True, timeout=30
+            capture_output=True, text=True, encoding="utf-8", errors="replace",
+            timeout=30
         )
         diff_content = diff_result.stdout if diff_result.returncode == 0 else ""
     except (subprocess.TimeoutExpired, FileNotFoundError):
@@ -178,7 +182,8 @@ def extract_space_ids_from_git_log(
     try:
         result = subprocess.run(
             ["git", "log", "--oneline", "-n", str(max_commits)],
-            capture_output=True, text=True, timeout=10
+            capture_output=True, text=True, encoding="utf-8", errors="replace",
+            timeout=10
         )
         if result.returncode != 0:
             return []
@@ -203,17 +208,22 @@ def extract_space_ids_from_git_log(
             return sorted_prefixes
 
     # 策略 2：正则启发式兜底（无已知前缀或精确匹配无结果）
-    pattern = re.compile(r'\b([a-zA-Z][a-zA-Z0-9_]*)-(\d+)\b')
+    # 支持含连字符的复合前缀，如 DevOps-iScan-36261、TPUE-EE-2-22
+    # 贪婪匹配：最后一个 -数字 是卡片 ID，前面所有部分都是空间前缀
+    pattern = re.compile(r'\b([a-zA-Z][a-zA-Z0-9_]*(?:-[a-zA-Z0-9_]+)*)-(\d+)\b')
     counter_fallback: Dict[str, int] = {}
 
     for line in log_text.splitlines():
         for match in pattern.finditer(line):
-            prefix = match.group(1).lower()
-            if prefix in GIT_LOG_FALSE_POSITIVE_PREFIXES:
+            raw_prefix = match.group(1)
+            prefix_lower = raw_prefix.lower()
+            # 检查前缀首段是否是常见误报（如 feat-xxx、fix-xxx）
+            first_segment = raw_prefix.split('-', 1)[0].lower()
+            if first_segment in GIT_LOG_FALSE_POSITIVE_PREFIXES:
                 continue
-            if len(prefix) <= 1:
+            if len(raw_prefix) <= 1:
                 continue
-            counter_fallback[prefix] = counter_fallback.get(prefix, 0) + 1
+            counter_fallback[prefix_lower] = counter_fallback.get(prefix_lower, 0) + 1
 
     sorted_prefixes = sorted(counter_fallback, key=counter_fallback.get, reverse=True)
     logger.info("git log 提取前缀: %s, 策略=正则启发式", sorted_prefixes)

package/comate-engine/assets/skills/{smart-commit → auto-commit-comate}/scripts/icafe/client.py

@@ -3,13 +3,15 @@
 包含常量、配置类和 API 客户端。
 """
 
+import json as _json
 import os
+import urllib.error
+import urllib.parse
+import urllib.request
 from dataclasses import dataclass
 from pathlib import Path
 from typing import Dict, List, Any, Optional
 
-import requests
-
 from logger import get_logger
 
 logger = get_logger()
@@ -126,34 +128,69 @@ class ICafeQueryClient:
 
     def __init__(self, config: Optional[ICafeQueryConfig] = None):
         self.config = config or ICafeQueryConfig()
-        self.session = requests.Session()
-
-        self.session.headers.update({
-            "Content-Type": "application/json"
-        })
+        self._default_headers: Dict[str, str] = {
+            "Content-Type": "application/json",
+            "User-Agent": "iAPI/1.0.0 (http://iapi.baidu-int.com)",
+        }
 
         auth_token = self.config._get_auth_token()
         if auth_token:
-            self.session.headers["x-ac-Authorization"] = auth_token
+            self._default_headers["x-ac-Authorization"] = auth_token
 
-    def _get_headers(self) -> Dict[str, str]:
-        """获取通用请求 headers"""
-        return {
-            'User-Agent': 'iAPI/1.0.0 (http://iapi.baidu-int.com)'
-        }
+    def _http_request(
+        self,
+        url: str,
+        params: Optional[dict] = None,
+        data: Optional[dict] = None,
+        headers: Optional[Dict[str, str]] = None,
+        timeout: Optional[int] = None,
+    ) -> Any:
+        """发送 HTTP 请求并返回解析后的 JSON
+
+        Args:
+            url: 请求 URL
+            params: GET 查询参数
+            data: POST 请求体（dict，会被序列化为 JSON）
+            headers: 额外 headers（会合并到默认 headers）
+            timeout: 超时时间（秒）
+
+        Returns:
+            解析后的 JSON 对象（dict 或 list）
+
+        Raises:
+            urllib.error.HTTPError: HTTP 状态码非 2xx 时
+            urllib.error.URLError: 网络连接失败时
+        """
+        if timeout is None:
+            timeout = self.config.timeout
+
+        # 合并 headers
+        merged_headers = dict(self._default_headers)
+        if headers:
+            merged_headers.update(headers)
+
+        # 构建完整 URL
+        if params:
+            query_string = urllib.parse.urlencode(params, doseq=True)
+            url = f"{url}?{query_string}" if "?" not in url else f"{url}&{query_string}"
+
+        # 构建 Request
+        body = None
+        if data is not None:
+            body = _json.dumps(data).encode("utf-8")
+
+        req = urllib.request.Request(url, data=body, headers=merged_headers)
+
+        with urllib.request.urlopen(req, timeout=timeout) as resp:
+            return _json.loads(resp.read().decode("utf-8"))
 
-    def _get_with_retry(self, url: str, params: dict, max_retries: int = 3) -> requests.Response:
-        """带重试的 GET 请求"""
+    def _get_with_retry(self, url: str, params: dict, max_retries: int = 3) -> Any:
+        """带重试的 GET 请求，返回解析后的 JSON"""
         import time
         last_exc = None
         for attempt in range(max_retries + 1):
             try:
-                response = self.session.get(
-                    url, params=params, headers=self._get_headers(),
-                    timeout=self.config.timeout
-                )
-                response.raise_for_status()
-                return response
+                return self._http_request(url, params=params)
             except Exception as e:
                 last_exc = e
                 if attempt < max_retries:
@@ -195,7 +232,7 @@ class ICafeQueryClient:
 
         Raises:
             ValueError: 当 space_id 或 iql 为空时
-            requests.RequestException: 请求失败时
+            urllib.error.URLError: 请求失败时
 
         IQL 表达式示例：
             - "类型 = Bug"
@@ -234,8 +271,7 @@ class ICafeQueryClient:
 
         url = f"{self.config.base_url}/api/spaces/{space_id}/cards"
         logger.info("查询卡片: space=%s, iql=%s", space_id, iql)
-        response = self._get_with_retry(url, params)
-        result = response.json()
+        result = self._get_with_retry(url, params)
         cards_count = len(result.get("cards", []))
         logger.info("查询卡片返回: %d 张", cards_count)
         return result
@@ -263,7 +299,7 @@ class ICafeQueryClient:
 
         Raises:
             ValueError: 当 space_id 或 card_id 为空时
-            requests.RequestException: 请求失败时
+            urllib.error.URLError: 请求失败时
         """
         if not space_id or not card_id:
             raise ValueError("space_id 和 card_id 不能为空")
@@ -279,8 +315,7 @@ class ICafeQueryClient:
             params['showAccumulate'] = ''
 
         url = f"{self.config.base_url}/api/spaces/{space_id}/cards/{card_id}"
-        response = self._get_with_retry(url, params)
-        return response.json()
+        return self._get_with_retry(url, params)
 
     # ========================================
     # 3. 查询最近访问的空间列表
@@ -297,7 +332,7 @@ class ICafeQueryClient:
 
         Raises:
             ValueError: 当 current_user 为空时
-            requests.RequestException: 请求失败时
+            urllib.error.URLError: 请求失败时
         """
         if not current_user:
             raise ValueError("current_user 不能为空")
@@ -305,8 +340,7 @@ class ICafeQueryClient:
         logger.info("查询最近访问空间: user=%s, limit=%d", current_user, limit)
         url = f"{self.config.base_url}/api/v2/space/latest"
         params = {'currentUser': current_user}
-        response = self._get_with_retry(url, params)
-        data = response.json()
+        data = self._get_with_retry(url, params)
 
         # 对返回的空间列表截取前 limit 个
         if isinstance(data, dict) and 'result' in data:
@@ -330,14 +364,13 @@ class ICafeQueryClient:
 
         Raises:
             ValueError: 当 space_id 为空时
-            requests.RequestException: 请求失败时
+            urllib.error.URLError: 请求失败时
         """
         if not space_id:
             raise ValueError("space_id 不能为空")
 
         url = f"{self.config.base_url}/api/v2/space/{space_id}/plans"
-        response = self._get_with_retry(url, {})
-        return response.json()
+        return self._get_with_retry(url, {})
 
     # ========================================
     # 5. 获取空间卡片类型列表
@@ -353,14 +386,13 @@ class ICafeQueryClient:
 
         Raises:
             ValueError: 当 space_prefix 为空时
-            requests.RequestException: 请求失败时
+            urllib.error.URLError: 请求失败时
         """
         if not space_prefix:
             raise ValueError("space_prefix 不能为空")
 
         url = f"{self.config.base_url}/api/v2/space/{space_prefix}/issueTypes"
-        response = self._get_with_retry(url, {})
-        return response.json()
+        return self._get_with_retry(url, {})
 
     # ========================================
     # 6. 创建卡片
@@ -421,10 +453,7 @@ class ICafeQueryClient:
                 'Content-Type': 'application/json'
             }
 
-            # 使用 self.session.post 发送请求
-            response = self.session.post(url, json=data, headers=headers, timeout=self.config.timeout)
-            response.raise_for_status()
-            result = response.json()
+            result = self._http_request(url, data=data, headers=headers)
 
             # 检查返回的状态
             if isinstance(result, dict):