开发者

概念说明

两种空间

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

类型用途
知识库跨任务复用、长期保存;整理结果为「知识页面」
任务文献库绑定单个论文任务;整理结果为「编译文稿」

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

流程图加载中…

两层结构

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

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

系统会自动创建 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 不同

和千问

  • 侧栏「千问问答」:打开空间后提问;只搜当前空间
  • 用库里的资料提问 / 写作(同时参考时任务文献优先):见 典型流程
  • 论文对接:挂任务库 /{slug}/mcp;细节见 论文平台对接千问 MCP