CI/CD 质量门禁（swe-rex + deepcode + code-review-graph） 已实测

场景

你在 CI/CD 里想要一道真正的「质量门禁」：跑测试时不怕代码把环境搞炸（沙箱隔离）、提交前自动查出潜在问题（静态分析）、审查时看清改动的影响面（关联图谱）。但三件事是三种工具，你会担心：沙箱要不要 Docker？分析器要不要配 AI provider？三个 pip 包装一起会不会冲突？

本组合包给答案：swe-rex 沙箱安全执行（跑代码不怕炸环境）、deepcode 静态分析（提交前查问题）、code-review-graph（crg） 审查图谱（构建代码关联图）。三件已实测共装兼容（3/3 对子 verified），全 CLI 面、无注册面写入。

组合成员 （3）

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple swe-rex==1.4.0
swerex-remote --help   # 预期输出: usage: swerex-remote [-h] [--host HOST] [--port PORT] --auth-token AUTH_TOKEN

pip install deepcode-hku --index-url https://pypi.tuna.tsinghua.edu.cn/simple
deepcode --version   # 预期输出: DeepCode 2.1.0

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple code-review-graph==2.3.8
code-review-graph --version   # 预期输出: code-review-graph 2.3.8

方案总览

备选方案：只要「提交前查问题」→ 只装 deepcode；只要「安全执行」→ 只装 swe-rex。三件一起装不打架（CLI 面写面互不重叠，实测）。顺序逻辑：先底座（swe-rex）→ 再分析器（deepcode）→ 最后图谱（crg），按「底座 → 分析 → 图谱」语义装；三者同 venv 共装实测兼容，任意顺序其实都行。

快速开始

一键脚本由本文档自动生成（渲染后位于 pages/combos/combo-cicd-quality.sh），逐条执行：

bash pages/combos/combo-cicd-quality.sh

• 装完你会得到：swerex-remote / deepcode / code-review-graph 三个命令全部可用，CI/CD 质量门禁三件套就位。
• 预计耗时：10-15 分钟。最大卡点 = deepcode 全量依赖安装（40s 量级，网络差时更长；Python 3.12 要求比另两件高）。
• 前置条件：Python >= 3.12（deepcode；swe-rex/crg 需 3.10+）；真实沙箱执行需 Docker（未实测，CLI 层已验）。

想弄明白每一步在干什么、装错了怎么恢复 → 看「逐步教学」。一键脚本出问题 → 按逐步教学手动执行定位。

逐步教学

第 1 步：装 swe-rex（沙箱执行底座）

swe-rex 让代码在沙箱里安全执行——跑测试、跑脚本不怕把 CI 环境搞炸。它是个 Python 包，装完提供 swerex-remote 命令（起沙箱服务）。注意：真实沙箱执行依赖 Docker，本环境未实测沙箱运行（无 Docker 执行沙箱），CLI 层实测通过——先装好命令，实际跑沙箱前确保目标机有 Docker。

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple swe-rex==1.4.0
swerex-remote --help   # 预期输出: usage: swerex-remote [-h] [--host HOST] [--port PORT] --auth-token AUTH_TOKEN

预期输出: usage: swerex-remote [-h] [--host HOST] [--port PORT] --auth-token AUTH_TOKEN

装好确认：

• swerex-remote --help 打印 usage（说明命令面就位）；
• swerex-remote --version（若支持）输出 1.4.0。

卡住怎么办：

• pip 超时 → 命令已带清华镜像；仍失败换阿里云源 -i https://mirrors.aliyun.com/pypi/simple。
• 依赖冲突（已有其他包）→ 用隔离 venv：python3 -m venv ~/.venvs/ciq && source ~/.venvs/ciq/bin/activate 再装。
• 跑沙箱报 Docker 错 → 沙箱执行需要 Docker（本组合未实测），先确认 docker info 可用。

第 2 步：装 deepcode（静态分析）

deepcode 在提交前查问题。它是重件：Python >= 3.12，全量依赖安装实测约 40 秒（网络差时更长），这是整套安装的最大耗时点。装完还需配置 provider 才能跑分析（deepcode init + deepcode provider set；本地 provider 不需要云 key）。

pip install deepcode-hku --index-url https://pypi.tuna.tsinghua.edu.cn/simple
deepcode --version   # 预期输出: DeepCode 2.1.0

预期输出: DeepCode 2.1.0

装好确认：

• deepcode --version 输出 DeepCode 2.1.0；
• deepcode init 初始化成功（首次运行会引导配置）。

卡住怎么办：

• 安装 40s+ 甚至更久（依赖多）→ 正常现象，等；超时重试一次（pip 断点续传）。
• Python 版本不够（3.10/3.11）→ deepcode 需要 3.12，先 sudo apt install python3.12 或换环境。
• 跑任务报 provider 未配置 → 按 deepcode provider set <厂商> --api-key <key> 配置；本地推理不需要云 key。

第 3 步：装 code-review-graph（审查图谱）

crg 构建代码关联图，审查时看清一个改动影响哪些文件。轻件（依赖少），与 swe-rex/deepcode 同 venv 共装实测兼容。不要执行 crg install 注册子命令（会写 ~/.claude.json 等注册面），本组合只用 CLI 面。

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple code-review-graph==2.3.8
code-review-graph --version   # 预期输出: code-review-graph 2.3.8

