JohnXu22786/pty-runner0

dsh-backstage

Background terminal job management for the DeepSeek Harness: launch long-running processes in a PTY, feed them input, page through their output, and stop them on demand.

包名
dsh-backstage
版本
0.1.0
许可证
MIT
最近更新
2026年8月17日

安装

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:JohnXu22786/pty-runner

Configuration

The plugin accepts optional configuration (in the config block of the patch line or a profile patch layer); everything has a default, and illegal values fail plugin loading rather than running half-configured:

- insert:
    - id: backstage
      name: dsh-backstage
      config:
        bufferCapacity: 20000   # output lines kept per job (100-200000, default 5000)
        defaultGroup: 'default' # default group tag when none is specified
        backend: 'auto'         # 'pty' (real pseudo-terminal) | 'pipe' (pipe fallback) | 'auto'
        stopGraceMs: 1500       # grace period for graceful stop, then force kill (50-60000)
        portScan: true          # check requested port occupancy before launch

backend semantics: pty uses node-pty (ConPTY on Windows) and interactive programs behave exactly as on a real terminal; pipe uses a plain subprocess pipe without terminal semantics (programs that only flush when a TTY is present may buffer output), with zero native dependencies; auto prefers pty and degrades to pipe when no native module is available.