Flaq AI Agenten-Guide

Praktischer Leitfaden zur Verwendung von DeepSeek Harness mit der OpenAI-kompatiblen API von Flaq AI

Führen Sie die quelloffene Weboberfläche von DeepSeek Harness mit dem OpenAI-kompatiblen Endpunkt von Flaq AI aus und binden Sie anschließend ein unterstütztes DeepSeek-v4-Modell für Repository-Analysen und Programmierabläufe ein. DeepSeek Harness folgt einer „Alles ist ein Plugin“-Architektur: Modelladapter, Werkzeuge, Agentenschleife, Sitzungsspeicher, Berechtigungen, Sandboxing, Telemetrie und Weboberfläche lassen sich über Plugins und Konfigurationen zusammenstellen oder ersetzen.

Agenten-Guides

Claude Code/cc-apiOpenAI Codex/codex-api/v1Hermes Agent/api/v1DeepSeek Harness/api/v1ZCode/api/v1

Installieren

DeepSeek Harness ausführen

DeepSeek Harness erfordert Node.js 22.19+ oder eine Version ab 24. Starten Sie es in dem Projektverzeichnis, das Sie als standardmäßigen Speicherort im Dateisystem verwenden möchten. Der offizielle npm-Befehl startet die Weboberfläche standardmäßig unter http://127.0.0.1:3080.

1

Weboberfläche von DeepSeek Harness ausführen

Starten Sie die Weboberfläche mit dem offiziellen npm-Paket. Lassen Sie dieses Terminal geöffnet, während Sie DeepSeek Harness verwenden.

Beim ersten Start wird das aktuelle Paket @deepseek-ai/dsh heruntergeladen und das Profil der Weboberfläche initialisiert.

Offizieller npm-Befehl

npx @deepseek-ai/dsh web

Repository: Die neuesten Installationsanweisungen, Releases, Kompatibilitätshinweise und den Quellcode finden Sie im offiziellen GitHub-Repository von DeepSeek Harness.

Konfigurieren

DeepSeek Harness mit Flaq AI verbinden

Öffnen Sie in DeepSeek Harness Settings → Models, fügen Sie Flaq AI als benutzerdefinierten Anbieter hinzu und geben Sie Ihren Flaq-API-Schlüssel ein. Die Provider ID kann nach dem Speichern nicht mehr geändert werden. Verwenden Sie daher flaq, sofern Sie nicht bewusst einen anderen Routennamen benötigen. Wählen Sie nach dem Speichern des Anbieters einen Arbeitsbereich aus, bevor Sie eine Sitzung starten.

Empfohlenes DeepSeek-v4-Pro-Modell für Repository-Analysen, Programmieraufgaben und Arbeitsabläufe, die von ausgeprägteren Schlussfolgerungsfähigkeiten profitieren.

Wählen Sie unter Settings → Models die Optionen Add provider → Add a custom provider. Geben Sie die unten aufgeführten Werte ein und fügen Sie die ausgewählte Modell-ID manuell hinzu, statt Fetch available models zu verwenden. Speichern Sie den Anbieter und wählen Sie dieses Modell anschließend für eine neue Sitzung aus. DeepSeek Harness behandelt manuell eingegebene Modelle als reine Textmodelle, sofern keine zusätzlichen Modalitäten angegeben werden.

  • Verwenden Sie exakt die Flaq-Basis-URL und das Protokoll openai-completions.
  • Ersetzen Sie den Platzhalter durch Ihren Flaq-API-Schlüssel und übernehmen Sie die Modell-ID genau wie angegeben.

Benutzerdefinierter Anbieter für Flaq AI

Provider ID: flaqDisplay name: Flaq AIBase URL: https://api.flaq.ai/api/v1API protocol: openai-completionsCredential / API key: Your_Flaq_Api_KeyModel ID: deepseek-v4-pro-text-to-text

Prüfen

Flaq in DeepSeek Harness überprüfen

Öffnen Sie die Weboberfläche, wählen Sie das Projektverzeichnis aus, in dem Sie DeepSeek Harness gestartet haben, wählen Sie das konfigurierte Flaq-Modell und erstellen Sie eine neue Sitzung. Das Eingabefeld bleibt deaktiviert, bis ein Arbeitsbereich ausgewählt wurde.

  • DeepSeek Harness gibt die aktive URL im Terminal aus.
  • Die standardmäßige lokale Adresse ist unten angegeben.

Weboberfläche öffnen

http://127.0.0.1:3080
  • Senden Sie zunächst eine schreibgeschützte Aufgabe.
  • Eine normale Antwort, die den ausgewählten Arbeitsbereich berücksichtigt, bestätigt, dass DeepSeek Harness den Flaq-Endpunkt erreichen und das konfigurierte Modell verwenden kann.

