RepoGuardian

由 RHD - 仓库健康主管提供支持

自主工程智能。基于证据的决策。人工控制的执行。

连接一个 GitHub 仓库。RHD 使用代理式 RAG、确定性多代理编排、专业化模型治理和基于证据的推理，调查其问题、拉取请求、源代码、发布、工程风险和仓库健康状况。

RHD 自动分析。RHD 自动推荐。人类授权外部操作。

Related MCP server: GitHub Repo Explainer MCP

实时应用

公共 Web 应用：https://repoguardian-rhd.vercel.app

FastAPI：https://repoguardian-rhd-api.vercel.app

API 文档：https://repoguardian-rhd-api.vercel.app/docs

架构：https://repoguardian-rhd.vercel.app/architecture

RHD v4 任务控制中心：https://repoguardian-rhd.vercel.app/mission-control

RHD v5 聊天工作区：https://repoguardian-rhd.vercel.app

演示仓库：https://github.com/romil569/RepoGuardian-Demo

公共 v5.1 流程：将 GitHub 仓库粘贴到主页聊天中，运行分析，等待持久化的任务阶段完成，然后在同一仓库上下文中查看内联 SVG 架构图并提出后续问题。

架构

flowchart LR
  G[GitHub] --> W[Webhooks / Sync]
  W --> Q[Event Queue]
  Q --> RI[Repository Intelligence]
  RI --> S[(SQL + Vector + Graph)]
  S --> AR[Agentic RAG]
  AR --> RHD[RHD Supervisor]
  RHD --> A[Specialist Agents]
  A --> ML[ML / DL Intelligence]
  ML --> EC[Evidence Critic]
  EC --> PG[Policy Gate]
  PG --> HR[Human Review]
  HR --> GA[GitHub Action]

部署模式：

• LIGHTWEIGHT_LOCAL：SQLite，本地向量，确定性/RHD 工具。

• INDUSTRY_LOCAL：当存在 Docker 时，可选的 Docker PostgreSQL/Redis。

• MANAGED_CLOUD：Vercel 前端，Vercel Python FastAPI 后端，Neon PostgreSQL/pgvector，Postgres 队列。

• ENTERPRISE_AWS：Terraform 基础；未配置。

功能矩阵

真实能力等级：

• 工作正常：生产兼容，并覆盖回归测试。

• Beta：作为附加的 v4 路径实现，并覆盖测试，但依赖于同步的仓库数据质量。

• 部分：基础存在，并明确记录了限制。

• 可选：需要本地/配置的提供方；在公共云中未配置时绝不声称处于活动状态。

• 路线图：仅记录，不表示为已交付的行为。

快速开始

轻量级本地

cd C:\Users\HP\Desktop\RepoGuardian
copy .env.example .env
copy backend\.env.example backend\.env
.\scripts\start-dev.ps1

打开 http://127.0.0.1:3000。

行业本地

cd C:\Users\HP\Desktop\RepoGuardian
.\scripts\start-industry-local.ps1
.\scripts\doctor.ps1

仅当安装了 Docker 时，才使用 Docker PostgreSQL/Redis。否则，稳定的轻量级路径仍然可用。

托管云

后端 Vercel 入口点：api/index.py。

所需的后端环境：

• DEPLOYMENT_MODE=MANAGED_CLOUD

• DATABASE_URL=postgresql://...

• POSTGRES_RUNTIME_MODE=managed

• QUEUE_BACKEND=postgres

• PUBLIC_ANALYSIS_MODE=true

• GITHUB_WRITE_MODE=disabled

• FRONTEND_URL=https://...

• CORS_ORIGINS=https://...

• ENABLE_STARTUP_SCHEMA_CREATE=false

前端环境：

NEXT_PUBLIC_API_URL=https://your-fastapi-service.example.com

参见 docs/deployment-managed-cloud.md 和 docs/vercel-backend-audit.md。

MCP

cd mcp-server
npm install
$env:REPOGUARDIAN_API_URL="http://127.0.0.1:8000"
npm start

MCP 暴露 RHD 工具、资源和提示。写门控操作仍受人工/策略门控。参见 docs/mcp.md。

测试

cd backend
.\.venv\Scripts\python -m pytest

cd frontend
npm run lint
npm run typecheck
npm run build
npm run e2e

cd mcp-server
npm run typecheck
npm test

安全

• 仓库写入操作已列入允许列表，并需要人工批准。

• 除非策略明确允许写入，否则公共仓库以只读模式进行分析。

• 私有仓库默认使用本地/确定性处理。

• 问题文本、评论、README 文件、代码和 PR 描述均视为不可信证据。

• 证据必须与同步的仓库记录相对应。

• 前端 NEXT_PUBLIC_ 变量绝不包含后端机密。

• 审计日志存储安全摘要，不存储机密或私有推理。

当前限制

• 托管 PostgreSQL/pgvector 已准备好接受凭据，但未在此本地运行中连接。

• Redis 是可选的，且未在本地连接。

• Docker 仍然是可选的，在当前机器上不可用。

• qwen3:1.7b Ollama 已在本地验证；qwen3:8b 已拉取，但对于演示来说太慢。

• 在没有可辩护的标记数据集的情况下，不声称 ML/DL 训练。

• 在部署基础设施和实时生产测试存在之前，生产环境未标记为已验证。

文档

• API

• MCP

• 托管云部署

• 提供方基准测试

• 行业就绪度

• 公共源代码审计

• RHD v4 架构

• RHD v4 演示脚本

• RHD v5 聊天工作区