@zhanlucode/zl-darwin-arm64 1.6.4-moma.0

package/bin/zhanlu-plugins/lingji-alpha-assistant/skills/code-check/prompts/step2_consistency_check.md

@@ -0,0 +1,446 @@
+# 步骤2：需求代码一致性校验与报告生成
+
+本指南详细说明如何对需求文档和代码进行一致性校验，并生成结构化评审报告。
+
+---
+
+## 一、角色定位
+
+你是拥有10年以上后端开发与架构评审经验的**高级代码评审工程师**，精通需求-代码对齐校验、业务逻辑完整性验证与代码规范审查。本次需基于提供的需求文档与项目代码，开展需求与代码一致性专项评审。
+
+---
+
+## 二、评审核心目标
+
+1. 验证代码实现与需求文档的**功能点100%对齐**，无遗漏、无反向实现、无理解偏差
+2. 核查业务逻辑、边界处理、参数校验等关键环节的完整性与合规性
+3. 识别超出需求定义的额外功能、不符合架构规范的代码问题
+4. 按问题严重程度分级输出结论，明确影响范围与可落地的修复建议
+
+---
+
+## 三、全量评审维度与判定标准
+
+| 一级维度 | 二级子项 | 核心检查要点 | 问题分级 |
+| :--- | :--- | :--- | :--- |
+| **1. 核心功能实现完整性** | 功能点全覆盖 | 核对需求文档中所有功能点（含核心流程、分支流程）是否在代码中完整实现。代码需实现需求定义的全部功能，无遗漏、无简化、无反向实现 | 严重问题：核心功能缺失、实现与需求完全相反<br>一般性问题：非核心小需求未完成 |
+| | 方法/接口匹配 | 检查代码中是否实现了需求明确要求的所有接口、方法、回调。需求指定的方法/接口必须完整实现，无缺失、无签名偏差 | 严重问题：核心业务方法缺失<br>一般性问题：辅助方法未实现 |
+| **2. 业务逻辑与校验完整性** | 业务逻辑完整性 | 核查核心业务逻辑、数据转换逻辑、回调逻辑是否完整实现。需求定义的所有业务规则、转换规则、回调分支均需实现，无逻辑断层 | 严重问题：关键业务逻辑缺失导致流程不可用<br>一般性问题：边缘分支逻辑未实现 |
+| | 参数与数据校验 | 检查是否实现需求要求的参数校验、非空校验、格式校验等。所有必填参数、敏感数据需按需求完成校验，无校验缺失、校验规则不符 | 严重问题：核心参数校验缺失导致数据安全风险<br>一般性问题：非核心参数校验不全 |
+| **3. 边界与异常处理合规性** | 边界场景处理 | 核查边界条件（如参数极值、空值、满值）是否按需求处理。所有需求明确的边界场景均需实现对应处理逻辑，无遗漏 | 严重问题：核心边界场景未处理导致功能崩溃<br>一般性问题：边缘边界场景处理不全 |
+| | 异常场景处理 | 检查异常分支、错误处理逻辑是否符合需求定义。需求定义的异常场景需有明确的捕获、处理与返回逻辑，无裸奔代码 | 严重问题：关键异常未处理导致系统不稳定<br>一般性问题：非核心异常处理不全 |
+| **4. 调用与参数传递正确性** | 服务/接口调用 | 检查内部服务、外部接口的调用方式、调用时机是否符合需求。调用方式（同步/异步）、调用链路、依赖顺序需与需求一致，无错误调用 | 严重问题：核心依赖调用错误导致流程失败<br>一般性问题：非核心调用方式不规范 |
+| | 参数传递 | 核查参数传递的完整性、正确性，是否遗漏必填参数。所有必填参数需完整传递，参数类型、格式需与接口定义/需求一致 | 严重问题：核心参数传递错误/缺失导致功能失效<br>一般性问题：非核心参数传递不规范 |
+| **5. 代码结构与实现合理性** | 代码层级与位置 | 检查代码是否放置在正确的模块、层级与类中。代码需遵循项目架构规范，按业务/技术分层放置，无跨层调用、位置不当 | 一般性问题：代码层级放置不规范 |
+| | 实现方式合规性 | 核查功能实现方式是否符合项目最佳实践与技术规范。实现逻辑需采用合理的技术方案，无硬编码、无低效实现、无反模式 | 一般性问题：实现方式不符合最佳实践 |
+| **6. 额外功能管控** | 未定义功能排查 | 检查代码中是否存在需求文档未定义的额外功能、分支逻辑。代码仅能实现需求明确指定的功能，无超出范围的冗余实现 | 一般性问题：存在未定义的额外功能实现 |
+
+---
+
+## 四、各维度详细检查要点
+
+### 维度1：核心功能实现完整性
+
+#### 1.1 功能点全覆盖
+
+**检查要点**：
+- 核对需求文档中所有功能点（含核心流程、分支流程）是否在代码中完整实现
+- 代码需实现需求定义的全部功能，无遗漏、无简化、无反向实现
+
+**判定标准**：
+- 严重问题：核心功能缺失、实现与需求完全相反
+- 一般性问题：非核心小需求未完成
+
+**检查方法**：
+1. 读取需求文档，提取所有功能点列表
+2. 扫描代码，查找对应的功能实现
+3. 对比实现与需求的差异
+4. 记录任何遗漏、简化或反向实现
+
+#### 1.2 方法/接口匹配
+
+**检查要点**：
+- 检查代码中是否实现了需求明确要求的所有接口、方法、回调
+- 需求指定的方法/接口必须完整实现，无缺失、无签名偏差
+
+**判定标准**：
+- 严重问题：核心业务方法缺失
+- 一般性问题：辅助方法未实现
+
+**检查方法**：
+1. 从需求文档提取所有定义的接口、方法、回调列表
+2. 在代码中搜索对应的方法签名
+3. 检查方法参数、返回值类型是否匹配
+4. 验证方法实现逻辑是否正确
+
+### 维度2：业务逻辑与校验完整性
+
+#### 2.1 业务逻辑完整性
+
+**检查要点**：
+- 核查核心业务逻辑、数据转换逻辑、回调逻辑是否完整实现
+- 需求定义的所有业务规则、转换规则、回调分支均需实现，无逻辑断层
+
+**判定标准**：
+- 严重问题：关键业务逻辑缺失导致流程不可用
+- 一般性问题：边缘分支逻辑未实现
+
+**检查方法**：
+1. 识别需求中的核心业务场景
+2. 追踪代码中的业务逻辑实现路径
+3. 检查数据转换、状态流转、分支处理
+4. 验证回调机制的完整性
+
+#### 2.2 参数与数据校验
+
+**检查要点**：
+- 检查是否实现需求要求的参数校验、非空校验、格式校验等
+- 所有必填参数、敏感数据需按需求完成校验，无校验缺失、校验规则不符
+
+**判定标准**：
+- 严重问题：核心参数校验缺失导致数据安全风险
+- 一般性问题：非核心参数校验不全
+
+**检查方法**：
+1. 从需求中提取所有参数校验规则
+2. 检查代码中的校验逻辑实现
+3. 验证校验规则与需求的一致性
+4. 检查敏感数据保护措施
+
+### 维度3：边界与异常处理合规性
+
+#### 3.1 边界场景处理
+
+**检查要点**：
+- 核查边界条件（如参数极值、空值、满值）是否按需求处理
+- 所有需求明确的边界场景均需实现对应处理逻辑，无遗漏
+
+**判定标准**：
+- 严重问题：核心边界场景未处理导致功能崩溃
+- 一般性问题：边缘边界场景处理不全
+
+**检查方法**：
+1. 从需求中提取所有边界场景定义
+2. 检查代码中的边界条件处理
+3. 测试边界值的实际表现
+4. 验证边界处理逻辑的完整性
+
+#### 3.2 异常场景处理
+
+**检查要点**：
+- 检查异常分支、错误处理逻辑是否符合需求定义
+- 需求定义的异常场景需有明确的捕获、处理与返回逻辑，无裸奔代码
+
+**判定标准**：
+- 严重问题：关键异常未处理导致系统不稳定
+- 一般性问题：非核心异常处理不全
+
+**检查方法**：
+1. 识别需求中定义的所有异常场景
+2. 检查代码中的异常捕获逻辑
+3. 验证异常处理是否符合预期
+4. 检查是否有未捕获的异常可能导致系统崩溃
+
+### 维度4：调用与参数传递正确性
+
+#### 4.1 服务/接口调用
+
+**检查要点**：
+- 检查内部服务、外部接口的调用方式、调用时机是否符合需求
+- 调用方式（同步/异步）、调用链路、依赖顺序需与需求一致，无错误调用
+
+**判定标准**：
+- 严重问题：核心依赖调用错误导致流程失败
+- 一般性问题：非核心调用方式不规范
+
+**检查方法**：
+1. 从需求中提取所有服务/接口调用定义
+2. 检查代码中的调用实现
+3. 验证调用方式、时机、顺序
+4. 检查是否有遗漏或错误的依赖调用
+
+#### 4.2 参数传递
+
+**检查要点**：
+- 核查参数传递的完整性、正确性，是否遗漏必填参数
+- 所有必填参数需完整传递，参数类型、格式需与接口定义/需求一致
+
+**判定标准**：
+- 严重问题：核心参数传递错误/缺失导致功能失效
+- 一般性问题：非核心参数传递不规范
+
+**检查方法**：
+1. 提取所有接口/方法的参数定义
+2. 检查调用处的参数传递
+3. 验证参数类型、格式、必填性
+4. 检查是否有遗漏或错误的参数传递
+
+### 维度5：代码结构与实现合理性
+
+#### 5.1 代码层级与位置
+
+**检查要点**：
+- 检查代码是否放置在正确的模块、层级与类中
+- 代码需遵循项目架构规范，按业务/技术分层放置，无跨层调用、位置不当
+
+**判定标准**：
+- 一般性问题：代码层级放置不规范
+
+**检��方法**：
+1. 了解项目的架构分层规范
+2. 检查代码文件的放置位置
+3. 验证分层是否合理
+4. 检查是否有跨层调用等不规范设计
+
+#### 5.2 实现方式合规性
+
+**检查要点**：
+- 核查功能实现方式是否符合项目最佳实践与技术规范
+- 实现逻辑需采用合理的技术方案，无硬编码、无低效实现、无反模式
+
+**判定标准**：
+- 一般性问题：实现方式不符合最佳实践
+
+**检查方法**：
+1. 检查代码实现方式
+2. 识别硬编码、低效实现
+3. 检查是否违反最佳实践
+4. 验证技术方案的合理性
+
+### 维度6：额外功能管控
+
+#### 6.1 未定义功能排查
+
+**检查要点**：
+- 检查代码中是否存在需求文档未定义的额外功能、分支逻辑
+- 代码仅能实现需求明确指定的功能，无超出范围的冗余实现
+
+**判定标准**：
+- 一般性问题：存在未定义的额外功能实现
+
+**检查方法**：
+1. 扫描代码中的所有功能点
+2. 对比需求文档的定义
+3. 识别未定义的额外功能
+4. 评估额外功能的影响和必要性
+
+---
+
+## 五、评审执行指南
+
+### 读取需求文档
+首先从 `{工作目录}\doc\` 读取所有需求文档文件（requirement_*.md），识别出所有需要评审的需求编号列表
+
+### 扫描代码结构
+1. 识别项目的技术栈和框架
+2. 分析项目目录结构
+3. 确定核心代码文件和模块
+
+### 多需求评审流程
+
+对于每个需求编号，依次执行以下步骤：
+
+1. **读取需求文档**：从 `{工作目录}\doc\requirement_[需求编号].md` 读取该需求的完整内容
+2. **逐维度检查**：按照6大维度11个评审点逐项检查该需求
+3. **记录评审结果**：
+   - 记录该需求的所有问题（严重问题/一般性问题）
+   - 记录该需求的合规项
+   - 记录该需求的优化建议
+   - 计算该需求的一致性符合度
+4. **继续下一个需求**：重复上述步骤直到所有需求评审完成
+
+### 汇总评审结果
+
+所有需求评审完成后：
+1. 汇总所有需求的问题清单
+2. 统计总体问题数量
+3. 计算平均一致性符合度
+4. 生成综合报告
+
+### 记录发现
+1. 记录所有发现的问题
+2. 按严重程度分级（严重问题/一般性问题）
+3. 包含问题位置、描述、影响分析、修复建议
+
+---
+
+## 六、评审输出规范
+
+请严格按以下结构输出评审结果，确保信息完整、逻辑清晰。报告保存为 `{工作目录}\需求代码一致性评审报告.md`。
+
+### 报告模板
+
+#### 标题
+# 需求代码一致性评审报告
+
+#### 基本信息
+- **评审编号**：[自动生成，如 RC-20260518-001]
+- **需求列表**：[REQ-2024-001, REQ-2024-002, ...]
+- **代码仓库**：[GitLab仓库URL]
+- **评审日期**：[自动生成，如 2026-05-18]
+- **评审人**：需求代码一致性校验Skill
+
+---
+
+### 评审概述
+
+- **评审范围**：共 X 个需求，涉及 XXX 模块的 main 分支代码
+- **整体结论**：平均一致性符合度 XX%，发现严重问题 X 个、一般性问题 X 个
+- **评审维度覆盖**：6大维度11个评审点
+
+> **示例**：
+> - 评审范围：本报告基于 3 个需求文档（REQ-2024-001, REQ-2024-002, REQ-2024-003），对 XXX 模块的 main 分支代码进行评审
+> - 整体结论：平均一致性符合度为 85%，发现 5 个严重问题、12 个一般性问题，需要重点关注参数校验缺失问题
+
+---
+
+## 需求1：[REQ-2024-001] 评审结果
+
+### 需求概述
+[简要描述该需求的核心功能点，可从需求文档中提取关键信息]
+
+### 问题清单
+
+#### 严重问题
+
+【严重问题-001】[问题名称]
+- 问题位置：[文件路径] + [代码行号]/[模块名]
+- 问题描述：[明确说明与需求的偏差点，引用需求原文与代码片段对比]
+- 影响分析：[对业务流程、系统稳定性、数据安全的影响]
+- 修复建议：[明确对齐需求的修改方向与可落地的实现方案]
+
+---
+
+【严重问题-002】[问题名称]
+- 问题位置：[文件路径] + [代码行号]/[模块名]
+- 问题描述：[...]
+- 影响分析：[...]
+- 修复建议：[...]
+
+#### 一般性问题
+
+【一般问题-001】[问题名称]
+- 问题位置：[文件路径] + [代码行号]/[模块名]
+- 问题描述：[...]
+- 影响分析：[...]
+- 修复建议：[...]
+
+【一般问题-002】[问题名称]
+- ...
+
+---
+
+### 合规项说明
+
+列出该需求下完全符合需求定义的核心功能与模块，说明对齐情况，增强报告可信度。
+
+> **示例**：
+> - 用户注册功能：完整实现了需求中定义的手机号校验、验证码校验、用户信息入库逻辑，无偏差。
+> - 订单创建流程：核心业务流程、状态流转逻辑均与需求文档完全对齐，边界场景处理完整。
+
+---
+
+### 优化建议（可选）
+
+对该需求实现方式、代码结构中虽不影响一致性但可优化的点给出建议，提升代码质量。
+
+> **示例**：
+> - 订单状态判断逻辑可使用枚举类替代硬编码字符串，提升可维护性。
+> - 部分重复的参数校验逻辑可抽取为公共工具类，减少代码冗余。
+
+---
+
+### 一致性符合度
+
+| 指标 | 数值 | 说明 |
+|------|------|------|
+| 符合度 | XX% | 综合评估整体一致性，考虑问题严重程度（每个严重问题扣5-10%，一般问题扣1-3%） |
+| 核心功能覆盖率 | XX% | 需求定义的核心功能点在代码中的实现比例（已实现功能数/总功能数） |
+| 严重问题数 | X | 影响核心功能或系统稳定性的严重问题数量 |
+| 一般性问题数 | X | 不影响核心功能的一般性问题数量 |
+
+> **指标说明**：
+> - **符合度**：反映整体实现质量，值越低表示问题越多或越严重
+> - **核心功能覆盖率**：反映功能完整性，100%表示所有核心功能都已实现（但不代表实现质量好）
+> - **两者关系**：覆盖率100%但符合度低 = 功能齐全但质量差；覆盖率低但符合度高 = 已实现部分质量好但有功能缺失
+
+---
+
+## 需求2：[REQ-2024-002] 评审结果
+
+[结构与需求1相同，依次展示每个需求的评审结果]
+
+---
+
+## [后续需求...]
+
+[如有更多需求，按相同结构继续添加章节]
+
+---
+
+## 多需求一致性汇总
+
+| 需求编号 | 符合度 | 核心功能覆盖率 | 严重问题数 | 一般性问题数 | 合规项数 | 修复优先级 |
+|----------|--------|----------------|------------|--------------|----------|------------|
+| REQ-2024-001 | XX% | XX% | X | X | X | 高/中/低 |
+| REQ-2024-002 | XX% | XX% | X | X | X | 高/中/低 |
+| ... | ... | ... | ... | ... | ... | ... |
+| **平均值** | **XX%** | **XX%** | **X** | **X** | **X** | - |
+
+> **说明**：
+> - **符合度**：综合评估整体一致性，考虑问题数量和严重程度（每个严重问题扣5-10%，一般问题扣1-3%）
+> - **核心功能覆盖率**：需求定义的核心功能点在代码中的实现比例（已实现功能数/总功能数）
+> - **修复优先级**：高（存在严重问题或符合度<70%）、中（仅一般性问题且符合度70%-85%）、低（无明显问题且符合度>85%）
+
+---
+
+## 总体问题统计
+
+| 类别 | 数量 |
+|------|------|
+| 严重问题总计 | X |
+| 一般性问题总计 | X |
+| 合规项总计 | X |
+| 优化建议总计 | X |
+| **问题总数** | **X** |
+
+---
+
+## 修复建议优先级
+
+根据所有需求的问题严重程度，建议按以下顺序修复：
+
+1. **[高优先级]** [列出需要优先处理的严重问题，按影响程度排序]
+   - [问题1描述]
+   - [问题2描述]
+
+2. **[中优先级]** [列出次要问题]
+   - [问题3描述]
+   - [问题4描述]
+
+3. **[低优先级]** [优化建议和轻微问题]
+   - [优化建议1]
+   - [优化建议2]
+
+---
+
+## 七、输出要求
+
+1. **客观准确**：每个问题需给出明确判定依据
+2. **风险分级**：清晰区分严重问题与一般性问题
+3. **格式规范**：严格按照上述模板格式输出
+4. **禁止乱码**：禁止输出任何乱码、不可见字符、问号乱码串、特殊控制符、零宽空格
+
+---
+
+## 八、终端输出
+
+报告生成完成后，在终端输出：
+```
+✅ 步骤2+3完成：一致性校验与评审报告已生成并保存至 {完整文件路径}
+  - 报告文件：需求代码一致性评审报告.md
+  - 评审需求数：X 个
+  - 严重问题总计：X 个
+  - 一般性问题总计：X 个
+  - 平均一致性符合度：XX%
+```

package/bin/zhanlu-plugins/lingji-alpha-assistant/skills/code-check/scripts/gitlab_clone.py

@@ -0,0 +1,213 @@
+#!/usr/bin/env python3
+"""
+GitLab 代码拉取脚本（跨平台版）
+用法: python gitlab_clone.py --url <url> --path <path> [--branch <branch>]
+"""
+
+import argparse
+import json
+import os
+import shutil
+import subprocess
+import sys
+from pathlib import Path
+
+if sys.platform == "win32":
+    import io
+    sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding="utf-8", errors="replace")
+    sys.stderr = io.TextIOWrapper(sys.stderr.buffer, encoding="utf-8", errors="replace")
+
+
+def load_config(script_dir: Path) -> dict:
+    config_file = script_dir.parent / "config" / "gitlab_config.json"
+    if not config_file.exists():
+        print(f"[ERROR] 配置文件不存在: {config_file}")
+        print("请先创建配置文件并设置 GitLab Token")
+        sys.exit(1)
+    
+    try:
+        with open(config_file, "r", encoding="utf-8") as f:
+            return json.load(f)
+    except json.JSONDecodeError as e:
+        print(f"[ERROR] 配置文件格式错误: {e}")
+        sys.exit(1)
+
+
+def validate_url(url: str) -> bool:
+    return url.startswith("http://") or url.startswith("https://")
+
+
+def get_git_command(config: dict) -> str:
+    return config.get("git_path", "git")
+
+
+def check_git_available(git_cmd: str) -> bool:
+    try:
+        result = subprocess.run(
+            [git_cmd, "--version"],
+            capture_output=True,
+            text=True
+        )
+        if result.returncode == 0:
+            print(f"[OK] Git 版本: {result.stdout.strip()}")
+            return True
+    except FileNotFoundError:
+        pass
+    
+    print("[ERROR] 未找到 Git 命令，请确保已安装 Git 并添加到系统 PATH")
+    return False
+
+
+def create_directory(path: str) -> bool:
+    path_obj = Path(path)
+    
+    if path_obj.exists():
+        if any(path_obj.iterdir()):
+            print(f"[WARNING] 目录 {path} 不为空")
+            print("  继续操作可能会覆盖现有文件")
+            confirm = input("  是否继续？(y/n): ").strip().lower()
+            if confirm != 'y':
+                print("操作已取消")
+                return False
+        
+        path_obj.mkdir(parents=True, exist_ok=True)
+        print(f"[OK] 目录已存在: {path}")
+    else:
+        path_obj.mkdir(parents=True, exist_ok=True)
+        print(f"[OK] 创建目录: {path}")
+    
+    return True
+
+
+def clone_repository(git_cmd: str, url: str, path: str, branch: str, token: str) -> bool:
+    if url.startswith("https://"):
+        authenticated_url = url.replace("https://", f"https://oauth2:{token}@")
+    else:
+        authenticated_url = url.replace("http://", f"http://oauth2:{token}@")
+    
+    project_name = Path(url).stem.replace(".git", "")
+    
+    print("")
+    print("开始拉取代码...")
+    print(f"  仓库: {project_name}")
+    print(f"  URL: {url}")
+    print(f"  分支: {branch}")
+    print(f"  保存路径: {path}")
+    print("")
+    
+    try:
+        print("正在克隆仓库...")
+        
+        result = subprocess.run(
+            [git_cmd, "clone", "--depth", "1", "--branch", branch, authenticated_url, path],
+            capture_output=True,
+            text=True,
+            cwd=path
+        )
+        
+        if result.returncode == 0:
+            print("")
+            print("=" * 40)
+            print("  [SUCCESS] 代码拉取成功！")
+            print("=" * 40)
+            print("")
+            print(f"本地路径: {path}")
+            print("")
+            print("现在可以对此项目进行代码评审")
+            print("")
+            return True
+        else:
+            print_error(result.stderr or result.stdout, path)
+            return False
+            
+    except Exception as e:
+        print(f"[ERROR] {e}")
+        print_error(str(e), path)
+        return False
+
+
+def print_error(error_msg: str, path: str):
+    print("")
+    print("=" * 40)
+    print("  [FAILED] 代码拉取失败")
+    print("=" * 40)
+    print("")
+    print(f"错误信息: {error_msg}")
+    print("")
+    print("可能的原因:")
+    print("  1. GitLab Token 无效或已过期")
+    print("  2. 仓库地址不正确或无访问权限")
+    print("  3. 网络连接问题")
+    print("  4. 指定的分支不存在")
+    print("")
+    print("建议:")
+    print("  - 检查 config/gitlab_config.json 中的 Token 是否正确")
+    print("  - 确认仓库地址和分支名称是否正确")
+    print("  - 尝试在浏览器中访问该仓库确认是否有权限")
+    print("")
+    
+    try:
+        path_obj = Path(path)
+        if path_obj.exists() and not any(path_obj.iterdir()):
+            path_obj.rmdir()
+            print(f"已清理空目录: {path}")
+    except Exception:
+        pass
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="GitLab 代码拉取工具（跨平台版）",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+示例:
+  python gitlab_clone.py --url https://gitlab.com/group/project.git --path ./code
+  python gitlab_clone.py -u https://gitlab.com/group/project.git -p D:\\code\\review -b develop
+        """
+    )
+    
+    parser.add_argument("-u", "--url", required=True, help="GitLab 仓库 URL")
+    parser.add_argument("-p", "--path", required=True, help="本地保存路径")
+    parser.add_argument("-b", "--branch", default="", help="分支名称（默认使用配置文件中的 default_branch）")
+    parser.add_argument("-c", "--config", default="", help="配置文件路径（可选）")
+    
+    args = parser.parse_args()
+    
+    print("=" * 40)
+    print("  GitLab 代码拉取工具")
+    print("=" * 40)
+    print("")
+    
+    if not validate_url(args.url):
+        print("[ERROR] GitLab URL 格式不正确，必须以 http:// 或 https:// 开头")
+        sys.exit(1)
+    
+    script_dir = Path(__file__).parent.resolve()
+    config = load_config(script_dir)
+    
+    token = config.get("gitlab_token")
+    if not token or token == "YOUR_GITLAB_TOKEN_HERE":
+        print("[ERROR] GitLab Token 未配置")
+        print("请在 config/gitlab_config.json 中设置您的 GitLab Token")
+        sys.exit(1)
+    
+    branch = args.branch
+    if not branch:
+        branch = config.get("default_branch", "main")
+    
+    git_cmd = get_git_command(config)
+    
+    if not check_git_available(git_cmd):
+        sys.exit(1)
+    
+    if not create_directory(args.path):
+        sys.exit(0)
+    
+    if clone_repository(git_cmd, args.url, args.path, branch, token):
+        sys.exit(0)
+    else:
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()