MaxKB 最具辨识度的落地形态(据 clawdbytes 介绍):系统生成一段 JS 脚本,粘贴到任意 HTML 页面即出现知识库问答挂件,不需要 iframe、不用改目标系统后端。对“公司已有官网/内部系统、只想加一个智能问答入口”的团队,这是本批项目里改造量最小的路线;代价是公网挂件等于公开入口,知识库内容与访问控制要先想清楚。

适用场景:已有网站想快速上线产品咨询/帮助中心问答;内部系统加问答入口但不想动原系统代码

案例 MaxKB 嵌入挂件 官网客服 低改造

操作步骤

  1. 按第 4 条部署 MaxKB 并接好 LIN 的模型,建“对外版”知识库——只放可公开文档(产品手册、FAQ、帮助中心),与内部库物理分开
  2. 建应用并套第 12 条防幻觉模板,拒答话术改为引导到人工客服/留言
  3. 先在测试页挂载挂件,用真实访客问题(含库外问题)验收一轮
  4. 正式粘贴脚本到官网/帮助中心页面,上线后每周看问答日志,把高频未答问题补进知识库
接入本站 API:挂件背后的 MaxKB 模型全部指向 LIN API(第 4 条接法),访客量带来的推理消耗集中走这一个应用的 Key——在 LIN 后台给该 Key 设额度与告警(团队管理专栏的治理方法),防止公网入口被刷爆额度。

注意事项

  • ⚠️ 把内部知识库直接绑到公网挂件——内容与成本双泄露
  • ⚠️ 上线后不看日志:挂件类应用靠“补文档”迭代,没人维护两周就沦为摆设
  • ⚠️ 许可证按 GPLv3 评估(见第 4 条冲突说明),别信二手文章的 Apache 说法

来源:https://clawdbytes.com/article/2026-05-21-the-simplest-self-hosted-rag-youll-ever-set-up-apache-20-20k-stars