dsh-youmind-plugin: Integrating YouMind OpenAPI Tools and Skills into DeepSeek Harness
dsh-youmind-plugin is a community adapter plugin for DeepSeek Harness (DSH), maintained by seamas0825-lab, licensed under MIT, requiring Node.js >=20. Following DSH's "everything is a plugin" philosophy, this plugin integrates the YouMind OpenAPI workflow into DSH, registering the `youmind` Skill and five core model tools: searching available APIs, reading API documentation, invoking confirmed interfaces, searching personal knowledge bases or specified Boards, and conducting public internet searches via YouMind. In terms of configuration, the plugin leverages DSH's native `credentials` service to dynamically read API Keys, eliminating the need for restart after modifying credentials.
Read Moredsh-openapi: Adding OpenAPI Discovery and Secure Invocation Tools to DeepSeek Harness
dsh-openapi is a plugin for DeepSeek Harness, designed to address issues such as inconsistent parameters, uncontrolled credentials, and excessive scope when models directly call APIs. This plugin indexes OpenAPI 3.x documents and provides three core tools: `openapi_list` (discovery and search operations), `openapi_describe` (viewing details), and `openapi_call` (restricted invocation). Its core features include strict security boundaries: by default, only GET/HEAD requests are allowed, access to local and private network IPs is blocked, response body sizes are limited, and sensitive response headers are shielded, while redirect checks are supported. Credential management is implemented through environment variable mapping, ensuring that keys are not directly exposed in configurations or outputs. Installation requires the use of the `dsh plugin` command.
Read MoreFastAPI Documentation Auto-generation: Tips for Using Swagger and OpenAPI
FastAPI's automatic documentation is based on the OpenAPI specification, providing interactive API documentation through Swagger UI and ReDoc. It can quickly display interface functions, parameters, and return values, supporting direct testing. Enabling it is simple: create a FastAPI application, and after running, access `/docs` (Swagger UI) or `/redoc` (ReDoc) to view the documentation. Core techniques include: setting global information (title, description, version, etc.) using FastAPI constructor parameters; using function annotations and the `Path`/`Query` utility classes to describe interfaces and parameters in detail; categorizing interfaces with `tags` for easy filtering; hiding internal interfaces with `include_in_schema=False`; using Pydantic models to standardize return formats, or `HTTPException` to mark error status codes. These methods can enhance document clarity and usability, avoid the trouble of manual writing and maintenance, ensure consistency between interface information and code, and optimize team collaboration and user experience.
Read More