Plugin Qwen Live Delivery : livrez tôt, améliorez en continu avec Codex CLI
Le plugin Qwen Live Delivery est un plugin open source pour Codex CLI, développé par l'équipe Qwen, qui permet à une tâche d'agent de longue durée de livrer une première version utilisable rapidement, puis de l'améliorer version après version pendant que vous ajoutez des exigences depuis un atelier web (workbench). Il est sous licence Apache-2.0, en version 0.1.0, et fonctionne sous Linux et macOS avec Node.js 22 ou ultérieur.
Essayez Apidog dès aujourd'hui
C'est la réponse courte. Le reste de ce guide présente le contenu du plugin, son installation, le fonctionnement des budgets de temps, le paramètre de sandbox qu'il ne faut pas modifier à la légère, et comment faire en sorte que votre agent prouve chaque version livrée contre une API réelle avec Apidog CLI.
Qu'est-ce que le plugin Qwen Live Delivery ?
Le plugin Qwen Live Delivery est un module complémentaire léger pour les tâches d'agent de codage de longue durée. Plutôt que de laisser l'agent travailler pendant une heure dans une boîte noire, il impose un rythme : planifier une petite étape utilisable, la construire, la vérifier, publier une version figée, puis planifier la suivante à partir des résultats et de vos retours. Vous pouvez intervenir à tout moment.
L'équipe Qwen d'Alibaba l'a publié en même temps que la sortie générale de Qwen4-Max le 16/11/2026 ; le billet de lancement appelle ce concept « Live Delivery » : livrer une version fonctionnelle tôt, puis continuer à l'améliorer release après release pendant que l'utilisateur pilote le processus. Si vous avez besoin d'abord du contexte sur le modèle, lisez ce qu'est Qwen4-Max et comment utiliser Qwen4-Max.
L'avantage : une mauvaise direction ne coûte qu'une version, et non toute l'exécution, car un livrable utilisable reste disponible en permanence.
Ce que contient le plugin
Le dépôt Qwen-Live-Delivery-Plugin contient quatre parties qui fonctionnent ensemble :
| Composant | De quoi s'agit-il | À quoi il sert |
|---|---|---|
| Compétence Live Delivery | $ld:go |
Indique à l'agent de choisir une première version minimale utilisable, de planifier chaque version suivante à partir des résultats réels et d'exécuter des vérifications à chaque itération |
| Serveur MCP |
ld_begin, ld_publish, ld_status, ld_done
|
Gère le plan de livraison, fige les instantanés de version avec une entrée d'aperçu, signale le budget restant, conclut la tâche |
| Hooks de cycle de vie |
SessionStart, UserPromptSubmit, PostToolUse, Stop, Interrupt, SessionEnd
|
Injectent vos retours dans le contexte, bloquent les tours « j'ai fini » prématurés tant que du budget reste, prennent en charge la clôture |
| Atelier web (workbench) | Interface web locale | Affiche le plan, permet de prévisualiser et de télécharger les versions, recueille de nouvelles exigences, ajuste le budget ou arrête la tâche |
Les quatre outils MCP constituent le protocole suivi par la compétence :
-
ld_begindémarre la tâche avec l'objectif complet, un titre et une première étape. Chaque étape comporte un id, un périmètre, des critères d'acceptation et unetarget_after(heure cible) mesurée depuis le début de la tâche. -
ld_publishfige une version : les fichiers, unepreview_entryexplicite (par exemple unindex.htmlpour un site), une note de modifications et une liste dechecks. Chaque vérification comporte unelabel(étiquette), unresultparmipassed,failedounot_run, et uneevidence(preuve) facultative. -
ld_statuslit le plan, le budget restant, les retours en attente et l'état d'arrêt, ou publie un message d'activité public d'une ligne dans l'atelier. -
ld_doneclôt la tâche avec un résumé.
La compétence interdit à l'agent de marquer une vérification échouée ou non exécutée comme réussie. L'hôte vérifie les copies d'instantanés et les empreintes, mais les résultats d'acceptation restent déclarés par l'agent lui-même. Nous comblerons cette lacune plus tard avec un test sur une API réelle.
Les hooks servent de volant de direction. Pour une tâche démarrée depuis le navigateur, l'hôte interrompt l'agent et reprend le même thread Codex afin que votre message arrive via UserPromptSubmit. Pour une tâche démarrée en CLI, les retours arrivent au prochain outil pris en charge ou à la frontière du tour suivant.
Comment Live Delivery exécute une tâche longue
Voici la boucle, dans l'ordre :
- Vous tapez une requête
$ld:goavec le résultat souhaité. - L'agent appelle
ld_beginavec l'objectif complet et une première étape. Pas d'étape d'approbation de plan séparée. - Il construit l'étape et exécute les vérifications d'acceptation de cette étape.
- Il appelle
ld_publish, qui fige la version 1 avec ses fichiers et son entrée d'aperçu. - Vous ouvrez l'atelier, essayez la version et tapez vos modifications dans le panneau de gauche.
- L'agent replanifie : il compare la livraison à l'objectif complet, intègre vos retours et appelle
ld_beginavec l'étape suivante. - Les étapes 3 à 6 se répètent jusqu'à épuisement du budget ou jusqu'à ce que vous cliquiez sur Stop task. L'agent publie alors toute amélioration prête et appelle
ld_done.
Deux règles se détachent. Il n'y a pas de nombre de versions fixé à l'avance : l'agent décide du périmètre à chaque tour selon la valeur apportée. Et la fin des étapes planifiées ne met pas fin à la tâche tant qu'il reste du temps autorisé : l'agent continue de chercher la prochaine amélioration utile.
Comment installer le plugin Qwen Live Delivery
Vérifiez d'abord les prérequis :
- Codex CLI (seul harness pris en charge au lancement ; testé avec Codex 0.166.0 et 0.167.1)
- Linux ou macOS
- Node.js 22 ou ultérieur
Le plugin n'embarque ni modèle ni clé API. Il utilise le modèle Codex, l'authentification et les paramètres d'approbation que vous avez déjà. Consultez la documentation de Codex CLI d'OpenAI si vous n'avez pas encore configuré Codex.
Clonez le dépôt et lancez l'installateur sur votre projet :
git clone https://github.com/QwenLM/Qwen-Live-Delivery-Plugin.git
cd Qwen-Live-Delivery-Plugin
./live-delivery/install.sh --workspace /path/to/project
Appuyez sur Entrée et le plugin s'installe, les hooks sont configurés et Codex s'ouvre. La version livrée ne nécessite pas de npm install. Si Codex était déjà ouvert, démarrez une nouvelle session.
Options utiles de l'installateur :
-
--install-onlyinstalle sans ouvrir Codex -
--doctorvérifie une installation existante
Vous pouvez aussi demander à Codex de lire le README et de suivre sa compétence d'installation ; après l'installation, $ld:install prend en charge la configuration et le diagnostic. Pour désinstaller, exécutez codex plugin remove ld@live-delivery-local --json puis codex plugin marketplace remove live-delivery-local --json. Vos workspaces et vos enregistrements de livraison sont conservés.
Prise en main : votre première tâche pilotable
Démarrez Codex dans votre projet avec un budget de temps :
cd /path/to/project
QWEN_LD_TIME_BUDGET=12m codex
Tapez ensuite la requête. L'exemple du README :
$ld:go Build an offline pendulum experiment. Let me adjust the length, pause the
animation, and understand how length affects the period. Make it work on mobile too.
La CLI affiche une URL d'atelier. Ouvrez-la. Ce lien donne accès à l'atelier : traitez-le comme un mot de passe et ne le collez pas dans des tickets ou des discussions. Après un redémarrage, utilisez le dernier lien affiché par la CLI.
Dans l'atelier :
- Après la première livraison, sélectionnez une version à droite et ouvrez Files pour prévisualiser ou télécharger les fichiers individuellement.
- Ajoutez des exigences à gauche. Entrée envoie le message ; Maj+Entrée ajoute un retour à la ligne.
- Utilisez Time budget dans l'en-tête pour modifier le temps total, ou Stop task pour terminer.
Budgets de temps, sandbox et autres paramètres
Le budget de temps est la durée totale d'exécution que l'agent peut utiliser. Définissez-le avec QWEN_LD_TIME_BUDGET avant de démarrer Codex, ou modifiez-le plus tard dans l'en-tête de l'atelier. Les valeurs à connaître :
| Paramètre | Valeur |
|---|---|
| Budget par défaut (variable non définie) | 30 minutes (1 800 secondes dans la configuration du plugin) |
| Unités acceptées | minutes, heures ou jours, par exemple 15m, 3h, 2d
|
| Maximum | 7 jours |
| Qui peut l'augmenter | Vous uniquement ; les outils du modèle ne peuvent pas relever la limite autorisée |
| Comportement à l'arrêt | Attend la fin de l'appel d'outil en cours |
Venons-en à l'avertissement. Les tâches démarrées depuis le navigateur utilisent par défaut la sandbox workspace-write de Codex. Définir QWEN_LD_TASK_SANDBOX=danger-full-access désactive la sandbox et l'approbation par commande, permettant à l'agent de toucher tout ce qui se trouve hors du workspace avec les permissions de votre compte système. L'installateur ne l'active jamais pour vous. Gardez le réglage par défaut, sauf si vous exécutez le tout dans une VM ou un conteneur jetable.
Utilisez l'atelier sur un réseau de confiance. Pour un accès strictement local ou une redirection de port SSH, définissez QWEN_LD_BIND_HOST=127.0.0.1 avant de démarrer Codex.
Limites à connaître avant d'en dépendre
C'est une version 0.1.0, et le README est transparent sur son périmètre :
- Codex CLI uniquement. La prise en charge d'autres harness d'agent figure sur la liste à faire, sans date.
- Linux et macOS uniquement. Aucune mention de Windows.
- Votre modèle, votre quota. Le plugin utilise le modèle configuré dans Codex. Un budget de sept jours sur un modèle de pointe coûte réellement de l'argent : consultez les tarifs de Qwen4-Max ou le Qwen4-Max Token Plan si c'est le modèle derrière votre harness, ou Qwen4-Max gratuitement pour les pistes de quota.
- Les vérifications sont autodéclarées. L'hôte vérifie les instantanés de fichiers, pas le fait que vos critères d'acceptation passent réellement.
- Les tâches CLI reçoivent les retours plus tard. Les tâches démarrées en CLI ne voient les retours du navigateur qu'aux frontières d'outil ou de tour.
Faites prouver chaque version livrée avec Apidog CLI
Live Delivery demande des vérifications sincères à chaque version, mais une vérification du type « l'API fonctionne » ne vaut que le test qui la sous-tend. Si votre agent construit une API, ou une application qui en appelle une, comme l'API Qwen4-Max, faites-lui exécuter un test réel avec Apidog CLI avant chaque ld_publish et coller le résultat comme preuve.
Configurez-le une seule fois :
npm install -g apidog-cli@latest
apidog login --with-token <YOUR_TOKEN>
npx -y skills add https://apidog.com # pick Codex when prompted
Ajoutez ensuite une consigne à la requête $ld:go, ou envoyez-la depuis l'atelier en cours de tâche :
Before every ld_publish: in Apidog project <projectId>, keep an environment
"Qwen Singapore" with base URL https://ap-southeast-1.maas.qwencloudapi.com/compatible-mode/v1
and a secret DASHSCOPE_API_KEY. Keep a test case for POST /chat/completions with
model qwen4-max that asserts status 200, a non-empty choices array and a usage object.
Run it, and turn each assertion into an ld_publish check with the report as evidence.
Never mark a failed assertion passed.
L'agent lit chaque schéma de payload avant d'écrire, puis exécute le cas de test à chaque version :
apidog environment create "Qwen Singapore" --project <projectId> --base-url https://ap-southeast-1.maas.qwencloudapi.com/compatible-mode/v1
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project <projectId> --file case.json
apidog run --test-case <caseId> --project <projectId> -e <envId> -r cli,json --out-dir ld-reports
Le rapporteur cli affiche réussite ou échec dans le journal ; json écrit un rapport dans ld-reports que l'agent cite dans l'evidence de chaque vérification. Si c'est votre propre API qui est en cours de construction, remplacez le point de terminaison par le vôtre et ajoutez à chaque tour les nouvelles routes de la version au cas de test. Ajoutez --upload-report pour consulter les exécutions dans l'application Apidog. Pour plus de prompts Codex, voir Apidog CLI dans Codex, et déplacez le même apidog run ... -r junit vers votre CI avec le guide CI/CD d'Apidog CLI. Le plan gratuit d'Apidog couvre jusqu'à 4 utilisateurs.
FAQ
Le plugin Qwen Live Delivery fonctionne-t-il avec Claude Code ou Cursor ? Pas encore. Au lancement, il ne prend en charge que Codex CLI. Les autres harness figurent sur la liste à faire du projet, sans date.
Ai-je besoin d'une clé API Qwen pour l'utiliser ? Non. Le plugin n'inclut ni modèle ni clé. Il s'appuie sur le modèle et l'authentification que votre installation Codex utilise déjà.
Quel est le budget de temps par défaut ? 30 minutes si vous ne définissez pas QWEN_LD_TIME_BUDGET. Vous pouvez définir des minutes, des heures ou des jours, jusqu'à 7 jours, et le modifier depuis l'en-tête de l'atelier.
Que se passe-t-il quand je clique sur Stop task ? L'agent termine l'appel d'outil en cours, ne démarre aucun nouveau périmètre, publie toute amélioration prête dont les vérifications passent et appelle ld_done. Chaque version livrée reste disponible.
Est-il sûr de l'exécuter avec un accès complet ? Uniquement dans un environnement jetable. danger-full-access supprime la sandbox et l'approbation par commande. L'installateur ne l'active jamais, et la sandbox par défaut workspace-write est le choix raisonnable pour la plupart des travaux.



Top comments (0)