Plugin directory / Developer / dsh-win-launchscript
dsh-win-launchscript
Verified · install-tested on dsh NaNExist
What it does
One-click startup script for DeepSeek Harness (DSH) on Windows: automatically starts web service, opens browser, and stops service after window closes.
Works — verified, early-stage project
One-click startup script for DeepSeek Harness (DSH) on Windows: automatically starts web service, opens browser, and stops service after window closes. It installs cleanly and boots without issues in our testing. It's early-stage but functional.
“Verified” means our automated CI actually ran dsh plugin add in a clean profile and it booted — nothing more. Feature descriptions and version compatibility are the author’s claims. This is not a security audit and not an endorsement of third-party code.
README
DSH Windows 一键启动脚本
用于在 Windows 上一键启动 https://github.com/deepseek-ai/deepseek-harness 的两个便携脚本。 本项目不负责安装 DSH。把两个脚本复制到已经通过 npm 安装了@deepseek-ai/dsh 的目录(与 node_modules 同级),然后双击批处理文件即可。
文件说明
-StartDSH.bat:双击入口。优先使用 PowerShell 7(pwsh),未安装时使用 Windows PowerShell。
- start-dsh.ps1:启动 DSH Web 服务、打开浏览器并负责退出时清理服务。
使用方法
1. 准备 DSH 目录
请先安装 Node.js 和 npm,然后在准备存放 DSH 的目录中安装依赖: ``powershell
npm install @deepseek-ai/dsh
`
安装完成后,目录中应存在:
`text
你的 DSH 目录/
├─ node_modules/
│ └─ @deepseek-ai/
│ └─ dsh/
├─ StartDSH.bat
└─ start-dsh.ps1
`
2. 启动
双击 StartDSH.bat。
脚本会:
1. 在本机 127.0.0.1:3080 启动 DSH Web 服务;
2. 优先用 Chrome,其次用 Edge 打开独立浏览器窗口;
3. 将 DSH 的本地数据放在脚本目录下的 data 文件夹;
4. 在该浏览器窗口关闭后,停止本次脚本启动的服务。
如果 3080 端口上已经运行 DSH,脚本只会打开页面,不会接管或关闭已有服务。如果端口被其他程序占用,脚本会提示错误并退出。
常见问题
提示找不到 DSH
确认脚本与 node_modules 位于同一目录,并检查以下文件是否存在:
`text
node_modules\@deepseek-ai\dsh\lib\bin.js
`
若不存在,请在该目录重新执行:
`powershell
npm install @deepseek-ai/dsh
`
3080 端口被占用
关闭占用 3080 端口的程序后重试。脚本不会强行终止无法确认为 DSH 的进程。
浏览器关闭后服务没有停止
脚本依赖 Windows 进程信息来识别独立浏览器窗口。在权限受限的环境中,可能需要回到启动窗口并按提示结束服务。
数据与安全
- DSH 数据保存在本地 data/,不要将其中的账号、会话或配置提交到 Git。
- 不要把 .env、API Key、访问令牌或其他凭据加入仓库。
- 本项目的 .gitignore 已排除 node_modules/、data/、常见环境变量文件和日志。
- 脚本通过 -ExecutionPolicy Bypass` 仅对本次 PowerShell 进程放宽执行策略,不会修改系统的永久策略。
适用环境
- Windows 10/11 - Node.js 与 npm - PowerShell 7 或 Windows PowerShell 5.1 - Chrome、Edge,或系统默认浏览器说明
本项目只是社区启动脚本,不隶属于 DeepSeek。DSH 本身的安装、配置请以其上游项目说明为准。Install
Install the catalog once, then DeepSeek Harness can find and install any plugin from this site automatically:
dsh plugin add dshbase-catalog Then say "install dsh-win-launchscript for me" — your agent finds it in the directory and installs it. Docs: dshbase-catalog · verified packs.
This plugin is GitHub source (not published to npm) — install it straight from the repo:
Web profile:
dsh plugin --profile web add github:NaNExist/dsh-win-launchscript Headless (CLI) profile:
dsh plugin --profile headless add github:NaNExist/dsh-win-launchscript Test report
Verified: L1 install + L2 load + L3 runtime from GitHub source on dsh 0.1.0-rc.6.
When to use it
Extend the agent's coding surface — give it a new tool, workflow, or integration so it handles a dev task it couldn't before.
Who it's for
Developers who want dsh to behave like a teammate on real codebases — editing, running, and verifying changes rather than just answering.
For developers — extending it
The tool/command surface is the seam: expose more of the SDK, add smarter context wiring, or tighten the loop between code changes and verification.