Repository-Zugriff testen

Summarize this repository and identify its main packages. Do not modify any files.

Plugin-Beispiel

Ein DeepSeek-Harness-Plugin installieren

DSH OpenPencil dient als konkretes Beispiel für die „Alles ist ein Plugin“-Architektur von DeepSeek Harness. Schließen Sie die oben beschriebene Konfiguration und Überprüfung des Flaq-Anbieters ab, beenden Sie die laufende Weboberfläche, fügen Sie das Plugin zum Profil web hinzu und starten Sie dieselbe DeepSeek-Harness-Version neu. DSH OpenPencil stellt Werkzeuge zum Erstellen, Anzeigen, Prüfen und Bearbeiten von .op-Designdokumenten innerhalb einer Unterhaltung bereit.

1

DSH OpenPencil installieren

Fügen Sie das öffentliche OpenPencil-Paket mit der derzeit vom Plugin getesteten DeepSeek-Harness-Version zum Profil web hinzu. Führen Sie diesen Befehl in demselben Projektverzeichnis aus, das Sie für DeepSeek Harness verwenden.

DSH OpenPencil installieren

npx --yes -p @deepseek-ai/[email protected] dsh plugin --profile web add @zseven-w/dsh-openpencil@latest

Repository: Quellcode, Einrichtungsanforderungen, Releases und Kompatibilitätshinweise finden Sie im GitHub-Repository von DSH OpenPencil.

2

Weboberfläche neu starten

Starten Sie die getestete DeepSeek-Harness-Version erneut, damit das Profil web DSH OpenPencil lädt. Lassen Sie dieses Terminal geöffnet, während Sie die Weboberfläche erneut aufrufen.

Weboberfläche neu starten

npx --yes -p @deepseek-ai/[email protected] dsh web
3

DSH OpenPencil mit Flaq AI testen

Wählen Sie das konfigurierte Flaq-Modell und den Arbeitsbereich aus, starten Sie eine neue Sitzung und senden Sie die unten stehende Anfrage. Wenn die OpenPencil-Binärdatei verfügbar ist, sollte das Plugin ein .op-Dokument erstellen und eine bearbeitbare Vorschau in der Unterhaltung anzeigen.

DSH OpenPencil mit Flaq AI testen

Create a simple editable OpenPencil document with a title, a subtitle, and two feature cards. Save it as openpencil-demo.op, then render an editable preview.

Open Source

Das offizielle Repository von DeepSeek Harness erkunden

DeepSeek Harness ist ein von DeepSeek AI entwickeltes quelloffenes Agenten-Framework. Besuchen Sie das offizielle Repository, um den Quellcode einzusehen, Releases und Kompatibilitätsänderungen zu verfolgen, die aktuelle Dokumentation zu lesen und während der Entwicklervorschau Probleme zu melden.

DeepSeek Harness auf GitHub

Öffnen Sie das offizielle Repository von DeepSeek Harness, um Quellcode, Einrichtungsdokumentation, Entwicklungshinweise, Diskussionen und Projektneuigkeiten aufzurufen.

Open-Source-Leitfaden

Den quelloffenen DeepSeek-Harness-Leitfaden von Flaq AI erkunden

Gehen Sie mit dem unabhängigen, von der Community gepflegten Leitfaden von Flaq AI zu DeepSeek Harness über die Ersteinrichtung hinaus. Erfahren Sie, wie Plugin-Baum, Profile, Bundles, Patch-Ebenen, austauschbare Agentenschleife, Modelladapter, Werkzeuge, Sitzungsdienste, Berechtigungsrichtlinien, Sandboxes und Erweiterungen der Weboberfläche benutzerdefinierte Agentenabläufe unterstützen.

DeepSeek-Harness-Leitfaden auf GitHub

Entdecken Sie praktische Architekturhinweise, ein Benutzerhandbuch, Anleitungen zur Plugin-Entwicklung, mehrsprachige Dokumentation und wiederverwendbare Agenten-Skills, um DeepSeek Harness zu verstehen, zu erweitern und darauf aufzubauen.

Fehlerbehebung

Häufig gestellte Fragen zu DeepSeek Harness

Bei Verwendung dieses Setups in diesem Guide kann die Token-Nutzung deutlich steigen.

Diskussionen über DeepSeek Harness auf X (Twitter)

Entdecken Sie Diskussionen von Entwicklern und frühen Teilnehmern über DeepSeek Harness (DSH), ein quelloffenes Agenten-Framework, zu seiner „Alles ist ein Plugin“-Architektur, der kombinierbaren Laufzeitumgebung, dem Plugin-Ökosystem und praktischen Erfahrungen.