知识库

搜索知识库概念

POST /external/v1/projects/{project_id}/knowledge-base/search

请求体（JSON）：

字段	类型	说明
query	string	搜索词（必填）
workspace_id	string（可选）	知识库工作区 UUID；默认使用项目的知识库工作区

curl -X POST http://localhost:8000/external/v1/projects/PROJECT_ID/knowledge-base/search \
  -H "Authorization: Bearer API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "身份验证流程"}'

响应（200）： 概念摘要数组，每项包含 title、description、concept_type、path 等字段。

---

知识库健康检查

POST /external/v1/projects/{project_id}/knowledge-base/lint

检查断链、孤儿概念、缺失 type/citations、重复标题。

请求体（JSON，可选）：

{ "workspace_id": "kb-ws-uuid" }

curl -X POST http://localhost:8000/external/v1/projects/PROJECT_ID/knowledge-base/lint \
  -H "Authorization: Bearer API_KEY" \
  -d '{}'

响应（200）： 问题数组，每项包含 issue_type、concept_id、message。空数组表示无问题。