跳到主内容

dsh-chatgpt-bridge 使用指南

通过官方 MCP 协议把 ChatGPT Web 桥接到本地 DSH,让 ChatGPT 直接创建、查看并继续 DSH 代理会话与受监督目标。

本文为派生内容(基于 wiki / faq / compatibility_json 自动组装),非 AI 即时创作。

本文由本站基于该插件已收录的字段自动派生(wiki / faq / compatibility_json / readme),非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-chatgpt-bridge

— 源: plugin_wiki.wiki_content

安装与验证

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

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

  • Node.js >= 22 installed and on your PATH.
  • A working DeepSeek Harness (DSH) installation — dsh on your PATH
  • A web profile is recommended. The Web UI and the Bridge should run in
  • **ChatGPT-side MCP and write-action availability depends on your current
  • This plugin includes write/action tools (dsh_send_message,

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装后还需要额外配置吗?

一般不需要。默认监听 127.0.0.1:3456,启用 token 鉴权,首次启动会自动生成 token 并写入 ~/.dsh/chatgpt-bridge.token;如果想用自定义 token 可设置环境变量 DSH_CHATGPT_BRIDGE_TOKEN。

ChatGPT 怎么访问到我本机的 MCP 端点?

ChatGPT 是远程 MCP 客户端,无法直接访问 127.0.0.1。需要走 OpenAI 当前支持的 Secure MCP Tunnel / 自定义连接器,把请求转发到 localhost:3456,并把上面的 token 作为 Bearer 头部带上。

这个插件会改动 DSH 核心吗?

不会。它只通过 Cordis 公开的 ctx.agents / ctx.sessions / ctx.sessionPersistence / ctx.workspaceRegistry / ctx.approval / ctx.userQuestions 等接缝驱动 DSH,DSH 的会话、代理、工具、沙箱与工作区安全模型保持原样。

会话保存在哪里?会跨重启丢失吗?

由 DSH 自己落盘到 $DSH_HOME/sessions///session.jsonl.zstd。插件重启、ChatGPT 对话关闭、DSH 重启都不会丢失,dsh_send_message 走 DSH 的 agent.resume() 把日志重放进模型上下文。

报 401 Unauthorized 怎么办?

token 跟运行时的 $DSH_HOME 绑定。换过 DSH_HOME、token 被重新生成、或环境变量 DSH_CHATGPT_BRIDGE_TOKEN 与已落盘 token 不一致都会触发;读取运行时实际生成的 token 后再让 ChatGPT 重新连接即可。

端口 3456 被占用怎么解决?

先用 lsof 或 Get-NetTCPConnection 查占用进程,不要直接 kill 陌生进程。如果是旧的 DSH/桥接进程就正常停止;否则改插件的 port 配置或者释放端口。

怎么彻底卸载?

执行 dsh plugin --profile chatgpt-bridge remove dsh-chatgpt-bridge 或删除对应 profile 目录。插件创建的会话日志仍可被任何共享 $DSH_HOME 的 profile 恢复。

stdio 传输能给 ChatGPT 用吗?

不行,ChatGPT Web 不在本地拉起进程。stdio 只适合与同机运行的 MCP 客户端对接;ChatGPT 必须走 HTTP + 安全隧道。

— 源: plugin_wiki.faq_json

兼容性

  • DSH: 0.1.0-rc.6+
  • Node: >=22
  • Platforms: macOS, Windows, Linux

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库;本指南基于已收录字段自动派生,可能滞后于最新版本。如发现与官方文档冲突,请以上游为准。

— 来源:通用规则