DeepSeek Harness für Design.
Ein Modell kann JSX schreiben, aber ein nützlicher Design-Agent braucht mehr als eine Modellausgabe. Er benötigt Markenrichtlinien, Referenzen, Tools, Berechtigungen und eine Schleife, die das Ergebnis rendert und prüft. DeepSeek Harness legt diese umgebenden Komponenten offen, statt sie zu verbergen.
Formuliere bei der Arbeit an Benutzeroberflächen das Briefing und die Abnahmeschleife ausdrücklich. Die standardmäßige DeepSeek-Route verarbeitet nur Text; die zuverlässigste Grundlage ist daher ein Code-und-Spezifikations-Workflow. Füge Screenshots erst hinzu, nachdem du eine Modellroute mit deklarierter Bildeingabe ausgewählt hast.
Diese Flexibilität ist für Designarbeit nützlich, weil die Qualität der generierten UI vom Harness rund um das Modell abhängt: dauerhafte Projektregeln, wiederverwendbare Skills, der richtige Anbieter für Text- oder Bildeingaben, Datei- und Shell-Tools sowie eine Prüfschleife. Dieser Leitfaden zeigt den kürzesten funktionierenden Einrichtungsweg, die für UI-Aufgaben relevanten Grenzen und die klare Abgrenzung zu Open Design: dsh ist noch kein offizieller Open Design-Adapter, während der vorhandene DeepSeek TUI-Adapter eine andere CLI ist.
DeepSeek Harness von Grund auf einrichten
Die öffentliche Vorschau erfordert Node.js `^22.19.0` oder `>=24.0.0`. Der npm-Befehl initialisiert das Webprofil bei der ersten Verwendung, sodass du ohne Klonen des Repositorys eine funktionierende lokale UI erhältst.
# 1. Start the official DeepSeek Harness Web UI
# Requires Node.js ^22.19.0 or >=24.0.0
npx @deepseek-ai/dsh web
# 2. Open the local UI (default)
# http://127.0.0.1:3080
# 3. In Settings → Models, add a DeepSeek API key
# or configure another supported provider.
# 4. Choose the project directory as your workspace.
# Optional: run one headless job after the profile is initialized
npx @deepseek-ai/dsh --profile headless "Audit this UI against AGENTS.md"
- Anmeldedaten bleiben referenziert: Die Web UI speichert Anbieter-Secrets in `$DSH_HOME/.credentials.yaml`; die Einstellungen enthalten eine Anmeldedatenreferenz, und die UI erhält anstelle des eigentlichen Schlüssels eine maskierte Beschreibung.
- Die Vorschau wie fest versionierte Infrastruktur behandeln: Die Maintainer weisen ausdrücklich auf bevorstehende Änderungen mit Kompatibilitätsbrüchen hin. Fixiere die Version für Team-Workflows und prüfe vor einer Aktualisierung die Release-Änderungen.
Warum ein Plugin-First-Harness zu Designarbeit passt
Ein Modell kann JSX schreiben, aber ein nützlicher Design-Agent braucht mehr als eine Modellausgabe. Er benötigt Markenrichtlinien, Referenzen, Tools, Berechtigungen und eine Schleife, die das Ergebnis rendert und prüft. DeepSeek Harness legt diese umgebenden Komponenten offen, statt sie zu verbergen.
- Dauerhafter Designkontext: Der standardmäßige Anweisungs-Loader liest `AGENTS.md` und `CLAUDE.md` aus der Projekthierarchie. Hinterlege Tokens, Komponentenregeln, responsive Breakpoints und Prüfkriterien dort, wo sie bei jedem Lauf verfügbar sind.
- Wiederverwendbare Skills: Lokale Skills können unter `.dsh/skills` oder `.agents/skills` liegen. Ein Frontend-Skill kann das genaue Briefing, die Checkliste, Beispiele und Skripte bündeln, damit nicht jede UI-Aufgabe bei null beginnt.
- Aufgabengerechte Anbieterwahl: Die Web UI kann DeepSeek, Kataloganbieter wie Anthropic oder OpenAI und benutzerdefinierte OpenAI-kompatible Endpunkte konfigurieren. Verwende für Screenshot-Eingaben eine deklarierte bildfähige Route; für text-, code-, DOM- und spezifikationsbasierte Arbeit eignet sich die native DeepSeek-Route.
Die entscheidende Grenze ist bei jedem Agenten dieselbe: Modularität ersetzt keine gestalterische Qualität. Ohne bewusste Vorgaben für Typografie, Abstände, Komponenten und Interaktionen automatisiert die Laufzeit zuverlässig ein generisches Ergebnis. Open Design liefert und organisiert diese Designgrundlagen.
Ein praktischer UI- und Frontend-Workflow mit DeepSeek Harness
Formuliere bei der Arbeit an Benutzeroberflächen das Briefing und die Abnahmeschleife ausdrücklich. Die standardmäßige DeepSeek-Route verarbeitet nur Text; die zuverlässigste Grundlage ist daher ein Code-und-Spezifikations-Workflow. Füge Screenshots erst hinzu, nachdem du eine Modellroute mit deklarierter Bildeingabe ausgewählt hast.
- Starte dsh aus dem Repository, wähle dieses Verzeichnis als Arbeitsbereich und dann die Modellroute für die Aufgabe.
- Hinterlege den Markenvertrag in `AGENTS.md`, `CLAUDE.md` oder einer referenzierten `DESIGN.md`: Tokens, Grundelemente, Abstände, Typografie, Breakpoints, Zustände und verbotene Muster.
- Lade einen fokussierten Frontend-Skill aus `.dsh/skills` oder `.agents/skills`; bewahre Beispiele und Validierungsskripte neben den Anweisungen auf.
- Weise den Agenten an, vorhandene Komponenten wiederzuverwenden, die Anwendung auszuführen und responsive Zustände mit den projekteigenen Tests oder Browser-Tools zu validieren.
- Prüfe das sichtbare Ergebnis, protokolliere konkrete Abweichungen und iteriere in kleinen Commits. Setze schwache Durchläufe zurück, statt Korrekturen auf einer schlechten Grundlage aufzuschichten.
Ein guter Prompt benennt sowohl die visuellen Vorgaben als auch die Nachweise der Überprüfung:
Implement the account dashboard in React + TypeScript.
Reuse the components and tokens named in AGENTS.md and DESIGN.md.
Use a 240px sidebar, a 12-column content grid, and the documented
mobile navigation pattern. Include loading, empty, error, and focus states.
Run the app and existing UI checks, inspect desktop and mobile breakpoints,
and report the exact files and states you verified.Wenn ein Screenshot unerlässlich ist, konfiguriere zuerst einen bildfähigen Anbieter. DeepSeek Harness lehnt ein Bild vor dem Senden ab, wenn die ausgewählte Route keine Bildunterstützung deklariert — ein sinnvoller Schutz davor, dass die Referenz unbemerkt verworfen wird.
Plugins, Skills und Projektkontext
DeepSeek Harness hebt sich vor allem unterhalb der Chat-Oberfläche ab. Mit seinem Plugin-Baum können Teams den Design-Workflow zum Bestandteil der Laufzeit machen, statt in jeder Sitzung erneut einen Prompt einzufügen.
- AGENTS.md und CLAUDE.md: Das Anweisungs-Plugin lädt die globale Benutzerdatei und die Projekthierarchie und erkennt nach Dateioperationen durch integrierte Tools relevante verschachtelte Anweisungsdateien. Nutze es für dauerhafte Designregeln, nicht für einmalige Anforderungen.
- Dateisystem-Skills: Die Skill-Registry findet Projekt- und Benutzerwurzeln, priorisiert Duplikate und stellt ein modellseitiges Tool namens `skill` bereit. Dies ist der natürliche Ort für Frontend-Handwerk, Barrierefreiheit, responsive Qualitätssicherung und Designsystem-Verfahren.
- Profile und Bundles: Ein Profil stapelt geordnete Plugin-Bundles und benutzerdefinierte Patches. Teams können eine designorientierte Zusammenstellung mit den tatsächlich benötigten Anbietern, Tools, Berechtigungsrichtlinien und Skill-Quellen pflegen.
- MCP und externe Funktionen: Der Quellbaum enthält MCP-Client-Funktionen, doch die benutzerseitige Konfiguration richtet sich weiterhin an Entwickler. Behandle Integrationen während der Vorschau als versionierte Plugin-Arbeit und nicht als stabilen Checkbox-Workflow.
Bevor du einen langlebigen internen Workflow aufbaust, solltest du den effektiven Baum mit `dsh --profile web --dump-config` prüfen. Diese Ausgabe zeigt, was tatsächlich eingebunden und patchbar ist; sie ist zuverlässiger als die Annahme, jedes Paket im Repository sei im ausgelieferten Profil aktiv.
Fallstricke bei Entwicklervorschau und Design
Die größten Fehler entstehen, wenn eine Vorschau wie ein stabiles Produkt behandelt wird, eine reine Textroute wie ein Vision-Modell oder ein flexibles Harness wie eine Quelle gestalterischer Qualität.
- Version vor dem Anpassen fixieren: Änderungen mit Kompatibilitätsbrüchen sind ausdrücklich Teil der Vorschau-Richtlinie. Fixiere die npm-Version und halte Profil-Patches klein genug, um sie nach einem Upgrade überprüfen zu können.
- Modalitäten des ausgewählten Modells prüfen: Die native Chat-Completions-Route von DeepSeek verarbeitet ausschließlich Text. Wähle und deklariere für Screenshot-to-Code stattdessen eine bildfähige Anbieterroute, statt davon auszugehen, dass der Anhang verstanden wird.
- Gestalterische Qualität als Daten bereitstellen: Gib dem Agenten Tokens, kanonische Komponenten, Referenzzustände und verbotene Muster. Eine modulare Laufzeit ohne Designvertrag erzeugt weiterhin generische UI.
- Prüfen, was das Profil tatsächlich einbindet: Repository-Pakete stellen Funktionen bereit, beweisen aber nicht, dass sie im Standardprofil aktiviert sind. Prüfe die zusammengesetzte Konfiguration, bevor du eine Integration dokumentierst oder dich darauf verlässt.
Jede Gegenmaßnahme ist eine Entscheidung über Kontext und Überprüfung. Genau diese Arbeit sollte eine Design-Ebene wiederholbar machen, anstatt jedes Projekt sie neu entdecken zu lassen.
Was DeepSeek Harness tatsächlich ist
DeepSeek Harness (`dsh`) ist ein von DeepSeek AI entwickeltes Agent-Harness mit MIT-Lizenz. Die öffentliche Entwicklervorschau umfasst eine lokale Web UI und einen Headless-Runner. Es ist weder ein Modell noch lediglich eine Terminal-Oberfläche: Es ist die Laufzeit, die ein Modell, Tools, Kontext, Berechtigungen, Sitzungen und eine Benutzeroberfläche zu einem Agenten zusammenfügt.
Die zentrale Idee lautet: „Alles ist ein Plugin.“ Cordis setzt einen Baum zusammen, in dem Modelladapter, Tool-Registry, Agentenschleife, Dateisystem, Shell, Sandbox, Skills, Subagenten, Persistenz und UI über Profile und Bundles eingebunden, ersetzt oder gepatcht werden können. Die mitgelieferten Profile `web` und `headless` sind Ausgangspunkte und keine fest vorgegebenen Produkte.
- Lokale Web UI: `npx @deepseek-ai/dsh web` startet standardmäßig einen Browser-Arbeitsbereich unter `127.0.0.1:3080`. Füge ein Modell hinzu, wähle einen Arbeitsbereich und führe Aufgaben über die Chat-Oberfläche aus.
- Headless-Modus: Das Profil `headless` führt eine neue persistierte Sitzung aus, gibt die endgültige Antwort aus und beendet sich — nützlich für skriptgesteuerte Audits, Builds und wiederholbare Designprüfungen.
- Modular zusammensetzbare Laufzeit: Profile stapeln Plugin-Bundles und eigene Patches. So kann ein Team Anbieter, Tools, Richtlinien und das UI-Verhalten ändern, ohne eine Agentenschleife forken zu müssen.
- Entwickler: DeepSeek AI (offizielles Projekt)
- Status: Entwicklervorschau; Änderungen mit Kompatibilitätsbrüchen sind zu erwarten
- Lizenz: MIT
- Primärer Befehl: `npx @deepseek-ai/dsh web`
DeepSeek Harness im Vergleich zu DeepSeek TUI und anderen Design-Agenten
Die Namen werden leicht verwechselt. DeepSeek Harness und das derzeit in Open Design aufgeführte DeepSeek TUI sind separate Projekte mit unterschiedlichen ausführbaren Dateien und unterschiedlichem Integrationsstatus.
| Tool | Was es ist | Beste Verwendung im Design |
|---|---|---|
| DeepSeek Harness (`dsh`) | Offizielles Plugin-First-Harness von DeepSeek AI mit lokaler Web UI und Headless-Profilen; Entwicklervorschau | Für Teams, die Laufzeit, Skills, Anbieter, Richtlinien und UI rund um einen Design-Workflow selbst zusammenstellen möchten |
| DeepSeek TUI (`deepseek` / `codewhale`) | Ein separater Terminal-Coding-Agent und der DeepSeek-Adapter, den Open Design derzeit unterstützt | Für die heutige Nutzung von DeepSeek innerhalb von Open Design |
| OpenCode | Ausgereifter, anbieterunabhängiger Open-Source-Terminal-Agent | Für den Modellwechsel innerhalb eines stabilen TUI-Workflows mit AGENTS.md und MCP |
| Claude Code | Ausgereifter Coding-Agent für Terminal-, IDE-, Desktop- und Weboberflächen | Für Frontend-Reasoning, bildlastige Referenzen und etablierte Designintegrationen |
| Open Design | Agentennativer Design-Arbeitsbereich und Bibliothek rund um unterstützte Coding-Agenten | Für kuratierte Designsysteme, Skills, visuelle Artefakte und einen lokalen Workflow unabhängig von einem einzelnen Modellanbieter |
Wähle dsh, wenn du das Harness selbst erweitern möchtest. Wähle DeepSeek TUI innerhalb von Open Design, wenn du den derzeit unterstützten DeepSeek-Adapter und eine einsatzbereite Design-Ebene benötigst. Beide könnten durch einen zukünftigen Adapter zusammengeführt werden, sind heute aber nicht austauschbar.
DeepSeek Harness mit einem agentennativen Design-Arbeitsbereich verwenden
Open Design und DeepSeek Harness besetzen benachbarte Ebenen. dsh setzt eine Agent-Laufzeit zusammen; Open Design kuratiert die Designsysteme, Skills und den lokalen Artefakt-Workflow, die einen Agenten für visuelle Arbeit nützlich machen. Open Design liefert noch keinen eigenen `dsh`-Adapter aus, daher werden beide heute korrekterweise nebeneinander verwendet.
- Installiere Open Design und nutze seine Designsysteme und Skills, um den visuellen Vertrag für das Projekt festzulegen.
- Bewahre die daraus entstandene `DESIGN.md`, Referenzen und Projektanweisungen in demselben Repository auf, das DeepSeek Harness als Arbeitsbereich öffnet.
- Führe dsh für Plugin-First-Experimente und Coding-Aufgaben aus; verwende dieselben Tokens, Regeln, Assets und Validierungskriterien, statt ein zweites Design-Briefing zu pflegen.
- Wenn du DeepSeek heute direkt in Open Design benötigst, wähle den vorhandenen DeepSeek TUI-Adapter. Betrachte einen zukünftigen dsh-Adapter als separate Integration und nicht als derzeitiges Verhalten.
Das Ergebnis ist eine einzige eigene Codebasis und ein portabler Designvertrag für zwei Local-First-Tools. Open Design bleibt von DeepSeek AI unabhängig; DeepSeek und DeepSeek Harness sind Marken ihres jeweiligen Inhabers.
FAQ zu DeepSeek Harness
-
01 Was ist DeepSeek Harness?
DeepSeek Harness (`dsh`) ist das offizielle Open-Source-Agent-Harness von DeepSeek AI. Es verbindet Modelle, Tools, Kontext, Sitzungen, Richtlinien, Orchestrierung und UI über einen Cordis-Plugin-Baum. Die öffentliche Version ist derzeit eine Entwicklervorschau unter der MIT-Lizenz.
-
02 Wie installiere und starte ich DeepSeek Harness?
Installiere eine unterstützte Node.js-Version und führe dann `npx @deepseek-ai/dsh web` aus. Dadurch startet die lokale Web UI standardmäßig unter `http://127.0.0.1:3080`. Füge unter Einstellungen → Modelle ein Modell hinzu, wähle einen Arbeitsbereich und starte eine Sitzung.
-
03 Ist DeepSeek Harness ein offizielles DeepSeek-Projekt?
Ja. Das Repository wird unter der GitHub-Organisation `deepseek-ai` veröffentlicht und beschreibt dsh als ein von DeepSeek AI entwickeltes Agent-Harness. Es steht unter der MIT-Lizenz und ist ausdrücklich als Entwicklervorschau gekennzeichnet.
-
04 Kann DeepSeek Harness UI anhand von Screenshots erstellen?
Nur wenn die ausgewählte Anbieterroute Bildeingaben deklariert. Die eigene Chat-Completions-Route von DeepSeek in dsh verarbeitet ausschließlich Text, und das Harness lehnt Bildanhänge vor dem Senden über eine reine Textroute ab. Verwende für Screenshots einen bildfähigen Anbieter oder beschreibe das Ziel durch Code, DOM, Tokens und schriftliche Spezifikationen.
-
05 Unterstützt DeepSeek Harness AGENTS.md und Skills?
Ja. Sein Anweisungs-Plugin lädt AGENTS.md- und CLAUDE.md-kompatible Projektdateien. Sein Dateisystem-Skill-Anbieter findet Projekt-Skills unter `.dsh/skills` und `.agents/skills` sowie konfigurierte Benutzer- und Bundle-Wurzeln.
-
06 Was ist der Unterschied zwischen DeepSeek Harness und DeepSeek TUI?
Es handelt sich um separate Tools. DeepSeek Harness verwendet die ausführbare Datei `dsh` und ist eine offizielle Plugin-First-Laufzeit mit Web UI und Headless-Modus von DeepSeek AI. DeepSeek TUI verwendet den Dispatcher `deepseek` oder `codewhale` und ist der separate DeepSeek-Adapter, den Open Design derzeit unterstützt.
-
07 Unterstützt Open Design DeepSeek Harness?
Noch nicht als eigenen offiziellen Adapter. Open Design unterstützt derzeit den separaten DeepSeek TUI-Adapter. Du kannst die Designsysteme, Skills, DESIGN.md-Dateien und Artefakte von Open Design dennoch zusammen mit dsh im selben lokalen Repository verwenden.
-
08 Wo speichert DeepSeek Harness meinen API-Schlüssel?
Laut offiziellem Modellleitfaden werden Anbieterschlüssel in `$DSH_HOME/.credentials.yaml` gespeichert. Die Einstellungen enthalten nur eine Anmeldedatenreferenz, und die Web UI erhält anstelle des eigentlichen Secrets eine maskierte Beschreibung.
Baue die Design-Ebene rund um deinen DeepSeek-Workflow auf.
Nutze schon heute die lokalen Designsysteme, Skills und den Artefakt-Workflow von Open Design und halte denselben Projektvertrag für jede Agent-Laufzeit bereit, die du als Nächstes wählst.