# Chrome 插件（知识管理助手）

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

插件本身在 [Chrome 应用商店](https://chromewebstore.google.com/detail/jpemjbopikggjlmikmclgbmkhhopjdgd)（名为「知识管理助手」），配合你自建的 WeKnora 服务使用——它不自带后端，所有数据都写进你自己的实例。

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

## 能做什么

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

## 怎么配

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

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

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

## 排查

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

## 相关

- 凭证与能力：[租户、用户与认证授权](../03-features/01-tenant-auth.md)
- 剪藏内容的入库流程：[文档入库流程](../02-architecture/03-document-pipeline.md)
- 其它集成方式：[Claw Skill](07-claw-skill.md)、[命令行工具](02-cli.md)、[Go SDK](03-go-sdk.md)