返回目录

dsh-console

维护状态: 活跃

cofy-x/dsh-console

DeepSeek Harness 的 TypeScript + React/Ink 终端前端(TUI)。

前往 GitHub项目主页
$ dsh plugin add dsh-console

安装

dsh 没有统一的安装命令——把该插件 README 中的配置行加入你的 profile/patch 配置,然后重启即可。

了解安装方式

21

星标

1

Fork

TypeScript

语言

Apache-2.0

许可证

2026-08-24

创建于

2026-11-18

最近推送

README

DSH Console

English | 简体中文

DSH Console is a keyboard-first, DSH-native terminal workbench for DeepSeek Harness. It combines durable sessions, structured tool and approval flows, plan and subagent views, local shell workflows, and rotating Pokémon startup art in a polished React/Ink interface.

DSH Console creating and running a Python program

[!WARNING]

DSH Console is currently a public prerelease. Its DSH contracts and persisted sessions are real, but commands and UI details may still change before the first stable release.

Quick start

DSH Console requires Node.js 24 or newer and pnpm on PATH to install its DSH profile. Install pnpm and the exact audited DeepSeek Harness and DSH Console pair:

npm install --global pnpm@12.15.0
npm install --global @deepseek-ai/dsh@0.2.2-rc.4 @cofy-x/dsh-console@0.1.0-rc.5
dsh-console

The dsh-console launcher first resolves the dsh executable selected from PATH and checks its version, then initializes its owned DSH profile and keeps the profile package aligned with the installed launcher version before starting the interactive TUI. Run dsh --version plus command -v dsh on macOS/Linux, (Get-Command dsh).Source in PowerShell, or where dsh in Command Prompt to inspect the selected installation.

To use an existing DSH profile with your own provider, model, or tools, select it before Console arguments:

dsh-console --profile my-profile --prompt "hello"

--profile <name> takes precedence over DSH_CONSOLE_PROFILE; otherwise the launcher uses its managed dsh-console profile. Create a custom profile with DSH first (for example, dsh plugin --profile my-profile add @cofy-x/dsh-console@0.1.0-rc.5, which requires pnpm on PATH). The launcher installs or updates only its Console bundle in the selected profile; DSH still owns providers, credentials, packages, and patches. Profiles under the same DSH_HOME share Sessions, credentials, settings, and attachments; use a separate DSH_HOME for isolation. Missing or invalid custom profiles fail rather than silently falling back. From a source checkout, invoke node apps/cli/bin/dsh-console.js --profile my-profile; pnpm start is a separate development path.

This Console release supports DSH 0.2.2-rc.4 through the maximum tested version 0.2.2-rc.4. DSH Console follows audited DSH releases, and a compatible prerelease can differ from npm latest, so the installation command pins both products exactly. Older DSH releases are rejected before profile changes; newer unaudited releases produce a warning but remain available for user-directed testing.

Plugin admission on newer releases is still governed by DSH compatibility checks; Console never grants version exemptions or bypasses Host restrictions.

Start directly with a prompt:

dsh-console --prompt "hello"

Continue the latest resumable Session for the current directory, or resume an exact Session ID. An initial prompt can be supplied after either option:

dsh-console --continue
dsh-console --resume dsh-console-01234567-89ab-cdef-0123-456789abcdef --prompt "continue this work"

If the official DeepSeek provider is missing a credential that DSH can configure, DSH Console opens a masked setup dialog before submitting the first prompt and writes the credential through DSH. DSH controls credential precedence and writability; saved DeepSeek credentials take precedence over environment values, and writable environment-backed credentials can be replaced through DSH. Providers without a Console setup adapter continue to use their existing DSH configuration paths. DSH Console never maintains a separate credential store.

Public prereleases use versions such as 0.1.0-alpha.x and 0.1.0-rc.x while the current published Console remains available through npm's default install path.

A published package launch uses the globally installed launcher and reconciles its exact package into the dsh-console profile. A source checkout launch with pnpm start resolves that checkout instead; it is a development path and does not prove the behavior of the published package.

What you get

  • Streaming, multi-turn conversations with Markdown, reasoning, interruption, and usage display
  • DSH tool calls, results, approvals, questions, todo state, and browsable /tools and /skills catalogs
  • Per-Session DSH Agent composition with /preset, including deterministic restoration
  • DSH-native model selection, image input from @path or the clipboard, and isolated prompt completion
  • Persistent DSH sessions with startup continuation, /new, and /sessions
  • Local shell mode, themes, settings, terminal-safe cleanup, and continued operation in a regular PTY or embedded terminal such as Orca

Interactive commands

Command Purpose
/model Select the active DSH model
/new Start a fresh conversation
/sessions Search, preview, rename, resume, or fork workspace Sessions
/jobs Inspect and stop background jobs for the current Session
/goals Manage the Session goal, activation, and round limit
/tools Inspect tools exposed by the active DSH agent
/skills Inspect and discover user-invocable DSH Skills
/preset Show or change the blank Session's DSH Agent preset
/theme Select the terminal theme
/settings Edit Console settings
!command Run a command locally without submitting it to the model

在 GitHub 阅读完整 README →

DSH Plugins 是独立的 DeepSeek Harness 插件目录,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。