DSH for VS Code 🐳

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

📸 界面截图

---

✨ 特性

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

📥 安装

方式一：商店安装（推荐）

VS Code 扩展面板搜索 DSH（发布者 Fengze233），或命令行执行：

code --install-extension Fengze233.dsh-vscode-panel

商店页面：https://marketplace.visualstudio.com/items?itemName=Fengze233.dsh-vscode-panel

方式二：下载 .vsix 安装包

1. 前往 Releases 下载最新 dsh-vscode.vsix；
2. VS Code 中按 Ctrl+Shift+P → 执行 Extensions: Install from VSIX... → 选择下载的文件；
3. 重载窗口（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 中（插件会自动检测；未安装时会给出提示）。

🚀 使用

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

命令面板（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

MIT © 2026 Fengze233

---

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: from the Marketplace (code --install-extension Fengze233.dsh-vscode-panel) or download dsh-vscode.vsix from Releases and 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.