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.

AI 分析

核心用途是让 Agent 能够管理和交互控制后台长周期运行的终端任务(如启动服务、持续测试)。适合需要复杂命令行交互与进程控制的开发任务。

パッケージ
dsh-backstage
バージョン
0.1.0
ライセンス
MIT
最終更新
2026/08/17

インストール

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

ドキュメント

README 全文を読む ↗

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.