两种空间
Textira 中的容器统称空间。空间分两种类型,用途与目录命名不同,创建时需指定类型:
对接 API:路径为 /v1/knowledge-bases,两种类型共用该接口;以字段 kind(knowledge / task_literature)区分。
Loading diagram…
两层结构
每个空间内均为两层:原始文件与整理结果。
- 原始文件(路径
/):上传或导入的内容。在知识库中称为「资料」,在任务文献库中称为「任务文献」。 - 整理结果(路径
/wiki/):由原始文件生成的文稿。知识库里点「整理到知识页」得到「知识页面」;任务文献库按需写「编译文稿」。说明见 知识库。
Loading diagram…
系统会自动创建 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 不同 |