前言¶
在 DSH 里对话的同时，如果还要单独开终端启停 Hermes 的 gateway 和 dashboard、再切到浏览器看面板，上下文会断得很厉害。Hermes 官方是独立 Python 发行物，DSH 也有自己的会话与 MCP 体系；两边要能互认配置、对得上 @deepseek-ai/dsh-mcp-client，通常得自己改 config.yaml、对日志。
dsh-hermes-panel 把 Hermes 的控制和可视化收进 DSH 右侧栏：启停 gateway 与 dashboard、在聊天旁嵌 dashboard、读 DSH 会话里的 Hermes 交换记录，并维护 DSH 与 Hermes 之间的 bridge。面向原生 Hermes agent（hermes-agent），不面向 hermes-web-ui / Ekko Studio。
这是什么¶
维护者 GuanYang14700 在 GitHub 发布 dsh-hermes-panel（npm 包名 @yang3333/dsh-hermes-panel），在社区目录 skillhub.cn 归类为客户端插件。仓库说明其为 plugins/hermes-panel 的生成镜像，不应在镜像仓直接改源码。
插件不安装 Hermes，只在本机已有 Hermes 的前提下定位运行环境或由你在设置里指定路径。
核心功能¶
侧栏面板（Panel）¶
在右侧栏 ⊕ 列表中选择 Open Hermes。顶部条可在三种视图间切换，并提供启停、重启、新标签页打开：
- Dashboard — 以 iframe 嵌入 Hermes dashboard，左侧仍为 DSH 对话。
- Record — 展示 Hermes ↔ DSH 的交换，数据来自 DSH 自身会话日志。
- Setup — 健康检查、更新、DSH bridge、共享工作区（shared workspace）。
健康检查与更新依赖 official-web 发行包自带的 PowerShell 脚本。若仅为上游 pip 安装、没有这些脚本，对应按钮会禁用，面板会说明原因；其余能力在任意安装方式下可用。
Bridge¶
开启 bridge 后，面板会把 Hermes 侧的 mcp_servers.dsh 写入 config.yaml，并检查各 profile 的 @deepseek-ai/dsh-mcp-client 是否与当前运行的 DSH 一致。不一致时会输出可执行的修复命令。
安全相关行为¶
HTTP 路由仅监听 loopback，并校验 Origin 与 Sec-Fetch-Site。解析 .env 时只保留 HERMES_HOME、VENV、HERMES_EXE、DASHBOARD_PORT，不持久化其它变量。文档要求：启用本插件时不要将 DSH 绑定到 0.0.0.0。
安装与启用¶
环境要求：DSH >= 0.2.0-rc.2，本机已安装 Hermes，仅支持 Windows。插件宿主侧为 Node 模块，安装后需重启 dsh，仅刷新页面不会重新加载宿主逻辑。
官方安装命令如下：
dsh plugin --profile web add @yang3333/dsh-hermes-panel
安装前建议阅读仓库源码与 MIT 许可证；插件以当前 dsh 进程权限运行。
设置项¶
在 Plugins → Official → Hermes Panel settings 中修改。两个目录均可选，留空则使用 DSH home 下的默认路径：
- Runtime — Hermes 使用的 Python 环境，默认
<dsh home>/hermes-panel/runtime。 - Data directory — 即
HERMES_HOME（profiles、sessions、config.yaml），默认<dsh home>/hermes-panel/home。
另有 dashboardPort（0 表示从 .env 读取，否则默认 9150）、sharedWorkspace、manageGateway、autostart。
典型用法¶
- 按上文命令安装并重启
dsh。 - 确认 Hermes 已安装；必要时在设置里指定 Runtime 与 Data directory。
- 侧栏 ⊕ → Open Hermes，在 Dashboard 查看面板，用顶部控件启停 gateway / dashboard。
- 需要 DSH 与 Hermes 互通时，在 Setup 中配置 bridge，按提示修正 MCP client 版本。
- 在 Record 中对照 Hermes 与 DSH 的会话交换。
适用场景与注意¶
适合在 Windows 上用 DSH Web 配置（--profile web）、并已部署 Hermes agent 的开发者：希望少切窗口、在一条工作流里管 gateway、看 dashboard、对齐 MCP bridge。
注意：
- 不支持 Linux / macOS（README 写明 Windows only）。
- 不负责安装 Hermes；pip 版缺少健康检查/更新脚本时，这两项不可用属预期行为。
- 社区目录 skillhub.cn 为独立站点，与 DeepSeek / 幻方无官方从属关系；安装第三方插件前请自行审阅代码与权限。
当前 npm 版本为 1.1.0-rc.5（见仓库 package.json），需 Node >= 20。
结尾¶
dsh-hermes-panel 把 Hermes 的 gateway、dashboard 与 DSH bridge 收进侧栏，减少在终端、浏览器和配置文件之间来回切换。目录页：https://www.skillhub.cn/plugins/GuanYang14700/dsh-hermes-panel；源码与说明：https://github.com/GuanYang14700/dsh-hermes-panel。
