ARTICLE · 1298421
DSH官方插件盘点 腾讯知识库WeKnora
WeKnora × DeepSeek Harness
先检索、再读全文，回答带引用
插件包 @wxg-prc-cpg/dsh-weknora
维护方 腾讯 WeKnora难度 照着做就行
日期 2026.10 （DSH 仍处于开发者预览阶段）
一句话 WeKnora 是腾讯开源的知识库/RAG 平台。这个插件不负责建库，它负责让 DSH 会用你已经建好的库：先搜片段，需要时读全文，最后给出带引用的答案。
读完你会得到
·制度问答：员工问报销、请假、采购流程，回答直接引用制度原文。
·产品资料：一堆 PDF、Word 放在知识库里，先检索再读，不用整篇塞进上下文。
·多项目隔离：不同知识库给不同项目用，按 agent 或知识库 ID 限范围。
另外附上：安装流程图、配置对照表、常见问题排查顺序、安全提醒和官方资料链接。
01使用场景
先说清楚它解决什么问题。如果下面这几条都不沾边，别装，装了也是负担。
场景 1 制度问答 员工问报销、请假、采购流程，回答直接引用制度原文。
场景 2 产品资料 一堆 PDF、Word 放在知识库里，先检索再读，不用整篇塞进上下文。
场景 3 多项目隔离 不同知识库给不同项目用，按 agent 或知识库 ID 限范围。
不适合 没有自建 WeKnora 部署的，或者只需要联网搜索、不需要私有资料的。
02准备工作
需要 | 说明 |
WeKnora | 已经部署好，验证版本 0.8.0 |
API Key | 要有 retrieve 能力；要用 ask 还得有 chat |
知识库 ID | 至少一个，格式像 kb-123 |
Node | 插件要求 >=20.11；DSH 环境建议 >=22.15 或 >=24，带 zstd |
pnpm | >=10 |
版本号不是摆设。DSH 还在快速迭代，插件和宿主对不上，最常见的表现就是装完不显示、扫码乱码、启动报错。
03安装步骤
先把整个流程看一眼，再往下做
第 1 步 装插件
装到 web profile。
dsh plugin --profile web add @wxg-prc-cpg/dsh-weknora
第 2 步 配环境变量
服务地址、Key、知识库 ID 一次给全。
export WEKNORA_BASE_URL=https://weknora.example.com
export WEKNORA_API_KEY='
export WEKNORA_KNOWLEDGE_BASE_IDS=kb-123,kb-456
export WEKNORA_RESOURCE_URLS=public
第 3 步 启动 DSH
启动后插件会连 WeKnora 的 REST API。
dsh web
第 4 步 按需改 profile
在 cordis.patch.yml 里配 baseUrl、知识库、工具开关和超时。
04配置与使用
项目 | 怎么配 / 能做什么 |
weknora_search | 混合检索片段，返回知识 ID、分块序号、得分 |
weknora_read_document | 按文档读有序正文，长文可翻页 |
weknora_ask | 在 WeKnora 服务端跑模型，返回答案、引用和工具过程 |
weknora_list_knowledge_bases | 列出当前凭据可见的知识库和 ID |
装完先把一条最简单的任务跑通，再逐步加权限和范围。不要一上来就把所有开关打开。
05常见问题
·401/403：Key 没 retrieve 权限，或没授权到目标知识库。
·ask 被拒：Key 还要有 chat；平台 Key 要带 tenantId。
·图片打不开：resource:// 句柄浏览器加载不了，要配可访问外链。
·长问题超时：调大 chatTimeoutMs，先确认 WeKnora 侧模型没卡住。
06安全提醒
先看这一条 知识库往往包含内部资料。给 DSH 单独建一个只读 Key，限定知识库范围，别用管理员 Key。
07参考资料
· DeepSeek Harness 插件 · WeKnora 文档https://weknora.weixin.qq.com/docs/05-clients/08-deepseek-harness
· npm · @wxg-prc-cpg/dsh-weknorahttps://www.npmjs.com/package/@wxg-prc-cpg/dsh-weknora
以上链接截至 2026 年 10 月。DSH 和插件都还在快速迭代，界面、包名和参数以官方页面当前版本为准。
