Skip to main content
Glama
ShadowMiner

hermes-dsh-bridge

by ShadowMiner
OverviewSchemaSourceRelated ServersScoreDiscussionsAdmin
JavaScript
Local

hermes-dsh-bridge

License: MIT Node >=22 dsh-plugin

Hermes Agent ↔ DeepSeek Harness (DSH) 桥:让 Hermes 把任务派发给 DSH 执行, 并在 DSH 侧边栏以 UI 可见会话 实时观看执行过程。

主线能力:

  • Hermes → DSH 派单 — POST /mcp/collab JSON-RPC:dispatch_task(one-shot / continuable),返回真实 token 用量,支持任务信封、知识切片、项目记忆注入。

  • 可见派单 (visible dispatch) — 默认把 one-shot 任务落地为 DSH 侧边栏可见的根会话(不是隐藏子代理):你能亲眼看到 agent 一步步执行 SSH、改文件、跑命令。

  • DSH → Hermes 工具 — 10 个工具:list_hermes_sessions、import_hermes_session、load_hermes_persona、consult_hermes、hermes_inbox、hermes_inbox_append、load_hermes_project_memory、mirror_session_to_hermes、session_mirror、dispatch_status、rotate_outbox_now。

  • 会话镜像 — 把任意 Hermes 会话作为原生 DSH 会话继续对话(side-by-side)。

  • MCP 工具暴露 — 通过 dsh-mcp-client 把外部 MCP server(如 hermes-web)暴露给 DSH 子代理。

快速开始

前置:DSH Desktop >= 0.7.x、Node >= 22、Hermes Agent(任意版本,只要有会话目录)。

# 1. 安装插件
dsh plugin --profile web add hermes-dsh-bridge

# 2. 创建磁盘连接(源码方式)
#    把本仓库 clone 到本地,在 profile 的 package.json dependencies 里
#    用 "link:" / junction 指向 packages/dsh-hermes-link

# 3. 配置 Hermes 家目录(必须与你的 Hermes 安装一致)
$env:HERMES_HOME = 'C:\Users\<you>\AppData\Local\hermes'   # Windows
# 或
export HERMES_HOME="$HOME/.hermes"                         # Linux/macOS

启动 DSH Desktop 后,插件健康检查:

curl http://127.0.0.1:<port>/mcp/collab/health
# {"ok":true,"version":"0.5.1","hermes_home":"...","importer_ready":true,...}

DSH Desktop 每次启动 HTTP 端口随机;从 harness.log 尾部取 dsh web: http://127.0.0.1:PORT/?token=... 获得当前端口与 token。

Related MCP server: dsh-web-mcp

派单示例

curl -X POST http://127.0.0.1:<port>/mcp/collab \
  -H 'content-type: application/json' \
  -H "cookie: dsh-auth=<token>" \
  -d '{
    "jsonrpc": "2.0", "id": "t1", "method": "tools/call",
    "params": {
      "name": "dispatch_task",
      "arguments": {
        "task_id": "demo-001",
        "skill": "pwsh",
        "task": "检查本机磁盘空间,汇报使用率",
        "model": "deepseek/deepseek-v4-flash",
        "visible": true
      }
    }
  }'

visible: true(默认)时,返回体带 visible_session_id 与 workspace_title—— 打开 DSH 侧边栏对应工作区即可看到该会话实时执行。

环境变量

变量

默认

作用

HERMES_HOME

~/.hermes

Hermes 会话/记忆根目录

DSH_LINK_LLM_PROVIDER

commandcode

子代理 LLM provider

DSH_LINK_VISIBLE_WORKSPACE

空

可见派单落地的 workspace(workspaceId/title/path 子串)

DSH_LINK_SSH_HOST / DSH_LINK_SSH_KEY

空

给子代理的 SSH 直连提示(避免探测主机)

DSH_LINK_PROXY

空

子代理 HTTP 代理提示

DSH_LINK_TZ_HINT

空

时区提示(如 server logs are UTC; Beijing = UTC+8)

架构

┌─────────────┐   POST /mcp/collab (JSON-RPC)   ┌─────────────────────┐
│   Hermes    │ ──────────────────────────────▶ │  DSH Desktop        │
│  Agent      │     dispatch_task / followup    │  ┌───────────────┐  │
└─────────────┘ ◀────────────────────────────── │  │ dsh-hermes-   │  │
      ▲               run.result / consult      │  │ link plugin   │  │
      │                                         │  └───────┬───────┘  │
      │      MCP tools (list_hermes_sessions,   │          │ creates  │
      └──────────────────────────────────────── │    UI-visible root  │
              import, mirror, consult ...)      │    session (侧边栏) │
                                                └─────────────────────┘

安全模型

  • POST /mcp/collab 由 DSH web token 鉴权(HERMES_LINK_TOKEN,当前 auth: open 仅供本地回环)。

  • 派单信封带 task_id 与 skill 白名单;子代理只能用一个工具(toolFilter.allow=[skill])。

  • amend/consult 协议带 nonce 认证;审计全量落盘 audit.jsonl。

  • 详细见 docs/security-model.md。

文档

License

MIT。本项目代码继承自 dsh-hermes-link (MIT, Copyright (c) 2026 Tianbuyu-wwx),并在其之上继续演进。

This server cannot be installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers