DeepSeek Harness Plugin

zhu1090093659/dsh-web#packages/dsh-git-graph

Stars ★ 10504 Downloads (30d) 92,048 Category Git & Code Review Added 2026-09-24 npm @linxin666/dsh-client-ui-git-graph

Git branch selector and Git graph for the dsh web GUI: switch branches and explore branch-lane and commit history from the conversation header.

Install

# from npm (prebuilt)

dsh plugin --profile web add @linxin666/dsh-client-ui-git-graph

# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)

dsh plugin --profile web add github:zhu1090093659/dsh-web#path:/packages/dsh-git-graph

Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).

README

中文 | English

dsh-web is an all-in-one modular plugin ecosystem and AI agent workbench for DeepSeek Harness (DSH) Web GUI, DeepSeek Web UI, and the official DeepSeek Desktop client (covering 21 in-repository family packages and 4 satellite packages, 25 public @linxin666/dsh-* npm modules in total). Built for frontier reasoning and coding models including the DeepSeek V4.1 series and multi-provider ecosystems, it equips developers and power users with autonomous task automation boards (autonomous parent subtask dispatch and cron background scheduling), LiangShen Mode (minimal persona, PTC programmatic tool transport, and zero-cache-invalidation on-demand paging), Agent Squads (reusable member rosters and whole-squad Agent Teams runs), Live Browser View (right-docked CDP screencast and web automation), mobile phone app remote access, web-based SSH terminal operations and Linux cluster management, full session search and archive management, token usage and API cost monitoring (including Token Bank), and a unified workshop for themes, skins, and desktop pets (dsh-market.com). Users can install the complete plugin bundle into an existing dsh web instance via the official profile mechanism, or install and run it directly in the official DeepSeek Harness desktop client.

What It Is · Official Desktop Client · Workshop · Feature Plugins · Skins · Quick Start · Compatibility · FAQ · Known Limitations · Community · Business Cooperation

What It Is

Stock DeepSeek Harness Web delivers fundamental chat interactions and tool execution capabilities. However, production workflows often require concurrent task scheduling, persistent background runs, remote collaboration, and developer-oriented tooling.

dsh-web mounts directly into dsh web via official profiles without modifying DSH core source code, providing a comprehensive modular extension suite:

  • Developer Operations & Collaboration Plugins: Long-running autonomous task boards (autonomous parent subtask dispatch and scheduled execution), LiangShen Mode (minimal persona, PTC programmatic tool transport, and agile dispatcher discipline), Agent Squads (reusable member rosters and whole-squad Agent Teams collaboration), Live Browser View (right-docked CDP screencast and 11 browser tools), mobile phone app remote access, SSH terminal and cluster operations, full session archive management, and message branch editing;
  • Decoupled Visual Themes & Assets: Functional plugins and visual assets remain strictly separated. The skin loader handles stylesheet and dynamic effect rendering, while themes and animated desktop pets can be installed on demand from the DSH Workshop;
  • Bundled or Pick-and-Choose: Install everything with one command via @linxin666/dsh-web-all, or install individual plugins independently. The aggregate pre-integrates every family plugin - see the plugin bundle installation and configuration guide.

DeepSeek Harness Web GUI workspace powered by dsh-web modular plugin ecosystem (Task Board, LiangShen Mode, Agent Squads, and Themes)

Core Capability Stock dsh web dsh-web Modular Ecosystem Advantage
Agent Presets & Disciplines Stock presets only (Standard / Minimal, etc.), heavy context overhead Stock presets + Workshop presets + LiangShen Mode (minimal persona, PTC program transport, on-demand tool-family paging, fact register, composer slot lever)
Agent Squads & Team Orchestration Ephemeral single-session subagent calls only Reusable squad and member definitions (preset/permission/model/effort/system-prompt brief) + whole-squad Agent Teams runs with live state projection + 10 squads_* / squad_member_* model tools
Live Browser View & Web Automation No visual agent-driven browser viewport Right-docked CDP live screencast tab + isolated Chromium by default or real signed-in browser attach + 11 browser_* interaction and lossless region-screenshot tools
Autonomous Task Board None Host-authoritative Schema v7 5-column board + subtask trees with autonomous parent dispatch + multimodal card attachments + offline cron/one-shot scheduling & sleep inhibition + GitHub / Team Hub / mobile remote extensions + 8 model-callable tools
Mobile Phone App Remote Access Localhost browser only Instant QR pairing for native phone apps, protocol v1 WebSocket streaming, public relay/tunnels & LAN ingress
Remote Server Operations None Web-based SSH terminal (xterm.js), SFTP file transfer, tunnels & cluster commands
Token Usage & Cost Monitor None Daily token consumption breakdowns, multi-provider balance tracking, plan quota reset monitoring & Token Bank
Session Search & Archive Lifecycle Flat list accumulation Full-text session search with multi-filter queries, batch archiving, cascade pruning & automated retention policies
Themes, Skins & Visuals Single default theme Built-in Blue Fantasy immersive dark eye-care theme, plus Wallpaper Engine live backgrounds & desktop pets on Workshop

