Skip to main content

deepseek-harness-desktop/packages/dsh-aionui-panel

156Stars5Forks6Issues0Watchers

Replicate AionUi right panel for DSH Web GUI: Explorer file tree and Git changes, multi-format preview, project-isolated panel width persistence.

Evidence5/5methodologySourceInstallMaintenanceDSH versionSecurity scan
Machine-auditedInstall commandRepo verifieddsh-plugin topicLicenseREADMEAI wiki

ⓘ This plugin is a sub-package of the ningbainb/deepseek-harness-desktop monorepo — stars and activity count the whole repository.

Language
TypeScript
License
BSD-3-Clause
Branch
main
ai-agentai-coding-assistantcodexdeepseekdeepseek-harnessdesktop-appdshdsh-plugin

Install

cmdweb profile
$ dsh plugin --profile web add @linxin666/dsh-client-ui-aionui-panel

Run the command above in your terminal to install this plugin via the dsh CLI. You can switch Profile in the top-right corner. New to dsh? Read the beginner tutorial

Install via your agent

Install the DeepSeek Harness plugin ningbainb/deepseek-harness-desktop/packages/dsh-aionui-panel for me: review the repository at https://github.com/ningbainb/deepseek-harness-desktop first, then run the install command and verify the plugin loads successfully.

Paste this instruction to the DSH Web GUI assistant — it will install and verify for you.

One-Sentence Positioning

dsh-aionui-panel is the two panels on the right side of the DSH Web GUI chat area: Explorer provides file tree, filename search, and Git change stage/unstage/discard; Preview provides multi-tab preview for 10+ formats including markdown/code/docs/images/PDF, with project-isolated panel width persistence. It reimplements AionUi's right panel (Apache-2.0 reference implementation) according to the official SDK, with data sources coming from the host process's real filesystem and real git repository.

Core Capabilities

  • Explorer File Tree: Click file to open in Preview, click entire row to expand/collapse folder, top filename search (150ms debounce, skip .git and node_modules, 200 hit limit, 20,000 scan limit).
  • Drag File to Chat Input Box: File tree rows can be dragged to input box and released to insert relative path at current draft cursor; highlight prompt bar appears above input box during drag.
  • Git Changes Panel: Reads real git status (porcelain v1 -z) with stage/unstage/discard support; untracked goes through deletion, tracked goes through restore, batch discard shows confirmation.
  • Preview Multi-Tab Preview: markdown/html/code/diff/csv/pdf/word/excel/ppt/images/text/url; supports source/preview toggle, split-pane editing (ratio persistence), save (mtime conflict detection), download, refresh, dirty dot, middle-click close, right-click batch close (dirty confirmation), tab overflow gradient indicator.
  • Panel Width Draggable (rAF frame merging): Explorer default 260px / range 220500px; Preview default 480px / range 3401200px; double-click handle to reset default width; two-level clamping ensures chat area >= 360px; collapse = width shrinks to 0 but component stays mounted, tree expansion state and preview tabs are preserved.
  • Preferences Project-Isolated Persistence: localStorage keys follow AionUi naming (chat-workspace-width-px, chat-preview-width-px, preview-panel-split-ratio, project-panel-collapse:<root>, explorer-ui:<root>, scm-ui:<root>, preview-ui:<root>), LRU上限 12 scopes, illegal value range validation falls back to default.

