前言¶

在 DSH（DeepSeek Harness）插件化架構中，擴展智能體能力通常涉及手動配置 MCP 服務器或編寫斜槓命令。dsh-plugin-agents-loader 插件通過自動掃描 ~/.agents 目錄，將本地配置直接掛載到運行時環境，支持熱重載，減少了手動編排的重複工作。

核心功能¶

該插件提供以下能力：

1. MCP 服務器加載：讀取 ~/.agents/mcp.json，自動創建 ctx.plugin(dsh-mcp-client, ...)，支持 http 與 stdio 兩種傳輸協議。
2. 斜槓命令註冊：掃描 ~/.agents/commands/*.md，將文件名註冊爲命令，正文內容在觸發時注入 Agent。
3. Agent 指令遷移：首次運行時，將 ~/.agents/AGENTS.md 鏈接到 dsh 的原生指令位置（~/.dsh/AGENTS.md），後續源文件變更自動同步。
4. 熱重載：監聽配置文件變更，通過 500ms 防抖機制自動重建動態資源，無需重啓進程。

安裝與前置要求¶

使用該插件前，請確保環境滿足以下條件：

• dsh 版本：0.1.7-rc.2（對應 cordis 4.0.4）。peer 依賴已精確鎖定，不匹配會直接安裝失敗。
• pnpm：插件安裝依賴 pnpm 環境。

安裝命令如下：

dsh plugin --profile web add https://github.com/CrazyPigHead/dsh-plugin-agents-loader.git

如果需要修改源碼，建議克隆倉庫後使用本地路徑安裝：

git clone https://github.com/CrazyPigHead/dsh-plugin-agents-loader.git
dsh plugin --profile web add /path/to/dsh-plugin-agents-loader

配置說明¶

插件主要依賴 ~/.agents 目錄下的三個文件/目錄。

MCP 服務器配置¶

創建 ~/.agents/mcp.json。配置項支持 enabled 字段控制加載，timeoutMs 設置超時。

{
  "mcpServers": {
    "context-7": {
      "type": "http",
      "url": "https://mcp.context7.com/mcp",
      "headers": { "Authorization": "Bearer {CONTEXT7_API_KEY}" }
    },
    "local-tool": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "some-mcp-server"]
    }
  }
}

斜槓命令配置¶

在 ~/.agents/commands/ 下創建 .md 文件。文件名即命令名，frontmatter 中的 description 爲命令描述。

---
description: 創建 conventional git commit
---

## Goal
Create conventional git commits...

## Workflow
1. `git diff --staged`
2. `git commit -m "feat: add new feature"`

驗證與調試¶

安裝完成後，可以通過 CLI 驗證插件是否已掛載：

dsh --profile <name> --dump-config | grep -A1 agents-loader

在 Agent 會話中輸入 / 查看命令列表，或嘗試執行註冊的斜槓命令。修改配置文件後，日誌應出現 reload scheduled 並自動生效。

注意事項¶

1. 版本兼容性：必須使用 dsh 0.1.7-rc.2 及以上版本，且需要 pnpm 環境。
2. 源碼修改：通過 pnpm link 安裝後，若修改源碼，需重啓 dsh 進程才能生效（Node.js 模塊緩存原因）。
3. 本地安裝：通過本地路徑安裝時，必須保留克隆目錄，後續通過 git pull 更新。
4. Profile 管理：不要手動修改 profile 目錄下的 package.json 或直接運行 pnpm，這會繞過版本檢查和寫鎖。