jiezeng2004-design/dsh-chatgpt-bridge

dsh-chatgpt-bridge

M8ven Score

让 ChatGPT 驱动你本地的 DSH 智能体。

在 ChatGPT 里创建任务、继续会话、监督 Goal、处理审批并检查结果，不用在 ChatGPT 和 DSH 之间反复复制 Prompt。

dsh-chatgpt-bridge 连接 ChatGPT Web → 安全 MCP 隧道 → DeepSeek Harness (DSH)。ChatGPT 成为控制界面；DSH 保留智能体循环、工具、技能、子智能体、工作流、沙箱、审批和工作区安全模型。

该桥接连接两端。它不替换 DSH、不修改 DSH 核心，也不将 DSH 模型流量经由 ChatGPT 路由。

当前包版本：v0.5.1，面向 DeepSeek Harness 0.1.1-rc.2。连接成功后，ChatGPT 应看到 工具数量 = 23。

为什么需要它

普通的 ChatGPT + 本地智能体工作流有太多手动衔接：

在 ChatGPT 中思考
↓
将 prompt 复制到 DSH
↓
等待 / 检查日志
↓
将结果复制回来
↓
在 ChatGPT 中审阅
↓
重复

使用桥接后：

ChatGPT Web
↓  创建 / 继续 / 监督 / 审批
安全 MCP 隧道
↓
dsh-chatgpt-bridge
↓
DeepSeek Harness
↓
本地工作区 + 工具 + 智能体运行时

你留在 ChatGPT 中，而 DSH 仍是执行引擎。

你可以在 ChatGPT 中做什么

- 创建并查看原生 DSH 会话；
- 发送后续指令，无需在应用之间复制上下文；
- 启动、查看、更新并等待 Goal；
- 当你的 DSH 策略要求时，通过桥接审批 DSH 操作；
- 列出已注册的工作区并检查运行时健康状况；
- 继续使用 DSH 自有的沙箱、审批和工作区边界；
- 从 DSH Web 设置界面管理受支持的隧道运行时。

实际配置

DSH Web ChatGPT Bridge 在真实安装中运行的设置界面

该截图来自真实的 DSH Web 安装，敏感值已打码。

快速开始

要求

- Node.js 22+
- 可正常工作的 DeepSeek Harness 安装（dsh 在 PATH 中）
- 一个 DSH Web 配置文件/运行时
- 可使用当前受支持的 MCP/自定义应用连接流程的 ChatGPT 访问权限

1. 安装插件

dsh plugin --profile web add dsh-chatgpt-bridge

仅执行 npm install dsh-chatgpt-bridge 是不够的：必须将该插件添加到 DSH 配置文件包中。

2. 启动 DSH Web

dsh web

让 DSH Web 和桥接保持在同一个 web 配置文件/运行时中，这样 ChatGPT 创建的会话会实时显示在 UI 中。

默认本地端点：

| 服务 | 端点 |
| --- | --- |
| DSH Web | http://127.0.0.1:3080 |
| Bridge MCP | http://127.0.0.1:3456/mcp |

3. 读取桥接令牌

Windows PowerShell：

Get-Content "$HOME\.dsh\chatgpt-bridge.token"

macOS / Linux：

cat ~/.dsh/chatgpt-bridge.token

请像对待密码一样对待此令牌。不要提交、发布或粘贴到公开聊天中。
或者，自行设置 DSH_CHATGPT_BRIDGE_TOKEN，桥接程序会使用它，而不是生成文件。

4. 连接 ChatGPT

ChatGPT Web 无法直接访问纯 localhost 的 MCP 端点。使用 OpenAI 当前支持的安全 MCP/隧道连接机制，并将其转发到：

http://127.0.0.1:3456/mcp

在连接流程需要时，将桥接令牌用作 MCP bearer 凭据。

桥接程序保持 localhost 优先的设计：它绑定 127.0.0.1，绝不暴露公共接口，也绝不自行托管隧道。

5. 刷新工具并验证

连接后，在 ChatGPT 中刷新/重新扫描 MCP 工具，并运行只读检查：

