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

package/bin/zhanlu-plugins/lingji-alpha-assistant/skills/code-review/prompts/step2_file_review.md

@@ -0,0 +1,83 @@
+# 第二步：文件级评审
+
+🚀 **性能优化提示**：
+- 若项目文件总数 > 500：仅对 P0 文件进行深度评审
+- 若项目文件总数 200-500：深度评审 P0 + 中度评审 P1
+- 若项目文件总数 < 200：全面评审 P0 + P1 + P2
+
+对每个待评审文件（按 P0 → P1 顺序），执行以下 **5 个核心步骤**：
+
+## 2.1 项目上下文检索（最小上下文闭包）
+
+**核心职责**：根据目标文件路径，按需检索「最小上下文闭包」，避免上下文爆炸，为后续评审提供精准关联信息。
+
+**执行步骤**：
+1. 读取目标文件的完整内容
+2. 基于全局依赖图，检索其直接关联文件（retrieval_depth = 1，仅直接依赖）
+3. 对关联文件**仅提取**：函数/类签名、接口定义、结构体定义、枚举定义
+4. **过滤掉**：具体实现代码、注释、空行、业务逻辑
+
+**输出格式**（内部结构化数据）：
+```json
+{
+  "target_file_content": "完整目标文件内容（已去注释/空行）",
+  "related_contexts": [
+    {
+      "file_path": "关联文件路径",
+      "signatures": "提取的签名内容（函数/类/接口/结构体）"
+    }
+  ]
+}
+```
+
+> 此步骤确保上下文量可控，同时保留足够的关联信息用于跨文件分析。
+
+## 2.2 文件级深度评审
+
+详细说明：`prompts/file_review_prompt.md`
+
+## 2.3 跨文件影响分析
+
+**输入**：
+- 上下文检索结果（2.1 输出）
+- 文件级评审结果（2.2 输出）
+- 全局依赖图（1.3 输出）
+
+**执行**：基于目标文件的问题清单和依赖图，分析对关联文件的潜在影响：
+1. 识别哪些关联文件会受当前问题的波及
+2. 评估是否存在以下风险：
+   - 接口不兼容（函数签名变更导致调用方失败）
+   - 调用链断裂（异常处理缺失导致中断）
+   - 数据不一致（事务边界错误、数据结构变更）
+   - 序列化/反序列化问题
+
+**输出**：跨文件影响报告（JSON 格式，内部记录）
+
+## 2.4 架构合规校验
+
+**输入**：
+- 目标文件路径和内容
+- 项目架构基线（1.2 输出）
+
+**核心检查点**：
+- **分层规范**：是否存在跨层调用（如 Controller 直接调用 Model/DAO）
+- **模块职责**：是否符合职责划分（如 Utils 层不应包含业务逻辑，Model 层不应包含 HTTP 处理）
+- **命名约定**：包名、类名、函数名是否符合语言规范和项目约定
+- **目录结构**：文件是否放置在正确的目录层级
+
+**输出**：架构合规检查结果（合规/违规及具体问题描述）
+
+## 2.5 结果汇总
+
+将上述 4 个子步骤的结果汇总为当前文件的评审结论，包括：
+- 问题清单（严重问题 + 一般问题）
+- 跨文件影响评估
+- 架构合规状态
+
+所有文件的评审结果将在第三步中统一汇总生成最终报告。
+
+注意：严格按照上述要求流程执行，禁止跳过或进行其他未设定的操作！执行完每个步骤必须按执行格式在终端输出显示，否则不清楚实际情况！
+
+✅ 执行完成后请输出: "✅ 步骤2完成：文件级评审已完成，共评审 {file_count} 个文件"
+
+

package/bin/zhanlu-plugins/lingji-alpha-assistant/skills/code-review/prompts/step3_report_generation.md

