♡ dsh-session-bridge ♡

让你的 MCP 客户端和 DeepSeek Harness 会话聊天~

English · 简体中文 · 繁體中文

@stellarie/dsh-session-bridge (≧∀≦)

> 非官方项目，与 DeepSeek 无关。目标版本：DeepSeek Harness 0.2.1-rc.3，也可运行在 0.2.1-rc.2 上。

这是什么？

DeepSeek Harness（DSH）是一款桌面智能体应用。这个包让另一个智能体来驾驶它。

它由两个小部件组成：

• 宿主插件。 运行在 DSH 应用内部，提供一个带令牌保护的本机回环 HTTP 桥。
• stdio MCP 服务器。 由你的 MCP 客户端（例如 Claude Code）启动，负责和桥通信。

客户端可以打开一个普通的 DSH 会话、发送消息、等待回复并读取它。
这个会话和其他会话一样显示在应用里。你随时可以旁观，也可以接手 ♡

环境要求

• DeepSeek Harness 0.2.1-rc.3 或 0.2.1-rc.2，并且你可以编辑它的配置档（profile）。
• Node.js ^22.19.0 或 >=24.0.0。
• 一个支持 stdio 的 MCP 客户端。

安装

1. 安装插件

使用 dsh 命令行。请把 default 换成你的 profile 名称。

dsh plugin --profile default add @stellarie/dsh-session-bridge

也可以直接从 GitHub 安装。安装时会在你的机器上构建本包，所以 profile 必须允许运行构建脚本：

dsh plugin --profile default add github:stellarie/dsh-session-bridge

也可以手动编辑 profile。在 profile 的 package.json 里加入依赖，然后把它写进 bundles，位置在 @deepseek-ai/dsh-web-app 之后。

{
"dependencies": {
"@stellarie/dsh-session-bridge": "^0.1.0"
},
"dsh": {
"profile": {
"bundles": [
"@deepseek-ai/dsh-base",
"@deepseek-ai/dsh-web-app",
"@stellarie/dsh-session-bridge"
]
}
}
}

包内附带 cordis.patch.yml，它会替你插入插件条目。重启应用。
日志会显示 session-bridge: serving http://127.0.0.1:…/session-bridge。

2. 注册 MCP 服务器

让 MCP 客户端指向 profile 内的副本（`` 是你的 DSH profile 目录）：

claude mcp add dsh-session-bridge -- node /node_modules/@stellarie/dsh-session-bridge/lib/mcp.js

或者直接从 npm 运行，无需安装到 profile：

claude mcp add dsh-session-bridge -- npx -y -p @stellarie/dsh-session-bridge dsh-session-bridge-mcp

其他 MCP 客户端也可以使用。命令是 dsh-session-bridge-mcp，传输方式是 stdio。

MCP 服务器每次调用都会重新读取 endpoint 文件，所以重启应用后不需要重启 MCP。

工具

一次典型的往返：

dsh_open_session { cwd: "C:/repo", preset: "my-preset" }  → { sessionId, reused, workspaceId, effort }
dsh_send         { sessionId, text: "Fix the failing test" } → { accepted, afterSeq: 41 }
dsh_wait         { sessionId, afterSeq: 41 }               → { ended: true, lastSeq: 58 }
dsh_read         { sessionId, afterSeq: 41 }               → { messages: [ … ] }

> dsh_open_session 的 preset 默认值是 yuu，那是作者自己的预设。请传入你自己的预设 id。
> 参见 BACKLOG 1。

> 新会话通过应用的模型选择来设置 effort。应用同时会把这个 effort 保存为所有会话的默认值。
> 参见 BACKLOG 5。

桥如何保证安全 (｀ω´)ゞ

这座桥拥有对你会话的完整所有者控制权。请务必读完这一节。

每个请求都必须按顺序通过这些检查：

1. 没有 Origin 头。浏览器页面一定会带上它，所以会被拒绝。
2. Host 是回环地址（127.0.0.1、localhost 或 [::1]），且端口与服务器端口一致。
3. 带有持有者令牌（bearer token），并以恒定时间比较。
4. 只允许 POST，JSON 正文最大 1 MiB。
5. 方法在白名单内。会话方法：create、prompt、page、projections、list、cancel、selectModel、modelCatalog。工作区方法：create。

令牌是 32 个随机字节，插件每次启动都会重新生成。
插件在 POSIX 上以 0600 权限写入 endpoint.json（url、token、pid、startedAt），关闭时删除。

• 请把 endpoint 文件当作机密。 任何能读取它的人都可以向你的智能体发送提示。
• 桥只监听 DSH 网页服务器所监听的地址，不会自己再开端口。
• 桥以应用所有者的身份发言。你发送的提示，效果等同于你在应用里亲手输入的提示。
• dsh_open_session 会在 cwd 没有工作区时创建工作区，并把新会话的 effort 保存为应用默认值。

配置

移动文件时，请在两侧设置相同的路径。

开发

pnpm install
pnpm run typecheck
pnpm test
pnpm run build

构建会生成 lib/index.js（插件）和 lib/mcp.js（MCP 服务器）。

许可证

MIT © stellarie。用 ♡ 制作 (๑˃ᴗ˂)ﻭ