前言¶
在 DeepSeek Harness（DSH）裏做前端或腳本開發時，常見做法是另開終端窗口，手動 cd 到項目目錄再執行 pnpm dev、npm run build 等命令。窗口一多，切換和停進程都要自己記 PID 或關窗口。社區插件 dsh-runner（維護者 HuaGyuu）在 Harness 左側欄提供「運行項」面板：爲每個項綁定工作目錄與一條命令，點運行即在該目錄下執行，日誌實時可見，並可停止或重啓。下面介紹它的定位、能力與安裝用法。
這是什麼¶
dsh-runner 是 DSH 生態中的工作流類插件（社區目錄：SkillHub 條目）。一句話定位：DeepSeek Harness 左側欄的「運行項」面板——爲每個項指定目錄和命令，點運行相當於在該目錄打開 cmd 執行；輸出實時可見，隨時可終止。源碼託管於 GitHub：HuaGyuu/dsh-runner，許可證 MIT，當前 package 版本爲 0.1.0。
核心功能¶
以下能力均來自項目 README 說明：
- 多個運行項：每項各自綁定工作目錄與命令，互不干擾。
- 一鍵運行 / 停止 / 重啓：停止時結束整棵進程樹，避免遺留孤兒進程。
- 實時日誌：按字節偏移增量拉取，長輸出不阻塞界面。
- 命令歷史與狀態持久化：數據保存在
$DSH_HOME/dsh-runner/（運行項配置、歷史、logs/<runId>.log）。 - 中英文界面：隨 Harness 界面語言自動切換。
命令按原樣交給 PowerShell 執行，支持 npm run build && node serve.js 這類組合命令。
安裝與啓用¶
需要 DeepSeek Harness >= 0.2.0-rc.1。安裝時把示例裏的 web 換成你實際使用的 profile 名。
方式一 · 直接從 GitHub 安裝：
dsh plugin --profile web add github:HuaGyuu/dsh-runner
方式二 · 克隆到本地再安裝（README 原文；若你方規範禁止 clone，可僅用方式一）：
git clone https://github.com/HuaGyuu/dsh-runner.git
dsh plugin --profile web add ./dsh-runner
安裝完成後，左側欄即可看到「運行項」面板。
典型用法¶
- 在面板中新建運行項：填寫名稱、工作目錄、命令（例如
pnpm dev）。 - 點「運行」，日誌實時滾動；點「停止」結束整個進程樹，點「重啓」重新拉起。
- 需要本地開發服務器、構建腳本或一次性任務時，可把常用命令固化爲運行項，減少在 Harness 外切終端的次數。
插件作者在 harness/ 目錄提供了冒煙測試，開發或自測時可執行：
pwsh -File ./harness/run-smoke.ps1
適用場景與注意¶
適合誰：經常在固定目錄重複跑 dev/build/serve 等命令的 DSH 用戶；希望在一個界面裏看日誌並統一停進程的場景。
權限與安全：運行項以當前 DSH 進程的用戶權限在本地啓動子進程，命令內容完全由你配置。安裝前建議瀏覽 倉庫源碼 與 MIT 許可證，確認符合你的環境策略。SkillHub 等社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
平臺：README 與 runner.ps1 表明命令墊片面向 Windows PowerShell；在非 Windows 環境使用前需自行確認 Harness 與插件在該平臺上的行爲。
結尾¶
dsh-runner 把「目錄 + 命令 + 日誌 + 停進程」收進 Harness 側欄，適合把本地軟件服務的啓停納入日常開發流。更多信息見 SkillHub 目錄頁 與 GitHub 倉庫。
