返回目录

weknora

编辑精选维护状态: 活跃

tencent/weknora

开源的 LLM 知识库平台:把原始文档转化为可检索的 RAG 知识库、自主推理智能体和自动维护的 Wiki 系统,支持多租户部署。

前往 GitHub项目主页
$ git clone https://github.com/Tencent/WeKnora.git && cd WeKnora && cp .env.example .env && docker compose pull && docker compose up -d

21,337

星标

3,085

Fork

Go

语言

NOASSERTION

许可证

2025-07-22

创建于

2026-09-04

最近推送

腾讯开源知识框架,带官方 DeepSeek Harness 插件:给 dsh Agent 四个只读工具,可在你的 RAG 知识库上检索、读取与提问。

DSH 适配

原生运行时

作者声明

安全审计

未审计

最后核验

2026-08-22

许可证

MIT

01它能帮你完成什么?

  • 让 DeepSeek Harness 编码 Agent 以只读方式访问你的文档

    四个只读工具——weknora_search(混合检索)、weknora_read_document(按序返回段落)、weknora_ask(带引用的回答)、weknora_list_knowledge_bases(名称 + id)——让 Agent 查询你的知识库

    运行 DeepSeek Harness、希望让 Agent 检索内部文档 / wiki,又不想自己搭检索链路的团队

  • 搭建具备 RAG、Agent 与自动 wiki 的企业知识库

    可自托管的知识框架:RAG 问答、ReAct Agent、Wiki 模式(自动生成互链 Markdown + 知识图谱),以及 20+ LLM 供应商

    需要对私有数据进行文档理解、语义检索与自主推理的研发 / 知识团队

02如何接入 DeepSeek Harness?

前置条件

  • Docker & Docker Compose 与 Git(用于自托管 WeKnora)
  • 已安装 DeepSeek Harness(dsh)——插件通过 `dsh plugin` 命令添加

安装步骤

  1. 01

    自托管 WeKnora:`git clone https://github.com/Tencent/WeKnora.git && cd WeKnora && cp .env.example .env && docker compose pull && docker compose up -d`,然后访问 http://localhost

    $ git clone https://github.com/Tencent/WeKnora.git && cd WeKnora && cp .env.example .env && docker compose pull && docker compose up -d

  2. 02

    添加官方 dsh 插件:`dsh plugin --profile web add @wxg-prc-cpg/dsh-weknora`,并指向你的 WeKnora 部署

    $ dsh plugin --profile web add @wxg-prc-cpg/dsh-weknora

  3. 03

    (可选)通过 CLI 管理 WeKnora 配置:`weknora profile add prod --host https://kb.example.com --use`,再 `weknora auth login`

验证接入成功

  • 添加插件后,确认 Agent 的工具集中出现了四个只读工具(weknora_search、weknora_read_document、weknora_ask、weknora_list_knowledge_bases)

03DSH 适配与能力边界

DSH 适配原生运行时

官方 DeepSeek Harness(dsh)插件 `@wxg-prc-cpg/dsh-weknora`——提供四个只读工具(weknora_search、weknora_read_document、weknora_ask、weknora_list_knowledge_bases),让编码 Agent 能够查询你的 WeKnora 知识库。

  • dsh 插件:4 个只读知识工具

    来自 DeepSeek Harness Agent 的自然语言查询weknora_search(混合检索)、weknora_read_document(按序段落)、weknora_ask(带引用回答)、weknora_list_knowledge_bases(名称 / id)

    只读:Agent 不能创建或修改知识库
  • RAG 问答与 ReAct Agent

    文档、wiki、FAQ基于知识库的快速 RAG 回答与多步自主推理

  • Wiki 模式(自动知识图谱)

    原始文档自维护的互链 Markdown 知识库,带交互式知识图谱、修订历史与一键回滚

    在你的知识库中生成并维护 wiki 页面

04适合谁?何时不该用?

适合

  • 运行 DeepSeek Harness、希望让 Agent 检索内部文档 / wiki,又不想自己搭检索链路的团队
  • 需要对私有数据进行文档理解、语义检索与自主推理的研发 / 知识团队

不适合

  • 登录鉴权默认开启(v0.1.3+);生产环境建议部署在内网 / 私有网络,避免公网暴露,并配置防火墙与访问控制。

05兼容性、维护与安全提示

  • dsh 插件是只读的,且需要已运行的 WeKnora 部署(通过 Docker Compose / Kubernetes / Helm 自托管);它自身不能创建或修改知识库。
  • 登录鉴权默认开启(v0.1.3+);生产环境建议部署在内网 / 私有网络,避免公网暴露,并配置防火墙与访问控制。
  • dsh 插件工具均为只读;API key 与 MCP / 数据源凭据以 AES-256-GCM 静态加密。Agent 可检索、读取、提问,但绝不写入知识库。
2025-07-222026-08-21dsh-weknora-v0.1.0

MIT · 活跃维护中(dsh 插件发布 dsh-weknora-v0.1.0,2026-08-21;WeKnora 核心 v0.7.2)

06常见问题

怎么把 WeKnora 接入 DeepSeek Harness?

安装官方插件:`dsh plugin --profile web add @wxg-prc-cpg/dsh-weknora`,然后将其指向一个正在运行的 WeKnora 部署。由于 harness 自身没有检索能力,插件把你的文档以四个只读工具的形式接入。

dsh 插件暴露哪些工具?

四个只读工具:weknora_search(混合检索,返回逐字原文段落 + knowledge_id)、weknora_read_document(按序段落带分页)、weknora_ask(WeKnora 基于 RAG / ReAct 的带引用回答)、weknora_list_knowledge_bases(用于限定检索范围的名称 + id)。

需要先自托管 WeKnora 吗?

是的。插件是只读的,指向一个已存在的部署。自托管执行 `git clone https://github.com/Tencent/WeKnora.git`、配置 .env、再 `docker compose up -d`(或 Helm 上 Kubernetes)。没有部署,工具就没有可查询的对象。

Agent 能修改我的知识库吗?

不能——dsh 工具明确为只读;Agent 可检索、读取、提问,但不能创建或编辑知识库。凭据以 AES-256-GCM 静态加密。

WeKnora 支持哪些模型?

20+ 供应商,包括 DeepSeek、OpenAI、Qwen、Zhipu、Hunyuan、Gemini、Ollama 等,且 LLM、向量库、存储后端均可替换,支持本地 / 私有云的数据主权。

08数据与来源

  • 作者声明github.com412dcc41c662…

    `@wxg-prc-cpg/dsh-weknora` is the official DeepSeek Harness (`dsh`) plugin.

  • 作者声明github.com412dcc41c662…

    dsh plugin --profile web add @wxg-prc-cpg/dsh-weknora

  • 作者声明github.com412dcc41c662…

    four read-only tools appear in the agent's tool set

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-08-22。发现错误?提交更正。

🏆

最佳 DeepSeek Harness 插件

从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件市场,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。