๐ฅ Modern DeepSeek Harness Full-Stack Workbench ยท Remote SSH Geek Sidebar ยท Multi-Source MCP Debugging Hub ยท CoT Vision Engine ยท Geek Mascot Companion
็ฎไฝไธญๆ โข
English โข
What's New โข
Real UI Showcase โข
Features โข
Quick Start
---
## ๐ฅ๏ธ Real UI Showcase
โฒ DSH Studio Authentic Full-Stack Workbench UI: Multi-model chat, enhanced geek sidebar, mascot companion & real-time token probe
---
## ๐ What is Added over Upstream DeepSeek Harness (DSH)?
While upstream **DeepSeek Harness (DSH)** provides the low-level Agent runtime loop and CLI kernel, **DSH Studio** is the **full-stack industrial-grade enhanced workbench and micro-frontend ecosystem**:
| Dimension | Upstream DeepSeek Harness (DSH) | ๐ **DSH Studio (Real Features)** |
| :--- | :--- | :--- |
| **๐ Remote SSH & Terminal** | โ Basic local subprocess only, no persistent terminal, no remote SSH | โ
**Integrated Remote SSH Direct Connection & ConPTY / PTY Terminal**, multi-tab support & **8 Dedicated Agent Terminal Tools** |
| **๐งฐ IDE-Grade Workflow** | โ Chat-only conversation window, no file browsing or git diff | โ
**Industrial Enhanced Sidebar**: Explorer syntax-highlighted code preview & search, Git branch switching, visual commit log & Diff |
| **๐ MCP Discovery** | โ Manual single JSON file editing only | โ
**All-Source Auto Discovery** (`.vscode`, Cursor, Claude, Antigravity) + 10+ Curated Official Presets Carousel |
| **๐งช MCP Online Sandbox** | โ None, requires prompting LLM with token cost | โ
**Tool Tester Sandbox** (Schema form generation, 1-click test mock data, real RPC handshake & **0 Token Millisecond Latency Probe**) |
| **๐ง Visual CoT Reasoning** | โ Cannot stream multimodal `reasoning_content`, prone to blank screens | โ
**Native CoT Vision Engine** (Stream-captures Xiaomi MiMo deep thinking chains with foldable typewriter rendering) |
| **๐ฌ Mascot Companion** | โ None, idle waiting during long generation | โ
**Little Whale Maid 2.0** (3 HD skins + **650ms Speed CET-4 Blind Flashcards** + snack feeding CD system + retro mini-arcade) |
| **๐ฐ Cost Transparency** | โ ๏ธ Single-session rough estimation only, lost on refresh | โ
**All-Time Billing Ledger (Persistent)** + Real-time token bottom probe + Monthly dynamic budget progress bar |
| **๐งฉ Extensibility** | Static single-bundle composition | **Hot-pluggable Micro-frontend Plugins** + Drag-and-drop customizable sidebar card tabs |
---
## ๐ Core Features & Real Screenshots
### ๐งฐ 1. Industrial-Grade Enhanced Sidebar & Remote SSH Terminal (`dsh-better-sidebar`)
An all-in-one developer productivity suite for full-stack engineering and operations:
โฒ Authentic Screenshot: Multi-function enhanced sidebar tabs, task boards, and workflow cards
* **๐ Remote SSH Sessions & Embedded Persistent PTY Terminal**:
- Multi-tab terminal management (Local Bash / PowerShell / WSL / **Direct Remote SSH Host Sessions**);
- Auto-reconnect and immersive full-screen terminal mode;
- **8 Built-in Agent Terminal Tools**:
`terminal_create`, `terminal_send`, `terminal_read`, `terminal_wait_for`, `terminal_resize`, `terminal_signal`, `terminal_close`, `terminal_list`,
empowering autonomous AI agents to operate local and remote servers effortlessly.
* **๐ Explorer & Code Syntax Preview**:
- Tree-structured workspace file navigation and fast search;
- Real-time syntax-highlighted code previews (Rust, Go, Python, TypeScript, C++, SQL, YAML, JSON and 15+ languages).
* **๐ฟ Source Control (Git) & Visual Commit Log**:
- Branch switching and working directory state tracking;
- Visual commit history inspection and file Diff highlighting with one-click revert.
---
### ๐ 2. MCP Multi-Source Management & Online RPC Testing Sandbox (`dsh-better-sidebar-mcp`)
Click "MCP Management" in the sidebar to access full-suite configuration sniffing, 10+ official presets carousel, and the isolated **Tool Tester Online Sandbox**:
โฒ Authentic Screenshot: Multi-source MCP & plugins visual management hub with live toggles
* **Multi-Source Auto-Aggregation**: Automatically scans and detects workspace configs (`./mcp.json`, `.vscode/mcp.json`, `.cursor/mcp.json`, `.agents/mcp_config.json`) and global environments (Claude Desktop, Cursor, Antigravity/Gemini, `~/.dsh/mcp.json`).
* **Single Tool Online Testing Sandbox (Tool Tester Modal)**: Renders dynamic parameter forms from JSON Schema, populates default mock data with one click, **executes real JSON-RPC handshakes**, and displays millisecond latency and structured returns **with zero LLM token cost**.
* **10+ Curated Official Presets Carousel**: Built-in GitHub, SQLite, Web Fetch, Brave Search, Puppeteer, PostgreSQL, Memory, Filesystem, Everything, Git presets with horizontal scroll and quick switches.
* **Bulk JSON Import & Live Toggles**: Paste raw `mcpServers` JSON snippets for instant parsing and toggle servers on/off non-destructively.
---
### ๐ง 3. CoT Visual Reasoning Stream Penetration Engine (`dsh-tool-describe-image`)
Engineered for multimodal vision models with deep thinking, unlocking loss-free reasoning chain streaming and network benchmarking:
* **Chain of Thought (CoT) Compatibility**: Tailored for models with deep reasoning (e.g., Xiaomi MiMo). Even when initial stream `content` is empty, it parses `reasoning_content` without latency or timeout.
* **Graphical Connectivity Probing**: Measure endpoint round-trip times and automatically probe and list provider models.
---
### ๐ฌ 4. Little Whale Maid 2.0 Geek Mascot & Companion (`dsh-mascot-pet`)
An interactive desktop companion docked to your workspace, fusing flashcard study, geek memes, snack feeding, and global billing ledgers:
โฒ Authentic Screenshot: Left shows docked mascot chat bubbles; Right shows mascot action dashboard & feeding center
#### ๐ 3 High-Definition Seamless Skins

