前言¶
在 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 仓库。
