前言¶
在 DeepSeek Harness（dsh）里让智能体读写笔记、任务、邮件和日历，常见做法是自建 MCP 服务或接第三方 API，权限边界和「改数据前要不要你点头」往往要自己在中间层再实现一遍。Recued 是自托管服务器：数据留在你自己控制的机器上，每次请求按你授予的合约校验，变更前在 Recued 应用里等你批准，并留下操作记录。dsh-recued 不自带业务代码，只在 Harness 里增加一行指向 Recued 的 MCP 客户端配置，把上述能力接到 DSH 的插件体系里。
这是什么¶
dsh-recued（仓库 recued/dsh-recued）由维护者 recued 发布，在 SkillHub 目录中归类为联网工具。插件说明为：Connects DeepSeek Harness to your own Recued server over MCP。实现上整包就是 cordis.patch.yml，通过 DeepSeek Harness 自带的 @deepseek-ai/dsh-mcp-client 连到你的 Recued 实例。
核心功能¶
- 在 DSH 中注册一条 MCP 客户端，目标为你的 Recued 服务器；可见工具名形如
mcp__recued__<tool>，Harness 可能对名称加短后缀（例如mcp__recued__work_search_71e96de3b41a）。 - 工具集合由你在 Recued Web 应用里为 DeepSeek Harness 创建的 Contract 决定；要增删能力需改合约，而非改插件代码。
- 读类操作可立即返回；写类操作 Recued 会返回
awaiting_approval，需在 Recued 页面顶部铃铛处批准，再告知智能体继续取结果。 - DSH 调用 Recued 工具前不会在 Harness 侧二次弹窗；能做什么由 Recued 的合约与你的批准决定。
- 数据留在 Recued 服务器；模型只看到工具返回值，且返回值受合约限制。合约密钥写在
~/.dsh/.env（或$DSH_HOME/.env），不会写入插件或 profile。
安装与启用¶
前置条件（来自 README）：
- DeepSeek Harness 0.2（文档写明在 0.2.1-rc.2 上测试），且
pnpm在PATH中以便使用dsh plugin。 - 在你控制的计算机上安装 Recued 服务器，参见 Recued 安装文档。
- 在 Recued Web 应用的 Contracts 中新建合约，选择 DeepSeek Harness 可用的工具，并复制 Recued 显示的密钥。
1、安装插件（Web UI 使用的 profile 为 web；无界面运行用 --profile headless，其他 profile 换对应名称）：
dsh plugin --profile web add github:recued/dsh-recued
2、在 ~/.dsh/.env（若设置了 DSH_HOME 则用 $DSH_HOME/.env）写入合约密钥：
RECUED_MCP_TOKEN=<the contract's key>
3、若 Recued 不在本机，按合约 Connect 页显示的地址增加 URL；未设置时默认连本机 http://127.0.0.1:7717/mcp：
RECUED_MCP_URL=https://<your server>/mcp
未设置 RECUED_MCP_TOKEN 时插件不会启用。
4、重启 DeepSeek Harness（例如 dsh web）。
package.json 中声明的 DSH 引擎范围为 >=0.2.1-rc.2 <0.3.0，peer 依赖 @deepseek-ai/dsh-mcp-client 同范围；当前插件版本为 0.1.0，许可证 MIT。
典型用法¶
安装并配置环境变量、重启后，可在对话中让智能体使用 Recued 工具。README 建议用自然语言自检，例如询问：「Which notes do I have in Recued?」（等价中文亦可，以模型是否成功调用 mcp__recued__* 为准）。
变更类操作：智能体收到 awaiting_approval 后，你到 Recued 应用批准，再告诉智能体你已处理，以便它继续向 Recued 索取结果。
适用场景与注意¶
适合已在或计划自建 Recued、希望 DSH 智能体在合约与批准框架内访问笔记、任务、邮件、日历等个人数据、且不愿把原始数据交给模型直读的场景。
插件以当前 dsh 进程的用户权限运行；安装前请阅读仓库源码（主要为 cordis.patch.yml）与 MIT 许可证。DeepSeek Harness 社区插件目录（如 SkillHub 条目）为独立生态站点，与 DeepSeek / 幻方无官方从属关系。
卸载：
dsh plugin --profile web remove dsh-recued
结尾¶
dsh-recued 用一条 MCP 补丁把 Harness 接到自托管 Recued，把数据边界和变更批准留在 Recued 侧。目录页：https://www.skillhub.cn/plugins/recued/dsh-recued；源码与说明：https://github.com/recued/dsh-recued。
