企业官网建设流程全解析

10分钟搭起医疗健康AI知识库：PandaWiki完整部署教程

【免费下载链接】PandaWikiPandaWiki 是一款 AI 大模型驱动的开源知识库搭建系统，帮助你快速构建智能化的 产品文档、技术文档、FAQ、博客系统，借助大模型的力量为你提供 AI 创作、AI 问答、AI 搜索等能力。项目地址: https://gitcode.com/gh_mirrors/pa/PandaWiki

医院、诊所、健康管理团队手里往往攥着一堆疾病指南、用药说明和患者宣教资料，散落在网盘和共享文件夹里没人维护。用PandaWiki——一款AI大模型驱动的开源知识库系统——把它们汇进一个带AI问答、AI搜索的统一站点，患者自助提问，医生快速查资料，一两个小时就能跑起来。这篇按真实操作顺序走一遍：部署、建库、导入资料、调问答、验证。

🧰 开工前：3项前置条件

一台能装Docker的Linux服务器。合格标准：Docker 20.x及以上版本，有公网IP或已做端口映射，用root账号登录。

一个可用的大模型API。合格标准：拿到对话模型的API Key。PandaWiki的问答和检索依赖两类模型——对话模型负责生成回答，向量模型负责把文档转成可检索的表示；自动配置会同时配好两者，手动配置时两者缺一不可。

一份整理过的资料。合格标准：Word、PDF、Markdown这类能抽出文字的文件优先；纯扫描图片型PDF无法被有效解析，效果差，先转成文字版。

🛠️ 实战主线：5步把知识库跑起来

第一步，一键部署PandaWiki

做什么：把后端、数据库、Wiki前台一次性装到服务器上。

怎么做：执行安装脚本，按提示完成交互：

bash -c "$(curl -fsSLk https://release.baizhi.cloud/panda-wiki/manager.sh)"

安装需要几分钟，跑完后终端会打印访问地址、用户名和密码。

做完后应该看到：终端出现访问地址（形如http://你的IP:2443）和admin账号密码；浏览器打开该地址，出现控制台登录页。

第二步，配置AI模型

做什么：让AI问答、AI搜索生效。首次登录控制台会被要求先配置模型，跳过它，后续所有AI功能都不可用。

怎么做：打开"系统配置"里的模型配置，选自动配置，填入百智云的API Key，确认对话模型选择后点"应用"；手动配置则填自有模型的API Key与地址。

做完后应该看到：配置保存成功。注意一点：切换配置方式或修改向量模型，会让所有文档重新学习，所以一次配准。

第三步，创建医疗知识库

做什么：建一个知识库，作为这批资料的容器。"知识库"是一组文档的集合，PandaWiki会为每个知识库生成一个独立的Wiki网站。

怎么做：控制台左侧"文档"点"创建文档"，走创建向导：先填知识库名称（如"患者健康宣教库"），再设置服务监听地址（域名或IP加HTTP/HTTPS端口），之后依次录入文档、发布内容、问答测试。

做完后应该看到：文档列表顶部出现"X个文档，X个文件夹未发布"的提示，知识库已就绪，可以导入资料。

第四步，导入医疗资料

做什么：把现有资料灌进知识库。

怎么做：资料入口在文档页的"导入文档"，共四种方式——按网页URL逐条导入、通过网站Sitemap整站导入、通过RSS订阅自动同步、直接上传离线文件；语雀、飞书、Notion、Confluence、印象笔记（Epic）、钉钉文档这类第三方平台也可以直接连通导入，处理逻辑集中在 backend/pkg/anydoc/，这里封装了各来源的抓取与解析。

做完后应该看到：文档进入目录树，每篇文档旁挂着"学习中"的状态标签。等所有文档变成"学习成功"，再勾选"可被问答"并发布——没学习成功的文档不会参与AI问答。

第五步，验证AI问答

做什么：确认AI真的在基于你的资料回答。

怎么做：点控制台右上角"访问Wiki网站"，打开知识库首页的AI智能问答框，问一个只有库内资料能回答的问题，比如某种药的具体用法，看答案是否给出正确内容并引用库内文档；框内还能切"仅搜索文档"模式，跳过AI生成，只看检索到的原文，方便对照。

✅ 快速自检：3个动作确认系统可用

1. 找一篇只有库内资料才有的细节（如某药的禁忌条目）提问，AI答对且引用指向正确文档，说明学习和检索链路通了。
2. 反过来问一个库里完全没有的话题，正常表现是回答"未找到相关内容"而不是编造；答得头头是道反而说明没走库内检索，需要检查文档是否处于"可被问答"状态。
3. 回到控制台文档列表，确认目标文档的状态是"学习成功"而不是"学习失败"。

⚠️ 避坑笔记：新手最常踩的3个坑

现象：文档一直"学习中"，或显示"学习失败"。原因：向量模型没配好或配置中途被改过，文档学习走的是向量模型，不是对话模型。 解法：到系统配置确认对话、向量两个模型都已保存；改配置后等全部文档重新学习完成再继续测试。

现象：AI回答和文档内容对不上。原因：文档还没学习成功，或被改过模型后没有触发重学，问答仍在用旧数据或空数据。 解法：先核对文档状态标签，再确认当前向量模型和文档学习时用的是同一个。

现象：控制台能进，Wiki网站打不开。原因：建库时服务监听方式与对外配置不一致，比如只勾了HTTPS 443，浏览器却用HTTP访问，或防火墙没放行对应端口。 解法：核对建库向导里的域名、端口配置，放行对应端口，再访问。

📚 延伸阅读

想往下深挖，从这几个入口入手：backend/api/kb/v1/kb.go 是知识库增删改查的接口定义；backend/api/node/v1/node.go 管文档节点的发布与"可被问答/可被访问"权限；backend/api/conversation/v1/conversation.go 是AI问答接口的入口；第三方来源的导入处理在 backend/pkg/anydoc/。

下一步两个值得做的方向：一是把知识库按文档分组划分权限，患者、医生、内部人员只看到各自可见的文档；二是给持续更新的资料（指南、药品更新）建立定期导入机制，用URL或RSS导入保持内容新鲜。

【免费下载链接】PandaWikiPandaWiki 是一款 AI 大模型驱动的开源知识库搭建系统，帮助你快速构建智能化的 产品文档、技术文档、FAQ、博客系统，借助大模型的力量为你提供 AI 创作、AI 问答、AI 搜索等能力。项目地址: https://gitcode.com/gh_mirrors/pa/PandaWiki