Quick Index by Use Case

User Goal & Scenario Recommended Solution & Capability Entry Point
Build 24/7 autonomous background AI engineering pipelines, scheduled code audits, subtask trees with autonomous parent dispatch, or automatic GitHub issue-to-PR resolution Task Board: host background scheduling, subtask trees & autonomous parent dispatch, GitHub / Team Hub / mobile remote extensions, and sleep inhibition Task board and cron execution
Maximize coding efficiency and minimize context waste with compact prompts, programmatic tool calling (PTC), and strict dispatcher discipline LiangShen Mode: Minimal persona, run_code program transport, on-demand tool-family paging, fact register, and composer lever LiangShen Mode Preset & PTC
Assemble reusable specialist AI members and agent squads to launch individual member sessions or whole-squad Agent Teams runs Agent Squads: reusable member definitions (preset/permission/model/effort/brief), whole-squad runs with live state projection, and 10 model tools Agent Squads & Team Runs
Watch an agent-driven Chromium live beside the chat to run web UI tests, inspect DOM snapshots, or attach to a signed-in browser Live Browser View: right-docked CDP screencast, isolated Chromium or real-browser attach, and 11 interaction & lossless region-screenshot tools Live Browser View & CDP Control
Remote access and control of DeepSeek Harness from mobile phone apps via protocol v1 Mobile App Remote Access: protocol v1 WebSocket, session streaming, ingress gateway & WAN/LAN ingress Mobile App Remote Access
Delegate Linux server DevOps, SFTP file transfers, SSH terminal interactions, or incident response to AI agents SSH Remote Ops: web terminal (xterm.js), visual SFTP transfers, port forwarding tunnels, cluster commands SSH terminal, file transfer, and tunnels
Monitor DeepSeek API and LLM token usage metrics, query provider account balances, and track subscription quotas Usage Statistics: daily token breakdown, balance queries, bill estimation & Token Bank Usage statistics and Token Bank
Accumulated chat history is hard to search, requiring full-text multi-filter queries, batch archiving, and lifecycle pruning Session Archive Manager: multi-filter search, batch archiving, cascade pruning & automated lifecycle policies Full session archive management
Customize interface aesthetics with dark eye-care themes, Wallpaper Engine live backgrounds, and desktop pets Workshop & Skin Center: built-in Blue Fantasy dark theme, plus vast skins, live wallpapers & pets Explore the DSH Workshop
Use the complete plugin and theme ecosystem directly inside the official DeepSeek Harness Desktop client Official Desktop Client: install the full aggregate bundle directly via in-app plugin manager Official desktop client guide
Install the all-in-one plugin bundle into an existing DeepSeek Harness CLI or Web GUI environment with one command Quick Start: one-command installation via npm or direct GitHub repository URL Quick start installation

Official Desktop Client

For a dedicated desktop application experience, we recommend downloading and using the official DeepSeek Harness desktop client (DeepSeek Harness Desktop).

The official desktop client shares the ~/.dsh data directory with dsh web and operates under its internal desktop profile. Because the official desktop client manages the desktop profile exclusively within the application (external CLI commands reject modifications to the desktop profile), install this plugin bundle directly from inside the desktop client:

  1. Open the official desktop client and navigate to the Plugins section in Settings (or the sidebar plugins view);
  2. In the plugin installation input field, enter the aggregate package specifier @linxin666/dsh-web-all (or @linxin666/dsh-web-all@latest), then click Install;
  3. Restart the desktop client once installation completes to activate all family plugins, including the task board, themes, and remote access.

Workshop (dsh-market.com)

The DSH Workshop is a unified hub for themes, pets, plugins, and community Agent presets, currently hosting 66 skins (including Wallpaper Engine live backgrounds), 12 interactive desktop pets, 139 community plugin entries, and 33 community Agent presets. Entries are ranked by verified device likes; themes provide live interactive previews, and plugins offer copy-ready install commands. The classic Blue Fantasy theme is bundled with the skin center plugin; additional themes and pets can be previewed, inspected, and installed on demand. In the Web GUI, the "Workshop" settings tab lets you browse the catalog directly: skins and pets install straight into the DSH home directory for immediate use, while community presets install to an inactive local library and activate under "Settings → Agent Presets".

DeepSeek Harness Workshop (dsh-market.com) — Themes, skins, desktop pets, and plugin marketplace

The site is built directly from this repository: static pages are generated by scripts/market-build from authoritative manifests (skin.json, pet.json, community.json, and presets/), while interactive features like anonymous voting run on Cloudflare Workers edge functions with D1 persistence (one vote per device, protected by Turnstile). Changes deploy automatically when market-related paths land on dev.

