gpt-dsh-bridge
开发工具 活跃维护

gpt-dsh-bridge

baochaofan0404/gpt-dsh-bridge

GPT(ChatGPT 网页)驱动 DeepSeek Harness 自动化执行:MCP Bridge + 任务编排状态机

1
Stars 标星
0
Forks 分支
1
Watchers 关注
0
Open Issues
TypeScript
主要语言
MIT
开源协议
109 KB
仓库大小
1 个月前
最后推送
一键安装扩展 / 插件指令
dsh plugin --profile web add github:baochaofan0404/gpt-dsh-bridge
git clone https://github.com/baochaofan0404/gpt-dsh-bridge.git
git clone git@github.com:baochaofan0404/gpt-dsh-bridge.git
README.md master

GPT↔DSH Bridge

ChatGPT 网页驱动 DeepSeek Harness(DSH)自动化执行任务的桥梁。

GPT 是指挥者,DSH 是执行者。一条 MCP 协议把它们串起来。

English · 中文 | MIT License


快速开始

git clone https://github.com/baochaofan0404/gpt-dsh-bridge.git
cd gpt-dsh-bridge
pnpm install
pnpm build
pnpm start

然后通过 ChatGPT 开发者模式(Connectors → 添加 MCP)连接暴露的 https://<tunnel>/mcp 端点,即可在对话中用 dsh_task_submit 等工具驱动 DSH 执行任务。


架构

┌─────────────────┐     HTTPS MCP       ┌──────────────────────────┐     ACP      ┌──────────┐
│  ChatGPT Web    │ ─────────────────►  │  Bridge Orchestrator      │ ───────────► │  DSH     │
│  (MCP Host)     │                     │  (Node · Windows/WSL)     │   stdio RPC  │ (WSL)    │
└─────────────────┘                     │                           │              └──────────┘
     ▲                                   │  · 13 MCP 工具            │
     │ 结果回投(模型自然写入对话)         │  · 任务状态机             │
     │                                   │  · conversation↔session   │
     └───────────────────────────────────┘    映射 + 持久化           │

核心设计原则:

  • DSH 不动:复用现有 ACP 服务器,零侵入
  • Bridge 是薄层:只做任务编排、状态管理和协议适配
  • ChatGPT 侧通过原生开发者模式 MCP 接入(已在 E:\mcpgpt 验证过通道)

MCP 工具契约(当前 13 个)

工具 用途
dsh_task_submit 提交新任务,返回 taskId
dsh_task_status 查询任务状态
dsh_task_result 获取任务最终结果
dsh_task_cancel 取消运行中任务
dsh_task_revise 基于当前结果修订并重新执行
dsh_task_approve 人工审批 HUMAN_REQUIRED 任务
dsh_task_review 人工评审任务结果
dsh_task_list 列出项目下所有任务
dsh_project_create 创建/切换工作区项目
dsh_project_status 查看项目状态
dsh_session_list 列出 DSH sessions
dsh_session_archive 归档完成 session
dsh_session_rotate 轮换 DSH session(上下文过长时)

任务状态机

CREATED → SUBMITTED → RUNNING → SUCCESS → COMPLETED
                           ↘ FAILED
                           ↘ TIMEOUT
                           ↘ CRASHED
                           ↘ CANCELLED
                           ↘ HUMAN_REQUIRED → (approve) → RUNNING
                                            → (reject) → CANCELLED

完整状态机定义见 designs/state-machine.md。


目录结构

gpt-dsh-bridge/
├── src/
│   ├── mcp/           # MCP server + 13 个工具实现
│   ├── task/          # TaskManager + TaskStore(SQLite)
│   ├── workspace/     # 项目/工作区管理
│   ├── errors.ts      # BridgeError + error codes
│   └── config.ts      # 配置加载
├── designs/           # 架构设计文档
├── docs/              # 用户文档
├── scripts/           # 启动/隧道脚本
└── recon/             # 侦察报告(原始研究材料)

依赖

  • Node.js ≥ 22
  • DeepSeek Harness(DSH)已安装并运行(pnpm dsh --profile web)
  • OpenAI MCP Tunnel 或 cloudflared(HTTPS 隧道)
  • ChatGPT Developer Mode(Pro/Plus/Enterprise)

License

MIT © 2026 baochaofan0404


自主执行循环(核心特性)

这是项目的核心卖点:ChatGPT 是指挥官,DSH 是执行者,Bridge 是神经中枢。

完整流水线

关键能力

能力 工具 说明
MCP 接入 13 个工具 完整 MCP 协议支持
任务提交 返回 taskId
状态查询 轮询检查进度
结果获取 最终输出
任务修订 失败后自动修订重试
审批流程 HUMAN_REQUIRED 状态处理
后台 Worker 自动启动 独立进程,Hermes 压缩不死
任务队列 TaskManager 有序执行,不重叠
任务锁 store.ts 防止并发冲突
心跳检测 manager.ts 自动清理僵死任务
断点恢复 崩溃后可恢复
会话管理 上下文轮换、归档
Review 循环 模型自然调用 ChatGPT 自动审查结果