dsh-msszsd-toolkit:DSH 工作流小功能合集

前言

在 DSH 桌面端長時間跑智能體時,常見需求並不都在「模型能力」裏:人不在電腦前時要能往某個會話裏補一句;界面上的審批和提問不能只能盯着客戶端;想在下個步進邊界停住補話;升級或崩潰後要能重啓並接着跑;工作日白天還要省一點 token。這些能力拆成多個獨立插件也能做,但維護多份 package.json、多份 cordis.patch.yml 和多次安裝重啓的成本偏高。下面介紹維護者 MSSZSD3925 發佈的 dsh-msszsd-toolkit(npm / 目錄名 dsh-msszsd-toolkit):把五個自用模塊合成一個 DSH 插件,在插件詳情頁用五個運行期開關分別啓用。

這是什麼

dsh-msszsd-toolkit 是分類爲「工作流」的社區插件(SkillHub 目錄:dsh-msszsd-toolkit;源碼:GitHub MSSZSD3925/dsh-msszsd-toolkit)。當前 package 版本 0.5.0,許可證 MIT。它把 QQ 遠程駕駛、跨會話提問、界面暫停、重啓 DSH(含可選重啓後自動續跑)、以及按時間段注入「貴時段紀律」提示詞,合併進同一套 Cordis 補丁與配置分組。

模塊 實現文件 作用概要
qq lib/qq.js 經 OneBot / NapCat 把 QQ 當作第二塊屏幕:注入消息、會話路由、審批/提問鏡像、提權、文件與進度推送等
session_ask lib/session-ask.js 向另一個已存在會話提問並取回答(只問不指揮;白名單、審批與日誌)
pause lib/pause.js 界面左下角暫停按鈕,在下一個步進邊界停住等你補話
restart lib/restart.js 重啓 DSH;可選「重啓後自動續跑」
peak lib/peak.js 工作日 9:00–12:00 / 14:00–18:00 向系統提示注入「省 token 五條」,其餘時間不出現

核心功能

QQ 遠程駕駛(qq)

插件把 QQ 私聊(及配置的羣場景)接到當前 profile 已有會話上:注入的是「你本人發的普通消息」,桌面端會話照常運行。常用命令包括 #list / #ls 列會話、#set / #use 設默認路由、#<路由> 內容 或 #內容 注入、#status 看連接與待辦、#restart 系列控制重啓、#stop 停輸出、#msg / #last 讀回內容、#help 看完整清單。README 還說明了審批與提問在 QQ 側的鏡像(#y / #n、#answer)、本輪提權 #escalate、文件 #file、進度 #progress、入站媒體落盤、以及與其他 QQ 插件共存時的 bind_token 綁定號機制。

模型側另有 OneBot 相關工具(如 onebot_send_file、qq_send_image 等),細節以 README「QQ 遠程駕駛」各小節爲準。

跨會話提問(session_ask)

面向「向另一個會話問一句、只取回答」的場景,帶白名單、審批與日誌,避免把遠程會話當成指揮台濫用。

界面暫停(pause)

在 Web 客戶端注入左下角暫停控件;配置項包括 pause.route_prefix(默認 /dsh-pause)和 pause.wait_seconds(無人操作時自動繼續的秒數,0 表示一直等)。舊鍵 routePrefix / waitSeconds 仍兼容。

重啓與續跑(restart)

提供重啓 DSH 的能力;QQ 側也有 #restart 等命令與之配合。若要用「重啓 DSH」相關腳本,README 提到可執行 install-restart.ps1(僅 Windows 場景)。重啓後是否自動續跑由該模塊配置與運行期邏輯決定,詳見倉庫說明。

貴時段紀律(peak)

僅在工作日指定時段向系統提示注入省 token 相關條文,非高峯時段整段不出現,避免全天硬塞同樣約束。

安裝與啓用

在 DSH 桌面端 插件 → 插件市場 搜索 dsh-msszsd-toolkit 安裝,或使用 CLI(命令來自倉庫 README):

dsh plugin --profile desktop add dsh-msszsd-toolkit

從 GitHub 源碼安裝:

dsh plugin --profile desktop add github:MSSZSD3925/dsh-msszsd-toolkit