预期输出: code-review-graph 2.3.8

装好确认：

• code-review-graph --version 输出版本号 2.3.8；
• 工作区跑 code-review-graph build 成功（生成 .code-review-graph/）。

卡住怎么办：

• 装不上（依赖冲突）→ 与其它两件同一 venv 实测兼容；异常时先卸载重装。
• build 失败 → 确认在 git 仓库根目录；语言配置按 crg 文档补。

装完验收（一步到位）

作用：装完跑下面一条命令块，全绿 = 本组合包就绪；某条失败 → 回「逐步教学」对应步骤定位。

swerex-remote --help
deepcode --version
code-review-graph --version

预期输出: swerex-remote 打印 usage；DeepCode 2.1.0；code-review-graph 2.3.8。全绿 = 质量门禁三件套命令面就位

注：成员级命令已实测；真实沙箱执行需 Docker，未实测、如实标注。

日常使用

启动与入口

• swe-rex：swerex-remote --auth-token <token> 起沙箱服务（Docker 环境）；或在代码里调用客户端连沙箱。
• deepcode：deepcode init（初始化）→ deepcode provider set <厂商> --api-key <key>（配 provider）→ deepcode run（分析）。
• crg：code-review-graph build（建图）→ code-review-graph status（看图状态）。

常用操作

1. 门禁流程：跑测试用 swe-rex 沙箱 → 提交前 deepcode run 查问题 → 审查时 code-review-graph build 看影响面。
2. 状态检查：三个 --version 一起跑确认共存（swerex-remote --help && deepcode --version && code-review-graph --version）。
3. 分析任务：deepcode run --target <目录>（参数以官方 README 为准）。

数据与目录

• crg：工作区 .code-review-graph/（图数据）。
• deepcode：配置在 ~/.config/deepcode/（推断，以官方为准）。
• swe-rex：无固定数据目录（沙箱由 Docker 管理）。

卸载与清理

按安装相反顺序卸载：

pip uninstall -y code-review-graph deepcode-hku swe-rex
rm -rf .code-review-graph

提示：deepcode 的 provider 配置若不再用，删除 ~/.config/deepcode/ 避免遗留密钥文件（以官方路径为准）。

安装顺序

1. 先 swe-rex（底座）——沙箱执行是「安全」的地基；装完 swerex-remote --help 冒烟。
2. 再 deepcode（分析器）——与 swe-rex 同 venv 共装实测兼容（coexist-deepcode 证据）。
3. 最后 crg（图谱）——三者同 venv 共装实测兼容；任意顺序均可，但按「底座 → 分析 → 图谱」语义装最顺。

依赖警告

• 冲突：swe-rex×deepcode compatible（verified 2026-08-28，共装实测双冒烟 exit 0，写面无重叠）；crg×deepcode compatible（verified）；crg×swe-rex compatible（verified）——3/3 对子 verified，出处：站内文档。未实测面：crg 的 MCP 注册面（claude 插件形态，本机未登录）与 claude 生态条目组合，矩阵保持 possible-conflict 推断态。
• 版本：swe-rex [1.4.0,1.4.0]；deepcode [2.1.0,2.1.0]（Python >= 3.12，注意比 swe-rex/crg 的 3.10 要求高）；crg [2.3.8,2.3.8]。
• 环境：swe-rex 沙箱执行需 Docker（未实测）；deepcode 分析需 LLM provider 配置；crg build 写工作区 .code-review-graph/；三者在 CLI 面无端口固定占用（swe-rex 端口按需传入 --port）。
• 国内网络：pip 三件走清华镜像；最容易卡的一步 = deepcode 全量依赖安装（40s 量级，网络差时更长），命令已带镜像参数。

FAQ

1. 三个 pip 包装一起会冲突吗？ → 不会，3/3 对子 verified（隔离 venv 共装双冒烟 exit 0，写面无重叠，实测复现日志（2026-08-28） 等）。
2. deepcode 装得很慢正常吗？ → 正常，全量依赖实测约 40s（网络差更久）；超时重试一次即可，命令已带清华镜像。
3. 沙箱必须要 Docker 吗？ → 真实沙箱执行要 Docker（本组合未实测沙箱运行）；CLI 层已实测通过，先装好命令、用之前确认目标机有 Docker。
4. deepcode 没有 API key 能用吗？ → 可以。deepcode provider set 支持本地 provider（不需要云 key）；用云厂商才需要 key。
5. 要不要执行 crg install 注册到 Claude Code？ → 本组合不需要，只用 CLI 面，避免注册面写入。

验证证据

每份组合包在隔离环境实测（冒烟 + 写面检查），未实测项在文中如实标注；实测日期见下方验证证据。

验证于 2026-08-29 · TTL 到期 2027-02-25（180 天）

本站实测记录（2026-08-28）

• 实测复现日志（2026-08-28）；实测复现日志（2026-08-28）；实测复现日志（2026-08-28）。
• 未实测（如实标注）：swe-rex 真实沙箱执行（需 Docker + 认证 token，本环境未跑沙箱）；deepcode 真实门禁流程（需 provider 配置）；crg 注册子命令（本组合不执行）。

关联问题

• code-review-graph-2
• npm-eresolve-peer-conflict
• docker-build-cache