Classic Maid Outfit
Gentle & Healing Companion
|

Cyber Geek Mecha
Neon & Hardcore Futuristic
|

Summer Sailor Swimsuit
Refreshing & Energetic Vibes
|
* **CET-4 Vocabulary Speed Rush**:
- Single-screen zero-scroll layout to maximize code generation downtime.
- **650ms Auto-Advance on correct answers** with **A / B / C / D full keyboard blind-typing** and combo streaks.
* **Snack Feeding CD System & Hunger Empathy**:
- 4 distinct snacks (Iced Cola, Hot Coffee, Donut, Energy Bar) with dynamic cooldowns (30s ~ 120s).
- Affection score discounts + natural fullness decay (1 point every 2 minutes).
- Fullness under 25% triggers hunger state and reminder dialogue bubbles.
* **All-Time Ledger & Real-Time Token Probes**:
- Persistent `dsh_billing_ledger_v2` tracking cumulative usage across sessions.
- Dual view displaying **Current Session Cost**, **All-Time Historical Total**, and **Monthly Budget Progress**.
#### ๐ฎ Geek Decompression Arcade

Geek Math ยท 2048
|

Retro Arcade ยท Breakout
|

Color Match ยท Bubble Shooter
|
---
## ๐๏ธ System Architecture
```
dsh-studio/
โโโ packages/
โ โโโ core/ # DSH Agent Loop state machine and session runtime
โ โโโ llm/ # Multimodal LLM providers (DeepSeek / MiMo / OpenAI)
โ โโโ typert/ # Type graph generator & RPC runtime registry
โ โโโ host/ # WebServer & micro-frontend host
โโโ plugins/ # ๐ Hot-pluggable micro-frontend plugins
โ โโโ dsh-better-sidebar/ # Industrial sidebar (SSH, ConPTY terminal, Explorer, Git)
โ โโโ dsh-better-sidebar-mcp/ # MCP multi-source scanner & RPC tester sandbox
โ โโโ dsh-mascot-pet/ # Mascot 2.0, speed flashcards & all-time ledger
โ โโโ dsh-tool-describe-image/# CoT visual reasoning stream adapter
โโโ assets/readme/ # ๐ธ Authentic screenshots and vector diagrams
โโโ docs/ # Architecture specs, PRDs, and automated test reports
```
---
## ๐ Quick Start
### Option 1: Standalone Workbench (Recommended)
Requires Node.js >= 22 and pnpm:
```bash
# 1. Clone this repository
git clone https://github.com/jiuge2467/dsh-studio.git
cd dsh-studio
# 2. Install dependencies and build
pnpm install
pnpm run build
# 3. Start Web Workbench (listens on 0.0.0.0:3080)
pnpm dsh web --host 0.0.0.0
```
Open `http://127.0.0.1:3080` in your browser to start exploring!
---
### Option 2: Add Plugins to Existing DSH Environment
```bash
# 1. Install Industrial Enhanced Sidebar (SSH & Terminal)
cd ~/.dsh && dsh plugin --profile web add dsh-better-sidebar
# 2. Install MCP Manager & Testing Sandbox
cd ~/.dsh && dsh plugin --profile web add dsh-better-sidebar-mcp
# 3. Install Little Whale Maid Mascot Companion
cd ~/.dsh && dsh plugin --profile web add dsh-mascot-pet
```
---
## ๐งช Automated Testing & Quality Gates
```bash
# Run full unit test suite
pnpm test
# Run mascot & billing ledger tests
pnpm --filter @deepseek-ai/dsh-mascot-pet test
# Run MCP manager unit tests
pnpm --filter dsh-better-sidebar-mcp test
```
> **Quality Metrics**:
> - Unit Test Pass Rate: **19/19 PASS (100%)**
> - TypeScript Strict Mode: **`strict: true` (0 compilation errors)**
---
## ๐ License
This project is licensed under the [MIT License](LICENSE).