The Workshop provides an open, transparent space for community creators to share their work and for users to discover vetted extensions.

Feature Plugins

Task Board (Enterprise Autonomous Execution Engine & Multi-Agent Pipelines)

Open from the "Task Board" icon in the sidebar (see dsh-task-board README). More than a visual card interface, the Task Board is the host-authoritative background autonomous execution and multi-agent scheduling engine for the DeepSeek Harness official Web GUI and desktop client. Tasks are tracked through a 5-column lifecycle (Backlog, Todo, In Progress, Done, Failed) with project scoping, AI paste parsing, and multimodal card attachments (up to 8 image or file attachments per card, verified by SHA256 against the official attachment store; images queue as multimodal prompt parts and files inject as read-only host paths), backed by an atomic Schema v7 transaction ledger that delivers end-to-end automation from requirement decomposition and autonomous parent dispatch to external deliverables:

  • Host-Authoritative Execution & 24/7 Offline Automation: Unlike fragile client-side boards that break when browser tabs close, all card transitions, scheduled triggers, and execution tracking run under the DSH Host background daemon as the single source of truth. Supports both recurring 5-field cron expressions (bound to an IANA time zone with an optional maxRuns execution cap) and one-shot (once) future schedules; the browser is purely an asynchronous viewport, so closing tabs, locking screens, or dropping connections does not interrupt autonomous agent execution or atomic disk settlement. Built-in cross-platform sleep inhibition (macOS caffeinate, Windows ES_SYSTEM_REQUIRED, Linux systemd-inhibit) powers down screens while preventing host idle sleep for reliable 24/7 background operation.
  • Subtask Trees & Autonomous Parent Dispatch: Complex engineering goals decompose into 1–3 levels of hierarchical subtasks (with built-in cycle and depth guards). Running any card opens only one session for that card itself—the Host never spawns separate sessions per subtask. When a card has unfinished descendants, the Host automatically runs that execution under the liangshen (LiangShen Mode) dispatcher preset and injects the unfinished subtask roster into the launch prompt: the parent session reads each subtask via task_board_get, dispatches them via subagent in dependency order (parallelizing independent subtasks), and backfills each subtask's verdict via task_board_manage({ action: 'record-external-outcome' }) before finishing (with idempotent Host fallback settlement for any remaining descendants). When multiple cards trigger simultaneously, a rate-governed admission queue (runLaunchWidth, 1–16, default 3) controls concurrent session creation.
  • GitHub Issues, Cloud Team Hub & Mobile Remote Extensions: Connects seamlessly to three companion extensions over the provider contract: dsh-client-ui-task-board-github synchronizes GitHub repository Issues and Pull Requests bidirectionally, ingesting remote issues for agents to diagnose, patch, test, open linked PRs, and auto-close issues upon merge; dsh-client-ui-task-board-team binds local dsh-agents members to cloud team-hub issues with lease-backed claiming, decision question routing, bidirectional comments (team_comment), and review rework; dsh-task-board-remote mounts the board.v1 surface onto the remote bridge extension seam so paired phones read and write the exact same host ledger.
  • Context Continuity: Session Reuse & Freeze Handover: Tasks can enable session reuse to preserve active conversation context across recurring runs. Sessions can also freeze via the <<<FREEZE protocol into structured snapshots (goals, progress, next steps) with pinned workspace/preset/permission triplets, letting incoming agents seamlessly take over with built-in prompt injection defense and provenance audits.
  • Enterprise Permission Gates & Token Spend Limits: Cards pin workspaces, agent presets, sandbox permissions, models, and reasoning tiers (failing closed on invalid bindings). High-risk permissions above the session baseline require manual approval via the Permission Gate in the Web UI before execution or cron scheduling is permitted. Configurable daily token spend limits (spendBudgetTokens) safeguard against runaway loops and unexpected API costs.
  • Model-Callable Agent Tool Surface & External Sync: Exposes 8 native model tools (task_board_list, task_board_get, task_board_create, task_board_update, task_board_set_parent, task_board_run, task_board_manage, task_board_schedule), empowering conversation agents to inspect boards, split subtasks, orchestrate pipelines, and arm schedules autonomously. External work completed in tools like Claude Code or Codex can also register authoritative outcomes via record-external-outcome.
Multi-Column Board & Agent Collaboration Background Scheduling & Configuration
DeepSeek Harness Task Board — AI agent multi-column task scheduling and lifecycle DeepSeek Task Details & Scheduled Execution — Agent configuration, cron scheduling, and run history

LiangShen Mode (Minimal Persona, PTC Runtime & Dispatcher Engine)

