website-docs/05-clients/06-chrome-extension.md
浏览器插件解决的是「看到有用的东西,但懒得复制粘贴进知识库」这件事。装上之后可以在任意网页的侧边栏直接向知识库提问,也可以把当前页面剪藏进去。
插件本身在 Chrome 应用商店(名为「知识管理助手」),配合你自建的 WeKnora 服务使用——它不自带后端,所有数据都写进你自己的实例。
<Screenshot src="/screenshots/chrome-extension.png" caption="Chrome 插件:网页侧边栏问答与内容剪藏" hint="展示插件侧边栏在某个网页上展开的样子(问答面板与知识库选择器),以及剪藏时的区域选择。" />
| 能力 | 说明 |
|---|---|
| 知识库问答 | 侧边栏对话面板,可切换多个知识库,支持快速 / 深度 / 精确三种回答模式,边浏览边问不打断当前工作 |
| 网页剪藏 | 保存页面 URL、由 AI 智能提取正文,或手动框选区域,写入指定知识库 |
| Markdown 速记 | 内置编辑器随手记想法,一键存进知识库 |
| 快捷键 | 提问、开侧边栏等操作都可自定义快捷键 |
WeKnora 界面里有一个引导页:「设置 → 集成 → Chrome 扩展」,会直接显示当前实例的 API 地址与复制按钮。步骤:
配置完成后建议先让它列一次知识库或问一个问题,确认凭证与网络都通。
| 现象 | 检查点 |
|---|---|
| 插件提示连不上 | API 地址是否可从浏览器所在机器访问(容器内地址、localhost 在远程部署下都不行);桌面版是否固定了端口 |
| 401 / 403 | API Key 是否被吊销;Key 的能力是否覆盖了检索与入库;如果 Key 限定了知识库范围,目标库是否在名单里 |
| 剪藏后知识库里没有 | 到知识库文档列表看解析状态,processing 说明在解析中;失败原因见文档详情 |