dsh-with-chatgpt

English | 中文

_{推荐 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 稳定版：

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. 完成配置

首次运行时，DSH with ChatGPT 会检查当前环境，并通过 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！