Toggle via the dedicated slot-machine lever in the composer on new-session screens, or select from "Settings > Agent Presets". LiangShen Mode (dsh-liangshen) is a killer preset and runtime engine rebuilt specifically for maximum reasoning efficiency, minimal static context overhead, and rigorous engineering discipline. Addressing common LLM pitfalls in complex programming — such as bloated system instructions, tool schemas flooding context windows, verbose rambling reasoning loops ("I need to..."), and degradation across long conversations — LiangShen Mode combines an action-driven minimal prompt, Programmatic Tool Calling (PTC), on-demand tool-family paging, and working-context fact registers to deliver an exceptionally sharp coding experience:

  • Minimal Persona & Action-Driven Working Discipline (Zero Prompt Waste): Strips away standard boilerplate instructions, condensing system prompts to a single-line persona and combat-tested engineering disciplines. Enforces reflection circuit-breaking (abort speculation after two reasoning passes without new evidence and immediately inspect via native tools), action orientation (thinking decides the immediate next operation rather than pre-rehearsing code), parallel exploration (dispatch multiple independent tool checks concurrently in one turn), YAGNI and PDCA cycles (validate single assumptions with zero redundant comments), and bounded convergence (converge within 2–3 inspection turns to answer or edit). This keeps the model's full attention focused strictly on your codebase.
  • Programmatic Tool Calling (PTC Transport): Replaces the heavyweight practice of serializing hundreds of JSON schemas on every API turn. By default, the wire collapses to a single run_code execution endpoint; all remaining tools are accessed programmatically via generated strongly typed SDKs running inside an isolated worker sandbox. The static transmission footprint remains microscopic regardless of tool count; models can dispatch concurrent calls via Promise.all and filter, slice, or aggregate large tool outputs inside the sandbox before returning concise summaries to context. For scenarios better suited to direct invocation, a one-click toggle restores the assembled Native tool roster in plugin settings.
  • On-Demand Tool-Family Paging & Zero-Invalidation Deferred Reclaim (Gentle Tool Paging): Prevents connected MCP servers and high-fan-out plugin families from overwhelming the context window. Matched tool families (defaulting to ['mcp__*', 'browser_*', 'task_board_*', 'team_*', 'squad*', 'ui_*', 'ssh_*'] while all host builtins stay resident, customizable via "On-demand tool families" in plugin settings) remain paged out of the wire and SDK declarations on startup, presented only as compact namespace summaries. When the model needs a family, it autonomously invokes tool_activate({ namespace }) to mount that namespace on the fly. An LRU cache maintains up to 3 active namespaces simultaneously (refreshing recency on activation or tool call), and optional idleReclaimSteps (default 0, disabled) defers evicting idle namespaces strictly to activation touches or compaction/end boundaries so prompt prefix caches never invalidate mid-conversation, rebuilding state across compactions and resumes.
  • Key Fact Register & Near-Horizon Context Projection (Fact Register): Prevents long-horizon context forgetting where models lose track of initial constraints or previously diagnosed failures. The preset exposes a dedicated fact_register tool, allowing models to record immutable requirements, confirmed architectural choices, and disproven paths as concise single-line facts (up to 160 characters each, capped at 12 entries). Recorded facts ride the [Working Context: ...] line projected directly above the latest user turn, ensuring persistent visibility within the local attention window.
  • Native Dispatcher Architecture & Triage Discipline (Dispatcher Identity): Ships with a built-in Dispatcher ruleset, enabling the agent to orchestrate complex engineering workflows like a technical lead. Features structured complexity triage (L0/L1 tasks execute directly; L2 multi-step initiatives require clarification interviews -> planning -> parallel subagent delegation -> two-tier acceptance verification); bounds interviews to a strict budget (maximum 4 questions per round, 3 rounds total, ordered by blast radius with assumption defaults); and maintains project state reliably within todo_write.
  • Composer Slot Lever & Jackpot Particle Effects (Interactive Lever): Integrates an interactive vintage slot-machine lever directly beside the model selector in the chat composer on new sessions. Pulling the lever down (via dragging, clicking, or keyboard trigger) arms LiangShen Mode with celebratory jackpot visual effects (particle burst, shockwave rings, sparks, and an Easter-egg banner); pushing it up seamlessly restores your previous default preset. The lever adapts dynamically to active skin themes and gracefully steps aside once a conversation begins.

For detailed architecture, benchmark evaluations, and configuration options, see the dsh-liangshen README.

Agent Squads (Reusable Member Roster & Whole-Squad Runs)

