zhu1090093659/dsh-web

What is dsh‑web?

dsh‑web is the plugin ecosystem for DeepSeek Harness (DSH) Web, the browser‑based UI that lets you interact with DeepSeek’s AI agents. The repository ships a “all‑in‑one” package (@linxin666/dsh-web-all) that bundles dozens of optional UI extensions –‑ task board, mobile remote control, SSH console, image‑understanding tool, Git visualiser, skins, pets, and a marketplace –‑ and makes them plug‑and‑play without modifying the core DSH code.

---

Core ideas

Idea	How it works
Everything is a plugin	Each feature lives in its own npm package under the @linxin666/dsh‑* scope. The aggregation package simply lists them all so you can install one dependency and get the full workstation.
Pluggable skins	Visual themes are also plugins. A skin package contains a skin.json manifest plus CSS, images and optional effect scripts. The UI loads the skin at runtime, completely decoupled from the core code, so new looks can be added without a release.
Marketplace (dsh‑market.com)	A static site generated from the same skin/​pet/​plugin manifests. Users can browse, preview, and install community‑made assets with a single click.
Remote‑mobile pairing	Scan a QR‑code (or copy a link) to pair a phone or another browser. The paired device sees the same DSH workspace, can send messages, switch models, and run commands. Communication uses SSE; when SSE isn’t supported the plugin falls back to polling.
SSH & file transfer	A built‑in xterm.js terminal, SFTP upload/download, port‑forwarding, and multi‑host batch execution are exposed as a UI panel.
Image understanding	Adds a button to the chat input; selected images are sent to a configurable OpenAI‑compatible vision endpoint (e.g., GPT‑4o, Qwen‑VL, Ollama) via a describe_image tool. Only the generated text is stored in the conversation.

---

Main plugins (included in the “all‑in‑one” bundle)

Plugin	Function
dsh-client-ui-task-board	Kanban board with five columns, real‑time execution of DSH agents, and cron‑style scheduling.
dsh-remote-web-ui	QR‑code pairing for mobile or secondary browsers; real‑time sync of sessions, models, and permissions.
dsh-ssh	SSH panel with terminal, SFTP, local‑only port forwarding, and cluster command execution.
dsh-tool-describe-image	Vision tool (describe_image) that forwards images to a configurable vision model and returns a textual description.
dsh-client-ui-git-graph	Branch selector and visual commit‑history graph.
dsh-client-ui-skin-center	Loader for all skin assets; skins are fetched from the marketplace on demand.
dsh-client-ui-market	UI card that opens the marketplace inside DSH Web.
dsh-client-ui-plugin-manager	Install/enable/disable other @linxin666/* plugins directly from the UI.
dsh-better-sidebar (external)	Right‑hand sidebar that hosts file explorer, editor, terminal, Git view, and browser.
…and many optional utilities such as skill explorer, chat recovery, desktop launcher, and a “doctor” rescue mode.

---

Getting started (quick‑start)

1. Prerequisites – DeepSeek Harness must already be installed and dsh web runnable. Node ≥ 22 and pnpm are needed only for building from source.
2. Install the bundle

   dsh plugin --profile web add @linxin666/dsh-web-all@latest
   

3. Restart dsh web. New entries appear in the left sidebar.
4. Enable/disable plugins or try skins via Settings → Plugin Configuration.

If you prefer to develop locally, clone the repo, run pnpm install && pnpm -r build, then link the built packages with node scripts/link-profile.mjs before restarting the UI.

---

Who might use this?

• AI‑agent developers who want a richer UI for building, testing, and monitoring DSH agents.
• Power users who need remote SSH access, scheduled tasks, or visual Git history without leaving the browser.
• Community creators who want to publish skins, pets, or plugins to the DSH marketplace.

---

Limitations & caveats

• Scheduled tasks run in the DSH host process; they survive a closed browser but are skipped if the host is stopped or the machine sleeps.
• SSH credentials are stored in plain‑text (~/.dsh/dsh-ssh.json with mode 0600).
• Real‑time mobile updates rely on Server‑Sent Events; some tunnelling services (e.g., Cloudflare quick tunnel, Tailscale) downgrade to polling, causing a few‑second delay.
• Building from source requires Node ≥ 22 and pnpm; normal users can install the pre‑published npm packages.

---

Community & contribution

• Join the QQ group (QR code in the README) or the Discord server for help and discussion.
• Contributions follow the standard CONTRIBUTING.md workflow, use Conventional Commits, and must pass pnpm typecheck && pnpm test && pnpm docs:check before PRs are merged.
• New plugins or skins can be scaffolded with node scripts/dsh-plugin-new <name> or node scripts/dsh-skin-new.

---

In short: dsh‑web is a modular, community‑driven extension layer that turns the DeepSeek Harness web UI into a full‑featured development workstation, with plug‑in task boards, remote mobile control, SSH, vision tools, skins, and a marketplace for community contributions.