前言¶
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