Open from the "Agents" entry in the sidebar. Agent Squads (dsh-agents) turns reusable specialist AI roles and team rosters into a host-authoritative ledger: each squad organizes an ordered list of members that can be launched individually on demand or mobilized together as a whole-squad Agent Teams run:

  • Reusable Squad & Member Definitions: Squads configure a name, description, optional pinned workspace, and Lead preset; each member independently pins a display name, Agent preset (such as LiangShen Mode or research squad presets), sandbox permission, model route, reasoning effort tier, and member brief. The member brief joins only that member session's system prompt, never polluting the first user message or ordinary chat sessions.
  • Whole-Squad Agent Teams Runs & Live Projection: Launch an entire squad in one action—the squad roster and goal reach the <squad name> / Lead session through the team:squad system-prompt context, and the Lead spawns dedicated teammates from each member's pinned preset, permission, and model route (failing closed on any unresolvable pin). The UI subscribes directly to the agentTeam session projection (stateVersion 4) in the shared session store to render Lead and teammate roles, phases, and startup errors in real time without polling.
  • 10 Model-Facing Management & Launch Tools: Registers squads_list, squads_read, squads_create, squads_update, squads_delete, squad_member_add, squad_member_update, squad_member_remove, squads_run_member, and squads_run_squad across all host sessions, enabling agents to assemble squads, launch individual member sessions, or start whole-squad runs in process (with confirm: true required on destructive operations).
  • Atomic Ledger Persistence & Runtime Coexistence: Definitions and the newest 200 run records persist at $DSH_HOME/dsh-agents/ledger.json via fsynced temp files plus atomic rename under ledger.json.lock (corrupt ledgers are preserved byte-identical without overwriting); when the host already serves an official agentTeams runtime, the package yields its internal team runtime and reuses the official projection.

For full contracts, tool specifications, and security boundaries, see the dsh-agents README.

Live Browser View (Right-Docked CDP Screencast & Web Automation)

