English | 中文
# DSH with ChatGPT
**告别复制粘贴与 DSH Token 焦虑！让网页版 ChatGPT 直连本地项目、自己动手 Coding，长任务交给 DSH 本地持续执行。**
[](https://www.npmjs.com/package/@beforewave/dsh-with-chatgpt)
[](#-快速开始)
[](./LICENSE)
推荐
Agent Helm Extensions · ChatGPT + 本地 Agent
|
Agent Helm · 本地运行时
---
## 💡 为什么需要 DSH with ChatGPT？
网页版 ChatGPT 有很强的模型能力，但原本无法直接访问你的本地项目、文件和终端。
DSH 能真正操作工程，但大量 Token 往往消耗在读取项目、理解上下文、分析问题和反复确认上。
**DSH with ChatGPT** 把两者连接起来：
* **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 稳定版：**
```bash
dsh plugin --profile web add @beforewave/dsh-with-chatgpt
```
> 指定版本：
> `dsh plugin --profile web add @beforewave/dsh-with-chatgpt@0.1.4`
**macOS / Linux：**
```bash
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：**
```powershell
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
```bash
dsh web
```
---
### 3. 完成配置
首次运行时，DSH with ChatGPT 会检查当前环境，并通过 **Setup Guide** 引导完成所需安装、ChatGPT Tunnel 和权限配置。
配置完成后，回到 `chatgpt.com` 就可以直接基于本地项目开始工作。
---
## 🛠️ 工作流与核心功能
### 1. ChatGPT 自己处理本地项目
通过 Agent Helm，ChatGPT 可以直接：
* 理解项目结构
* 查找和读取代码
* 修改本地文件
* 运行终端命令和工程工具
* 查看 Diagnostics 和 Git 状态
* 执行构建与测试
* 检查真实运行结果
小型修改、Bug 排查、代码理解和验证，可以直接由 ChatGPT 完成。
### 2. 重任务交给 DSH
任务需要大量修改、构建、测试或持续执行时，ChatGPT 可以直接创建原生 DSH Session。
```text
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](https://github.com/BeforeWave/agent-helm) | 本项目依赖的本地运行时，为 ChatGPT 提供代码理解、文件与命令操作、Sandbox 和 DSH Session 协作能力。 |
| [Agent Helm Extensions](https://github.com/BeforeWave/agent-helm-extensions) | Agent Helm 的 Chrome Extension，让 ChatGPT 从浏览器直接使用本地项目和 Coding Agent。 |
---
## 📌 项目状态
DSH with ChatGPT 正在持续开发与积极迭代中。欢迎提交 Issue 与 Pull Request！