插件化 Agent 配置指南Yihong89/dsh-setup

dsh-setup

DeepSeek Harness（DSH）的设置指南和工作示例——这是一个开源 agent harness，其中一切皆插件。

本仓库通过可复制粘贴的示例，记录了如何：

1. 设置 DSH —— 安装并运行 Web UI 和无头 CLI。
2. 安装插件并创建你自己的自定义插件 —— dsh plugin、补丁层，以及一个你可以 fork 的最小插件。
3. 创建自定义 agent —— ~/.dsh/.agent-presets/ 下的用户 agent 预设。
4. 安装 MCP 服务器 —— 通过 @deepseek-ai/dsh-mcp-client 使用 stdio 和 Streamable HTTP 服务器。

快速开始

1. Install DSH (requires Node.js)
npm install -g @deepseek-ai/dsh

2. Start the Web UI (served at http://127.0.0.1:3080 by default)
dsh web

3. Headless one-shot run
dsh --profile headless "run the tests"

DSH 中的一切——Web 应用、agent 循环、MCP 客户端、皮肤、工具——都是一个
Cordis 插件，组合进一个profile。你本机的覆盖配置位于
~/.dsh/profiles//cordis.patch.yml 以及你 profile 的 package.json 中。

仓库结构

docs/
setup.md          # install, first run, profiles, troubleshooting
plugins.md        # install community plugins + author a custom plugin
custom-agents.md  # create custom agent presets (persona + tool composition)
mcp-servers.md    # connect MCP servers (stdio / streamable-http)
examples/
custom-plugin/    # minimal "hello" plugin: a model-facing tool, buildable & installable
agent-preset/     # a custom agent preset: preset.yml + agent.cordis.yml
mcp/              # cordis.patch.yml snippet wiring three MCP servers

文档

| 指南 | 你将学到 |
|---|---|
| 设置 | npx 与全局安装与源码构建、profile、配置布局（package.json + cordis.patch.yml）、首次运行。 |
| 插件 | 安装已发布/工作区插件（dsh plugin --profile web add）、在补丁层中激活它、通过插件管理器 UI 进行管理，以及编写自定义插件（name / inject / Config / apply、defineTool）。 |
| 自定义 agent | Agent 预设、内置预设、用户预设目录、preset.yml + agent.cordis.yml、在 settings.yaml 中选择默认项。 |
| MCP 服务器 | @deepseek-ai/dsh-mcp-client 插件、stdio 和 streamable-http 配置、工具命名（mcp____）、重连行为。 |

许可证

MIT