前言¶
DSH 的理念是「一切皆插件」，社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系。如果你需要在 DSH 中调用 YouMind OpenAPI，需要处理工具注册、密钥读取和端点配置这几件事。dsh-youmind-plugin 把 YouMind 工作流适配到 DSH 中：注册一个 youmind Skill 和五个模型工具，并通过 DSH 原生 credentials 服务按调用读取密钥。
下面介绍它的功能、安装配置和注意事项。
这是什么¶
dsh-youmind-plugin 是一个面向 DeepSeek Harness 的社区插件，维护方是 seamas0825-lab，许可证为 MIT，Node.js 需要 >=20。
它向 DSH 注册 YouMind OpenAPI tools and skill bundle。该插件是面向 DeepSeek Harness 的社区适配，不代表 YouMind 官方发布。其 YouMind 工作流与 Skill 设计参考并适配自 YouMind-OpenLab/skills。
核心功能¶
插件提供以下模型工具：
youmind_search_api：搜索可用的 YouMind OpenAPI。youmind_api_info：读取某个 API 的请求说明。youmind_call_api：调用任意已确认的 YouMind API。youmind_find：搜索个人 YouMind 知识库或指定 Board。youmind_web_search：通过 YouMind 搜索公开互联网。
除工具外，插件支持两个运行配置点：
- 通过 DSH 原生
credentials服务按调用读取密钥，修改凭据后无需重启 Harness。 - 可额外设置
YOUMIND_ENDPOINT连接预览或自托管兼容端点。
安装与启用¶
1、安装插件。下面命令从 GitHub 的 main 分支安装：
dsh plugin --profile web add github:seamas0825-lab/dsh-youmind-plugin#main
正式使用时建议把 main 替换为具体 commit SHA。
2、检查组合配置：
dsh --profile web --dump-config
配置密钥与端点¶
先创建 API Key：访问 https://youmind.com/settings/api-keys 创建 API Key。
再把它保存到 DSH 的凭据文件。下面示例中的占位值不是真实密钥，不要把 API Key 发到聊天中：
# ~/.dsh/.credentials.yaml
YOUMIND_API_KEY: <API Key>
确保凭据文件只有当前用户可读：
chmod 600 ~/.dsh/.credentials.yaml
插件不会将密钥放入普通设置、工具参数、结果或日志。
如需连接预览或自托管兼容端点，可以额外设置：
export YOUMIND_ENDPOINT='https://youmind.com'
典型用法¶
在 Web UI 中尝试第一条指令，用于搜索资料库：
使用 YouMind 搜索我的资料库中关于 AI Agent 的内容。
尝试第二条指令，用于先查询 Board 相关 API，不执行修改：
先查找 YouMind 里和 Board 有关的 API，再告诉我有哪些可用操作，不要修改任何内容。
卸载¶
如果不再使用，可以执行：
dsh plugin --profile web remove dsh-youmind-plugin
适用场景与注意¶
适合在 DSH 中接入 YouMind 的开发者。它把 API 搜索、说明读取、已确认接口调用、资料库搜索和互联网搜索封装成工具，并通过 DSH 的 credentials 服务读取密钥。
使用前需要确认安全边界：
youmind_call_api能访问通用 OpenAPI，因此也可能执行发布、移动、删除或付费操作。- 随包 Skill 要求 Agent 在这些操作前确认用户意图。
- 插件仍应只在受信任的 Harness 环境中启用。
- 插件以当前
dsh进程权限运行，安装前应检查源码与许可证。 - 凭据文件应只允许当前用户读取，不要把 API Key 发到聊天中。
结尾¶
经过上面的步骤，你可以在 DeepSeek Harness 中启用一组 YouMind 工具，用于搜索可用 API、读取请求说明、调用已确认接口，以及搜索 YouMind 资料库或公开互联网。
GitHub 仓库：
https://github.com/seamas0825-lab/dsh-youmind-plugin
