使用说明

概念说明

两种空间

文稿智库中的容器统称空间。空间分两种类型,用途与目录命名不同,创建时需指定类型:

  • 知识库:跨任务复用、长期保存的通用资料;整理结果为「知识页面」。
  • 任务文献库:绑定单个论文任务;上传内容为「任务文献」,整理结果为「编译文稿」。每个论文任务对应一个任务文献库。

两类空间应分别创建,勿将跨任务通用资料与单篇论文任务放在同一空间。

对接 API:路径为 /v1/knowledge-bases,两种类型共用该接口;以字段 kindknowledge / task_literature)区分。

流程图加载中…

两层结构

每个空间内均为两层:原始文件与整理结果。

  1. 原始文件(路径 /):上传或导入的内容。在知识库中称为「资料」,在任务文献库中称为「任务文献」。
  2. 整理结果(路径 /wiki/):由原始文件生成的文稿。知识库通过「整理到知识页」生成「知识页面」;任务文献库按需通过 MCP write 生成「编译文稿」。
流程图加载中…

系统会自动创建 overview.md / log.md;列表中的「文件数」不包含上述模板页。HTTP 文档列表与 MCP search(mode=list) 默认也不返回这些脚手架(可用 include_scaffold=true 查看)。

常用标识

供 HTTP / MCP / 论文对接:

标识用途
API Key sv_…(设置页创建)HTTP API、MCP 鉴权
id(UUID)HTTP 路径:/v1/knowledge-bases/{id}/…
slug(同一账号下唯一)MCP:推荐 /{slug}/mcp(可省略参数);全局 /mcp 时工具参数 knowledge_base 传 slug(勿传 UUID)
external_task_id(如 lp_task_6论文侧幂等建库,与 slug 不同

和千问

  • 侧栏「千问问答」:打开空间后直接提问;底层经 MCP guidesearch / read。知识库按学科检索时使用 search + tags
  • 论文写作:百炼挂载 /{slug}/mcp,由模型自行检索;MCP 不可用时,可经 HTTP 摘录后注入 prompt。

详见 通义千问 MCP