git clone https://github.com/your-org/coderef-ai.git
cd coderef-ai
pip install -r requirements.txt

setup.bat

export CODEREF_API_KEY="your-api-key"
export CODEREF_PROVIDER="deepseek"        # 支持: deepseek / openai / ollama
export CODEREF_BASE_URL="https://api.deepseek.com/v1"
export CODEREF_MODEL="deepseek-chat"

export CODEREF_PROVIDER="ollama"
export CODEREF_BASE_URL="http://localhost:11434/v1"
export CODEREF_MODEL="qwen2.5:7b"
export CODEREF_API_KEY="ollama"

python -m core.mcp_server

{
  "mcpServers": {
    "coderef-ai": {
      "command": "python",
      "args": ["-m", "core.mcp_server"],
      "cwd": "/path/to/coderef-ai"
    }
  }
}

# 1. 初次分析：跑一次审计（自动构建知识图谱）
coderef_audit(project_path="/path/to/project", background=True)
coderef_task_status(task_id="...")

# 2. 编程 AI 随时查询知识图谱（替代 grep/读文件）
coderef_query(project_path="/path/to/project", query_type="callers", func_name="login")
coderef_query(project_path="/path/to/project", query_type="impact", file_path="utils.py")

# 3. 生成项目文档（非编程人员阅读）
coderef_docs(project_path="/path/to/project", background=True)

# 4. 查看健康仪表盘
# → coderef-report/health_dashboard_{timestamp}.html

# 5. 直接询问你的编程AI：请你阅读这个项目的报告，把漏报写进白名单，把问题归类为4种（①你可以自行处理 ②需要我介入 ③很复杂或者很严重，需要我参与讨论 ④新建一个暂存区，看看是误报还是真没有意义需要删除的东西）
# → coderef-report/health_dashboard_{timestamp}.html

coderef-ai/
├── core/                              # 核心模块
│   ├── mcp_server.py                  # MCP Server 入口（6 个工具）
│   ├── pipeline_runner.py             # 管线引擎（audit/architecture/docs + 知识图谱）
│   ├── code_knowledge_graph.py        # 知识图谱引擎（SQLite 持久化）
│   ├── health_dashboard.py            # 项目健康仪表盘（零外部依赖 HTML）
│   ├── wiki_generator.py              # Wiki 生成器（三级管线）
│   ├── code_analyzer.py               # 代码分析引擎（AST）
│   ├── ast_parser.py                  # AST 精细解析器（调用关系/赋值/配置）
│   ├── workflow_graph.py              # 架构图生成器（vis-network）
│   ├── shared_filter.py               # 通用过滤基础设施（AutoNoiseFilter）
│   ├── project_scope.py               # 项目范围管理
│   ├── llm_integration.py             # LLM 集成（多模型支持）
│   ├── cache_manager.py               # 缓存管理
│   ├── gitnexus_client.py             # GitNexus 客户端
│   ├── governance_audit.py            # 11 个检测器
│   ├── agent_security_auditor.py
│   ├── sca_checker.py
│   ├── tech_debt_detector.py
│   ├── integrity_checker.py
│   ├── blind_spot_detector.py
│   ├── innovation_propagation_detector.py
│   ├── junk_detector.py
│   ├── resource_gap_detector.py
│   ├── code_simplifier.py
│   └── project_maturity_checker.py
├── config/                            # 配置文件
│   └── settings.py
├── utils/                             # 工具函数
│   └── helpers.py
├── cache/                             # 运行时缓存（.gitignore 已忽略）
├── coderef-report/                    # 输出报告（.gitignore 已忽略）
├── setup.bat                          # Windows 配置向导
├── requirements.txt
├── MCP_SETUP.md                       # 详细配置指南
└── LICENSE