DeepSeek Harness 插件

dsh-tui-pro

Interactive terminal UI plugin for DeepSeek Harness(英文原文)

跳到安装方式

来源信息

GitHub 仓库
lk251066/dsh-tui-pro
最近更新
2026年8月21日
分类
插件开发工具
GitHub stars
1
载体类型
plugin
包路径
packages/dsh-tui
目录证据
上游声明已找到 dsh.bundle
证据路径
packages/dsh-tui/package.json#dsh.bundle
核对版本
0.1.0-rc.8
上游核对日期
2026-08-20

该证据由上游目录提供。本站没有安装、运行或安全审核这个插件。

安装

默认先复制一段 Prompt,让 Agent 读 GitHub 仓库和源码;需要自己装时再切到命令。

复制这段 Prompt,发给 DSH、Codex 或其他 Agent,让它先读 GitHub 仓库和源码。

请先不要安装或执行任何命令。阅读这个插件的 GitHub 仓库、README 和关键源码,然后用清楚、直接的方式回答以下问题,帮助我判断它是否适合我的需求:

1. 这个插件是什么,解决什么问题;
2. 适合哪些用户和典型使用场景;
3. 安装后如何使用,并给出一个最小使用示例;
4. 有哪些已知限制,以及隐私、安全、兼容性或维护风险;
5. 给出“推荐 / 有条件推荐 / 不推荐”的明确建议和理由。

请区分仓库明确说明、根据源码推断和未知信息。证据不足时请明确说明,不要猜测或照抄 README。

GitHub:https://github.com/lk251066/dsh-tui-pro/tree/HEAD/packages/dsh-tui
插件名:dsh-tui-pro
作者:lk251066

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器3 个文件
README.md来源说明 · 只读预览

@lk251066/dsh-tui

English | 简体中文

A multi-session terminal workbench plugin and profile bundle for DeepSeek Harness.

![dsh-tui-pro switching between persistent project sessions](./assets/session-workbench.gif)

Install

This package requires Node.js ^22.19.0 || >=24.0.0, the dsh CLI, and DEEPSEEK_API_KEY configured outside the package.

dsh plugin --profile tui add @lk251066/dsh-tui
dsh --profile tui

Without a global dsh installation:

npx -y @deepseek-ai/dsh@latest plugin --profile tui add @lk251066/dsh-tui
npx -y @deepseek-ai/dsh@latest --profile tui

The package declares its own dsh.bundle.patch; a separate bundle package is neither required nor supported.

Runtime behavior

  • Only the transcript scrolls; the input, live status, plan, and sidebar remain fixed.
  • The terminal title shows the mounted session and animates the process-wide running-session count; supported terminals also expose taskbar progress.
  • One durable Assistant remains outside project workspaces, uses a permanent working directory, and manages active project sessions.
  • Project sessions are grouped by workspace, retain their ordering, and resume from the launch directory.
  • Enter steers a running turn, Tab queues the next turn, Esc recovers queued input, and double Esc browses checkpoints.
  • Model, reasoning effort, image draft, input draft, and memory state remain independent per live session.
  • Thinking, tools, code, diffs, plans, todo progress, and subagents use structured renderers.
  • Final replies always render in full. Tool bodies have compact and expanded states; tool identity, status, and failures never disappear.
  • Model, effort, skill, theme, setting, permission, question, and approval selectors use the fixed bottom area.
  • Transcript selection copies plain text without ANSI styles; Alt+V attaches clipboard images.

Starting in a project directory resumes its first manually ordered active session or creates one when none exists. /new creates another session for the current project, /new <path> opens another project, and /assistant opens the fixed Assistant. /quit closes the current project session while preserving history; /exit closes the TUI.

Use /sessions for complete history and /switch for the compact active-session selector. Alt+Left and Alt+Right cycle active project sessions. Empty-input Delete closes the selected project session.

Input and media

While the agent runs, Enter sends immediate steering and keeps a receipt visible until the current turn claims or discards it. Tab queues the next turn. Empty Up recalls the latest submission. With an empty editor, Esc restores the latest queued message before a later Esc can cancel the turn.

Drag across transcript text to copy it. Alt+V reads a clipboard image into the current session draft. PNG, JPEG, WebP, and GIF are supported; Windows uses PowerShell, macOS requires pngpaste, and Linux uses wl-paste or xclip.

Commands

The TUI owns /help, /model, /effort, /clear, /details, /theme, /rename, /fork, /status, /context, /agents, /jobs, /settings, /memory, /skill, /export, /sessions, /switch, /new, /assistant, /quit, and /exit. The selected dsh composition may register additional commands.

/skill opens a searchable bottom selector. /memory on|off persists memory state per session; the Assistant defaults on and project sessions default off. Enabled sessions share durable user facts through plugin-local save, search, correction, and deletion tools. The store has no fixed-count eviction; automatic recall remains bounded to keep model context finite.

Configuration

- id: tui
  name: '@lk251066/dsh-tui'
  config:
    sidebarWidth: 32
    assistantCwd: '/absolute/path/to/assistant'
    showReasoning: false
    maxToolOutputLines: 6

assistantCwd defaults to $DSH_HOME/assistant, or ~/.dsh/assistant when DSH_HOME is unset. It is recorded when the fixed Assistant is created; a persisted Assistant resumes with its recorded directory. sidebarWidth accepts values of 24 or greater. The sidebar hides below 65 inner columns, and a height of at least 24 rows is recommended.

The package also exports @lk251066/dsh-tui/prompt, @lk251066/dsh-tui/invariant, @lk251066/dsh-tui/memory, and @lk251066/dsh-tui/workspace-agent-loop for the bundled composition. Treat cordis.patch.yml as the supported entry path.

Development and support

See the repository development guide, verification guide, and issue tracker.

License

[MIT](./LICENSE). Based on the original TUI implementation from DeepSeek Harness.