dsh-command-quit
Manifest validA simple plugin that allows users to quit their DSH client with a slash command.
dsh-command-quit
插件名:dsh-command-quit
版本:1.4.0
给 DeepSeek Harness(DSH)桌面客户端加两种退出方式:对话框里的斜杠指令 /quit-dsh,以及任意终端窗口里的 quit-dsh。两个命令名都可以自己改,终端命令还可以设置成"先问一句再退出"。
声明:本插件编写过程均由Deepseek V4.1 Flash完成(包括这个Readme文件本身),上传者只进行了基本功能测试,未逐行复查代码,可能存在未知的bug。
与官方的关系:本插件不是 DeepSeek 官方插件,与 DeepSeek 官方没有任何关系。插件里的"配置菜单"只是借用了 DSH 自带的插件设置入口来存一个自己的配置项,界面控件和官方插件共用,仅此而已。
功能
一、对话框指令:在 DSH 对话框中输入 /quit-dsh 并回车,关闭 DeepSeek Harness 桌面客户端。
二、终端命令:在任意终端窗口(PowerShell、cmd、Windows Terminal、Git Bash 都行)输入 quit-dsh 并回车,同样关闭客户端;默认还会先问一句"确认退出吗 [y/N]",答 y 才继续。
两种方式走的是同一条应用原生退出流程:如果此时还有任务在跑,会弹出确认框,而不是直接杀掉进程。不强杀、不丢数据。
使用
在输入框里输入 /q,下方会出现 /quit-dsh 候选。按 Tab 键后,候选会补全并立即执行,客户端随即关闭——当前版本里补全与执行是一步完成的。
如果输入命令时,还有任务在跑,会先弹出确认框。
也可以在命令面板里选择 quit-dsh。命令描述为「关闭 DeepSeek Harness 客户端(退出程序)」。
运行时不消耗 Token:命令完全在本地处理,只是通过 IPC 让应用外壳退出,不会发起任何模型调用,不计入 token 用量。
改命令名(配置菜单)
在 DSH 界面左侧栏打开插件页面("插件"面板),在官方分组里找到退出命令,点开它就能改命令名。
免责声明:本插件(
dsh-command-quit)不是 DeepSeek 官方插件,与 DeepSeek 官方没有关系。上面那个配置面板是 DSH 自带的插件设置入口,被本插件借用来存放自己的一个配置项(就是命令名)。因为插件配置页必须由插件自带,而界面上的设置控件是 DSH 提供的公共控件,所以它和官方插件的设置页长得一样、也排在同一个分组里——但这不代表它是官方功能。
-
四个预设:
/quit、/quit-dsh、/quitdsh、/qd。点一下就直接填进输入框。 -
自定义:在「命令名」输入框里直接打字,填
/后面那一段(例如bye)。 -
同一时刻只生效一个:只有你保存的那个命令名能用,其他名字输入了也没有反应。
-
保存后立刻生效,不需要重启客户端;旧名字同时失效。
-
保存前的两道检查(不通过就拒绝保存,输入框会变红、保存按钮点不动):
- 格式:必须以小写英文字母开头,只能包含小写字母、数字、下划线
_或连字符-。大写、中文、空格、数字开头、空值都不行。这一条由配置声明的规则直接拒绝,连写盘都不会发生。 - 撞名:不能和 DSH 内置命令、其他插件已注册的命令重名。这里有个容易踩的坑:DSH 的命令分两层存放——一部分(比如
compact、goal、plan)登记在每个会话/预设各自的作用域里,另一部分(比如export、feedback、permission)才是全局的。如果只看全局层,像compact这种名字会被当成"没人用",结果你的退出命令虽然登记成功了,却被同名的内置命令遮住,输入它根本不会退出(这正是"改成 compact 之后退出效果消失"的原因)。现在检查会遍历注册表里所有已知作用域,任一层被占用就拒绝保存:面板出现红字说明,输入框保留你的内容,配置文件不会被改写,当前正在用的命令继续可用。
万一你之前已经把一个撞名保存进去了(例如
compact),插件启动时发现这个已保存的名字不可用,会自动退回默认命令名/quit-dsh,并在日志里写明。 - 格式:必须以小写英文字母开头,只能包含小写字母、数字、下划线
-
名字事后被抢走,也会当场告诉你:还有一种保存时查不出来的情况——另一个插件只在某个会话跑起来之后才登记同名命令,而你保存时那个会话还不存在。插件会监听 DSH 的「命令表发生变化」通知,每次变化后重新确认"这个名字现在还归我吗":一旦发现被别的命令盖住,就自动改回默认命令名
/quit-dsh,并且在界面上明确告诉你:- 插件配置页(插件 → 官方 → 退出命令)里出现一段红字,写明"你配置的命令名
/xxx已被其他命令占用(占用者)",并接着说明插件已自动改用/quit-dsh、输入它即可退出。 - 应用界面底部弹出一条横幅,不用打开设置页也能看到,可以点
×关掉。关掉只关这一条;换个名字再撞、或重启后仍是同一个冲突,会再弹一次。 - 如果连默认名也被占用(极端情况),提示会改成"退出命令暂时无法使用",并请你去配置页另选一个名字。
- 插件配置页(插件 → 官方 → 退出命令)里出现一段红字,写明"你配置的命令名
配置由 DSH 自己保管,写进当前 profile 的
cordis.patch.yml,插件目录下不会产生独立的配置文件。上面那条冲突提醒会作为一个notice字段写进同一个配置项里(只在这个冲突真的发生过时才出现,平时是空的),你在配置页里换回一个可用的名字后它会被自动清掉。
终端命令 quit-dsh
先安装(只做一次)
- 打开插件文件夹,双击
install-dsh-quit.cmd。 - 看到"安装完成"后关掉那个窗口。
- 重新打开一个终端(已经开着的终端认不到新命令),输入
quit-dsh回车。
安装做两件事:把两个几行的小文件写进 DSH 自己那个已经在 PATH 里的命令目录(也就是放着 dsh.cmd 的那个目录),并且顺带找到客户端、打好退出补丁、记住它的位置。两件都不需要管理员权限,客户端开着也能做——补丁要等下次启动客户端才生效(见下面的"生效方式")。
用起来是什么样
> quit-dsh
即将关闭 DeepSeek Harness 客户端。
(如果客户端里还有任务在跑,关的时候它自己还会再弹一次确认框。)
确认退出吗? [y/N] y
正在请求关闭 DeepSeek Harness 客户端…
已发送退出请求,客户端正在关闭。
- 直接回车 = 不退出。 只有输入
y、yes或是才算同意,避免手滑。 - 客户端没开着时运行,会明确提示"没有检测到正在运行的 DeepSeek Harness 客户端"。
- 两道确认是设计如此:终端这个是第一道;客户端自己那个"有任务在跑,确定退出吗"是 DSH 官方的第二道,插件不会也不能绕过它——这正是它"正常退出、不丢数据"的原因。
- 同时开着多个客户端时,一次会把它们都请退出。
几个参数
| 命令 | 作用 |
|---|---|
quit-dsh | 先问一句,答 y 才退出(默认行为) |
quit-dsh --yes | 不询问,直接退出(写脚本或快捷方式时用) |
quit-dsh --list | 只列出正在运行的客户端,不退出 |
quit-dsh --help | 显示说明 |
--help和所有提示里出现的命令名,都跟着你实际安装的那个名字走:把终端命令名改成dshq,提示里写的就是dshq,不会写死成默认名。
设置里能改什么
在 DSH 界面左侧栏打开插件页面,找到退出命令,里面有一节"终端命令":
| 控件 | 默认 | 说明 |
|---|---|---|
| 启用终端退出功能 | 开 | 关掉后 quit-dsh 不会退出客户端,只提示功能已关闭。已经安装的启动文件会保留,重新打开开关即可继续用。 |
| 执行前先询问确认(y/N) | 开 | 关掉后 quit-dsh 直接退出、不再提问。上面那个开关关掉时,这一项会变灰。 |
| 终端命令名 | quit-dsh | 可改成任意合法名字(预设:quit-dsh、dsh-quit、dshq、dsq)。改完保存后,已经安装的启动文件会自动改名,不用重新安装。 |
| 状态那一行 | — | 告诉你装没装、装在哪个目录、有没有撞名。 |
改名后已经开着的终端需要重新打开才能认到新名字(终端会缓存 PATH 上的命令)。
名字撞了怎么办
保存时若发现这个名字在 PATH 上已经被别的文件占用(例如某个目录里的 dshq.ps1),保存会被直接拒绝,输入框变红并列出占用的文件——因为终端解析命令看的是整个 PATH,撞名会让你的命令变成另一个程序。Windows 的保留设备名(con、nul、com1 等)同样会被拒绝。
卸载
双击 uninstall-dsh-quit.cmd。它只删除带本插件标记的那两个文件;你自己创建的、恰好同名的文件不会被动;客户端的 /quit-dsh 不受影响。
它是怎么做到"正常退出"的
终端里的 quit-dsh 和插件是两个不同的进程:客户端内部那条"请退出"的专线只有插件的子进程够得着,终端够不着。所以插件在客户端运行时会开一个只允许本机连接的小接口——优先用 Windows 命名管道,环境不支持时退回 127.0.0.1 的回环端口,并且服务端会拒绝任何非本机来源的连接。接口的门牌号不是秘密,所以另配了一把随机口令(64 位十六进制),放在你自己的用户目录 ~/.dsh-command-quit/ 下。终端命令读到门牌号和口令、连上去说"请退出",插件收到后做的事和 /quit-dsh 完全相同。
口令对不上会被明确拒绝。别的程序拿不到口令,也就关不掉你的客户端。
安装
方式一:从 GitHub 安装
install_bundle github:Noobboi-22401/dsh-command-quit
github:用户名/仓库名 是 install_bundle 支持的标准写法,推荐用它。
方式二:本地路径安装
先把仓库克隆下来:
git clone https://github.com/Noobboi-22401/dsh-command-quit.git
然后:
install_bundle link:<克隆到的绝对路径>/dsh-command-quit
安装由 DSH 自带的 plugin_manager 完成,它会自动执行 pnpm add、把 dsh-command-quit 写进 profile 的 dsh.profile.bundles、建立符号链接并更新 lockfile。
生效方式
装完插件后还有一步:给客户端打上"退出补丁"。最省事的方式是双击插件目录里的 install-dsh-quit.cmd——它本来是用来装终端命令的,现在会顺便找到你的客户端、打好补丁、并记住客户端的安装位置。不想装终端命令、只想让 /quit-dsh 能用的话,在插件目录执行一次:
node tools\patch-asar.mjs
然后重启一次桌面客户端。profile 的 bundle 列表在客户端启动时读取,所以刚装上的插件也要重启后才生效。重启后默认的 /quit-dsh 就能用了(命令名随时可在插件配置页里改,改完立即生效,不用再重启)。
补丁状态随时可查:
node tools\patch-asar.mjs --check # patched / unpatched / unknown
node tools\patch-asar.mjs --revert # 还原成出厂字节
从 1.4.0 起,/quit-dsh 需要给客户端打一次"退出补丁"。 桌面客户端对子进程发来的消息只认固定几种,其余一律当成异常:它会报一句 dsh desktop host sent an invalid IPC event,把干活的进程掐掉,然后弹出"应用无法启动或已意外停止"的窗口。所以插件在发送之前会先检查客户端打了补丁没有:没打就只回答一句话、什么都不发,绝不会再把客户端弄崩。
补丁只改客户端 app.asar 里的两处语句,而且改完文件大小一个字节都不变(所以不会破坏客户端自身的完整性校验),也能用一条命令精确还原。打完要重启客户端才生效。客户端升级会换掉 app.asar,补丁随之消失——那时重新跑一次 install-dsh-quit.cmd 或 node tools\patch-asar.mjs 就行;在这之前 /quit-dsh 只会回答"还没打补丁",不会崩溃。
插件升级
已经在用旧版本的话,升级分三步——终端命令是 1.2.x 才有的新功能,光换掉插件文件是不够的。
-
换掉插件本身。用
plugin_manager先移除、再装最新版(直接重装可能报ambiguous-install,先移除最省事):remove_bundle dsh-command-quit install_bundle github:Noobboi-22401/dsh-command-quit -
装一次终端命令(只做一次,1.2.x 或更早版本的用户做;已经装过的跳过)。打开插件文件夹,双击
install-dsh-quit.cmd。 -
重启客户端。重启后原来的
/quit-dsh照旧可用,终端里也会多出一个quit-dsh。
如果终端命令你之前已经装过(例如用过测试版),不用先手动删除:插件按"第几代"识别自己写过的启动文件,发现是旧版就会自动换成新版。
1.4.0 更新了什么
- 退出功能重新可用。 1.3.0 曾判断"客户端自带一条官方退出消息,不必改安装文件"——这个判断是错的:那条消息只能由客户端往下发给子进程,插件反过来往上发会被客户端判成异常,结果就是崩溃窗口。1.4.0 回到"给客户端打补丁"的做法,但补上了 1.2.x 没有的两道保险:补丁是等长改写(文件大小不变、可一条命令精确还原),以及发送前先确认补丁在不在(不在就只说一句话、不发消息,所以不会再崩)。
- 新增
tools\patch-asar.mjs:不带参数 = 打补丁(已打过就什么也不做),--check只看状态,--revert还原成出厂字节。 - 安装脚本会自动打补丁并记住客户端位置:双击
install-dsh-quit.cmd时,除了装终端命令,还会找到你的客户端、打上补丁,并把这个位置记在下一次要用的地方,所以装在非常规目录(比如D:\Apps\DeepSeek Harness)也不用你填路径。
1.3.0 更新了什么(已作废,请升级到 1.4.0)
- 1.3.0 的说法是"不再需要给客户端打补丁,直接使用客户端自带的官方退出消息"。这个说法是错的,按它做会让客户端在退出时弹崩溃窗口。1.4.0 已改回打补丁的方式,并保证不会再出现那个崩溃。
1.2.2 更新了什么
- 新增终端命令:任意终端窗口输入
quit-dsh就能关闭客户端,走和/quit-dsh完全相同的正常退出流程,不是强杀进程。 - 命令名可以自己改:默认
quit-dsh,改完已安装的启动文件会自动跟着改名,不用重新安装。 - 执行前先问一句:默认开,答
y才退出;也可以关掉变成直接退出。 - 提示语跟随实际命令名:把命令名改成
dshq,--help和所有提示里写的就是dshq,不再写死默认名。 - 旧的启动文件会自动升级:插件按"世代"识别自己装过的文件,老版本留在磁盘上的会被自动重写。
客户端升级后
1.4.0 起:需要重新打一次补丁。 客户端升级会换掉 app.asar,补丁随之消失,/quit-dsh 会回答"这个客户端还没打好退出补丁",不会崩溃。解决办法是双击一次 install-dsh-quit.cmd(它会自动找到客户端并重新打上补丁),然后重启客户端。
终端命令的启动文件也写在 DSH 的安装目录里,客户端升级有可能把它清掉。升级后如果 quit-dsh 不见了,同样是双击一次 install-dsh-quit.cmd(配置页的状态行也会显示"尚未安装")。
卸载
- 移除插件(用应用内 plugin_manager,等价于界面里点卸载):
remove_bundle dsh-command-quit - 重启客户端。
- 如果你装过终端命令,想一并清掉:双击
uninstall-dsh-quit.cmd(它只删带本插件标记的那两个文件,也可以随时从配置页重新安装)。
补丁只在客户端的 app.asar 里改两处语句,且文件大小不变。 正常卸载时,uninstall-dsh-quit.cmd 会自动把补丁撤掉(客户端下次启动时生效)。如果插件目录已经被删掉,手动还原的命令是在仍留有本插件副本的目录里执行 node tools\patch-asar.mjs --revert;客户端本身不会因为补丁而无法使用,最坏情况只是留下一条"接受 quit-request"的多余判断。
路径配置
终端命令的安装脚本会按以下顺序决定"把启动文件写到哪里",不含任何硬编码的绝对路径:
| 环境变量 | 作用 |
|---|---|
DSH_COMMAND_DIR | 终端命令的安装目录(默认自动找放着 dsh.cmd 的那个目录) |
DSH_COMMAND_QUIT_STATE | 终端功能的状态目录(默认 ~/.dsh-command-quit) |
DSH_COMMAND_QUIT_TRANSPORT | 强制中转通道:pipe(命名管道)/ tcp(回环端口)/ auto(默认) |
DSH_HOME | DSH home 目录(默认 ~/.dsh) |
tools/ 下还有几个开发商用的小工具(profile-check.mjs 等),它们会用下面这些变量定位客户端的安装位置:
| 环境变量 | 作用 |
|---|---|
DSH_APP_ASAR | 桌面客户端的 resources\app.asar 绝对路径(打补丁和读取信息都用它) |
DSH_COMMAND_QUIT_CHANNEL | 仅用于诊断与测试:强制指定"客户端是否已打补丁"(patched / unpatched / unknown),正常使用不要设置 |
DSH_DESKTOP_EXE | 桌面客户端可执行文件绝对路径 |
DSH_DESKTOP_RESOURCES | 安装目录下的 resources 目录 |
DSH_PROFILE_DIR | DSH profile 目录 |
如果没有设置,脚本会在常见的安装位置(%LOCALAPPDATA%\Programs\DeepSeek Harness\resources 等)里自动查找;找不到时会报一条明确的错误,告诉你要设置哪个变量。
注意:显式设置的变量优先级最高,而且必须真实存在。 如果 DSH_APP_ASAR 指到了一个不存在的位置,脚本会直接报错停止,而不是悄悄改用自动找到的另一个安装——避免看错客户端。同理,脚本在自动寻找桌面主程序时,不会把安装目录里的卸载程序(如 Uninstall DeepSeek Harness.exe)误当成客户端。
目录结构
dsh-command-quit/
├── package.json # npm 包清单(含 dsh.bundle.patch 与 dsh.client 声明)
├── cordis.patch.yml # bundle 挂载声明:insert command-quit
├── .gitignore # 忽略 node_modules 等
├── lib/
│ ├── index.js # 插件本体(Host 半侧):注册指令、命令名校验、保存拦截与运行时复查
│ ├── client.js # 浏览器半侧:插件配置页(两个命令名 + 两个开关)+ 冲突提醒
│ ├── shell-channel.js # 客户端退出通道:等长补丁、状态检测、打补丁 / 还原
│ ├── terminal-state.js # 终端功能的落盘状态:实例登记表与设置快照
│ ├── quit-channel.js # 本机中转通道:命名管道 / 回环端口 + 随机口令
│ ├── terminal-install.js # PATH 扫描、启动文件安装 / 改名 / 卸载
│ ├── terminal-quit.js # Host 半侧的终端功能生命周期(监听、登记、自动同步)
│ └── quit-cli.js # 终端命令本体:提问、判定、发请求、打印结果
├── bin/
│ ├── dsh-quit.mjs # 终端命令入口(由下面两个启动器调用)
│ ├── dsh-quit.cmd # Windows 启动器(自动定位 Node.js)
│ └── dsh-quit # POSIX 启动器(Git Bash 等)
├── tools/
│ ├── dsh-paths.mjs # 共享的路径解析(环境变量 / 常见安装位置)
│ ├── profile-check.mjs # 校验 profile 是否正确组合了本插件
│ ├── install-dsh-quit.mjs # 安装 / 卸载终端命令(顺带打补丁、中文提示层)
│ ├── patch-asar.mjs # 给客户端打 / 查 / 撤销退出补丁
│ ├── test-command.mjs # 指令的 IPC 端到端测试 + 两个命令名的配置测试(Host 半侧)
│ ├── test-client.mjs # 配置页(浏览器半侧)的结构测试
│ ├── test-patch.mjs # 补丁本身的测试(等长、可还原、认不出的构建拒绝改动)
│ └── test-terminal.mjs # 终端命令的端到端测试(通道、提问、安装文件)
├── install-dsh-quit.cmd # Windows 双击入口:安装终端命令
├── uninstall-dsh-quit.cmd # Windows 双击入口:卸载终端命令
├── README.md
├── README_en.md
└── LICENSE
.gitignore 是给仓库用的,不会打进 npm 包里。
兼容性
- 平台:插件本体(
lib/)跨平台,不含任何与操作系统绑定的代码。但"退出桌面客户端"这一功能依赖 Host 子进程与桌面外壳之间的通信通道,只有在桌面客户端里运行时才可用(从终端直接启动的 Host 没有这条通道,命令会给出明确提示)。开发和测试仍以 Windows 为优先。 - macOS / Linux 未经验证:本插件只在一台 Windows 机器上、对着 Windows 版 DeepSeek Harness 开发和测试过。作者不清楚本插件是否兼容 macOS 或 Linux,也没有在那些系统上做过任何验证。插件本体(
lib/)不含平台相关代码,理论上不排斥其它系统,但双击入口(install-dsh-quit.cmd/uninstall-dsh-quit.cmd)与部分提示只针对 Windows 编写。请在其它系统上自行评估与测试,不要假定它一定能用。 - DSH 版本:在
0.2.0-rc.2、0.2.1-rc.5一类桌面构建(Electron 44.x)上验证。补丁锚定的是客户端lib/main.js里两段具体语句,换一个大版本可能对不上;对不上时补丁工具会拒绝改动并说明原因,命令只会回答"还没打补丁",不会破坏客户端。 - 配置菜单:命令名配置走 DSH 自带的插件配置页(Host 半侧声明
Config+ 浏览器半侧lib/client.js注册配置页)。要求 DSH 组合里带有@deepseek-ai/dsh-client-ui-settings、@deepseek-ai/dsh-client-ui-plugin-manager与@deepseek-ai/dsh-client-ui-primitives(配置卡片所用公共界面控件的来源),以及react(DSH 前端自带)——这四者由 DSH 主程序提供,官方桌面构建默认都有,不需要单独安装,package.json里已把它们标注为可选的 peer 依赖(peerDependenciesMeta.optional)。缺少浏览器半侧时,插件本体仍能加载,但界面上不会出现配置页。这个入口是 DSH 提供的公共机制,本插件只是使用方,配置面板底部也写明了"非官方"的说明。再次提醒:本插件与Deepseek官方无任何关系。 - 保存拦截:撞名拦截依赖 DSH 在写入 profile patch 之前派发
internal/config钩子(dsh-config-editor的保存路径)。本插件同时按“自己的 fiber”和“自己的 profile 条目 id”两种方式识别该次保存,任一命中即生效;检查范围是全局层 + 注册表里每个已知的会话/预设作用域(DSH 的/compact、/goal、/plan就藏在作用域层,只看全局层会漏掉)。若某个 DSH 版本不暴露作用域(此时只剩全局层检查),已保存的名字在启动时若不可用,仍会自动退回默认名/quit-dsh,退出指令不会失效。 - 被抢名字后的兜底与提醒:插件同时监听 DSH 的
commands/change事件(注册表每次增删命令都会派发一次,这个事件也会转发到浏览器)。每次变化后重新确认"当前注册的名字在各作用域里是否还归自己"——自己靠登记时写下的固定身份标识(definitionId,DSH 命令注册表的公开字段,与显示文字无关)辨认;只有当运行环境的注册表不返回这个字段时,才退回比对命令说明文字(并做首尾空白归一化)。所以自己的全局注册不会被误判成冲突,命令说明文字被 DSH 改写也不影响判断。一旦被别人盖住就自动改回默认名,并把原因写进插件自己的配置项(notice字段)。浏览器半侧通过 DSH 转发的settings/document-updated事件读到它,在配置页渲染红字,并注册一个shell.overlay条目在界面底部弹横幅。若某个 DSH 版本不转发该事件、或没有shell.overlay槽位,最坏情况只是提醒显示不出来,命令本身的自动退回不受影响。 - 浏览器半侧的容错:底部横幅所在的
shell.overlay正是设置弹窗所在的那一层,所以那个组件一旦在渲染时报错,会连带把设置页一起弄没。为此做了三重隔离:设置页先注册、横幅最后注册且各自独立容错;横幅自己保管状态,不依赖"槽位注入"给组件传数据;两个组件都不会抛错——渲染失败会降级成页面上的一行提示,并把失败内容记进浏览器localStorage的dsh-command-quit:diag键,排查时可以直接读它。 - 配置页读取状态的约定:DSH 用 React 的
useSyncExternalStore把“槽位注入”里的数据源变成组件属性,这条通道要求getSnapshot()在数据没变时必须返回同一个对象。两次读取只要引用不同,React 就会不断重渲染,最终把插件页连同设置页一起拖垮,表现是配置菜单打不开或一片空白,而且页面上没有任何报错。本插件的卡片因此把表单自己的绑定(SettingsFormModel.bind,与官方设置页同一做法)当作数据源,外面再包一层结构比较缓存,两重保证读取结果稳定;tools/test-client.mjs里有专门的回归检查盯着这一点。 - Node.js:
>=18(构建产物使用 ESM、顶层 await 与node:前缀导入)。终端命令的启动器(bin\下的文件与安装后写进 PATH 的那两个)会依次尝试:安装时记录下来的 Node → 系统PATH上的node.exe(并实际运行一次确认可用)→ DeepSeek Harness 自带的 Node,因此没单独安装 Node.js 的机器也能直接使用。 - Host 形态:只有在桌面客户端里运行时指令才能真正退出。在纯 Web / 服务端 Host 中执行会返回明确的提示("当前 Host 不是由桌面客户端启动的"),不会静默失败。
- 终端命令的通道:优先使用 Windows 命名管道(操作系统本身就不把它暴露到网络之外),某些受限环境不允许创建管道时自动退回
127.0.0.1的回环端口。回环模式下服务端会检查来源地址,非本机连接一律丢弃;两种模式都要求请求携带实例登记表里的随机口令,口令用定长比较,比较过程不泄露差异位置。功能关闭时不监听任何端口,"关闭"就是真的没有在听。 - 终端命令的启动文件:装在 DSH 自己那个已经在 PATH 里的命令目录(放着
dsh.cmd的目录),Windows 下同时写<名字>.cmd(cmd / PowerShell / Windows Terminal 用)与无扩展名的<名字>(Git Bash 等用),macOS / Linux 下写无扩展名的那一个。两个文件都带本插件的标记,改名和卸载时只动带标记的文件。 - 终端命令的撞名检查:保存和安装时都会扫描整条 PATH,把
<名字>以及.cmd/.bat/.exe/.ps1/.com/.vbs各种拼法都算进去,只放过带本插件标记的文件;Windows 的保留设备名(con、nul、com1…)也会被拒绝。 - 终端命令与配置页的联动:插件把当前状态写进自己配置项的
terminalNotice字段,浏览器半侧通过 DSH 转发的设置更新事件读到它并渲染成状态行。DSH 不转发该事件时最坏情况只是状态行不刷新,命令本身照常工作。改名、开关状态都会即时生效,不需要重启客户端。
注意事项
- 本插件会改动客户端安装目录里的
app.asar(1.4.0 起;1.3.0 曾声称"不改任何文件",那个说法是错的)。改动是等长的、只涉及两处语句、可用--revert精确还原,但它确实是对客户端安装文件的修改,而且客户端升级后需要重新打一次。不想要这个改动的话,本插件就没有存在的意义——不如不用它。 - 本插件不是 DeepSeek 官方插件。 它调用的是 DSH 自带的插件配置入口、插件注册服务,以及客户端自己的
app.quit()退出流程,插件本身与 DeepSeek 官方无关。 - 命令名冲突是"保存时"拦截的。 检查发生在配置写盘之前:撞名则保存直接被拒绝,面板显示红字,配置不落盘、命令不切换。想验证的话,试一个 DSH 自带的名字(如
compact),撞名会在保存那一刻被直接拒绝。 - 保存时查不出的那种撞名,会在运行中兜底并告诉你。 如果另一个插件只在某个会话跑起来之后才登记同名命令,保存那一刻它还看不见;插件会在命令表变化时重新复查,被盖住就自动改回
/quit-dsh,并在配置页红字和界面底部横幅上写明原因。这条提醒要经过 DSH 的设置推送才会显示,因此重启客户端后如果冲突仍在,会重新出现。 - 已知遗留:对已存在的本地路径依赖再执行一次
install_bundle,plugin_manager可能返回ambiguous-install(它的兜底匹配不认link:<路径>)。这是plugin_manager的匹配行为,不是本插件的问题;首次安装不受影响,遇到时先remove_bundle再重新install_bundle即可。 - 终端命令的启动文件写在 DSH 的安装目录里。客户端升级有可能把它清掉,升级后如果
quit-dsh不见了,双击一次install-dsh-quit.cmd即可恢复;插件配置页的状态行也会显示"尚未安装"。 - 终端命令是"另一个程序",需要一个正在运行的客户端。 客户端没开着时运行它只会提示;它没有办法"预先排队"。
- 本插件不会覆盖别人的文件。 终端命令名撞上已有文件时,保存会被拒绝;安装文件只删除带本插件标记的那些;
uninstall-dsh-quit.cmd不会碰你自己创建的同名文件。 - 与 DSH 的互操作性说明:插件与桌面外壳之间走 Node IPC。插件使用的事件名
quit-request是本插件新增的,由tools\patch-asar.mjs在客户端外壳里加两处判断后生效:一处把它加入"允许子进程发送"的名单,一处让它调用客户端自己的app.quit()(因此任务在跑时仍会弹出官方确认框)。插件不逐字复制客户端内部的代码,也不改动 DSH 的任何源仓库文件。DeepSeek Harness 采用 MIT 许可(https://github.com/deepseek-ai/deepseek-harness)。
License
Copyright (c) 2026 Noobboi-22401
Comments
Loading…
Similar plugins
by shuiqian520
DSH plugin: permanently delete a session from the sidebar menu, and retry a user message or an assistant reply.
★ 3
↓ 736/wk
MIT
JavaScript
Oct 17, 2026
dsh plugin --profile web add dsh-session-deleteby MAXeaglet
DSH plugin: one shell tool that runs commands through PowerShell, Git Bash, or WSL on Windows, with a user-chosen default terminal in the Web UI settings.
★ 24
↓ 197/wk
MIT
JavaScript
Sep 11, 2026
dsh plugin --profile web add dsh-bash-terminalby bcdws
DSH plugin for personal server operations: pooled SSH connections, log analysis, and a guard for machine-destruction commands.
★ 0
MIT
JavaScript
Nov 12, 2026
dsh plugin --profile web add dsh-ssh-helperby weimingyu9312
Adds customizable switch shortcut buttons to the left of the DSH Web GUI chat input for one-click slash-command insertion.
★ 0
JavaScript
Oct 10, 2026
dsh plugin --profile web add dsh-switchby Zenjibad
Enables or disables DSH plugins from Settings → Plugins: each toggle stops or starts the plugin immediately without a restart and the change persists across restarts.
★ 1
↓ 51/wk
MIT
TypeScript
Aug 28, 2026
dsh plugin --profile web add dsh-plugin-toggleDSH plugin: password SSH into a remote host — a natural-language tool (connect/exec/close/status) over a persistent ControlMaster session, plus a browser terminal panel (right-side floating) with a real PTY over WebSocket.
★ 0
dsh plugin --profile web add dsh-ssh-shell