deepseekplugins

DeepSeek Harness 插件

dsh-start

macOS 上 DSH Web 的一键启停启动器：前台/后台启动、停止、状态、防重复启动、自动打开浏览器，并可用脚本构建程序坞版 DSH.app。

插件开发工具
跳到安装方式

来源信息

GitHub 仓库
zhengjy01/dsh-start
最近更新
2026年8月18日
分类
插件开发工具
GitHub stars
0

安装

默认先复制一段 Prompt，让 Agent 读页面和仓库；需要自己装时再切到命令。

复制这段 Prompt，发给 DSH、Codex 或其他 Agent，让它先读页面和仓库。

请先不要安装。阅读这个 DeepSeek Harness 插件，说明它解决什么问题、会访问哪些文件、网络或密钥，以及如何安装和卸载。

插件页面：https://deepseekplugins.org/zh/plugins/zhengjy01/dsh-start
GitHub：https://github.com/zhengjy01/dsh-start
插件名：dsh-start
作者：zhengjy01
安装命令：dsh plugin --profile web add dsh-start

确认前不要执行安装命令。

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器3 个文件
README.md来源说明 · 只读预览

dsh-start

> English | [中文](README.zh.md)

A one-click launcher for DeepSeek Harness (DSH) Web on macOS. Stop typing dsh web by hand — start, stop, and check the server from a single command, or build a Dock-able DSH.app that behaves like a normal macOS application.

Features

  • One command, four modes — dsh-start (foreground, logs visible, Ctrl+C to stop), dsh-start -d (daemon, logs to ~/.dsh/web.log), dsh-start stop, dsh-start status.
  • Duplicate-launch guard — if the server is already up (default port 3080), it just opens the browser instead of starting a second instance.
  • Auto-open browser — polls the port after launch and opens http://127.0.0.1:3080 once ready (both foreground and daemon modes).
  • Normal-app feel (DSH.app) — scripts/build-dsh-app.sh compiles a stay-open launcher app at ~/Applications/DSH.app: double-click to start, Cmd+Q (with a confirmation dialog) to stop. Re-clicking the Dock icon ensures the server is running and opens the browser.
  • Permission-safe by design — the app delegates the server process to Terminal (which has full file-access context), avoiding the macOS sandbox/TCC EPERM failures that occur when a bare app spawns dsh directly.

Install

From npm (recommended)

npm install -g dsh-start
dsh-start            # start in foreground
dsh-start status     # is it running?

From source

git clone https://github.com/zhengjy01/dsh-start.git
cd dsh-start
./bin/dsh-start      # same CLI

Build the Dock app (optional)

dsh-start --build-app        # same as scripts/build-dsh-app.sh
# or
./scripts/build-dsh-app.sh   # needs python3 + Pillow for the icon

Usage

CommandWhat it does
dsh-startStart in the foreground; Ctrl+C stops the server
dsh-start -dStart in the background (window can close); log at ~/.dsh/web.log
dsh-start stopStop the running server (found via the port)
dsh-start statusShow whether the server is running and its URL
dsh-start --build-appBuild/refresh ~/Applications/DSH.app

The port defaults to 3080 (the dsh web default); override with the DSH_PORT environment variable.

How it works

  • scripts/start-dsh.sh checks the port first. Already running → open the browser. Otherwise it launches dsh web in the foreground (or nohup'd in daemon mode) and watches for readiness.
  • scripts/DSH.applescript is a stay-open AppleScript app (osacompile -s): run/reopen ensure the server is up and open the browser; quit asks for confirmation and runs start-dsh.sh stop before exiting.
  • The build script generates the icon with Pillow, compiles the app, patches Info.plist, and registers it with LaunchServices.

Troubleshooting

  • EPERM: operation not permitted when launching from the app — this is a macOS permission-context issue: run dsh-start --build-app (v2 app delegates to Terminal), or start via dsh-start in your own terminal.
  • Sessions "missing" after a restart — session data is never deleted; it lives in ~/.dsh/sessions. If the app-spawned server crashed at boot (see ~/.dsh/web.log), start from the terminal instead and the sidebar repopulates.
  • First launch of DSH.app — macOS may ask "DSH wants to control Terminal"; click Allow (one-time).

License

[MIT](LICENSE) © zhengjy01

返回搜索打开 GitHub 仓库

更多相关插件

查看分类