yauntyour/DSH-for-VSC
把 DeepSeek Harness（DSH）的 WebUI 搬进 VS Code：编辑器内嵌面板 + 侧边栏控制台，服务离线自动拉起，日志随时可查。
安装Install
dsh plugin --profile web add github:yauntyour/DSH-for-VSC把 yauntyour/DSH-for-VSC 加入你的 DSH 配置（web profile）即可启用。
READMEREADME
DSH for VSC
把 DeepSeek Harness（DSH）的 WebUI 搬进 VS Code：编辑器内嵌面板 + 侧边栏控制台，服务离线自动拉起，日志随时可查。
DSH for VSC 是一个 VS Code 扩展，将 DSH 的 Web 界面（默认 http://127.0.0.1:3080/）映射为 VS Code 的扩展页面，让你在 IDE 内完成"看状态 → 开面板 → 用 WebUI → 看日志"的完整闭环，无需在浏览器和编辑器之间切换。
功能特性
- 侧边栏快捷入口：Activity Bar 新增 DSH 鲸鱼图标，一键打开「DSH 控制台」。
- 侧边栏控制台：实时显示服务在线/离线状态与服务地址；内置「打开 WebUI / 刷新页面 / 浏览器 / 启动服务 / 停止服务」按钮。
- 侧边栏配置：自动启动开关、启动命令均可直接在控制台内修改并即时生效（写入 VS Code 全局设置）。
- 侧边栏运行日志：滚动记录扩展运行事件（状态切换、面板操作、进程启停、配置变更），同时写入输出通道。
- 编辑器内嵌面板：Webview 全屏加载 DSH WebUI，保留完整页面交互；切换后台不重载，重启 VS Code 自动恢复。
- 状态栏指示：左下角常驻 DSH 图标，在线/离线一目了然（离线红色高亮），点击即开面板。
- 服务自动启动：检测到服务离线约 6 秒后，自动以隐藏后台子进程方式拉起 DSH（不占用终端）；60 秒冷却防止反复拉起。
- 服务日志：服务进程的 stdout/stderr 经管道实时输出到「输出 → DSH Server」，不占终端、随时可查。
- 可配置地址：通过
dsh.webuiUrl可指向任意 DSH 服务（含远程主机）。
环境要求
- VS Code
^1.85.0（Windows / macOS / Linux） - Node.js（扩展宿主自带；启动 DSH 服务时需要）
- DSH CLI：
dsh在 PATH 中，或可通过npx @deepseek-ai/dsh运行（二选一，见自动检测）
安装
方式一：安装 .vsix（推荐）
npm install
npm run compile
npm run package # 生成 dsh-for-vsc-0.1.0.vsix
code --install-extension dsh-for-vsc-0.1.0.vsix
安装后重载窗口，左侧 Activity Bar 即出现 DSH 鲸鱼图标。
方式二：F5 调试运行
- 用 VS Code 打开本仓库目录；
- 按
F5（.vscode/launch.json已配置，自动编译并启动扩展开发宿主窗口）； - 在开发宿主窗口中点击鲸鱼图标或执行命令 DSH: Open WebUI。
快速开始
- 安装扩展并重载窗口；
- 若 DSH 服务未启动，等待约 6 秒——扩展会自动在后台拉起服务（也可点控制台「启动服务」立即拉起）；
- 点击 Activity Bar 的鲸鱼图标打开「DSH 控制台」，确认状态为绿色「在线」；
- 点击「打开 WebUI」，DSH 界面即在编辑区呈现。
使用指南
命令
| 命令 | 说明 |
|---|---|
DSH: Open WebUI |
打开（或聚焦）WebUI 内嵌面板 |
DSH: Reload WebUI |
关闭并重新打开面板（强制刷新页面） |
DSH: Open in Browser |
在系统浏览器中打开 DSH 页面 |
DSH: Start Server |
手动启动 DSH 服务（后台子进程） |
DSH: Stop Server |
停止由本扩展启动的服务进程 |
侧边栏「DSH 控制台」
| 区域 | 内容 |
|---|---|
| 状态区 | 在线/离线圆点、服务地址 |
| 操作区 | 打开 WebUI / 刷新页面 / 浏览器 / 启动服务 / 停止服务 |
| 设置区 | 「离线时自动启动服务」开关、启动命令输入框（留空自动检测，回车或点「保存」生效） |
| 运行日志 | 扩展运行事件滚动列表（最新在前，最多保留 150 条） |
服务管理
- 启动：服务离线约 6 秒后自动拉起；或点击「启动服务」/ 执行
DSH: Start Server。 - 停止：点击「停止服务」/ 执行
DSH: Stop Server；VS Code 关闭时扩展会自动终止其拉起的服务进程，不留孤儿进程。 - 日志：服务进程输出实时写入「输出 → DSH Server」通道；扩展自身事件写入「输出 → DSH for VSC」通道。
配置
| 设置项 | 默认值 | 说明 |
|---|---|---|
dsh.webuiUrl |
http://127.0.0.1:3080/ |
DSH WebUI 服务地址（Webview 面板与控制台状态均基于此） |
dsh.autoStart |
true |
服务离线时是否自动启动 |
dsh.startCommand |
空（自动检测） | 启动 DSH 服务的完整命令；留空自动检测（见下） |
自动检测
dsh.startCommand 留空时，扩展按以下顺序选择启动命令：
- 检测扩展宿主 PATH 中是否存在
dsh→ 使用dsh web； - 否则回退为
npx @deepseek-ai/dsh web。
自定义示例：dsh --profile web --port 3080、node C:/path/to/dsh/lib/bin.js web 等。
工作原理
┌──────────────────────────── VS Code ────────────────────────────┐
│ Activity Bar(鲸鱼) ──> DSH 控制台 (WebviewView) │
│ │ 状态推送/日志推送/配置读写 (postMessage) │
│ ▼ │
│ 扩展宿主 (extension host) │
│ ├─ 状态机：每 2s http.get 探测服务连通性 │
│ │ └─ 离线连续 3 次(≈6s) 且 autoStart=on ──> spawn 启动 │
│ ├─ 服务进程：childProcess.spawn(隐藏, 管道 stdio) │
│ │ └─ stdout/stderr ──> 输出通道 DSH Server │
│ ├─ WebUI 面板：Webview + iframe(frame-src 仅指向 WebUI 地址) │
│ └─ 状态栏：DSH 图标（离线红色高亮） │
└─────────────────────────────────────────────────────────────────┘
│ ▲
▼ │ 连通性探测 / 页面加载
┌─────────────────────────────────────────────────────────────────┐
│ DSH 服务 (dsh web, 默认 127.0.0.1:3080) │
└─────────────────────────────────────────────────────────────────┘
- 连通性探测：扩展激活后常驻轮询（2 秒间隔，1.5 秒超时），状态变化时同步刷新状态栏、侧边栏与面板，并写入日志。
- 自动启动：连续离线 3 次探测后触发；启动采用
spawn(command, { shell: true, windowsHide: true, stdio: ['ignore','pipe','pipe'] })，stdin 关闭、输出经管道持续消费（避免子进程因管道缓冲写满而阻塞），转存到「DSH Server」输出通道。 - 进程生命周期：
exit/error事件驱动状态重置与日志记录；deactivate时终止服务进程。 - 安全嵌入：面板与控制台 HTML 使用严格 CSP（
default-src 'none'），iframe 的frame-src仅允许 DSH 服务地址；已验证 DSH 服务响应头不含X-Frame-Options/frame-ancestors，可安全内嵌。 - 会话恢复：
retainContextWhenHidden保留面板状态；registerWebviewPanelSerializer在窗口重启后恢复面板。
目录结构
DSH for VSC/
├── src/extension.ts # 扩展唯一入口：面板/控制台/状态机/进程管理
├── media/deepseek-whale.svg # Activity Bar 鲸鱼图标（单色，自适应主题）
├── out/ # 编译产物（extension.js）
├── package.json # 清单：命令/视图/配置/激活事件
├── tsconfig.json # TypeScript 编译配置
├── .vscode/ # launch.json / tasks.json（F5 调试）
├── .vscodeignore # vsix 打包排除规则
├── README.md
└── LICENSE # MIT
开发
npm install # 安装依赖（typescript / @types/vscode / vsce）
npm run compile # 编译 TypeScript → out/
npm run watch # 增量编译（开发时配合 F5 使用）
npm run package # 打包 .vsix（vsce --no-dependencies）
常见问题
服务启动失败，日志提示找不到可用命令
扩展会在侧边栏与输出通道打印实际尝试的命令。若 dsh 与 npx 均不可用，请在设置 dsh.startCommand 中填入实际启动命令（例如用 Node 直接指向 DSH 的 lib/bin.js）。
自动启动没有生效
检查控制台设置区「离线时自动启动服务」开关是否打开（对应 dsh.autoStart）；另外自动启动有 60 秒冷却期，手动停止后需等待冷却结束。
服务日志在哪里看
「查看 → 输出」→ 下拉选择 DSH Server（服务进程输出）或 DSH for VSC（扩展事件日志）。
VS Code 关闭后服务会怎样
由扩展拉起的服务进程会随 VS Code 关闭被终止（deactivate 时 kill）。如需常驻服务，请在外部终端自行启动 dsh web，扩展会自动探测并接入。
端口冲突
若 3080 端口被其他进程占用，请通过 dsh.webuiUrl 与 dsh.startCommand 分别配置实际地址与端口（如 dsh --profile web --port 3090）。
License
MIT
相关推荐Related
- deepseek-ai/deepseek-harness DeepSeek Harness: Everything is a Plugin.
- deepseek-ai/deepseek-harness DeepSeek Harness (dsh) — 由 DeepSeek AI 开发的开源 agent harness（智能体框架）。一切皆插件：核心 + 插件 + 技能 = 可热插拔的 AI 编程工作台。DeepSeek Harness: …
-
ruvnet/ruflo
🌊 The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build c…
-
amruthpillai/reactive-resume
A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source a…
-
volcengine/OpenViking
Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.
-
Molunerfinn/PicGo
:rocket: The Ultimate Image Uploader for Efficient Creators. Supports Obsidian, Typora, VS Code etc. and 60+ image hosti…
-
titanwings/colleague-skill
将冰冷的离别化为温暖的 Skill，欢迎加入数字生命1.0！Transforming cold farewells into warm skills? It's giving rebirth era. Welcome to Digital …
-
nocobase/nocobase
NocoBase is an open-source AI + no-code platform for building business systems fast. Instead of generating everything fr…