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`标注错误状态码。 这些方法可提升文档清晰度与易用性，避免手动编写维护的麻烦，确保接口信息与代码一致，优化团队协作与用户体验。
阅读全文