前言¶

在 DeepSeek Harness（DSH）中开发智能体时，将外部知识库连接到代理是一个常见需求。Knowz 提供了一种通过 MCP 协议连接托管 vaults 的解决方案。

这是什么¶

Knowz 是一个为 DSH 提供托管 MCP 连接器及轻量级 vault 技能的插件。它由 knowz-io 维护，专注于知识检索与管理。

核心功能¶

• MCP 连接：通过 MCP 协议连接代理到托管的 Knowz vaults。
• 知识访问：提供 vault 访问权限。
• 知识 Only：此插件专注于知识库功能，不包含代码执行或测试相关能力。

安装与启用¶

安装插件需要执行以下步骤：

1. 安装插件：

    dsh plugin --profile web add github:knowz-io/deepseek-knowz-plugin

2. 配置 API 密钥：
   • 在 app.knowz.io/settings/api-keys 创建一个以 ukz_ 开头的 key。
   • 在环境变量或 $DSH_HOME/.credentials.yaml 中设置 KNOWZ_API_KEY。

        export KNOWZ_API_KEY=ukz_…

*   设置密钥后，重启 `dsh web`。

3. 映射 vaults：
   设置好密钥后，向智能体发起指令，运行 knowz-setup 技能以映射 vaults。

技能列表¶

插件提供以下技能：
* knowz-ask
* knowz-save
* knowz-search
* knowz-browse
* knowz-amend
* knowz-setup
* knowz-status
* knowz-flush
* knowz-auto

注意事项¶

• 安全：不要将 API 密钥粘贴到聊天中。
• 注册陷阱：不要在现有 Knowz 账号上运行 /knowz register，该命令会创建一个新账号，并非现有用户的登录路径。
• 认证方式：此切片中无 OAuth。
• 依赖：需要 @deepseek-ai/dsh-mcp-client。
• 包内安全：此包中不包含 secrets、CLIENT_ID、字面量 bearer token 或 x-api-key，所有认证由环境变量注入。

短结尾¶

Knowz 插件为 DSH 提供了连接托管知识库的能力。通过配置环境变量并运行 knowz-setup，即可将外部 vault 映射到智能体中。更多细节请参考项目主页或 GitHub 仓库。