Back to Weknora

Chrome 插件(知识管理助手)

website-docs/05-clients/06-chrome-extension.md

0.7.22.9 KB
Original Source

Chrome 插件(知识管理助手)

浏览器插件解决的是「看到有用的东西,但懒得复制粘贴进知识库」这件事。装上之后可以在任意网页的侧边栏直接向知识库提问,也可以把当前页面剪藏进去。

插件本身在 Chrome 应用商店(名为「知识管理助手」),配合你自建的 WeKnora 服务使用——它不自带后端,所有数据都写进你自己的实例。

<Screenshot src="/screenshots/chrome-extension.png" caption="Chrome 插件:网页侧边栏问答与内容剪藏" hint="展示插件侧边栏在某个网页上展开的样子(问答面板与知识库选择器),以及剪藏时的区域选择。" />

能做什么

能力说明
知识库问答侧边栏对话面板,可切换多个知识库,支持快速 / 深度 / 精确三种回答模式,边浏览边问不打断当前工作
网页剪藏保存页面 URL、由 AI 智能提取正文,或手动框选区域,写入指定知识库
Markdown 速记内置编辑器随手记想法,一键存进知识库
快捷键提问、开侧边栏等操作都可自定义快捷键

怎么配

WeKnora 界面里有一个引导页:「设置 → 集成 → Chrome 扩展」,会直接显示当前实例的 API 地址与复制按钮。步骤:

  1. 拿 API 凭证:在「设置 → API 信息」复制 API Key 与 API 地址。建议单独建一个 Key 并按需收窄能力(至少需要检索与入库相关能力,见租户、用户与认证授权的 API Key 章节);
  2. 桌面版建议先固定端口:用 WeKnora 桌面版时,在 API 信息里设一个固定端口(例如 37841)。否则每次启动端口变化,插件会连不上;
  3. 安装插件:从 Chrome 应用商店安装;
  4. 在插件里连接:打开插件设置,选「企业/开发者」模式,填入 API 地址与 API Key。

配置完成后建议先让它列一次知识库或问一个问题,确认凭证与网络都通。

排查

现象检查点
插件提示连不上API 地址是否可从浏览器所在机器访问(容器内地址、localhost 在远程部署下都不行);桌面版是否固定了端口
401 / 403API Key 是否被吊销;Key 的能力是否覆盖了检索与入库;如果 Key 限定了知识库范围,目标库是否在名单里
剪藏后知识库里没有到知识库文档列表看解析状态,processing 说明在解析中;失败原因见文档详情

相关