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

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

@@ -0,0 +1,144 @@
+#!/usr/bin/env python3
+"""
+Excel 需求编号读取脚本（跨平台版）
+用法: python read_excel_requirements.py --excel-path <path>
+"""
+
+import argparse
+import os
+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 validate_excel_path(excel_path: str) -> bool:
+    if not Path(excel_path).exists():
+        print(f"[ERROR] Excel 文件不存在: {excel_path}")
+        return False
+
+    ext = Path(excel_path).suffix.lower()
+    if ext not in (".xlsx", ".xls"):
+        print(f"[ERROR] 不支持的文件格式: {ext}")
+        print("请使用 .xlsx 或 .xls 格式")
+        return False
+
+    return True
+
+
+def read_requirements(excel_path: str) -> list[str]:
+    try:
+        import openpyxl
+    except ImportError:
+        print("[ERROR] 缺少 openpyxl 库，请运行: pip install openpyxl")
+        sys.exit(1)
+
+    wb = openpyxl.load_workbook(excel_path)
+    ws = wb.active
+
+    rows = list(ws.iter_rows(values_only=True))
+
+    if not rows:
+        print("[ERROR] Excel 文件为空")
+        sys.exit(1)
+
+    header_row = rows[0]
+
+    requirement_col_index = None
+    keywords = ['requirement', 'req', 'id', 'number', 'no', '需求', '编号']
+    for idx, cell in enumerate(header_row):
+        if cell and any(kw in str(cell).lower() for kw in keywords):
+            requirement_col_index = idx
+            break
+
+    if requirement_col_index is None:
+        requirement_col_index = 0
+
+    requirements = []
+    for row in rows[1:]:
+        if row and len(row) > requirement_col_index:
+            value = row[requirement_col_index]
+            if value and str(value).strip():
+                req_id = str(value).strip()
+                if req_id and req_id != str(header_row[requirement_col_index]):
+                    requirements.append(req_id)
+
+    return requirements
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="Excel 需求编号读取工具（跨平台版）",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+示例:
+  python read_excel_requirements.py --excel-path "D:\\需求编号.xlsx"
+  python read_excel_requirements.py -e "C:\\data\\requirements.xls"
+        """
+    )
+
+    parser.add_argument(
+        "-e", "--excel-path",
+        required=True,
+        help="Excel 文件路径（.xlsx 或 .xls）"
+    )
+
+    args = parser.parse_args()
+
+    print("=" * 40)
+    print("  Excel 需求编号读取工具")
+    print("=" * 40)
+    print("")
+
+    if not validate_excel_path(args.excel_path):
+        sys.exit(1)
+
+    print("正在读取 Excel 文件...")
+    print(f"  文件路径: {args.excel_path}")
+    print("")
+
+    try:
+        requirements = read_requirements(args.excel_path)
+    except Exception as e:
+        print("")
+        print("=" * 40)
+        print("  [FAILED] 读取 Excel 文件失败")
+        print("=" * 40)
+        print("")
+        print(f"错误信息: {e}")
+        print("")
+        sys.exit(1)
+
+    if not requirements:
+        print("")
+        print("=" * 40)
+        print("  [FAILED] 未找到需求编号")
+        print("=" * 40)
+        print("")
+        print("建议: 确保 Excel 文件中包含需求编号列")
+        print("  列名应包含关键词: 需求、编号、requirement、req、id、number、no")
+        print("")
+        sys.exit(1)
+
+    result = ','.join(requirements)
+
+    print("")
+    print("=" * 40)
+    print("  [SUCCESS] Excel 文件读取成功！")
+    print("=" * 40)
+    print("")
+    print(f"文件路径: {args.excel_path}")
+    print(f"需求编号数量: {len(requirements)}")
+    print("需求编号列表:")
+    for req in requirements:
+        print(f"  - {req}")
+    print("")
+    print(result)
+    print("")
+
+
+if __name__ == "__main__":
+    main()

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

@@ -0,0 +1,160 @@
+# GitLab 代码评审使用指南
+
+## 📋 目录
+- [首次配置](#首次配置)
+- [使用方式](#使用方式)
+- [常见问题](#常见问题)
+
+---
+
+## 首次配置
+
+### 1. 获取 GitLab Personal Access Token
+
+1. 登录您的 GitLab 账户
+2. 点击右上角头像 → **Preferences** → **Access Tokens**
+3. 点击 **Add new token**
+4. 填写以下信息：
+   - **Token name**: 例如 "Code Review Skill"
+   - **Expiration date**: 设置过期时间（建议至少 90 天）
+   - **Scopes**: 勾选 `read_api` 和 `read_repository`
+5. 点击 **Create personal access token**
+6. **立即复制并保存 Token**（只显示一次）
+
+### 2. 配置 Token
+
+打开 `config/gitlab_config.json` 文件：
+
+```json
+{
+  "gitlab_token": "YOUR_GITLAB_TOKEN_HERE",
+  "default_branch": "main",
+  "git_path": "git"
+}
+```
+
+将 `YOUR_GITLAB_TOKEN_HERE` 替换为您刚才复制的 Token：
+
+```json
+{
+  "gitlab_token": "glpat-xxxxxxxxxxxxxxxxxxxx",
+  "default_branch": "main",
+  "git_path": "git"
+}
+```
+
+保存文件即可。
+
+> ⚠️ **安全提醒**：
+> - Token 以明文存储，请妥善保管
+> - 不要将配置文件提交到版本控制系统
+> - 定期更换 Token
+
+---
+
+## 使用方式
+
+### 方式一：GitLab 远程仓库评审
+
+**基本语法**：
+```
+评审 GitLab <GitLab仓库URL> <本地保存路径>
+```
+
+**示例**：
+
+1. **评审公开仓库**：
+   ```
+   评审 GitLab https://gitlab.com/group/project.git D:\code\review\project
+   ```
+
+2. **评审私有仓库**：
+   ```
+   评审 GitLab https://gitlab.company.com/team/backend.git D:\code\backend
+   ```
+
+3. **指定分支**（可选，默认使用 main/master）：
+   ```
+   评审 GitLab https://gitlab.com/group/project.git D:\code\review --branch develop
+   ```
+
+**执行流程**：
+1. 自动从 GitLab 拉取代码到指定路径
+2. 对拉取的代码执行完整的三步评审流程
+3. 生成评审报告并保存到项目根目录
+
+### 方式二：本地项目评审（原有功能）
+
+**基本语法**：
+```
+项目级代码评审 @<本地项目路径>
+```
+
+**示例**：
+```
+项目级代码评审 @D:\workspace\myproject
+```
+
+或直接在聊天中提及项目：
+```
+代码评审 @D:\workspace\myproject
+```
+
+---
+
+## 常见问题
+
+### Q1: Token 配置后仍然提示未配置？
+
+**A**: 检查以下几点：
+1. 确认 `config/gitlab_config.json` 文件存在且格式正确
+2. 确认 Token 没有多余的空格或引号
+3. 重启 Lingma IDE 使配置生效
+
+### Q2: 拉取代码失败，提示认证错误？
+
+**A**: 
+1. 确认 Token 有效且未过期
+2. 确认 Token 具有 `read_repository` 权限
+3. 尝试在浏览器中访问该仓库，确认有访问权限
+4. 如果是企业版 GitLab，确认 URL 地址正确
+
+### Q3: 可以评审 GitHub 仓库吗？
+
+**A**: 当前版本仅支持 GitLab。如需支持 GitHub，需要额外开发相应的拉取脚本。
+
+### Q4: 拉取的代码会保留多久？
+
+**A**: 代码会永久保存在您指定的路径下，除非您手动删除。建议定期清理不再需要的代码。
+
+### Q5: 如何更新已拉取的代码？
+
+**A**: 目前需要手动删除旧代码后重新拉取，或者进入目录执行 `git pull`。未来版本可能会增加自动更新功能。
+
+### Q6: 评审大型仓库会很慢吗？
+
+**A**: 
+- 代码拉取使用浅克隆（--depth 1），速度较快
+- 评审时间取决于项目大小，大型项目（>500 文件）会自动优化，只深度评审核心文件
+- 建议优先评审 P0 核心文件
+
+### Q7: Token 泄露了怎么办？
+
+**A**: 
+1. 立即在 GitLab 中撤销该 Token
+2. 生成新的 Token 并更新配置
+3. 检查是否有未授权的访问记录
+
+---
+
+## 技术支持
+
+如遇到其他问题，请：
+1. 查看 `README.md` 获取详细文档
+2. 查看 `QUICK_REFERENCE.md` 获取快速参考
+3. 联系项目维护团队
+
+---
+
+**最后更新**: 2026-05-12  
+**版本**: v1.5.0

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

@@ -0,0 +1,149 @@
+# 代码评审 Skill - 快速参考
+
+## 🚀 快速开始
+
+### 触发方式
+在 Lingma IDE 中输入以下任一命令:
+- `项目级代码评审`
+- `代码评审 @项目路径`
+- `评审代码`
+- `评审 GitLab https://gitlab.com/group/project.git D:\code\review` ⭐新增
+
+### 评审范围
+自动覆盖 **3大维度 25个评审点**:
+- ✅ 代码质量(22点): 可读性、安全性、性能、并发等
+- ✅ 功能一致性(1点): 需求实现完整性
+- ✅ 架构先进性(2点): 技术栈时效性、扩展性
+
+### GitLab 评审特殊说明 ⭐
+- 首次使用需配置 `config/gitlab_config.json` 中的 Token
+- 支持私有仓库评审（需配置有效 Token）
+- 自动拉取指定分支代码（默认 main/master）
+- 支持浅克隆以提高拉取速度
+
+### 报告输出
+- **文件名**: `{项目名称}项目级代码评审分析报告.md`
+- **保存位置**: 被评审项目的根目录
+- **格式**: Markdown (.md), UTF-8 编码
+
+---
+
+## 📂 目录结构速查
+
+```
+code-review-skill/
+├── SKILL.md                    ← 主入口(包含角色设定和流程)
+├── README.md                   ← 详细说明
+├── QUICK_REFERENCE.md          ← 快速参考
+├── config/                     ← 配置文件目录 ⭐新增
+│   └── gitlab_config.json     ← GitLab 配置（Token、分支等）
+├── scripts/                    ← 脚本目录 ⭐新增
+│   └── gitlab_clone.ps1       ← GitLab 代码拉取脚本
+├── assets/
+│   └── review_standards.md    ← 评审标准库 ⭐
+└── prompts/                    ← 提示词模块
+    ├── step1_project_preprocessing.md ← 项目预处理
+    ├── step2_file_review.md          ← 文件评审流程
+    ├── file_review_prompt.md         ← 文件评审详细提示词 ⭐新增
+    ├── step3_report_generation.md    ← 报告模板
+    └── output_requirements.md        ← 输出要求
+```
+
+---
+
+## 🛠️ 常用修改场景
+
+### 1️⃣ 更新评审规则
+**文件**: `assets/review_standards.md`  
+**示例**: 添加新的安全检查项或调整判定标准
+
+### 2️⃣ 调整评审流程
+**文件**: `prompts/step*.md`  
+- `step1`: 项目预处理(文件过滤、架构分析)
+- `step2`: 文件级评审流程框架
+- `file_review_prompt`: 文件评审详细提示词 ⭐核心
+- `step3`: 报告生成(输出格式)
+
+### 3️⃣ 修改报告样式
+**文件**: `prompts/step3_report_generation.md`  
+**内容**: Markdown 报告模板
+
+### 4️⃣ 更改触发词
+**文件**: `SKILL.md` (顶部 YAML 区域)  
+**字段**: `trigger_words`
+
+### 5️⃣ 配置 GitLab Token ⭐新增
+**文件**: `config/gitlab_config.json`  
+**操作**: 将 `YOUR_GITLAB_TOKEN_HERE` 替换为您的 GitLab Personal Access Token
+
+---
+
+## 📊 评审流程概览
+
+```
+用户触发
+   ↓
+[Step 0] 代码准备 ⭐新增
+  ├─ GitLab URL → 自动拉取代码到本地
+  └─ 本地路径 → 直接使用
+   ↓
+[Step 1] 项目预处理
+  ├─ 文件过滤(排除非核心文件)
+  ├─ 架构基线提取(识别技术栈)
+  ├─ 依赖关系分析(构建DAG)
+  └─ 文件优先级划分(P0/P1/P2)
+   ↓
+[Step 2] 文件级评审 (按 P0→P1 顺序)
+  ├─ 2.1 上下文检索(最小闭包)
+  ├─ 2.2 深度评审(25个评审点)
+  ├─ 2.3 跨文件影响分析
+  ├─ 2.4 架构合规校验
+  └─ 2.5 结果汇总
+   ↓
+[Step 3] 生成报告
+  └─ 结构化 Markdown 报告
+```
+
+---
+
+## 💡 最佳实践
+
+### Token 优化
+- P0 文件: 深度评审(完整上下文)
+- P1 文件: 中度评审(精简上下文)
+- P2 文件: 轻度评审或跳过
+
+### 大型项目 (>500文件)
+- 优先评审 P0 核心文件
+- 分批次执行,避免超时
+- 重点关注安全和性能问题
+
+### 动态语言 (Python/JS)
+- 部分类型安全问题可能无法检测
+- 建议结合静态分析工具使用
+
+---
+
+## 🔧 故障排查
+
+### Q: Skill 不生效?
+A: 重启 Lingma IDE,确认文件已安装到正确目录
+
+### Q: 评审结果不完整?
+A: 检查项目是否过大,尝试只评审 P0 文件
+
+### Q: 如何自定义评审范围?
+A: 在触发时指定: `项目级代码评审 @项目路径 --focus=security`
+
+---
+
+## 📞 更多信息
+
+- 详细文档: 查看 `README.md`
+- 重构说明: 查看 `REFACTORING_SUMMARY.md`
+- 评审标准: 查看 `assets/review_standards.md`
+
+---
+
+**版本**: v1.5.0 (GitLab 代码拉取功能增强)  
+**最后更新**: 2026-05-12

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

@@ -0,0 +1,134 @@
+# 代码评审 Skill 目录结构说明
+
+## 📁 目录结构
+
+```
+code-review-skill/
+├── SKILL.md                    # 主 Skill 文件（核心入口，包含角色设定和执行流程）
+├── README.md                   # 本说明文件
+├── QUICK_REFERENCE.md          # 快速参考卡片
+├── config/                     # 配置文件目录
+│   └── gitlab_config.json     # GitLab 配置（Token、分支等）
+├── scripts/                    # 脚本目录
+│   └── gitlab_clone.ps1       # GitLab 代码拉取脚本
+├── assets/                     # 静态资源目录
+│   └── review_standards.md    # 评审标准库（25个评审点的详细规则）
+└── prompts/                    # 提示词模块目录（可独立维护）
+    ├── step1_project_preprocessing.md # 第一步：项目预处理流程
+    ├── step2_file_review.md          # 第二步：文件级评审流程框架
+    ├── file_review_prompt.md         # 文件级深度评审详细提示词 ⭐
+    ├── step3_report_generation.md    # 第三步：报告生成模板
+    └── output_requirements.md        # 输出要求与使用说明
+```
+
+## 📝 文件说明
+
+### 核心文件
+
+- **SKILL.md**: Skill 的主入口文件，包含元数据（名称、版本、触发词）、角色设定和执行流程框架。
+- **GITLAB_USAGE.md**: GitLab 代码评审使用指南（⭐新增）
+
+### 配置文件
+
+- **config/gitlab_config.json**: GitLab 配置，包含 Token、默认分支等设置（⭐新增）
+- **scripts/gitlab_clone.ps1**: GitLab 代码拉取脚本（⭐新增）
+
+### 评审标准
+
+- **assets/review_standards.md**: 存放所有 25 个评审点的详细规则，包括：
+  - 评审点描述
+  - 一般性问题判定标准
+  - 严重问题判定标准
+  
+  > 💡 更新评审规则时，只需修改此文件，无需改动其他文件。
+
+### 提示词模块
+
+- **prompts/step1_project_preprocessing.md**: 项目预处理的详细步骤（文件过滤、架构分析、依赖图构建、优先级划分）
+- **prompts/step2_file_review.md**: 文件级评审的流程框架，引用 `file_review_prompt.md`
+- **prompts/file_review_prompt.md**: ⭐ 文件级深度评审的详细提示词（243行），包含完整的评审指导、输出格式、评审原则等
+- **prompts/step3_report_generation.md**: 最终报告的 Markdown 模板
+- **prompts/output_requirements.md**: 输出质量要求和使用说明
+
+## 🔄 模块化优势
+
+### 1. **易于维护**
+- 每个模块职责单一，修改时不影响其他部分
+- 评审标准独立存放，更新规则无需改动流程逻辑
+
+### 2. **便于扩展**
+- 新增评审维度：在 `review_standards.md` 中添加即可
+- 调整评审流程：修改对应的 `step*.md` 文件
+- 优化报告格式：仅修改 `step3_report_generation.md`
+
+### 3. **清晰可读**
+- 主文件简洁明了，聚焦整体流程
+- 详细内容分散在各模块，避免单文件过长
+- 模块命名直观，快速定位需要修改的内容
+
+### 4. **复用性强**
+- 各模块可独立测试和优化
+- 评审标准可在其他项目中复用
+- 提示词模块可根据需要组合使用
+
+## 🛠️ 修改指南
+
+### 更新评审标准
+编辑 `assets/review_standards.md`，添加或修改评审点规则。
+
+### 调整评审流程
+根据要修改的步骤，编辑对应的 `prompts/step*.md` 文件。
+
+### 修改报告格式
+编辑 `prompts/step3_report_generation.md` 中的报告模板。
+
+### 更改触发词或元数据
+编辑 `SKILL.md` 顶部的 YAML frontmatter 部分。
+
+## 📊 报告输出
+
+- **文件名**: `{项目名称}项目级代码评审分析报告.md`
+- **保存位置**: 被评审项目的根目录
+- **格式**: Markdown (.md)
+- **编码**: UTF-8
+- **内容**: 包含项目概览、问题清单、改进建议、架构评估等完整评审结果
+
+**示例**:
+- 评审 `user-service` 项目 → 生成 `user-service/user-service项目级代码评审分析报告.md`
+- 评审 `order-management` 项目 → 生成 `order-management/order-management项目级代码评审分析报告.md`
+
+## 📦 安装与使用
+
+### 首次使用配置
+
+**GitLab Token 配置**（仅 GitLab 评审需要）：
+1. 打开 `config/gitlab_config.json` 文件
+2. 将 `YOUR_GITLAB_TOKEN_HERE` 替换为您的 GitLab Personal Access Token
+3. 保存文件
+
+> ⚠️ **安全提醒**：Token 以明文存储，请妥善保管配置文件，不要提交到版本控制系统
+
+### 使用方式
+
+**方式一：GitLab 远程仓库评审**
+```bash
+评审 GitLab https://gitlab.com/group/project.git D:\code\review
+```
+- 自动从 GitLab 拉取代码到指定路径
+- 然后执行完整的代码评审流程
+- 支持私有仓库（需配置 Token）
+
+**方式二：本地项目评审**
+```bash
+项目级代码评审 @D:\workspace\myproject
+```
+- 直接对本地已有项目进行评审
+- 保持原有功能不变
+
+### 更多文档
+
+- **GitLab 使用指南**: 查看 `GITLAB_USAGE.md` 获取详细的 GitLab Token 配置和使用说明
+- **快速参考**: 查看 `QUICK_REFERENCE.md` 获取常用命令和故障排查
+- **评审标准**: 查看 `assets/review_standards.md` 了解 25 个评审点的详细规则
+
+参见主目录下的安装说明文档。