把一份材料交给系统：入库 → 拿回一个 id → 🔴 立刻拿刚入库进去的那段去检索一次， 当场看出它到底有没有被召回。
入库成功 ≠ 以后查得到。中间还隔着切块、向量化、写索引几步 —— 任何一步不对，材料就像扔进了黑洞：入库接口照样回"成功"。
| 如果你只做一半 | 会发生什么 |
|---|---|
| 只入库，不验 | 库里有这条、检索召不回 —— 而界面上一切正常，看不出来 |
| 入库 + 当场验一次 | 召不回就当场明说"没召回"，而不是留到下一次问答才露馅 |
🔴 所以本页把「验一次」当作入库的一部分，⛔ 不是可选项。 这也是本页和「上传一下就算完」那种做法的唯一区别。
三种走三条不同的端点：/rag/insert · /rag/insert_batch · /rag/upload_document。点上面切换 —— 只有上传那条会切块，另两条是整篇当一条。
⚠️ 档位由后端定义，这里的选项由 RagKb.DOC_TYPES 填，
而且有一条跨语言的门钉着它与后端 CHUNK_CONFIGS 逐字相等
⇒ ⛔ 页面不许自己编一个档位。
⚠️ 后端有格式白名单（pdf / docx / md / html）—— 不支持的会明确报错，⛔ 不静默吞。
点一下会真入库 —— 会花掉 embedding 的钱，结果与费用都来自这一次返回。
⚠️ 只能删自己上传的（后端会 403）。⚠️ 全仓没有"列出文档"以外的接口时靠 id —— 现在上面「库里有什么」区能列出来，但那份列表不给 id，所以删除仍要手输。
自动拿刚入库进去那句里的一段话去检索；召不回就明说召不回，⛔ 不静默。
三种入库方式（各走哪条端点）默认收起 · 点开 ▾
| 方式 | 端点 | 什么时候用它 |
|---|---|---|
| 单条文本 | POST /rag/insert | 手头就一段 |
| 批量 | POST /rag/insert_batch | 一次几十上百段 |
| 上传文件 | POST /rag/upload_document | 有现成的文档文件 |
⚠️ 上传那条对文件类型有白名单，⛔ 不支持的格式会明确报错（不会静默吞掉）。
删掉刚入库的这条默认收起 · 点开 ▾
拿上面那个 id 去删：DELETE /api/v1/rag/documents/{doc_id}。
⚠️ 删不掉要明说原因，⛔ 不装作删掉了。
本次花费 / 我的额度默认收起 · 点开 ▾
- 本次 embedding tokens
- —
- 本次费用
- —
- 今日剩余额度
- —
⚠️ 缺值一律显示「取不到」，⛔ 不显示 0。入库只有 embedding，没有 LLM —— 所以这页比问答便宜。
🔴 分组用的是语料方自己定的五类（A 产品规格 · B 流程制度 · C 常见问题 · D 数据报告 · E 负样本）——
⚠️ 表里没有「目录」这一层（source 只是文件名）⇒ 按文件夹分层做不到，⛔ 也不编。
点一篇 ⇒ 走 PostgreSQL 直接取全文（⛔ 不经向量库）· ⛔ 只会列出你自己的与公用的。