使用说明

空间（创建 / 列表 / 详情）

可创建 知识库（kind=knowledge）或 任务文献库（kind=task_literature），并查询列表与详情。

通用鉴权与 Base URL 见 HTTP API 总览。

POST /v1/knowledge-bases

创建一个空间。路径是 /v1/knowledge-bases，两种类型都走此接口；用请求/响应里的 kind 区分知识库与任务文献库。

创建成功后会自动生成概览页 overview.md 与日志页 log.md（不计为「上传文件数」）。

请求体

字段类型必填说明
namestring是显示名称
descriptionstring | null否描述
kindstring否knowledge（知识库，默认）或 task_literature（任务文献库）

示例：创建知识库

POST /v1/knowledge-bases
Authorization: Bearer <token>
Content-Type: application/json

{
  "name": "机器学习资料",
  "description": "跨课题复用",
  "kind": "knowledge"
}

示例：创建任务文献库

创建任务文献库时必须传 kind: "task_literature"（省略则默认为知识库）。
产品说明见 任务文献库。

POST /v1/knowledge-bases
Authorization: Bearer <token>
Content-Type: application/json

{
  "name": "论文任务-XXX",
  "kind": "task_literature"
}

成功响应

201，返回空间对象（节选）：

字段说明
id空间 UUID（上传、列文档时要用）
name / slug / description名称与标识
kindknowledge 或 task_literature
source_count用户上传文件数（不含 /wiki/ 下结构页）
wiki_page_count编译文稿 / 知识页面数（不含 overview、log、index）
created_at / updated_at时间

列表与详情

列出空间

GET /v1/knowledge-bases
Authorization: Bearer <token>

成功：200，空间对象数组（含知识库与任务文献库；用 kind 区分）。字段与下方创建成功响应相同。

单个空间

GET /v1/knowledge-bases/{kb_id}
Authorization: Bearer <token>

成功：200，单个空间对象（含 source_count / wiki_page_count）。
失败：404。

用量

GET /v1/knowledge-bases/{kb_id}/usage
Authorization: Bearer <token>

成功：200

{
  "total_pages": 12,
  "document_count": 5,
  "max_pages": 1000
}

更新空间

PATCH /v1/knowledge-bases/{kb_id}
Authorization: Bearer <token>
Content-Type: application/json

{ "name": "新名称" }

可更新 name / description / kind（至少一项）。
成功：200，更新后的空间对象。

下一步