Open from the right-sidebar tab strip or the guide capsule inside a conversation. Live Browser View (dsh-browser-view) gives the agent a host-driven Chromium browser watched live from a right-docked tab beside the chat, closing the loop on frontend verification, visual QA, and interactive web automation:

  • Right-Docked CDP Screencast & Keep-Mounted View: Registers a dedicated browser-view right-sidebar tab type (coexisting cleanly alongside the stock browser tab), streaming CDP Page.startScreencast frames, active URL, title, and the agent's latest action summary over a single WebSocket; switching tab chips keeps the view mounted without dropping the socket, streaming frames only when the page changes.
  • Isolated Chromium by Default & Real Browser Attach: Launches a headless Chromium with a throwaway profile directory and random debugging port by default (pinned 1280x800 viewport, automatically minting a memory-only launch ticket when navigating to this host's own DSH Web GUI challenge); enabling realBrowserEnabled attaches over loopback CDP (default http://127.0.0.1:9222) to a Chrome or Edge instance started with a non-default --user-data-dir, operating directly with existing sign-ins without copying or exporting cookies.
  • 11 Agent Browser Tools: Provides browser_navigate, browser_click, browser_type, browser_press, browser_scroll, browser_snapshot, browser_screenshot, browser_console, browser_network, browser_tabs, and browser_close; browser_snapshot returns a depth-first numbered (ref) DOM tree with bounding boxes for deterministic clicking and typing, backed by per-tab console and network ring buffers.
  • Lossless Region Screenshots & Transcript Evidence: browser_screenshot captures lossless PNGs by default and attaches them directly to the conversation transcript via the host attachment service; passing clip: { x, y, width, height } in the same coordinate space as browser_snapshot renders a targeted region at 2x scale by default (1x/2x/3x supported) for crisp visual token inspection, failing loudly on out-of-bounds clips or connection errors rather than silently degrading.

For configuration details, real-browser launch flags, and security model, see the dsh-browser-view README.

Mobile Phone App Remote Access (Native Phone App Access)

After installing @linxin666/dsh-remote-bridge in your profile and restarting the server, click the QR code icon at the bottom of the sidebar (accessible label "Pair an iPhone") to open the pairing panel. Scan the QR code with the mobile phone app to start using it immediately.

The pairing panel is protected by a loopback security gate on /remote-bridge/pair/token and can only be accessed from a browser running on localhost (remote access returns 403). Pairing codes are single-use credentials valid for 30 seconds; clicking "New code" voids the previous code. The QR code encodes a document containing the address and token (URL format wss://<origin>/ios/v1?token=...), allowing the mobile app to acquire both the host address and authentication token in one scan.

The network protocol surface exposes only one WebSocket endpoint at /ios/v1. Both tunnels and the LAN forwarder route exclusively to an ingress gate that forwards this path, keeping Web GUI routes inaccessible from the public internet. Host dial addresses resolve in order from live runtime state (relay lease or running tunnel), to the DSH_REMOTE_PUBLIC_BASE_URL environment variable, to the active LAN forwarding address when listening. By default, public access is available out of the box (relay is enabled by default, tunnels are off, and LAN forwarding is off); for direct local network access, enable LAN forwarding in the plugin settings.

The iOS app is in beta. Come talk to us on Discord.

SSH Remote Ops (Web Terminal, SFTP Transfer & Cluster Commands)

Open the remote operations panel from the "SSH" sidebar icon (see dsh-ssh README). Supports key-based and password authentication, and imports existing host definitions from ~/.ssh/config with one click; configurations persist securely in ~/.dsh/dsh-ssh.json. Available capabilities include:

  • Web Terminal: Full-featured interactive terminal powered by xterm.js with real-time output and responsive window resizing;
  • File Transfer: Built-in SFTP file manager with visual upload and download progress bars and directory browsing;
  • Port Forwarding: Local tunnels routing to remote internal services (such as databases or internal APIs), binding exclusively to 127.0.0.1;
  • Cluster Execution: Concurrently dispatch commands across multiple servers filtered by alias, environment, or tags;
  • Agent Integration: AI agents share host configurations with the panel; simply instruct the agent in chat to inspect remote servers and run diagnostics.

Usage Statistics (Token Metrics, Balance Monitoring & Token Bank)

Monitor token consumption, provider balances, and subscription quotas under "Settings > Usage Statistics" with automated refresh and manual query options.

  • Usage Breakdown: Track daily input, output, and cache token metrics segmented by provider and model, alongside 30-day expenditure trends; compatible providers display real-time balances, and DeepSeek official routes estimate off-peak pricing and billing details.
  • Subscription Tracking: Monitor percentage allowances and reset schedules for personal plans including Kimi, GLM, MiniMax, OpenCode Go, and Codex / ChatGPT.
  • Token Bank: Mint 1 Whale Yuan for every 1,000,000 tokens across every provider, tracked as collectible Whale Vouchers with sharing capabilities.
  • Pet Integration: With the desktop pet plugin installed, floating desktop companions provide conversational bubble notifications displaying current quota balances and daily consumption.

Tracking starts upon initial plugin activation without backfilling historical sessions; vouchers cover every provider's tokens within configured ledger retention windows (the spend line still comes only from the observed DeepSeek official balance). See dsh-usage README for supported providers and limitations.

DeepSeek Token Usage Tracker & Token Bank — API expenditure tracking and bill estimation

Session Archive Manager (Full-Text Search, Batch Archiving & Lifecycle)

The session archive manager (dsh-session-archive) provides centralized governance over growing numbers of short-lived and persistent conversation logs:

  • Centralized Search & Filtering: Audit active, archived, blank, subagent, and orphaned historical sessions with keyword filtering across titles, workspaces, and session IDs.
  • Batch Actions with Cascade Safety: Perform multi-select archiving, restoration, and permanent deletions. Physical deletions display affected descendant counts and estimated reclaimed disk space, requiring confirmation prompts for bulk actions; active sessions and sessions with running children remain protected against deletion.
  • Automated Retention Policies: Two optional automated rules archive stale sessions based on last activity and prune aged archives by retention period, with dry-run previews supported before enabling.

Permanent deletions cannot be undone, and all operational routes bind strictly to the local loopback interface. See dsh-session-archive README.

More Plugins

  • Mermaid Diagram Rendering (@linxin666/dsh-client-ui-diagrams): Renders fenced mermaid code blocks in place as SVG diagrams across chat transcripts and document previews, automatically redrawing on theme switches with two-stage SVG sanitization.
  • Windows Persistent Bash (@linxin666/dsh-win-bash): Provides Windows x64 sessions with a SHA256-verified and integrity-checked vendored MinGit persistent win_bash process per session, preserving working directories and environment variables across calls while stripping terminal escape sequences.
  • Task Board GitHub Sync (@linxin666/dsh-client-ui-task-board-github): Connects GitHub Issues and Pull Requests bidirectionally with task board cards, driving autonomous AI agent bug triage and automated PR delivery.
  • Task Board Team Collaboration (@linxin666/dsh-client-ui-task-board-team): Binds local dsh-agents members to cloud team-hub issues with lease-backed claiming, question routing, team_comment threads, and review rework.
  • Task Board Remote Surface (@linxin666/dsh-task-board-remote): Mounts the task board capability surface (board.v1) onto the dsh-remote-bridge extension seam so paired phones read and write the same host ledger.
  • Skill Explorer (@linxin666/dsh-client-ui-skill-explorer): Inspect and manage loaded agent skills grouped by origin, featuring keyword filtering across names and descriptions, workspace scoping, creation, and activation toggling.
  • Plugin Manager (Updates & Toggles) (@linxin666/dsh-client-ui-plugin-manager): Extends the official Plugins page with registry update checking, DSH runtime minimum version gating, one-click upgrades, keyword search and pagination (20 items/page) across built-in plugins, and visual toggle switches.
  • Workshop Client & Preferences Panel: Includes the Workshop Client (@linxin666/dsh-client-ui-market, browsing and installing skins, pets, plugins, and presets in the GUI) and the Preferences Panel (@linxin666/dsh-client-ui-web-ui-settings, hosting family plugin switches and configuration forms).
  • Session ID Helper (@linxin666/dsh-client-ui-session-id): Quick sidebar-footer access to copy full session IDs and search across sessions with zero host overhead.
  • Russian Language Pack (@linxin666/dsh-i18n): Centrally carries Russian (ru) localization dictionaries for all family plugin namespaces.

Skins

The classic Blue Fantasy theme serves as the built-in default skin: rich indigo gradients, semi-transparent frosted glass elements, and custom whale artwork provide an immersive dark-mode visual experience. Additional themes and Wallpaper Engine animated backgrounds are managed by the skin center and can be previewed, tried on, and installed through the Workshop.

DeepSeek Harness Theme Skin — Blue Fantasy dark immersive theme preview

Quick Start

System Requirements

  • DeepSeek Harness installed with dsh web functioning properly.
  • npm installations have no extra requirements; building from the source repository requires Node.js >= 24.9 and pnpm.

Get Started in 3 Steps (npm, Recommended)

  • DSH Web CLI (Browser Installation):
    1. Approve the three build scripts first (see Install Troubleshooting), then run dsh plugin --profile web add @linxin666/dsh-web-all@latest
    2. Restart dsh web to display new plugin icons in the sidebar
    3. Navigate to "Settings > Plugin Configuration" to toggle individual features, or select skins from the skin panel
  • Official Desktop Client (DeepSeek Harness Desktop):
    1. Open the official desktop client and navigate to "Settings > Plugins"
    2. Enter @linxin666/dsh-web-all in the plugin install input and click Install
    3. Restart the client to access all plugin features and settings from the sidebar

To install only the skin engine, use @linxin666/dsh-client-ui-skin-center. If your package manager pins an older version due to release age restrictions, see "Install Troubleshooting" below.

Install Directly from the GitHub Repository

The repository root includes a standard dsh.bundle manifest, allowing installation directly from git without cloning or manual building:

dsh plugin --profile web add github:zhu1090093659/dsh-web
# Equivalent: dsh plugin --profile web add git+https://github.com/zhu1090093659/dsh-web.git

This approach is equivalent to installing the npm aggregate package. Use either method, but do not install both simultaneously to prevent conflicting entry IDs.

Install from the Repository (Development)

For plugin development and debugging, build from source using Node.js >= 24.9 and pnpm:

# 1. Clone the repository
git clone https://github.com/zhu1090093659/dsh-web.git
cd dsh-web

# 2. Install dependencies (automatically pins @deepseek-ai SDK to host tree) and build all packages
pnpm run deps:install
pnpm build

# 3. Link packages into the web profile (linking sub-packages before the aggregate is recommended)
node scripts/link-profile.mjs
dsh plugin --profile web add link:$(pwd)/packages/dsh-web-all

# 4. Restart the web server
dsh web

Note: Because profile directories are not configured as pnpm workspaces, internal workspace:* dependencies fall back to npm versions. If published npm packages differ from local builds, run node scripts/link-profile.mjs first to ensure all sub-packages resolve to local build outputs.

Install a Single Plugin

Install individual components independently if you prefer not to use the complete bundle:

dsh plugin --profile web add @linxin666/dsh-client-ui-task-board@latest            # Task Board
dsh plugin --profile web add @linxin666/dsh-liangshen@latest                       # LiangShen Mode (Minimal Preset & PTC)
dsh plugin --profile web add @linxin666/dsh-agents@latest                          # Agent Squads (Reusable Roster & Squad Runs)
dsh plugin --profile web add @linxin666/dsh-client-ui-browser-view@latest          # Live Browser View (Right-Docked CDP Screencast)
dsh plugin --profile web add @linxin666/dsh-remote-bridge@latest                   # Mobile App Remote Access (Protocol v1 Bridge)
dsh plugin --profile web add @linxin666/dsh-client-ui-task-board-github@latest     # Task Board GitHub Issues Sync Extension
dsh plugin --profile web add @linxin666/dsh-client-ui-task-board-team@latest       # Task Board Cloud Team Hub Extension
dsh plugin --profile web add @linxin666/dsh-task-board-remote@latest               # Task Board Mobile Remote Surface Extension
dsh plugin --profile web add @linxin666/dsh-ssh@latest                             # SSH Remote Ops (Terminal & Cluster)
dsh plugin --profile web add @linxin666/dsh-usage@latest                           # Usage Statistics & Token Bank
dsh plugin --profile web add @linxin666/dsh-session-archive@latest                 # Session Archive Manager
dsh plugin --profile web add @linxin666/dsh-client-ui-diagrams@latest              # Mermaid In-Place Diagram Renderer
dsh plugin --profile web add @linxin666/dsh-win-bash@latest                        # Windows Persistent Private Bash
dsh plugin --profile web add @linxin666/dsh-client-ui-skin-center@latest           # Skin Center
dsh plugin --profile web add @linxin666/dsh-pet@latest                             # Desktop Pet
dsh plugin --profile web add @linxin666/dsh-client-ui-market@latest                # Workshop Client
dsh plugin --profile web add @linxin666/dsh-client-ui-preset-center@latest         # Preset Center
dsh plugin --profile web add @linxin666/dsh-client-ui-plugin-manager@latest        # Plugin Manager (Updates & Toggles)
dsh plugin --profile web add @linxin666/dsh-client-ui-skill-explorer@latest        # Skill Explorer
dsh plugin --profile web add @linxin666/dsh-client-ui-web-ui-settings@latest       # Preferences Panel
dsh plugin --profile web add @linxin666/dsh-client-ui-session-id@latest            # Session ID Helper
dsh plugin --profile web add @linxin666/dsh-i18n@latest                            # Russian Language Pack

All plugins are published under the @linxin666/dsh-* npm scope (covering all 21 in-repository family packages under packages/ and 4 satellite repository packages, 25 packages in total):

Package Name Docs Description
@linxin666/dsh-web-all README Aggregate bundle: one-command installation of all feature plugins, skin center, desktop pet, and preset center
@linxin666/dsh-client-ui-task-board README Task board: host-authoritative Schema v7 5-column ledger, subtask trees with autonomous parent dispatch, multimodal card attachments & cron/one-shot scheduling
@linxin666/dsh-client-ui-task-board-github README Task board extension: bidirectional GitHub Issues and PR synchronization with automated PR creation
@linxin666/dsh-client-ui-task-board-team README Task board extension: binds local dsh-agents members to cloud team-hub issues with lease claiming, question routing, comments, and rework
@linxin666/dsh-task-board-remote README Task board remote surface: mounts board.v1 onto dsh-remote-bridge so paired phones read and write the same host ledger
@linxin666/dsh-liangshen README LiangShen Mode: minimal system prompt, PTC programmatic tool transport, on-demand tool-family paging, fact register, dispatcher discipline & composer slot lever
@linxin666/dsh-agents README Agent squads: reusable squad and member definitions, whole-squad Agent Teams runs with live projection, and 10 model-facing tools
@linxin666/dsh-client-ui-browser-view README Live browser view: right-docked CDP screencast tab, isolated Chromium or real signed-in browser attach, and 11 interaction & lossless region-screenshot tools
@linxin666/dsh-remote-bridge README Mobile app remote access: protocol v1 host adaptor, native client WebSocket, ingress gate & public relay/tunnel/LAN ingress
@linxin666/dsh-ssh README SSH operations: web terminal, SFTP transfers, port-forward tunnels, cluster execution, and 6 ssh_* agent tools
@linxin666/dsh-usage README Usage statistics: daily token consumption breakdown, provider balance alerts, coding-plan quota tracking, and Token Bank
@linxin666/dsh-session-archive README Session archive manager: multi-filter session search, batch archive/restore, cascade physical pruning, and automated lifecycle policies
@linxin666/dsh-client-ui-diagrams README Diagrams: renders fenced mermaid code blocks in place as SVG across chat transcripts and document previews
@linxin666/dsh-win-bash README Windows persistent private bash: SHA256-verified vendored MinGit persistent win_bash process per session for Windows x64 sessions
@linxin666/dsh-client-ui-market README Workshop client: browse and install skins, desktop pets, plugins, and community presets with one click
@linxin666/dsh-client-ui-plugin-manager README Plugin manager: registry update checking, DSH runtime minimum version gating, one-click upgrades, and visual plugin settings
@linxin666/dsh-client-ui-skill-explorer README Skill explorer: browse, search, toggle, create, and manage loaded agent skills by origin
@linxin666/dsh-client-ui-web-ui-settings README Preferences panel: first-level settings section hosting family plugin switches and configuration forms
@linxin666/dsh-client-ui-session-id README Session ID Helper: sidebar-foot panel for searching and copying full session IDs with one click
@linxin666/dsh-i18n README Russian Language Pack: centrally carries Russian (ru) dictionaries for every family plugin namespace
@linxin666/dsh-remote-web-ui README Cross-device browser remote access (deprecated, superseded by dsh-remote-bridge; do not enable relay concurrently with remote-bridge)
@linxin666/dsh-client-ui-skin-center dsh-skins Skin center (satellite repo): theme and Wallpaper Engine dynamic background runtime engine, bundling Blue Fantasy
[@linxin666/dsh-pet](https://www.npmjs.com/package/@linxin666/dsh

…

Content from the project README on GitHub ↗

Links

More in this category

View the whole category →

Community comments

Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.