dsh-youmind-plugin：爲 DeepSeek Harness 接入 YouMind OpenAPI 工具與 Skill
dsh-youmind-plugin 是面向 DeepSeek Harness (DSH) 的社區適配插件，由 seamas0825-lab 維護，採用 MIT 許可證，需 Node.js >=20。該插件遵循 DSH“一切皆插件”理念，將 YouMind OpenAPI 工作流集成至 DSH，註冊 `youmind` Skill 及五個核心模型工具：搜索可用 API、讀取 API 說明、調用已確認接口、搜索個人知識庫或指定 Board，以及通過 YouMind 進行公開互聯網搜索。 配置方面，插件利用 DSH 原生 `credentials` 服務動態讀取 API Key，修改憑據後無需重啓
閱讀全文dsh-openapi：給 DeepSeek Harness 增加 OpenAPI 發現與安全調用工具
dsh-openapi 是 DeepSeek Harness 的一款插件，旨在解決模型直接調用 API 時參數不一致、憑據失控及範圍過大等問題。該插件通過索引 OpenAPI 3.x 文檔，提供三個核心工具：`openapi_list`（發現與搜索操作）、`openapi_describe`（查看細節）及 `openapi_call`（受限調用）。 其核心特性包括嚴格的安全邊界：默認僅允許 GET/HEAD 請求，阻止訪問本地及私有網絡 IP，限制響應體大小並屏蔽敏感響應頭，同時支持重定向檢查。憑據管理通過環境變量映射實現，確保密鑰不直接暴露在配置或輸出中。 安裝需使用 `dsh plugin
閱讀全文FastAPI文檔自動生成：Swagger與OpenAPI的使用技巧
FastAPI的自動文檔功能基於OpenAPI規範，通過Swagger UI和ReDoc提供交互式接口文檔，可快速展示接口功能、參數及返回值，支持直接測試。啓用方式簡單：創建FastAPI應用，運行後訪問`/docs`（Swagger UI）或`/redoc`（ReDoc）即可查看。 核心技巧包括：用`FastAPI`構造函數參數設置全局信息（標題、描述、版本等）；通過函數註釋、`Path`/`Query`工具類詳細描述接口和參數；用`tags`分類接口便於篩選；通過`include_in_schema=False`隱藏內部接口；使用Pydantic模型規範返回格式，或用`HTTPException`標註錯誤狀態碼。 這些方法可提升文檔清晰度與易用性，避免手動編寫維護的麻煩，確保接口信息與代碼一致，優化團隊協作與用戶體驗。
閱讀全文