僅當需要「重啓 DSH」相關能力時,README 另給 PowerShell 安裝腳本:

powershell -ExecutionPolicy Bypass -File .\install-restart.ps1

本機開發可 link 本地倉庫路徑(示例路徑需按你的機器替換):

dsh plugin --profile desktop add link:C:/Users/<you>/Documents/deepseek-harness/default-workspace/_tools/dsh-toolkit

裝完後請覈對 C:\Users\<you>\.dsh\profiles\desktop\package.json 的 dsh.profile.bundles 是否包含 dsh-msszsd-toolkit:若 CLI 被 pnpm 構建腳本攔下,bundles 可能漏寫,表現爲重啓後插件靜默不生效。修改 lib/ 後需重啓 DSH;可用插件提供的 dsh_restart 工具。

插件詳情頁會出現「功能開關」卡片,五個模塊各一個開關,可按需關閉不需要的子功能。

配置要點

cordis.patch.yml 按 qq:、session_ask:、pause:、restart:、peak: 分組;鍵名以 schema 爲準,寫錯鍵不會阻止加載但會被忽略。換機器通常要改:qq.allow_users(QQ 白名單,空列表等於拒收所有人)、qq.napcat_path、qq.dsh_exe、restart.*_path。

倉庫默認值偏中性;個人 QQ 號與路徑建議寫在 ${DSH_HOME:-~/.dsh}/dsh-toolkit.local.json,啓動時深合併覆蓋。啓動日誌出現 [dsh-msszsd-toolkit] 本地配置已合併:… 表示本地覆蓋已生效。

QQ 模塊若啓用綁定號,在本地 JSON 配置 qq.bind_token 後,在 QQ 發 #bind <口令>;白名單 allow_users 中的號仍可發管理命令。

典型用法

  1. 安裝並打開五個開關中你需要的模塊,完成 QQ 路徑、白名單或本地 JSON 覆蓋。
  2. QQ 遠程:在 NapCat / OneBot 就緒後,QQ 發 #start 查狀態,#list 看會話,#set <路由> 設默認,之後直接發文字(不帶 #)進默認會話;需要審批時在 QQ 回覆 #y / #n,提問用 #answer 格式作答。
  3. 暫停補話:在界面點左下角暫停,等 agent 走到步進邊界停住,補完再繼續。
  4. 跨會話提問:在啓用 session_ask 的前提下,按該模塊文檔配置白名單與審批,向目標會話發起單次提問並讀回答案。
  5. 貴時段:啓用 peak 後,工作日白天自動注入紀律提示,無需手動改系統提示。

自檢入口示例:QQ 模塊提供 #testask 驗證提問鏡像鏈路;#check 可新建對話做 QQ 側自檢。

適用場景與注意

適合誰:已經在用 DSH desktop profile、且希望用手機 QQ 或第二入口參與同一 profile 會話;需要在多會話之間「只問不控」;或希望暫停、可控重啓、按時段省 token 的用戶。維護者說明這是自用能力合併包,功能面較寬,可按詳情頁開關只開需要的模塊。

運行權限:插件與當前 DSH 進程同權限,可觸達本機路徑、執行配置中的腳本(如 QQ 賬單 bill_script)。安裝前請閱讀源碼與 MIT 許可證,自行評估 NapCat、OneBot 與 QQ 賬號安全邊界。

環境:package.json 要求 Node ^22.19.0 || >=24.0.0;QQ 模塊依賴 onebot.js 0.2.1。README 中大量路徑示例面向 Windows;Linux 用戶需自行對照 DSH_HOME 與本地 JSON 覆蓋方式。

生態說明:DSH 社區插件目錄(SkillHub)是獨立站點,與 DeepSeek / 幻方無官方從屬關係;安裝來源以 npm 包名或上述 GitHub 倉庫爲準。

結尾

dsh-msszsd-toolkit 把遠程入口、跨會話協作、人機步進控制、重啓續跑和時段化提示詞收進一個可開關的合集,適合不想維護五個獨立插件包的 DSH 用戶。進一步瞭解可訪問 SkillHub 插件頁 與 GitHub 倉庫 README。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