前言¶
在 DeepSeek Harness（DSH）里做 Limob 一类桌面项目时，调试、构建、Rust 检查往往要反复切到外部终端或手敲同几条 PowerShell 命令。DSH 自带右侧栏终端，但缺少和当前会话、工作区绑定的快捷入口。社区维护者 lcx19970714 的客户端插件 dsh-limob-runner 在对话输入框正下方增加「▶ 运行」按钮，从菜单选命令后在 DSH 内置终端执行，输出实时滚动；命令可在设置里按项目或全局维护，并支持 GitHub Releases 更新提示。
这是什么¶
dsh-limob-runner 是 DSH 客户端插件（分类：客户端），仓库 lcx19970714/dsh-limob-runner，目录页见 SkillHub。当前 package 版本为 0.5.0，许可证 MIT，引擎要求 Node >=22，DSH >=0.2.1-0 <0.3.0-0；README 写明适用于 DSH 0.2.1 线（0.2.1-rc.2 实测）。插件依赖 DSH 内部客户端服务，升级 DSH 后可能需要适配。
核心功能¶
输入框下方的运行入口¶
按钮挂在对话输入框卡片正下方（conversation.composer.dock 槽位），样式为「▶」+「运行」，默认透明、悬停淡背景，不占额外高度。点击向上展开菜单：按当前项目过滤命令、显示运行中绿点、停止终端、管理命令、检查更新。有新版本时按钮上出现小橙点；启动/运行/失败状态以小字显示在按钮右侧，约 6 秒后消失。
命令配置¶
DSH 左下角 设置 → 「Limob 运行器」（也可从菜单 「管理命令…」 打开）。支持新增/编辑/删除、排序、启用停用；作用域可选 全局 或 指定项目（从 DSH 工作区下拉选择，或自定义路径）。命令在 Host 侧通过 PowerShell 执行，可勾选「先执行 chcp 65001」缓解 Windows PowerShell 5.1 中文乱码。可开关输入框下方运行按钮，并导出/导入配置 JSON、恢复内置默认命令。
首次安装自带 4 条 全局 示例（路径以 Limob-windows 为例，可按需改）：
| 名称 | 工作目录 | 命令 |
|---|---|---|
| 开发调试 | H:\Limob-windows |
pnpm 客户端-调试 |
| Rust 检查（cargo check） | H:\Limob-windows\src-tauri |
cargo check |
| 快速构建（tauri build –debug） | H:\Limob-windows |
pnpm exec tauri build --debug --no-bundle |
| 正式构建（pnpm 构建桌面端） | H:\Limob-windows |
pnpm 构建桌面端 |
终端行为¶
选中命令后，插件通过 remote.terminal 在 Host 创建 PTY，优先 pwsh（否则 Windows PowerShell），并将 %USERPROFILE%\.cargo\bin 前置到 PATH；自动展开右侧栏并打开 terminal 页签。同一命令若终端仍在运行则聚焦已有页签、不重复启动；终端已退出则关闭旧实例再重跑。菜单中的「停止本会话 Limob 终端」会关闭本插件在当前会话创建的终端。
更新提示¶
内建 GitHub Releases 检查（6 小时缓存，可手动「检查更新」）。有新版时按钮橙点、菜单顶部提示、插件详情页「可更新」徽标。升级需用户在 DSH 插件页卸载后用 github: 规格重装，或完全退出 DSH 后执行下文 CLI 安装命令；README 说明不做静默自动升级，以免绕过用户确认与 profile 写入权限。
安装与启用¶
下面介绍三种安装方式，任选其一。
方式 A：DSH 界面（推荐）
- 侧栏 插件 → 添加插件（Add plugin）
- 选择 Install a third-party plugin
- 粘贴安装规格：
github:lcx19970714/dsh-limob-runner
- 安装后进入任意会话，输入框卡片正下方应出现「▶ 运行」。
方式 B：命令行
桌面版需先完全退出 DSH，再执行：
dsh plugin --profile desktop add github:lcx19970714/dsh-limob-runner
其它 profile 将 desktop 换成对应名字。
方式 C：本地开发
git clone https://github.com/lcx19970714/dsh-limob-runner
dsh plugin --profile desktop add file:<仓库绝对路径>
典型用法¶
- 在 Limob 运行器 设置页把默认命令的工作目录改成你的 Limob 工程路径，或新增「指定项目」条目并与 DSH 侧栏工作区对齐。
- 打开对应该工作区的会话，点输入框下方 ▶ 运行，选择例如「Rust 检查（cargo check）」。
- 观察右侧终端输出；若需强制重跑仍在 shell 中的会话，先 停止本会话 Limob 终端，再点同一命令。
- 定期从菜单 检查更新，或关注插件页「可更新」提示后再重装。
配置与运行状态保存在浏览器 localStorage（键名含 dsh.limob-runner.config.v1 等）；卸载插件后若要彻底清理，可在 DevTools 中删除相关键。
适用场景与注意¶
适合在 DSH 0.2.1 线上开发 Limob 或类似 Tauri/pnpm 栈、且希望命令与当前工作区绑定的开发者。插件与 DSH 内置 UI 插件同属 Cordis 客户端 Context，使用的是 非官方承诺稳定 的内部接口（如 remote.terminal、settings.section）；实现侧有能力检测与 try/catch，异常通常只影响运行/更新提示，不应阻断聊天。
安装第三方插件前，应自行查看 GitHub 源码 与 MIT 许可证；命令在 DSH Host 进程权限 下执行，勿添加不可信 shell 内容。SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系，并非官方应用商店。
结尾¶
dsh-limob-runner 把 Limob 常用命令收拢到输入框下方和设置页，减少在 DSH 与外部终端之间来回切换。进一步了解可访问 SkillHub 目录页 与 GitHub 仓库。
