yawan
f7fc992f57
Anydoc / anydoc parser engine (push) Canceled after 0s
App / Format, vet, test, and build (push) Canceled after 0s
CLI / test (macos-latest / go 1.26) (push) Canceled after 0s
CLI / test (ubuntu-latest / go 1.26) (push) Canceled after 0s
CLI / test (windows-latest / go 1.26) (push) Canceled after 0s
Build and Push Docker Image / build-ui (push) Canceled after 0s
Build and Push Docker Image / build-docreader (push) Canceled after 0s
Build and Push Docker Image / build-sandbox (push) Canceled after 0s
Build and Push Docker Image / build-app (amd64, linux/amd64, ubuntu-latest) (push) Canceled after 0s
Build and Push Docker Image / build-app (arm64, linux/arm64, ubuntu-24.04-arm) (push) Canceled after 0s
DocReader / Python tests and Go client tests (push) Canceled after 0s
Build & Publish (dsh-weknora) / Typecheck, test, pack (push) Canceled after 0s
Build & Publish (dsh-weknora) / End-to-end inside dsh (pinned) (push) Canceled after 0s
Build & Publish (dsh-weknora) / End-to-end inside dsh (latest, advisory) (push) Canceled after 0s
Frontend / Test, type-check, and build (push) Canceled after 0s
Go Lint Cache / warm lint cache (.) (push) Canceled after 0s
Go Lint Cache / warm lint cache (cli) (push) Canceled after 0s
Go Lint Cache / warm lint cache (client) (push) Canceled after 0s
Build & Publish (mcp-server) / Test (Python 3.10) (push) Canceled after 0s
Build & Publish (mcp-server) / Test (Python 3.11) (push) Canceled after 0s
Build & Publish (mcp-server) / Test (Python 3.12) (push) Canceled after 0s
Build & Publish (mcp-server) / Test (Python 3.13) (push) Canceled after 0s
Build and Push Docker Image / merge (push) Canceled after 0s
Build & Publish (dsh-weknora) / Publish to npm (push) Canceled after 0s
Build & Publish (mcp-server) / Build sdist + wheel (push) Canceled after 0s
Build & Publish (mcp-server) / Publish to PyPI (push) Canceled after 0s
45 lines
2.9 KiB
Markdown
45 lines
2.9 KiB
Markdown
# 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)
|