从下载、安装到第一次对话的完整流程，含三大 LLM 供应商 API Key 获取教程
使用指南
欢迎使用智坞——一款本地优先的桌面 AI 知识库工具。本指南带你从零开始，10 分钟内完成下载、安装、配置并完成第一次对话。
适用版本
本指南适用于 v1.6.x 及以上版本。如已安装旧版，启动后客户端会自动检测更新。
1. 下载与安装
- 访问官网下载页：https://localkb.cn/download/
- 下载
LocalKB-AI-Setup-x.y.z.exe（约 80–120 MB） - 双击运行安装程序，按默认路径完成安装
- 启动「智坞」
系统要求：
- Windows 10/11 64 位
- 至少 4 GB 可用内存
- 至少 2 GB 可用磁盘空间（用于嵌入模型与本地向量库）
2. 首次启动
首次启动时，客户端会请求以下两项授权：
| 授权项 | 用途 | 是否可拒绝 |
|---|---|---|
| 匿名使用统计 | 帮助产品优化（崩溃报告、功能使用频率） | 可拒绝，不影响功能 |
| 防火墙放行 | 调用云端 LLM API（DeepSeek/通义/智谱） | 必需 |
拒绝匿名统计不会影响任何功能。如需后续调整，可在「设置 → 隐私」中重新开启。
3. 创建第一个知识库
- 在主界面侧栏点击 「+ 新建知识库」
- 输入知识库名称（例如「我的笔记」）
- 拖入文件夹或选择文件夹（支持嵌套子目录）
- 选择嵌入模型：
- 默认推荐：bge-small-zh-v1.5（中文优化，约 100 MB，首次构建自动下载）
- 大型语料可选bge-large-zh-v1.5（精度更高，体积更大） - 点击 「开始构建」，等待索引完成
支持的文件类型：
- 文本：
.txt.md.markdown - 文档：
.pdf.docx.doc.pptx - 网页：
.html.htm - 代码：
.py.js.ts.java.go.cpp等
4. 配置 LLM（获取 API Key）
智坞支持三家国内主流 LLM 供应商。任选其一即可，三家都提供新用户免费额度。
4.1 DeepSeek（推荐，性价比最高）
获取DeepSeek API Key的详细方法步骤请见 《获取 DeepSeek API Key》。
定价参考（截至 2026-07）：
- 输入：¥ 0.001 / 千 tokens（缓存命中再减半）
- 输出：¥ 0.008 / 千 tokens
4.2 通义千问（阿里云）
获取Qwen API Key的详细方法步骤请见 《获取通义千问 API Key》。
推荐模型：qwen-plus 或 qwen-turbo（性价比高）
4.3 智谱 GLM（启航计划）
获取智谱AI API Key的详细方法步骤请见 《获取智谱AI API Key》。
推荐模型：glm-4-flash（免费）或 glm-4-plus
启航计划
智坞与智谱合作的「启航计划」提供 GLM 免费体验额度。在客户端「对话 → 启航计划」领取。
5. 发起第一次对话
- 在主界面选择一个已构建的知识库
- 点击顶部模型选择器，选择已配置 API Key 的模型
- 在对话框输入问题，例如：
这份文档里有哪些关于「数据隐私」的章节？
- 按回车或点击「发送」
- 智坞会：
- 把你的问题转为向量
- 在知识库中检索最相关的段落（Top-K）
- 把检索结果连同问题一起发给 LLM
- 流式返回答案，并标注引用来源
深度思考模式
点击对话框旁的「深度思考」开关，可以让 LLM 在回答前先做一段思维链推理，适合复杂分析类问题。会消耗更多 tokens。
混合检索
在「知识库 → 设置 → 检索」中开启：
- 语义检索：默认开启，基于向量相似度
- 关键词检索：BM25 算法，适合精确匹配术语
- 混合模式（推荐）：两者结合，准确率最高
6. 常见问题
Q：构建知识库很慢？
A：首次构建需要下载嵌入模型（约 100 MB）；之后构建速度取决于文件数量与硬件，一般 1000 个文件 5–10 分钟。
Q：可以同时使用多个知识库吗？
A：Pro 版支持在对话中同时检索多个知识库。Free 版限制 1 个知识库、50 个文件。
Q：数据是否上传云端？
A：默认不会。文档、向量、对话记录均在本机处理。仅当你主动调用云端 LLM 时，问题与检索片段会发送给 LLM 供应商（这是使用 LLM 的必要步骤）。
如本指南未覆盖你的问题，请访问 FAQ 或邮件至 support@zhidock.com。