Skip to content
Apothem
Adaptadores de entorno

Qwen Code

Adaptador de entorno de Apothem para Qwen Code (Beta).

Proveedor: Alibaba Cloud Nombre de instalación: qwen-code Estado: Beta Configuración nativa: ~/.qwen/

Instalación

apothem install --harness qwen-code

El adaptador escribe los ajustes de Qwen Code, instala un ancla de contexto QWEN.md, registra los despachadores de hooks de Apothem, convierte los comandos de Apothem en archivos de comando Markdown de Qwen, instala las skills como directorios SKILL.md y adapta las definiciones de ayudantes como subagentes de Qwen.

Archivos escritos:

~/.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}/

El archivo ~/.qwen/apothem/rules/00-apothem-profile.md es el documento de perfil. Lleva tu identidad y tus preferencias del perfil compartido.

Asignación del perfil a la configuración nativa

El adaptador renderiza las claves documentadas de settings.json para el contexto y los hooks, escribe QWEN.md y distribuye los comandos, las skills y las definiciones de ayudantes de Apothem por los directorios de descubrimiento nativos de Qwen Code. Las reglas, las plantillas y el material fuente de los hooks siguen siendo material de soporte bajo ~/.qwen/.apothem/support/.

Notas de compatibilidad

~/.qwen/.apothem/support/ es material de soporte al que hacen referencia QWEN.md y los comandos de hook de los ajustes; no es un espacio de nombres de descubrimiento propiedad del proveedor. El bloque de Apothem en QWEN.md termina con una sección de archivos de soporte de Apothem que nombra el directorio absoluto bajo ~/.qwen/.apothem/support/ contra el que se resuelve cada cita con estilo de repositorio (rules/<name>.md, templates/..., hooks/...).

Listas de herramientas de las skills. Qwen Code lee la lista de herramientas permitidas de una skill desde la clave de frontmatter en camelCase allowedTools, y el valor debe ser una lista YAML. Ignora la clave con guion allowed-tools escrita para otros agentes. Por eso las skills instaladas llevan allowedTools como una lista, una entrada por línea, en lugar de la cadena allowed-tools separada por comas del corpus fuente. Cada entrada conserva la grafía de la fuente, incluidos patrones como Bash(git status *). Todas las demás claves de la skill, y el cuerpo de la skill, se instalan sin cambios.

Carpetas de skills. El adaptador escribe las skills en ~/.qwen/skills/. Qwen Code también lee ~/.agents/skills/ y, dentro de un proyecto, .qwen/skills/ y .agents/skills/. Cuando dos carpetas contienen una skill con el mismo nombre, gana la que está bajo .qwen, así que una skill de Apothem en ~/.qwen/skills/ tiene prioridad sobre una skill del mismo nombre que otro adaptador escribió en ~/.agents/skills/.

Eventos de hook. El adaptador conecta SessionStart, PreToolUse, PreCompact, PostCompact y Stop. Qwen Code define 22 eventos de hook y cada uno de estos cinco es uno de ellos. Tres de los 22 (SessionDelete, TodoCreated y TodoCompleted) no tienen ningún evento de Claude Code con el mismo nombre (Claude Code llama a los eventos de tareas TaskCreated y TaskCompleted); el adaptador no conecta ninguno de ellos.

Verificación

apothem verify --harness qwen-code

El comando verify confirma que:

  1. La configuración nativa existe en la ruta esperada.
  2. Cada destino gestionado existe; los archivos gestionados no están vacíos y las configuraciones JSON o YAML se analizan correctamente. Añade --profile PATH para confirmar también que los archivos instalados coinciden con ese perfil.
  3. La rutina de verificación específica del adaptador informa de éxito.

Actualización

apothem update --harness qwen-code

Refresca settings.json, QWEN.md, los comandos nativos, las skills, los subagentes y el árbol de soporte de Apothem.

Desinstalación

apothem uninstall --harness qwen-code

Elimina las entradas que el adaptador agregó a ~/.qwen/settings.json (tus propias claves, servidores MCP y controladores de hook permanecen, y el archivo se elimina solo cuando Apothem lo creó y no queda nada tuyo). Elimina el bloque de Apothem de ~/.qwen/QWEN.md y del documento de perfil ~/.qwen/apothem/rules/00-apothem-profile.md y conserva cualquier otro texto que contengan; cada archivo se elimina solo cuando no queda nada más en él. También elimina los archivos de Apothem en ~/.qwen/commands/, ~/.qwen/skills/, ~/.qwen/agents/ y ~/.qwen/.apothem/support/; los demás archivos de esas carpetas permanecen. Cada archivo se respalda bajo ~/.apothem/backups/ antes de modificarse o eliminarse. El YAML del perfil compartido y el motor de Apothem no se ven afectados.

Puerta de conformidad

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

Solución de problemas

SíntomaSolución
No se encuentra el archivo de configuraciónVuelve a ejecutar apothem install --harness qwen-code
La verificación fallóEjecuta apothem update --harness qwen-code y luego verifica de nuevo
Contenido de configuración inesperadoRevisa ~/.config/apothem/profile.yaml o --profile PATH y luego vuelve a ejecutar apothem update --harness qwen-code

Opciones de configuración

IndicadorPredeterminadoDescripción
--dry-runfalsePrevisualiza la instalación sin escribir archivos.

Véase también

On this page