nguyenduclong-ict/dsh-plugin-live-terminal

dsh-plugin-live-terminal

一个用于 DeepSeek Harness (DSH Desktop) 的实时直播终端输出插件。

默认情况下，DSH 会缓冲标准输出，仅在命令结束后才呈现完整的终端卡片。dsh-plugin-live-terminal 会在执行期间拦截 stdout 数据块，并将其实时直接流式传输到对话视图中一个可展开、原生风格的实时终端内。

功能特性

- 🟢 实时直播流：每 250ms 即可查看生成的 stdout 行，而无需等待命令完成。
- 🎨 100% 原生设计：与 DSH 官方的 --dsw- 设计令牌、字体层级和主题配色（Catppuccin、Dark、Light）无缝对齐。
- 📌 固定粘性头部：命令提示符头部保持固定，而输出内容可独立滚动。
- ⚡ 零外部依赖：轻量级 Cordis 客户端/服务端扩展，进程结束后自动进行生命周期清理。
- ⏹️ 停止，精准作用于正确的对象：在 job_output 卡片上，Stop 仅结束等待中的工具调用，并让后台任务继续运行；在 pwsh/bash 卡片上，它仍会终止任务或进程。
- 🖥️ 输出模态框：从 job_output 卡片，或通过点击 DSH 自带后台任务列表中的某一行，即可在模态框中打开该任务的输出，其中包含 View block（跳转到运行它的卡片——当转录尚未加载时，会分页拉取更早的历史记录）、Copy 和 Stop job。它通过任务 id 读取输出，因此即使生成它的卡片已不在转录中，它仍然可用。状态行复用了 DSH 自身的词汇——原生任务列表的状态圆点（killed 在其工具提示中显示为 cancelled）加上运行时长——并且一旦任务完成，Stop job 就会被禁用。

安装

适用于 DSH Desktop

Windows (PowerShell)

cd "$env:APPDATA\dsh-desktop\harness\profiles\web"
& "$env:APPDATA\dsh-desktop\harness\.desktop-bin\pnpm.cmd" add https://github.com/nguyenduclong-ict/dsh-plugin-live-terminal

macOS (Terminal)

cd "$HOME/Library/Application Support/dsh-desktop/harness/profiles/web"
"$HOME/Library/Application Support/dsh-desktop/harness/.desktop-bin/pnpm" add https://github.com/nguyenduclong-ict/dsh-plugin-live-terminal

Linux (Terminal)

cd "$HOME/.config/dsh-desktop/harness/profiles/web"
"$HOME/.config/dsh-desktop/harness/.desktop-bin/pnpm" add https://github.com/nguyenduclong-ict/dsh-plugin-live-terminal

安装后，请重启 DSH Desktop 以应用该插件。*

适用于 DSH CLI（所有平台）

如果你使用的是独立的 dsh CLI：

dsh plugin --profile web add https://github.com/nguyenduclong-ict/dsh-plugin-live-terminal

工作原理

1. 当 shell 命令（pwsh、bash）开始执行时，插件会检测到正在运行的块。
2. 点击工具调用行即可展开 Live Terminal View。
3. 从 ctx.subprocess 捕获 stdout 流，并实时送入活动终端控制台。
4. 进程结束后，实时查看器会优雅退出，并交由 DSH 原生的已结束终端卡片接管。
5. 以作业为中心的视图（job_output 卡片，或会话后台作业列表中的一行）会打开一个共享的输出模态框；它按作业 id 从宿主流式获取数据，因此即使生成该作业的卡片已离开对话记录，它仍能正常工作——这正是旧的“View Job”操作会返回 Job not found 的场景。

Tiếng Việt

Plugin hỗ trợ xem Live Stream Terminal Output theo thời gian thực cho DeepSeek Harness (DSH Desktop).

Tính năng nổi bật

