BeforeWave/dsh-with-chatgpt

搭配 ChatGPT 的 DSH

告别复制粘贴与 DSH Token 焦虑！让网页版 ChatGPT 直连本地项目、自己动手 Coding，长任务交给 DSH 本地持续执行。

npm
DSH
License

推荐
Agent Helm Extensions · ChatGPT + 本地 Agent
  |  
Agent Helm · 本地运行时

💡 为什么需要搭配 ChatGPT 的 DSH？

网页版 ChatGPT 有很强的模型能力，但原本无法直接访问你的本地项目、文件和终端。

DSH 能真正操作工程，但大量 Token 往往消耗在读取项目、理解上下文、分析问题和反复确认上。

搭配 ChatGPT 的 DSH 把两者连接起来：

* ChatGPT 直接动手 Coding： 读取和修改本地文件、运行终端命令、检查 Diagnostics、Git、构建和测试结果。
* 减少 DSH Token 消耗： 项目理解、问题分析、小型修改和结果 Review 可以直接由 ChatGPT 完成，把 DSH 的 Token 留给真正需要持续执行的任务。
* 复杂任务直接交给 DSH： ChatGPT 把已经理解清楚的任务直接交给原生 DSH Session，无需让 DSH 再从头理解整个项目。
* 完成后继续 Review： DSH 执行完成后，ChatGPT 可以重新检查真实代码、Diff 和测试结果。
* 原生 Session，随时接管： ChatGPT 创建的任务就是正常的 DSH Session，可以直接在 DSH Web 中查看、继续操作或人工接管。

⚡ 快速开始

1. 安装 Plugin

npm 稳定版：

dsh plugin --profile web add @beforewave/dsh-with-chatgpt

指定版本：
dsh plugin --profile web add @beforewave/dsh-with-chatgpt@0.1.4

macOS / Linux：

curl -fsSL https://raw.githubusercontent.com/BeforeWave/dsh-with-chatgpt/main/install.sh | sh

指定版本：
curl -fsSL https://raw.githubusercontent.com/BeforeWave/dsh-with-chatgpt/main/install.sh | sh -s -- 0.1.4

Windows x64：

irm https://raw.githubusercontent.com/BeforeWave/dsh-with-chatgpt/main/install.ps1 | iex

指定版本：
& ([scriptblock]::Create((irm https://raw.githubusercontent.com/BeforeWave/dsh-with-chatgpt/main/install.ps1))) -Version 0.1.4

GitHub 安装入口会先检查本机 DSH，下载并校验对应 Release 的 Plugin 包，再通过 dsh plugin add 完成安装。

2. 启动 DSH

dsh web

3. 完成配置

首次运行时，搭配 ChatGPT 的 DSH 会检查当前环境，并通过 Setup Guide 引导完成所需安装、ChatGPT Tunnel 和权限配置。

配置完成后，回到 chatgpt.com 就可以直接基于本地项目开始工作。

🛠️ 工作流与核心功能

1. ChatGPT 自己处理本地项目

通过 Agent Helm，ChatGPT 可以直接：

* 理解项目结构
* 查找和读取代码
* 修改本地文件
* 运行终端命令和工程工具
* 查看 Diagnostics 和 Git 状态
* 执行构建与测试
* 检查真实运行结果

小型修改、Bug 排查、代码理解和验证，可以直接由 ChatGPT 完成。

2. 重任务交给 DSH

任务需要大量修改、构建、测试或持续执行时，ChatGPT 可以直接创建原生 DSH Session。

ChatGPT
│
├── 理解项目
├── 分析问题
├── 直接修改与验证
│
└── 复杂任务 ──► DSH Session
│
Edit · Run · Test
│
▼
ChatGPT Review

DSH 接到的是已经明确的任务和工作上下文，把更多 Token 留给真正的执行。

3. 原生 DSH Session，随时接管

通过 ChatGPT 创建的任务仍然是完整的 DSH Session。

你可以直接在 DSH Web 中：

* 查看 Agent 当前执行状态
* 查看执行活动和结果
* 继续与 DSH 交互
* 手动修改代码
* 随时接管 Session

ChatGPT 和 DSH 始终围绕同一项真实工作协作。

👀 在 DSH 中查看 ChatGPT 的工作

DSH with ChatGPT 会在 DSH 中增加一个轻量入口，用来查看 ChatGPT 当前关联的本地工作：

* ChatGPT Conversation
* 项目 / Worktree
* ChatGPT 的本地操作
* 当前工作状态
* 最近执行活动
* 关联的 DSH Session

这个入口用于查看和管理 ChatGPT 的本地工作，不改变原生 DSH Session 的使用方式。

📚 Work History

ChatGPT 和 DSH 的工作会保留在 Work History 中：

* 对应的 ChatGPT Conversation
* 项目 / Worktree
* ChatGPT 做过的本地操作
* DSH Session
* 当前或最终状态
* 最近执行活动

离开原来的 Conversation 后，也可以重新找到这项工作。

🔒 本地项目与安全

项目和实际执行环境始终留在本地电脑上：

* 权限控制： ChatGPT 可以访问哪些项目、执行哪些操作，由当前 Workspace 的授权和能力决定。
* Sandbox： ChatGPT 自己执行本地操作时受到 Agent Helm 的权限和 Sandbox 保护。
* DSH 原生权限： 任务交给 DSH 后，按照对应 DSH Session 自身的权限和 Sandbox 配置执行。

🔗 相关项目

| 项目                                                                           | 与本项目的关系                                                             |
| ---------------------------------------------------------------------------- | ------------------------------------------------------------------- |
| Agent Helm                       | 本项目依赖的本地运行时，为 ChatGPT 提供代码理解、文件与命令操作、Sandbox 和 DSH Session 协作能力。    |
| Agent Helm Extensions | Agent Helm 的 Chrome Extension，让 ChatGPT 从浏览器直接使用本地项目和 Coding Agent。 |

📌 项目状态

DSH with ChatGPT 正在持续开发与积极迭代中。欢迎提交 Issue 与 Pull Request！