DSH for VS Code 🐳

在 VS Code 中直接使用 DeepSeek Harness（DSH）的网页界面：点击侧边栏图标即可内嵌打开 DSH，自动启动/复用 dsh web 服务，代码与 AI 界面同屏，无需再切换终端和浏览器。

📸 界面截图

DSH for VS Code 界面截图

✨ 特性

🖱️ 一键打开：左右侧边栏各有一个 DSH 鲸鱼图标，点击即在对应侧栏内嵌显示 DSH 网页；
🚀 服务自动管理：自动探测端口——已有 dsh web 直接复用，没有则后台静默启动，就绪后自动加载；
🔄 状态实时同步：状态栏四态指示（运行中绿 / 启动中黄 / 失败红 / 已停止灰），点击状态栏可开关面板；
🛟 异常兜底：端口被占、dsh 未安装、启动超时、服务崩溃/失联均有对应提示页与一键重连，绝不白屏；
🌐 双语界面：文案跟随 VS Code 显示语言——中文环境显示中文，其余语言一律英文；
🧹 退出清理：关闭窗口自动停止插件自启的服务，不留僵尸进程；手动启动的服务永不干预；
🔒 安全边界：只连接回环地址（127.0.0.1 / localhost / [::1]），不读取凭据、不向 DSH 网页注入任何脚本。

📥 安装

方式一：下载 .vsix 安装包（推荐）

前往 Releases 下载最新 dsh-vscode.vsix；
VS Code 中按 Ctrl+Shift+P → 执行 Extensions: Install from VSIX... → 选择下载的文件；
重载窗口（Developer: Reload Window）。

方式二：从源码构建

git clone https://github.com/Fengze233/dsh-vscode.git
cd dsh-vscode
npm install
npm run package        # 产出 dsh-vscode.vsix，再按方式一安装

前置要求：已安装 DeepSeek Harness 的 dsh 命令并位于 PATH 中（插件会自动检测；未安装时会给出提示）。

🚀 使用

安装后，左侧活动栏与右侧辅助侧边栏各出现一个 DSH 鲸鱼图标；
点击任意一个图标：插件自动启动（或复用）dsh web，并在该侧边栏内嵌显示 DSH 网页；
- 点右侧图标 → 面板开在右侧，左侧文件目录不受影响；
面板标题栏按钮：在浏览器中打开 重启服务 停止服务 复制网址 查看日志；
底部状态栏显示服务状态，点击可开关面板。

命令面板（`DSH:` 开头）

命令	说明
`DSH: 打开面板`	打开左侧面板
`DSH: 在辅助侧边栏打开`	打开右侧面板
`DSH: 在浏览器中打开`	在系统浏览器打开 DSH 页面
`DSH: 重启服务`	重启插件管理的服务
`DSH: 停止服务`	停止插件启动的服务
`DSH: 复制网址`	复制 DSH 页面地址
`DSH: 查看日志`	打开插件日志输出通道

⚙️ 设置（`dsh.*`）

设置项	默认值	说明
`dsh.port`	`3080`	期望端口（探测与启动共用）
`dsh.host`	`127.0.0.1`	服务地址（仅允许回环地址）
`dsh.autoStart`	`true`	服务未运行时自动启动
`dsh.stopOnExit`	`true`	关闭最后一个窗口时停止插件自启的服务
`dsh.extraArgs`	`[]`	启动 `dsh web` 时附加的参数

🌍 多语言

界面文案跟随 VS Code 显示语言（Configure Display Language）：zh-* → 简体中文，其余语言 → 英文。

🧑‍💻 开发

环境要求：Node.js ≥ 22、VS Code ≥ 1.91。

npm install
npm run test          # 39 个单元/集成测试（含真实 dsh web 全流程）
npm run compile       # 构建 out/extension.js
npm run watch         # 监听构建
npm run typecheck     # 类型检查
npm run package       # 打包 .vsix

调试：VS Code 打开本目录，按 F5 启动 Extension Development Host。

src/
├── extension.ts          # 入口：装配与命令注册
├── i18n.ts               # 动态文案字典（zh-* 中文 / 其余英文）
├── config.ts             # 设置读取与规范化（loopback 白名单校验）
├── service/
│   ├── detect.ts         # 端口探测（识别 DSH 标记）
│   ├── process.ts        # 跨平台子进程封装（dsh / dsh.cmd）
│   └── manager.ts        # 服务管理器状态机（核心）
├── panel/
│   ├── html.ts           # 面板占位页模板（CSP 最小权限）
│   └── provider.ts       # WebviewViewProvider（iframe + 占位页）
└── statusbar.ts          # 状态栏控制器

🧭 已知限制

欢迎页"DSH 入门"卡片的彩色图标来自 Marketplace 画廊数据，仅在商店上架后显示（卡片功能本身不受影响）；
VS Code 平台规则：左侧图标打开左侧面板、右侧图标打开右侧面板，无法让左侧图标打开右侧面板。

🌐 社区

本项目是 DeepSeek Harness 社区插件（话题：dsh-plugin）。

DSH 官方仓库：https://github.com/deepseek-ai/deepseek-harness
问题反馈：https://github.com/Fengze233/dsh-vscode/issues
DSH 社区讨论：https://github.com/deepseek-ai/deepseek-harness/discussions

📄 License

English

A VS Code extension that embeds the DeepSeek Harness (DSH) web UI right inside the sidebar. One click auto-starts (or reuses) dsh web and loads the page in an embedded panel — no more switching between terminal, browser, and IDE.

Features: dual sidebar entrances (activity bar + secondary side bar), automatic service lifecycle management, live status bar indicator, graceful error/reconnect pages, bilingual UI (Chinese for zh-*, English otherwise), loopback-only security boundary.

Install: download dsh-vscode.vsix from Releases, then run Extensions: Install from VSIX... — or build from source (npm install && npm run package).

Requirements: Node.js ≥ 22 to build; VS Code ≥ 1.91; the dsh CLI from deepseek-harness on your PATH.

Community: this is a DeepSeek Harness community plugin (topic: dsh-plugin). Feedback welcome at https://github.com/Fengze233/dsh-vscode/issues.

DSH

Fengze233