Technical Implementation

  • Language: TypeScript (ESM; host and browser half-separated layer compilation)
  • Key Dependencies: @deepseek-ai/cordis (host half plugin runtime), @deepseek-ai/dsh-client-runtime / @deepseek-ai/dsh-client-locale / @deepseek-ai/dsh-client-ui-conversation (browser half injection), @linxin666/dsh-desktop-client (only provides "Open in System App" action when running in Desktop, optional dependency), react ^18.2.0 (UI rendering)
  • Architecture Pattern: Cordis double-half plugin — src/index.ts is the host half (Node process: fs/git service + /aionui-panel/* routes + systemPrompt announcement), src/client/index.ts is the browser half (Web GUI side: state core + drag engine + DOM layout controller + React components), src/core/types.ts is pure types shared by both halves; cordis.patch.yml inserts plugin line into web profile list, package.json#dsh.client declares browser injection with platform: "web"
  • Entry Files: src/index.ts (host half entry), src/client/index.ts (browser half entry), src/host/routes.ts (/aionui-panel/* route layer, including loopback fence and SSE), src/host/gate.ts (workspace gate), src/host/fs-service.ts / src/host/git-service.ts (fs/git data services)

Use Cases

For users who open project sessions in DSH Web GUI and want LLMs to directly see/modify real repository files: let agents read .ts or view .yaml during chat, or manually open several files for draft comparison. If you're already running DSH on dsh web but feel "can only type to agent" isn't intuitive enough and want that VS Code-style right-side project explorer feeling, this plugin fills that gap.

Prerequisites & Compatibility

DependencyMin VersionDescription
DSH Runtime>=0.1.0-rc.7 <0.2.0Explicitly declared in package.json#dsh.compatibility.runtime.range (packages/dsh-aionui-panel/package.json:29-31)
DSH Desktop>=2.7.0 <3.0.0package.json#dsh.compatibility.desktop.range; "Open in System App" action depends on Desktop runtime (packages/dsh-aionui-panel/package.json:24-28)
Node.js^22.19 || >=24No independent engines declaration at package level; root package.json#engines unified as ^22.19 || >=24 (repository root package.json)
PlatformCross-platform (macOS / Windows / Linux)Browser half + loopback-only HTTP routes, browser loading uses platform: "web"; host half path handling does case-insensitive, separator-agnostic normalization on win32 (packages/dsh-aionui-panel/package.json:46-53, src/host/gate.ts:28-46)
Native ModulesNoneOnly depends on Node standard library (node:fs, node:http, node:path, node:fs/promises) and official SDK; no native bindings like koffi/node-pty/node:sqlite

Installation

dsh plugin --profile web add github:ningbainb/deepseek-harness-desktop/packages/dsh-aionui-panel

After installation, restart dsh web, open a project session with a working directory to see the "Preview" and "Files/Changes" panels on the right side of the chat area.

Configuration

This plugin requires no DSH-side configuration (no cordis Schema or ctx.config exposed items). Browser-side "user preferences" — panel width, collapsed state, Preview split ratio, tab order — are written by this plugin to localStorage, isolated by project root, requiring no manual user configuration.

FAQ

Q: What can I see after installing this plugin?

A: In project sessions opened in dsh web, two additional panels appear on the right side of the chat area: Explorer (file tree + Git Changes tab) and Preview (multi-tab file preview). Drag the file tree to the chat input box to insert the relative path at the draft cursor, without manually typing paths.

Q: What file preview formats are supported?

A: 10+ formats including markdown/html/code/diff/csv/pdf/word/excel/ppt/images/text/url, supporting source/preview toggle, split-pane editing, save (with mtime conflict detection), download, refresh, dirty dot, middle-click close, right-click batch close.

Q: Must I use DSH Web GUI (profile=web) to see this plugin?

A: Yes. cordis.patch.yml inserts the plugin line into the web profile list, and package.json#dsh.client.platform field is also web; in CLI mode (headless profile), the browser half won't load.

Q: Is the data real filesystem or mock?

A: Real. The host process provides directory listing, file read/write, filename search, git status/diff/stage/unstage/discard via /aionui-panel/* HTTP routes; recursive fs.watch + 30s git polling forms the SSE change stream.

Q: Can I access dsh web from another machine to use this plugin?

A: No. All /aionui-panel routes are forced loopback-only: non-127.0.0.1/::1 clients immediately receive 403 forbidden: loopback-only, same fence as dsh-ssh. LAN-exposed dsh web won't leak any fs/git operations to unpaired devices.

Q: What happens if workspace path is not in registered workspaces?

A: Directly rejected. All requests' project root go through workspace gate: after realpath normalization, must fall within some workspace returned by ctx.workspaceRegistry.list() or its subdirectory; out-of-bounds returns workspace-unknown, path traversal returns path-outside-root.

Q: Can I use it without git binary installed?

A: File tree and preview work perfectly. Git polling probes once, determines unavailability, logs and dispatches gitUnavailable event; SCM tab enters friendly "git not installed" state without retrying every 2 seconds.

Q: Are panel width and collapsed state saved?

A: Saved to localStorage isolated by project root, keys follow AionUi naming; LRU limit 12 scopes, oldest unused gets evicted; all reads do range validation, illegal values fall back to default.

Learning Curve

Beginner — install + restart dsh web + open project session for immediate use; panel width, collapse, Preview behavior are all WYSIWYG, no documentation reading needed.

Known Issues & Limitations

  • All /aionui-panel/* routes (including JSON operations, raw reads, and SSE event streams) are forced loopback-only; LAN clients are immediately rejected (src/host/routes.ts:70-96).
  • Workspace gate requires request path to be within workspace registered in ctx.workspaceRegistry; unregistered or path traversal is rejected (src/host/gate.ts:55-74, src/host/fs-service.ts:51-80).
  • Text read limit 80k characters, image read limit 8MB (src/host/fs-service.ts:29-33); filename search hit limit 200, scan limit 20,000, skips .git and node_modules (src/host/fs-service.ts:35-38).
  • Preview drag file to input box only works on file rows; directory rows cannot be dragged (README.md:30).
  • localStorage preference persistence LRU limit 12 project root scopes, oldest unused gets evicted (README.md:39).
  • Git polling probes once, determines machine has no git binary, marks unavailable; only fs.watch triggers refresh afterwards; SCM tab enters friendly state without retrying every 30s (src/host/routes.ts:172-185).
  • "Open in System App" button in Preview toolbar only works when host is DSH Desktop; clicking it in normal dsh web browser side prompts "Cannot open this file in system app" (src/client/preview/open-external.ts:14-31).
  • package.json#dsh.compatibility.runtime locked to >=0.1.0-rc.7 <0.2.0, strongly bound to upstream @deepseek-ai/* SDK rc versions; when DSH upgrades to incompatible version, need to wait for plugin release (packages/dsh-aionui-panel/package.json:29-31).

Read the usage guide →

Install steps, key points, FAQ and compatibility for this plugin — auto-derived from indexed fields.

Listing badge

Listed on deepseek-plugin.org
[![Listed on deepseek-plugin.org](https://img.shields.io/badge/listed_on-deepseek--plugin.org-007EC6)](https://deepseek-plugin.org/plugins/ningbainb/deepseek-harness-desktop/packages/dsh-aionui-panel)

Paste this markdown into your GitHub README to link back to this listing. The badge only states the listing — not a security endorsement.

← Back to plugin directory