构建你的第一个知识库
本教程将带你走完完整的端到端流程：提交内容、观察编译过程、查询生成的知识库。
前置条件
- KaaS 已在
http://localhost:8080运行（参见 快速开始） - 已配置 LLM API Key（OpenAI、DeepSeek、Ollama 等）
第一步：提交内容
打开 Web UI http://localhost:8080，进入 Submit（提交） 页面。
KaaS 支持三种输入方式：
| 方式 | 操作 | 适用场景 |
|---|---|---|
| 粘贴文本 | 直接粘贴到文本框 | 会议纪要、零散笔记 |
| 上传文件 | 点击"Upload"选择文件 | 文档、PDF、录音转写 |
| 提供 URL | 在 URL 输入框中填入链接 | 网页、在线文章 |
本教程中，粘贴以下示例文本：
团队决定将支付服务从 PostgreSQL 迁移到 CockroachDB。主要原因：
（1）无需分片即可水平扩展；（2）内置分布式事务；（3）兼容
PostgreSQL 协议，现有查询无需改动。迁移计划在 Q3 执行，切换前
将两套数据库并行运行 2 周。点击 Submit，页面会提示你的内容已进入处理队列。
第二步：查看编译状态
进入 Status（状态） 页面监控处理进度。每次提交都会经过四阶段流水线：
- Extract（提取） — 从原始内容中识别概念、实体、决策和关系
- Classify（分类） — 判断该内容应归入哪些 Wiki 文章（新建或已有）
- Write（撰写） — 生成或合并结构化 Markdown 文章
- Index（索引） — 更新主索引以供检索
Status 页面实时展示各阶段进度。一段短文本通常在 10–30 秒内完成，具体取决于你使用的 LLM 服务商的延迟。
TIP
如果任务在"Processing"状态停留超过 2 分钟，请检查 LLM API Key 和网络连接。常见问题请参阅 故障排查。
第三步：浏览 Wiki
编译完成后，进入 Wiki 页面查看生成的文章。对于上面的示例，你大概率会看到：
- Decisions（决策） — 包含迁移决策、理由和时间线
- Projects（项目） — 涉及支付服务迁移的相关内容
每篇文章都是可读的 Markdown 格式，内含标题、要点和交叉引用，你可以点击任意文章阅读完整内容。
第四步：提问
进入 Chat（对话） 页面，用自然语言查询你的知识库。
试着问：
为什么要迁移到 CockroachDB？第五步：验证带引用的回答
KaaS 以流式返回回答，并附带 来源引用。你会看到类似：
团队决定将支付服务从 PostgreSQL 迁移到 CockroachDB，主要原因有三：无需分片即可水平扩展、内置分布式事务、兼容 PostgreSQL 协议使现有查询无需改动。
— [Decisions.md]
底部的引用标注了回答所依据的 Wiki 文章。这是 KaaS 区别于黑盒 RAG 的关键——你可以点击查看源文章、验证内容准确性，甚至直接编辑。
背后发生了什么
与传统 RAG 系统将原始文本分块嵌入不同，KaaS 编译 你的内容：
原始内容 → 提取 → 分类 → 撰写 → 索引 → 结构化 Wiki最终产物是人类可读的 Markdown 文章，而非不透明的向量存储。当你提问时，KaaS 通过 LLM 迭代检索在主索引中定位相关文章，然后基于完整文章文本生成有据可查的回答。