- 🟢 Xem log trực tiếp: Không cần chờ lệnh kết thúc mới xem được kết quả, log xuất hiện ngay khi script in ra console.
- 🎨 Giao diện chuẩn gốc: Đồng bộ 100% với giao diện, màu sắc và theme của DSH Desktop.
- 📌 Cố định Header: Header chứa câu lệnh luôn được giữ cố định ở trên cùng khi cuộn xem log bên dưới.
- ⚡ Tự động dọn dẹp: Khi lệnh chạy xong, giao diện tự động trả lại khối hiển thị mặc định của DSH.
- ⏹️ Stop đúng phạm vi: Trên card job_output, nút Stop chỉ kết thúc tool call đang chờ, job nền vẫn tiếp tục chạy; trên card pwsh/bash thì vẫn kill job/tiến trình như cũ.
- 🖥️ Modal xem output: Từ card job_output, hoặc click vào một dòng trong danh sách background job của DSH, output của job mở trong modal kèm View block (nhảy tới card đang chạy job đó — tự nạp thêm history cũ nếu transcript chưa load tới), Copy và Stop job. Modal đọc output theo job id nên vẫn dùng được khi card khởi tạo job đã rời khỏi transcript. Hàng trạng thái dùng đúng ngôn ngữ của DSH — dot trạng thái y như danh sách job native (killed hiển thị là cancelled trong tooltip) — kèm thời gian chạy, và Stop job bị vô hiệu hoá khi job đã kết thúc.

Cách cài đặt trên DSH Desktop

Windows (PowerShell):
cd "$env:APPDATA\dsh-desktop\harness\profiles\web"
& "$env:APPDATA\dsh-desktop\harness\.desktop-bin\pnpm.cmd" add https://github.com/nguyenduclong-ict/dsh-plugin-live-terminal

macOS (Terminal):
cd "$HOME/Library/Application Support/dsh-desktop/harness/profiles/web"
"$HOME/Library/Application Support/dsh-desktop/harness/.desktop-bin/pnpm" add https://github.com/nguyenduclong-ict/dsh-plugin-live-terminal

Linux (Terminal):
cd "$HOME/.config/dsh-desktop/harness/profiles/web"
"$HOME/.config/dsh-desktop/harness/.desktop-bin/pnpm" add https://github.com/nguyenduclong-ict/dsh-plugin-live-terminal

Khởi động lại DSH Desktop sau khi cài đặt.

中文

适用于 DeepSeek Harness (DSH Desktop) 的实时终端流式输出查看插件。

功能特点

- 🟢 实时流式输出：命令运行时无需等待完成，实时查看标准输出（stdout）。
- 🎨 原生样式对齐：完全适配 DSH 官方 --dsw- 设计规范及主题（Catppuccin、暗色、亮色）。
- 📌 固定命令头：支持独立滚动日志，保持顶部命令提示栏固定。
- ⚡ 自动交接：命令执行完毕后自动切回官方默认结果展示卡片。
- ⏹️ 按上下文停止：在 job_output 卡片上，Stop 只结束正在等待的工具调用，后台任务继续运行；在 pwsh/bash 卡片上仍然终止任务或进程。
- 🖥️ 输出弹窗：从 job_output 卡片，或点击 DSH 后台任务列表中的一行，即可在弹窗中查看该任务的输出，并提供 View block（跳转到运行该任务的卡片，必要时自动加载更早的历史）、Copy 与 Stop job。弹窗按 job id 读取输出，因此即便发起任务的卡片已离开对话记录也仍然可用。状态行沿用 DSH 自身的表达方式 — 与后台任务列表一致的状态圆点（killed 在提示中显示为 cancelled）— 并附带运行时长；任务结束后 Stop job 会被禁用。

DSH Desktop 安装方法

Windows (PowerShell):
cd "$env:APPDATA\dsh-desktop\harness\profiles\web"
& "$env:APPDATA\dsh-desktop\harness\.desktop-bin\pnpm.cmd" add https://github.com/nguyenduclong-ict/dsh-plugin-live-terminal

macOS (Terminal):
cd "$HOME/Library/Application Support/dsh-desktop/harness/profiles/web"
"$HOME/Library/Application Support/dsh-desktop/harness/.desktop-bin/pnpm" add https://github.com/nguyenduclong-ict/dsh-plugin-live-terminal

Linux (Terminal):
cd "$HOME/.config/dsh-desktop/harness/profiles/web"
"$HOME/.config/dsh-desktop/harness/.desktop-bin/pnpm" add https://github.com/nguyenduclong-ict/dsh-plugin-live-terminal

安装完成后重启 DSH Desktop 即可。*

License

MIT © nguyenduclong-ict