请使用已连接的 DSH App，只做只读检查：
1. 调用 dsh_health
2. 调用 dsh_list_workspaces
3. 不修改任何文件
4. 返回 bridge version、health 和 workspace 名称

一次健康的首次检查应如下所示：

bridge version = 0.5.1
tool count = 23

如果 health 正常、版本匹配，并且你注册的工作区出现，则控制路径已就绪。

第一个有用的工作流

一个实用的模式是：

ChatGPT: define the task and constraints
↓
Bridge: create / start a DSH Goal
↓
DSH: execute inside its registered workspace
↓
Bridge: wait, inspect status, surface approvals
↓
ChatGPT: review the result and decide what happens next

为了安全地首次运行，请从只读 Goal 开始：

使用 DSH App 创建一个只读检查目标：
- workspace 使用 dsh_list_workspaces 查到的已注册工作区
- goal：只读检查项目
- constraints：read_only=true
- 列出项目结构并总结 README
- 等待目标结束后只汇报结果，不修改任何文件

安全模型

这是一个控制桥接程序，而不是远程 shell 替代品。

- MCP 服务器默认绑定到回环地址。
- 它绑定 127.0.0.1，绝不暴露公共接口，也绝不自行托管隧道。
- DSH 仍然负责其自身的沙箱、审批和工作区规则。
- 桥接程序仅适用于已在 DSH 中注册的工作区。
- 令牌和隧道/运行时密钥存储在仓库之外，绝不应提交。
- 写入/操作工具是真实操作。请为你所暴露的工作区保持适当的审批策略。
- 隧道/运行时管理在设计上围绕进程所有权和生命周期歧义采取故障关闭（fail closed）策略。

如果你只需要检查，请使用只读提示，并保持 DSH 约束为只读。

这个项目不是什么

- 它不是 ChatGPT API 代理。
- 它不会让 DSH 将你的 ChatGPT 订阅用作模型提供方。
- 它不会将任意工作区上传到 ChatGPT。
- 它不会绕过 DSH 审批或沙箱。
- 它不会修改 DeepSeek Harness 核心。

故障排除

ChatGPT 无法连接

127.0.0.1 只存在于你的机器上。确认你所支持的安全隧道/MCP 连接转发到桥接端点，并且桥接令牌与正在运行的 DSH 配置文件匹配。

401 Unauthorized

从活动的 DSH home/profile 重新读取令牌，并确保连接器发送匹配的 bearer 凭据。
未出现工作区

桥接器仅列出已注册的 DSH 工作区。请先在 DSH 中注册项目；桥接器有意不自动注册任意文件系统路径。

会话存在但在 DSH Web 中未处于活动状态

请在同一 Web 配置文件/运行时中运行桥接器和 DSH Web。不同的运行时可能会持久化会话，但不会提供相同的实时 UI 行为。

工具列表看起来已过时

根据需要重启/升级插件，然后在 ChatGPT 一侧刷新/重新扫描 MCP 工具。

项目状态

这是一个积极维护的独立 DSH 插件。兼容性版本会跟踪 DeepSeek Harness 的变更，同时保留桥接器的 MCP/工具语义和安全边界。

当前包：

dsh-chatgpt-bridge@0.5.1

兼容性：v0.5.1 → DSH 0.1.1-rc.2。每次 DSH 升级后，全新的真实 ChatGPT UI 验证仍需在你的机器上重新检查。

分发和生态系统列表：

- npm
- M8ven
- dshbase
- DSHarness

第三方目录标签描述的是这些目录自身的检查；它们不是安全审计或认可。

开发

桥接器是一个独立的 DSH 插件，不修改 DSH 核心。开发重点包括：

- MCP 工具/schema 兼容性；
- 目标/会话生命周期可靠性；
- 原生设置和隧道运行时管理；
- 进程所有权安全；
- 跨受支持 DSH 版本的回归和兼容性测试。

许可证

MIT。参见 LICENSE。

非官方社区项目。与 OpenAI 或 DeepSeek 无关联，也未获得其认可。