Hermes-to-DSH

中文 · English

Hermes to DSH

在 DeepSeek Harness Web 侧栏里浏览本机 Hermes 的 技能 / MCP 服务 / 对话历史,并把选中的技能与 MCP 配置注入到当前 agent。

---

Hermes to DSH(hermes-to-dsh) 是一个 DSH 插件(dsh.bundle),把本机 Hermes 资产(技能、MCP 服务、对话历史)以可停靠、可缩放的侧栏面板呈现在 DeepSeek Harness Web UI 中,并提供两种注入模式:

• 主动 — 勾选你真正要用的技能/MCP;插件读取所选 SKILL.md + MCP 配置,注入到当前 agent 的系统提示词(含长度警示与总量上限)。
• 被动 — 接触式提示;仅当某能力缺失时,agent 才按需读取技能 SKILL.md / MCP 配置。

功能

• 固定、可拖动/缩放面板,四角抓取手柄(26px 命中区)。
• 两列布局:左 = 仓库/项目 → 对话;右 = 技能 + MCP + 模式。
• 全局搜索:对话名/id、技能名/描述、MCP 服务名。
• 对话预览:点开任意对话看 开场 X 条 + 最新 Y 条(两侧条数可分别配置)。
• 来源过滤:按对话 source(desktop/cron/...)过滤。
• 消息类型过滤:只看 提问 user / 回答 assistant / 工具 tool;选定某类型后自动补齐到设定数量(跨越其他类型取足)。
• 复制地址:复制会话 id。
• MCP 详情:勾选前先查看某服务的配置块。
• 主动选择落盘:写入 ~/hermes-active-selection.json 并通知当前会话,让 agent 知道你的选择。

能力面

能力面	说明
UI	sidebar.footer.action 侧栏面板(pill 切换 固定/可缩放两列面板)
Host handlers	inspect、chatPreview、mcpDetail、setMode、detail
注入	systemPrompt.section hermes:mode(主动 → 所选 SKILL.md 全文 + MCP 配置;被动 → 接触式提示)

安装

# bundle:进入 profile layer stack(重启 web 生效)
dsh plugin --profile web add github:beimianism/Hermes-to-DSH

# 或 纯 Cordis:通过配置 HMR,零重启
dsh plugin add github:beimianism/Hermes-to-DSH

@deepseek-ai/* 与 cordis 公开依赖刻意不声明(由 profile 的 pnpm closure 注入)。

前置:本机 Hermes 数据位于 %LOCALAPPDATA%\hermes\state.db(只读),且 PATH 里有 python 供辅助脚本使用。

原生架构(跟随启动)

插件是原生 bundle + client,随 dsh web 每次启动自动加载,无需动态插件/启动器:

• host 半(index.js):注册 ctx.connection.rpc.handle('/hermes', …, {authority:'trusted-host'}),暴露 inspect / chatPreview / mcpDetail / setMode / detail 五个端点;systemPrompt.section('hermes:mode') 注入主动/被动提示词(若宿主未提供 systemPrompt 服务——如纯 web profile——注入段自动跳过,其余功能不受影响)。
• client 半(client/index.js,由 client/_make_native.cjs 生成):__ModuleLoader__.load bundle,require('react'),host.call 适配为 ctx.connection.rpc.call('/hermes', …),样式经 <style> 注入;面板挂 sidebar.footer.action slot。
• 主动选择落盘 ~/hermes-active-selection.json 并追加会话消息通知 agent。

使用

1. 打开 DeepSeek Harness web UI。
2. 点击左下角 📁 Hermes 资产 胶囊,切换面板。
3. 面板顶部:设置 开场/最新 条数、来源过滤、搜索、消息类型;标题栏切换 主动/被动。
4. 主动模式下勾选需要的 技能 / MCP 服务 —— 面板会写入选择并通知会话。

插件管理

在 DSH 浏览器控制台 / 插件管理器 中管理已启用插件。本 bundle 安装名为 hermes-to-dsh;卸载时从 profile layer stack 移除对应行并重启 web。

布局

Hermes-to-DSH/
├── package.json          # 清单(name, exports, dsh.bundle.patch, dsh.client)
├── cordis.patch.yml     # bundle 行,插入插件
├── index.js              # Node(host)半 —— Cordis 插件
├── client/index.js       # Web client 半 —— 侧栏面板(已构建产物)
├── client/_make_native.cjs  # client 生成器(仅开发用,源面板在工作区外)
├── scripts/              # 只读 python 辅助脚本
│   ├── _hermes_scan.py       # 扫描 projects/repos/chats/skills/mcp
│   ├── _chat_preview.py      # 开场 X + 最新 Y(消息类型自动补齐)
│   └── _mcp_detail.py        # 读取某服务配置块
├── AGENTS.md
├── LICENSE (MIT)
└── README / README.en

许可证

MIT