跳到主要内容

项目 API

管理项目并触发分析。

列出项目​

GET /v1/projects

响应：

{
  "success": true,
  "projects": [
    {
      "id": "proj_abc123",
      "name": "my-app",
      "status": "indexed",
      "filesCount": 234,
      "symbolsCount": 1847,
      "lastIndexedAt": "2024-01-15T10:30:00Z",
      "createdAt": "2024-01-10T08:00:00Z"
    }
  ]
}

获取项目​

GET /v1/projects/:id

响应：

{
  "success": true,
  "project": {
    "id": "proj_abc123",
    "name": "my-app",
    "status": "indexed",
    "filesCount": 234,
    "symbolsCount": 1847,
    "languages": ["typescript", "javascript"],
    "stats": {
      "linesOfCode": 15420,
      "avgComplexity": 4.2,
      "duplicatePercentage": 3.1
    },
    "lastIndexedAt": "2024-01-15T10:30:00Z",
    "createdAt": "2024-01-10T08:00:00Z"
  }
}

创建项目​

POST /v1/projects

请求体：

{
  "name": "my-new-project",
  "githubRepo": "owner/repo",
  "branch": "main"
}

响应：

{
  "success": true,
  "project": {
    "id": "proj_xyz789",
    "name": "my-new-project",
    "status": "pending"
  }
}

删除项目​

DELETE /v1/projects/:id

响应：

{
  "success": true
}

触发索引​

POST /v1/projects/:id/index

请求体（可选）：

{
  "force": true
}

响应：

{
  "success": true,
  "message": "索引已开始",
  "estimatedTime": 120
}

获取索引进度​

GET /v1/projects/:id/index-progress

响应（Server-Sent Events）：

event: progress
data: {"phase": "scanning", "progress": 25, "filesScanned": 58}

event: progress
data: {"phase": "extracting", "progress": 50, "symbolsExtracted": 450}

event: progress
data: {"phase": "embedding", "progress": 75, "chunksProcessed": 120}

event: complete
data: {"status": "indexed", "filesCount": 234, "symbolsCount": 1847}

归档项目​

POST /v1/projects/:id/archive

取消归档项目​

POST /v1/projects/:id/unarchive