DeepSeek Harness WeKnora 插件详解：企业级 RAG 知识平台的接入与架构
插件简介
WeKnora 是腾讯开源的 LLM 知识平台，GitHub 仓库 Tencent/WeKnora，当前星标 26960，综合评分 72，最近更新于 2026 年 9 月 18 日，实装验证通过于 9 月 16 日。WeKnora 将原始文档转化为可查询的 RAG、自主推理 Agent 和自维护 Wiki。官方 DeepSeek Harness 插件为 @wxg-prc-cpg/dsh-weknora，通过四个只读工具让 DSH 编码代理直接查询企业知识库。
技术架构与核心原理
WeKnora 采用全模块化流水线架构：文档解析、向量化、检索、LLM 推理各组件均可替换。
文档解析层：支持 PDF、Word、图片、Excel、XMind 等 10+ 格式。Office 文件通过 anydoc 进程内解析。父子分块策略保证上下文完整。
向量化层：支持 BGE、GTE、智谱、OpenAI 兼容等嵌入模型。pgvector（1024 维 HNSW 索引）为默认向量库，也支持 Elasticsearch、Milvus、Weaviate、Qdrant、Apache Doris、腾讯 VectorDB。
检索层：BM25 稀疏检索 + 稠密检索 + GraphRAG 三路融合。父子分块 + HNSW 加速，按知识库路由到对应向量库。
推理层：ReAct Agent 自主编排检索、MCP 工具、技能沙箱和网络搜索。支持 20+ LLM 提供商（OpenAI、DeepSeek、通义、智谱、混元、Gemini、Ollama 等）。
Wiki 模式：Agent 将原始文档提炼为相互链接的 Markdown Wiki 页面，配交互式知识图谱，支持手动编辑、修订历史和一键回滚。
功能机制详解
DSH 插件工具集
安装 @wxg-prc-cpg/dsh-weknora 后，DSH 代理获得四个只读工具：
- weknora_search：混合检索，逐字返回源段落，每段带 knowledge_id
- weknora_read_document：按顺序重新组装单个文档段落，支持分页
- weknora_ask：WeKnora 自身生成的带引用答案
- weknora_list_knowledge_bases：列出知识库名称和 ID
DSH 本身不提供检索和知识库能力，这个插件把企业文档变成编码代理可查询的上下文。
多源数据接入
支持飞书 Wiki、飞书云盘、GitLab、腾讯 IMA、Notion、语雀、钉钉文档、RSS 自动同步，支持增量和全量同步。
企业级能力
工作区 RBAC（4 级角色矩阵）、AES-256-GCM 凭据加密、Langfuse 可观测性、运行时任务队列仪表盘、多实例存储后端。
安装与配置
部署 WeKnora 服务端
git clone https://github.com/Tencent/WeKnora.git
cd WeKnora
cp .env.example .env
# 编辑 .env 配置 LLM API Key
docker compose pull
docker compose up -d
# 访问 http://localhost
可选 profile：neo4j（知识图谱）、minio（对象存储）、langfuse（链路追踪）、full（全部）。
安装 DSH 插件
npx @deepseek-ai/dsh plugin --profile web add @wxg-prc-cpg/dsh-weknora
插件指向已部署的 WeKnora 实例，DSH 代理工具集中自动出现四个只读工具。
兼容性与避坑指南
1. 主仓库缺 package.json：Tencent/WeKnora 是完整服务端，DSH 插件是独立 npm 包 @wxg-prc-cpg/dsh-weknora。不要从主仓库直接装。
2. 需先部署服务端：DSH 插件只是客户端，必须先跑起 WeKnora Docker 服务（PostgreSQL + Redis + 后端），否则插件无后端可连。
3. Docker 资源要求：核心服务需 PostgreSQL 和 Redis，建议 2 核 4G 起步。启用 neo4j profile 再加 2G 内存。
4. .env 配置：LLM API Key 必须在 .env 中配置，否则 WeKnora 启动后无法推理。
5. Node 版本未声明：DSH 插件包未声明 engines.node，DSH 基线 22.19.0 可满足。
6. 插件只读：四个工具都是只读，不能通过 DSH 直接写入知识库。写入走 WeKnora Web UI 或 CLI。
适合人群
有企业文档检索需求的 DSH 用户、需要 RAG 增强编码代理的团队、已部署 WeKnora 的企业、需要 Wiki 自动生成的知识管理场景。不适合没有 Docker 环境或不愿部署服务端的个人用户。
总结
WeKnora 是腾讯开源的企业级知识平台，DSH 插件把它的 RAG 能力接入编码代理。安装时需先部署 Docker 服务端，再装 npm 插件。四个只读工具让 DSH 能查企业文档但不破坏数据。
---
WeKnora 实战：让 DeepSeek Harness 编码代理直接查公司文档库
插件简介
WeKnora（Tencent/WeKnora，GitHub 26960 星）是腾讯开源的 LLM 知识平台。DSH 官方插件 @wxg-prc-cpg/dsh-weknora 为编码代理提供四个只读工具，直接查询已部署的 WeKnora 知识库。综合评分 72，Apache 2.0 开源，最近更新 2026 年 9 月 18 日。
核心应用场景
场景一：编码时查内部技术文档
DSH 帮你写代码时，经常需要参考公司内部 API 文档、数据库表结构、架构设计文档。装 WeKnora 插件后，DSH 代理自动调用 weknora_search 检索相关文档片段，把真实 API 用法带进代码上下文，不用你手动翻文档。
场景二：跨项目知识复用
WeKnora 支持多知识库。项目 A 的架构文档、项目 B 的踩坑记录都在各自知识库。DSH 代理用 weknora_list_knowledge_bases 列出可用库，检索时限定范围，避免跨项目串扰。
场景三：Wiki 自动生成
WeKnora 的 Wiki 模式把原始文档自动提炼为相互链接的 Markdown 页面。DSH 编码时引用的文档，在 WeKnora 后台已经过 Agent 整理成结构化知识，检索质量比原始 PDF 高。
场景四：多源数据自动同步
飞书 Wiki、GitLab、Notion、语雀自动同步到 WeKnora。团队文档更新后，DSH 下次检索就是最新内容，不用手动重新上传。
实战案例演示
第一步：部署 WeKnora
git clone https://github.com/Tencent/WeKnora.git
cd WeKnora
cp .env.example .env
# 编辑 .env 填入 LLM API Key
docker compose pull
docker compose up -d
访问 http://localhost 完成初始化，上传技术文档。
第二步：安装 DSH 插件
npx @deepseek-ai/dsh plugin --profile web add @wxg-prc-cpg/dsh-weknora
配置 WeKnora 服务地址（默认 http://localhost:8080）。
第三步：在 DSH 中使用
开新会话，让 DSH 帮你写代码。代理自动调用 weknora_search 检索相关文档，把 API 用法和表结构带进上下文。
第四步：验证工具调用
在 DSH 对话中观察工具调用日志，确认 weknora_search 返回了正确的文档片段。
最佳实践与技巧
1. 文档先在 WeKnora 中整理：上传后用 Wiki 模式让 Agent 提炼，检索质量更高。
2. 按项目建知识库：不同项目文档分开，检索更精准。
3. 用 weknora_ask 而非 weknora_search：ask 返回带引用的完整答案，search 返回原始片段。编码场景用 ask 更直接。
4. 定期同步数据源：飞书/GitLab 自动同步开启增量模式，避免全量重跑。
5. 插件只读：不要指望通过 DSH 写文档，写入走 WeKnora Web UI。
安装与配置
# 服务端
git clone https://github.com/Tencent/WeKnora.git
cd WeKnora && cp .env.example .env && docker compose up -d
# DSH 插件
npx @deepseek-ai/dsh plugin --profile web add @wxg-prc-cpg/dsh-weknora
适合人群
企业团队、有大量内部文档的开发者、需要 RAG 增强编码代理的技术团队。个人用户若无 Docker 环境建议观望。
总结
WeKnora 把企业知识库变成 DSH 编码代理的可查询上下文。四个只读工具、多源同步、Wiki 自动生成，让编码时不再脱离文档。关键是先把 WeKnora Docker 服务跑起来。