@@ -0,0 +1,319 @@
+# 第三步：报告生成
+
+## 角色设定
+
+你是一名资深代码评审专家，负责汇总所有文件的评审结果，生成专业的项目级代码评审报告。
+
+## 任务目标
+
+将多个单文件评审结果整合为一份结构化、专业的项目级代码评审报告，突出整体质量状况、核心风险和优先级建议。
+
+## 报告保存规范
+
+### 保存位置
+- **保存路径**: 被评审项目的根目录
+- **完整路径**: `{project_root_path}/{project_name}项目级代码评审分析报告.md`
+
+### 文件命名规则
+- **命名格式**: `{项目名称}项目级代码评审分析报告.md`
+- **示例**: 
+  - 项目名称为 "user-service" → `user-service项目级代码评审分析报告.md`
+  - 项目名称为 "order-management" → `order-management项目级代码评审分析报告.md`
+
+### 保存要求
+1. 报告生成完成后,必须将完整的 Markdown 内容保存到上述指定路径
+2. 使用 UTF-8 编码保存文件
+3. 如果同名文件已存在,询问用户是否覆盖或生成带时间戳的新文件名
+4. 保存成功后,向用户报告文件的完整路径
+
+### 注意事项
+- 如果无法直接写入文件系统,应将完整报告内容输出给用户,并明确告知应该保存的文件名和位置
+- 报告文件名中的"{项目名称}"应从项目架构基线中提取,或使用项目根目录的名称
+
+## 输入数据
+
+### 1. 项目架构基线
+```json
+{architecture_baseline}
+```
+
+### 2. 文件优先级分布
+```json
+{file_priority_distribution}
+```
+
+### 3. 单文件评审结果集合
+```
+{
+  "file_reviews": [
+    {
+      "file_path": "src/service/user.go",
+      "priority": "P0",
+      "critical_issues": [...],
+      "warning_issues": [...],
+      "architecture_compliance": {...}
+    },
+    ...
+  ]
+}
+```
+
+## 报告生成要求
+
+### ⛔ 绝对禁止事项（违反将导致报告无效）
+
+**在开始生成报告前，请牢记以下禁令：**
+
+1. **禁止添加任何额外章节**：报告只能包含模板中定义的5个章节，不得添加任何其他章节标题
+2. **禁止在报告末尾添加任何补充说明**：包括但不限于"评审范围"、"评审方法"、"局限性说明"、"后续建议"、"复评建议"、"免责声明"、"附录"等内容
+3. **禁止改变问题清单的表格格式**：严重问题和一般问题必须使用Markdown表格展示，不得使用标题+描述的列表形式
+4. **禁止省略"五、架构合规性评估"章节**：此章节为必需，即使没有发现架构问题也要如实填写
+5. **禁止在项目概览中省略JSON格式的架构基线**：必须包含完整的JSON代码块
+
+### 核心原则
+1. **全局视角**: 从项目整体角度总结问题，而非简单罗列各文件问题
+2. **风险聚焦**: 突出最严重的安全漏洞、架构缺陷和性能瓶颈
+3. ** actionable**: 提供可执行的改进建议和清晰的优先级
+4. **数据驱动**: 基于实际评审数据生成统计和结论
+
+### 汇总策略
+
+#### 问题去重与合并
+- 相同类型的问题在不同文件中出现时，合并为一条并标注影响范围
+- 示例: "SQL注入风险"在 5 个文件中出现 → 合并为一条，注明"影响 5 个文件"
+
+#### 严重程度重新评估
+- 单个文件中的一般问题，如果在多个核心文件中出现，可能升级为严重问题
+- 考虑问题的系统性影响，而非孤立看待
+
+#### 架构层面分析
+- 从所有文件的架构合规性检查结果中，提炼出项目级的架构问题
+- 识别跨模块的依赖问题和职责混乱
+
+## 报告模板
+
+请严格按照以下 Markdown 格式生成项目级评审报告：
+
+```markdown
+# 代码评审报告
+
+> 生成时间：{timestamp}
+> 评审范围：{project_path}
+
+---
+
+## 一、项目概览
+
+| 项目 | 信息 |
+|------|------|
+| 项目名称 | {name} |
+| 主语言 | {language} |
+| 技术栈 | {tech_stack} |
+| 架构类型 | {architecture} |
+| 评审文件数 | {total_files} (P0: {p0_count}, P1: {p1_count}, P2: {p2_count}) |
+
+### 项目架构基线
+
+```json
+{
+  "project_name": "{name}",
+  "main_language": "{language}",
+  "tech_stack": ["{framework1}", "{framework2}"],
+  "architecture": "{MVC/微服务/前后端分离/单体}",
+  "module_layers": {
+    "controller": "{controller层路径}",
+    "service": "{service层路径}",
+    "model": "{model层路径}",
+    "utils": "{utils层路径}"
+  },
+  "entry_files": ["{入口文件1}", "{入口文件2}"]
+}
+```
+
+
+---
+
+## 二、总体评价
+
+### 代码质量总结
+{从整体角度评估项目代码质量，2-3句话概括}
+{示例: "项目整体代码质量中等，核心业务逻辑实现较为规范，但存在多处安全漏洞和架构设计问题需要优先修复。"}
+
+### 主要优点
+- {优点1：具体的优秀实践，如"Service层职责划分清晰"}
+- {优点2：值得保持的代码风格或设计，如"单元测试覆盖率达到85%"}
+- {优点3：架构或工程化方面的亮点}
+
+### 核心风险
+- {风险1：最严重的安全漏洞或架构缺陷}
+- {风险2：可能导致服务故障的性能或并发问题}
+- {风险3：影响可维护性的设计问题}
+
+---
+
+## 三、问题清单
+
+> **说明**: 以下问题已进行去重和合并，相同类型的问题在不同文件中出现时已汇总。
+
+### 【严重问题】（必须修复）
+
+| # | 评审点 | 影响文件数 | 典型位置 | 问题描述 | 修改建议 |
+|---|--------|-----------|---------|----------|----------|
+| 1 | {评审点名称} | {count}个文件 | {file_path}:L{line} | {详细描述问题现象和系统性影响} | {具体的修复方案和最佳实践} |
+| 2 | ... | ... | ... | ... | ... |
+
+> 共发现 **{critical_count}** 个严重问题，影响 {affected_files_count} 个文件
+
+**严重问题分布**:
+- 安全漏洞: {count} 个
+- 架构缺陷: {count} 个
+- 性能瓶颈: {count} 个
+- 其他: {count} 个
+
+---
+
+### 【一般问题】（建议修复）
+
+| # | 评审点 | 文件 | 行号 | 问题描述 | 修改建议 |
+|---|--------|------|------|----------|----------|
+| 1 | {评审点名称} | {file_path} | {line} | {详细描述} | {具体建议} |
+| 2 | ... | ... | ... | ... | ... |
+
+> 共发现 **{warning_count}** 个一般问题
+
+---
+
+## 四、改进建议优先级
+
+### 高优先级（严重问题，应立即修复）
+
+> **修复时限**: 1-3天内
+
+1. **{问题简述}** ({影响文件数}个文件)
+   - **风险**: {为什么需要优先修复，可能的影响}
+   - **修复方案**: {具体的修复步骤}
+   - **涉及文件**: {file1}, {file2}, ...
+
+2. **{问题简述}** ({影响文件数}个文件)
+   - **风险**: {风险评估}
+   - **修复方案**: {具体的修复步骤}
+   - **涉及文件**: {...}
+
+### 中优先级（潜在风险，建议近期修复）
+
+> **修复时限**: 1-2周内
+
+1. **{问题简述}**
+   - **收益**: {优化后的改进效果}
+   - **修复方案**: {改进方向}
+
+2. **{问题简述}**
+   - **收益**: {改进价值}
+   - **修复方案**: {...}
+
+### 低优先级（优化建议，可逐步改进）
+
+> **修复时限**: 1-2个月内或迭代优化
+
+1. **{问题简述}**
+   - **价值**: {长期优化方向}
+   - **建议**: {代码质量提升建议}
+
+2. **{问题简述}**
+   - **价值**: {...}
+   - **建议**: {...}
+
+---
+
+## 五、架构合规性评估
+
+### 分层规范检查结果
+
+| 调用链路 | 检查结果 | 违规文件数 | 典型问题 |
+|---------|---------|-----------|----------|
+| Controller → Service | {合规/存在违规} | {count}个 | {具体问题描述} |
+| Service → Model | {合规/存在违规} | {count}个 | {...} |
+| 跨层调用 | {无/存在} | {count}个 | {描述违规情况} |
+
+**分层规范总结**: {从整体角度评价项目的分层架构执行情况}
+
+### 模块职责划分评估
+
+| 模块层级 | 职责清晰度 | 主要问题 | 建议 |
+|---------|-----------|---------|------|
+| Controller层 | {清晰/一般/混乱} | {问题描述} | {改进建议} |
+| Service层 | {清晰/一般/混乱} | {...} | {...} |
+| Model层 | {清晰/一般/混乱} | {...} | {...} |
+| Utils层 | {清晰/一般/混乱} | {...} | {...} |
+
+**模块职责总结**: {评价项目整体的模块职责划分是否合理}
+
+### 依赖关系评估
+
+- **循环依赖**: {存在/不存在}
+  - {如存在，列出循环依赖链路: A → B → C → A}
+  
+- **过度耦合模块**: 
+  - {模块1}: 被 {count} 个模块依赖，耦合度过高
+  - {模块2}: {...}
+  
+- **依赖方向合理性**: {合理/存在问题}
+  - {如存在问题，描述具体的依赖方向错误}
+
+**依赖关系总结**: {从整体角度评价项目的依赖管理是否健康}
+
+---
+
+⚠️ **强制约束（必须严格遵守）**：
+
+### 章节限制
+1. **报告必须且只能包含以下5个章节**，按顺序排列：
+   - 一、项目概览
+   - 二、总体评价
+   - 三、问题清单
+   - 四、改进建议优先级
+   - 五、架构合规性评估
+
+2. **严禁添加以下任何章节**（常见错误示例）：
+   - ❌ "代码与功能一致性评审"
+   - ❌ "技术架构先进性评审"
+   - ❌ "问题统计汇总"
+   - ❌ "附录"或"评审文件清单"
+   - ❌ "评审说明"、"评审范围"、"评审方法"
+   - ❌ "局限性说明"、"后续建议"、"复评建议"
+   - ❌ 任何未在模板中定义的章节标题
+
+### 格式要求
+3. **问题清单必须使用表格格式**：
+   - 严重问题：使用带列头的Markdown表格（# | 评审点 | 影响文件数 | 典型位置 | 问题描述 | 修改建议）
+   - 一般问题：使用带列头的Markdown表格（# | 评审点 | 文件 | 行号 | 问题描述 | 修改建议）
+   - **禁止**使用"### 问题1: xxx"这样的标题+描述形式
+
+4. **必须在"五、架构合规性评估"后立即结束报告**：
+   - 报告最后一个字符应该是架构合规性评估章节的内容
+   - **禁止**在报告末尾添加任何形式的补充说明、免责声明、总结语或签名
+   - **禁止**添加类似"*本报告由自动化代码评审工具生成，仅供参考*"的文字
+
+### 内容完整性
+5. **项目概览必须包含JSON格式的架构基线**：
+   - 在表格之后必须有一个```json代码块，包含完整的项目架构信息
+   - 不得省略此JSON代码块
+
+6. **总体评价必须分别列出"主要优点"和"核心风险"**：
+   - 使用无序列表格式（- 开头）
+   - 不得将优点和风险混合在一个段落中
+
+### 执行验证
+7. **生成报告后，请自我检查**：
+   - ✓ 是否只有5个章节？
+   - ✓ 是否有额外的章节标题？
+   - ✓ 问题清单是否使用了表格格式？
+   - ✓ 是否包含JSON格式的架构基线？
+   - ✓ 报告是否在"五、架构合规性评估"后立即结束？
+   - ✓ 末尾是否有任何补充说明或免责声明？
+   
+   **如果以上任何一项答案为"否"，请立即修正后再输出报告！**
+
+注意：严格按照上述要求流程执行，禁止跳过或进行其他未设定的操作！禁止新增无关（未设定）的内容章节输出；执行完每个步骤必须按执行格式在终端输出显示，否则不清楚实际情况！
+
+✅ 执行完成后请输出: "✅ 步骤3完成：代码评审报告已生成并保存至 {完整文件路径}"

package/bin/zhanlu-plugins/lingji-alpha-assistant/skills/code-review/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()