dsh-console

DeepSeek Harness 的控制台命令插件：网页服务管理、SSH 隧道管理、一次性问答、可选的控制台 TUI 启动——全部在斜杠命令里完成。

快速接入

# 1. 安装 bundle
dsh plugin --profile web add dsh-console

# 2. 重启 dsh web，然后直接用命令
/web status
/tunnel status

开箱即用：/web 和 /tunnel status 零配置可用（插件自动探测运行中的 dsh 入口）。隧道主机和控制台 TUI 路径在 profile 的 cordis.patch.yml 里配置：

- id: dsh-console
  config:
    tunnelHost: '192.168.1.100'        # 你的 SSH 服务器
    tunnelUser: 'root'
    tunnelKey: 'C:\\Users\\you\\.ssh\\id_rsa'
    consoleCommand: 'python C:\\tools\\dsh-tui\\main.py'

再次 dsh plugin --profile web 并重启后，/tunnel start、/console 即可用。

命令

命令	说明
/web status	网页界面是否在运行（端口 + PID）
/web start	后台启动网页界面（node <dshBin> web --port <webPort>）
/web stop	停止网页界面进程
/web restart	重启
/tunnel status	隧道是否在运行
/tunnel start	启动 SSH 隧道（需配置 tunnelHost）
/tunnel stop	停止隧道
/ask <问题>	走 headless 的一次性问答（有超时保护）
/console	启动控制台 TUI（需配置 consoleCommand）

配置

所有键都有合理默认值；在 profile 的 cordis.patch.yml（或 --patch 覆盖）里修改本 bundle 添加的行的 config：

- id: dsh-console
  config:
    webPort: 3080            # dsh 网页界面端口
    dshBin: ''               # apps/cli/lib/bin.js 路径；为空时自动探测
    tunnelHost: '192.168.1.100'
    tunnelUser: 'root'
    tunnelKey: 'C:\\Users\\you\\.ssh\\id_rsa'
    tunnelLocalPort: 3081
    tunnelRemotePort: 3080
    askTimeout: 150
    consoleCommand: 'python C:\\tools\\dsh-tui\\main.py'

键	默认	含义
webPort	3080	dsh 网页界面默认监听 127.0.0.1:3080；/web start 在此启动。
dshBin	自动	你代码仓库里 apps/cli/lib/bin.js 的绝对路径。为空时从运行进程探测（process.argv[1]），源码方式跑的 dsh 一般无需配置。
tunnelHost	''	SSH 服务器地址。为空禁用 /tunnel start。
tunnelUser	root	服务器上的 SSH 用户。
tunnelKey	''	SSH 私钥绝对路径（-i）。用 agent/其他认证时可省略。
tunnelLocalPort	3081	隧道本地监听端口（127.0.0.1:3081）。
tunnelRemotePort	3080	隧道转发到的远程端口（服务器上的 127.0.0.1:3080）。
askTimeout	150	/ask 超时秒数，超时自动终止。
consoleCommand	''	启动你的控制台 TUI 的 shell 命令。

隧道接线方式

你的机器                          SSH 服务器 (tunnelHost)
127.0.0.1:3081  ──ssh -L──▶  127.0.0.1:3080
   ▲                               ▲
   │  /tunnel start 在此监听        │  dsh web 或其他服务跑在这里

/tunnel start 会执行 ssh -N -L <tunnelLocalPort>:127.0.0.1:<tunnelRemotePort> <tunnelUser>@<tunnelHost>（配置了 tunnelKey 时加 -i）作为后台进程。/tunnel stop 找到并杀掉监听 tunnelLocalPort 的进程。

典型场景

• 本机启动器（CLI/headless profile）——终端里管理网页：/web start → 打开 http://127.0.0.1:3080；/web stop 停止。
• 远程网页（本机要访问另一台机器）——把 tunnelHost 指向远程，浏览器访问 http://127.0.0.1:<tunnelLocalPort>。
• 在 web profile 自身里——/web status、/tunnel status 安全；/web stop|restart 会杀掉正在服务当前界面的进程，请谨慎。

安全提示

• /web stop / /web restart 在 web profile 里执行会杀掉正在服务当前界面的进程。
• /tunnel start 会用你配置的密钥执行 ssh——只配置可信来源的密钥。
• /ask 会跑 headless 并消耗模型额度；结果由命令平面渲染，不进入模型历史。

开发

npm test          # 后端原语 node 测试（只读）
pnpm pack         # 打出可安装的 tarball

本 bundle 无构建步骤：纯 ESM，发布 index.js + lib/ + cordis.patch.yml。