Skip to content
Apothem
Harness-Adapter

Qwen Code

Apothem-Harness-Adapter für Qwen Code (Beta).

Anbieter: Alibaba Cloud Installationsname: qwen-code Status: Beta Native Konfiguration: ~/.qwen/

Installation

apothem install --harness qwen-code

Der Adapter schreibt die Einstellungen von Qwen Code, installiert einen QWEN.md-Kontextanker, registriert Apothem-Hook-Dispatcher, konvertiert Apothem-Commands in Markdown-Command-Dateien von Qwen, installiert Skills als SKILL.md-Verzeichnisse und passt Helferdefinitionen als Qwen-Subagenten an.

Geschriebene Dateien:

~/.qwen/settings.json
~/.qwen/QWEN.md
~/.qwen/apothem/rules/00-apothem-profile.md
~/.qwen/commands/
~/.qwen/skills/
~/.qwen/agents/
~/.qwen/.apothem/support/{rules,templates,hooks}/

Die Datei ~/.qwen/apothem/rules/00-apothem-profile.md ist das Profildokument. Es trägt Ihre Identität und Ihre Präferenzen aus dem gemeinsamen Profil.

Zuordnung von Profil zu nativer Konfiguration

Der Adapter rendert dokumentierte settings.json-Schlüssel für Kontext und Hooks, schreibt QWEN.md und verteilt Apothem-Commands, -Skills und Helferdefinitionen über die nativen Discovery-Verzeichnisse von Qwen Code. Regeln, Templates und Hook-Quellmaterial bleiben Unterstützungsmaterial unter ~/.qwen/.apothem/support/.

Kompatibilitätshinweise

~/.qwen/.apothem/support/ ist Unterstützungsmaterial, auf das QWEN.md und die Hook-Befehle in den Einstellungen verweisen; es ist kein anbietereigener Discovery-Namensraum. Der Apothem-Block in QWEN.md endet mit einem Abschnitt zu den Apothem-Unterstützungsdateien, der das absolute Verzeichnis unter ~/.qwen/.apothem/support/ nennt, gegen das jeder Verweis im Repository-Stil (rules/<name>.md, templates/..., hooks/...) aufgelöst wird.

Werkzeuglisten von Skills. Qwen Code liest die Werkzeug-Erlaubnisliste eines Skills aus dem camelCase-Frontmatter-Schlüssel allowedTools, und der Wert muss eine YAML-Liste sein. Den mit Bindestrich geschriebenen Schlüssel allowed-tools, der für andere Agenten geschrieben wird, ignoriert es. Installierte Skills tragen daher allowedTools als Liste, ein Eintrag pro Zeile, anstelle der kommagetrennten allowed-tools-Zeichenkette des Quellkorpus. Jeder Eintrag behält die Schreibweise der Quelle, einschließlich Mustern wie Bash(git status *). Jeder andere Skill-Schlüssel und der Skill-Rumpf werden unverändert installiert.

Skill-Ordner. Der Adapter schreibt Skills nach ~/.qwen/skills/. Qwen Code liest außerdem ~/.agents/skills/ und, innerhalb eines Projekts, .qwen/skills/ und .agents/skills/. Wenn zwei Ordner einen Skill mit demselben Namen enthalten, gewinnt der unter .qwen, sodass ein Apothem-Skill in ~/.qwen/skills/ Vorrang vor einem gleichnamigen Skill hat, den ein anderer Adapter nach ~/.agents/skills/ geschrieben hat.

Hook-Ereignisse. Der Adapter verdrahtet SessionStart, PreToolUse, PreCompact, PostCompact und Stop. Qwen Code definiert 22 Hook-Ereignisse, und jedes dieser fünf gehört dazu. Drei der 22 (SessionDelete, TodoCreated und TodoCompleted) haben kein gleichnamiges Claude Code-Ereignis (Claude Code nennt die Todo-Ereignisse TaskCreated und TaskCompleted); der Adapter verdrahtet keines davon.

Verifizierung

apothem verify --harness qwen-code

Der Befehl verify bestätigt Folgendes:

  1. Die native Konfiguration existiert am erwarteten Pfad.
  2. Jedes verwaltete Ziel existiert; verwaltete Dateien sind nicht leer, und JSON- oder YAML-Konfigurationen lassen sich parsen. Fügen Sie --profile PATH hinzu, um außerdem zu bestätigen, dass die installierten Dateien zu diesem Profil passen.
  3. Die adapterspezifische Verifizierungsroutine meldet Erfolg.

Aktualisierung

apothem update --harness qwen-code

Aktualisiert settings.json, QWEN.md, native Commands, Skills, Subagenten und den Apothem-Unterstützungs-Teilbaum.

Deinstallation

apothem uninstall --harness qwen-code

Entfernt die Einträge, die der Adapter zu ~/.qwen/settings.json hinzugefügt hat (Ihre eigenen Schlüssel, MCP-Server und Hook-Handler bleiben erhalten, und die Datei wird nur gelöscht, wenn Apothem sie angelegt hat und nichts von Ihnen übrig ist). Entfernt den Apothem-Block aus ~/.qwen/QWEN.md und aus dem Profildokument ~/.qwen/apothem/rules/00-apothem-profile.md und behält jeden anderen Text darin; jede dieser Dateien wird nur gelöscht, wenn darin nichts anderes mehr übrig ist. Entfernt außerdem die Apothem-Dateien in ~/.qwen/commands/, ~/.qwen/skills/, ~/.qwen/agents/ und ~/.qwen/.apothem/support/; andere Dateien in diesen Ordnern bleiben bestehen. Jede Datei wird unter ~/.apothem/backups/ gesichert, bevor sie geändert oder entfernt wird. Die YAML-Datei des gemeinsamen Profils und die Apothem-Engine bleiben unberührt.

Konformitäts-Gate

python -m apothem.conformity.gate --all .

Fehlerbehebung

SymptomBehebung
Konfigurationsdatei nicht gefundenFühren Sie apothem install --harness qwen-code erneut aus
Verifizierung fehlgeschlagenFühren Sie apothem update --harness qwen-code aus und verifizieren Sie dann erneut
Unerwarteter KonfigurationsinhaltPrüfen Sie ~/.config/apothem/profile.yaml oder --profile PATH und führen Sie dann apothem update --harness qwen-code erneut aus

Konfigurationsschalter

FlagStandardBeschreibung
--dry-runfalseVorschau der Installation, ohne Dateien zu schreiben.

Siehe auch

On this page