Soporte

Esta página cubre el comando acp2md support, como contactar al equipo de soporte de Climakers y como enviar solicitudes de funcionalidades.

El comando support


acp2md support [flags]

Genera un paquete de diagnostico para compartir con el equipo de soporte.

El comando support recopila información del sistema, configuración, comprobaciones diagnosticas, variables de entorno y salida reciente del log en un unico archivo. Las credenciales presentes en la configuración y en las variables de entorno se anonimizan automáticamente. El contenido del log se incluye tal cual, asi que conviene revisarlo brevemente antes de compartirlo si tu configuración de logging puede capturar datos sensibles.

Flags

Flag	Short	Predeterminado	Descripcion
`--output`	`-o`	stdout	Escribe el paquete en un archivo en lugar de stdout
`--log-file`	`-l`	desde config	Ruta del archivo de log que se incluira en el paquete
`--log-lines`		`50`	Numero de lineas recientes del log que se incluiran

Contenido del paquete

El paquete de soporte incluye las siguientes secciones:

Seccion	Contenido
System	Nombre de la app, versión, versión de Go, SO/arquitectura, commit y fecha de compilacion
Configuration	Ruta del archivo de config, dominio y tipo de Confluence, token API (anonimizado), reintentos HTTP y timeouts, nivel de log, formato de log, ruta del archivo de log
Diagnostics	Las mismas comprobaciones que `doctor`: archivo de configuración, credenciales de Confluence, conectividad API, archivo de licencia, ID de máquina, versión
Environment	Solo variables de entorno `ACP2MD_*`, con tokens y secretos anonimizados. Si no hay ninguna definida, la seccion lo indica explicitamente
Recent log	Las ultimas N lineas del archivo de log seleccionado. Si no hay archivo de log configurado, la seccion indica como habilitarlo

Ejemplo de salida

A continuacion se muestra la salida real de acp2md support, con valores sensibles anonimizados:


Support Bundle for acp2md
================================

Contact: support@climakers.com

--- System ---
App:                 acp2md
Versión:             v1.0.0
Go:                  go1.26.1
OS/Arch:             darwin/arm64
Git Commit:          4d17...ad42
Build Date:          2026-04-03T20:06:22Z

--- Configuration ---
Config File:         /Users/<user>/Library/Application Support/acp2md/config.yaml
Confluence Domain:   <tenant>.atlassian.net
Confluence Type:     cloud
API Token:           AT************************************************************3D
HTTP Max Retries:    7
HTTP Base Timeout:   10ms
HTTP Max Timeout:    100ms
Log Level:           debug
Log Format:          text
Log File:            (not set)

--- Diagnostics ---
  ✅  Configuration file       /Users/<user>/Library/Application Support/acp2md/config.yaml
  ✅  Confluence credentials   <tenant>.atlassian.net (user: <redacted>)
  ✅  Confluence API           connected (258ms)
  ✅  License file             loaded (LO*****61)
  ✅  Machine ID               e2****25
  ✅  Versión                  acp2md v1.0.0 (darwin/arm64, built 2026-04-03T20:06:22Z)

--- Environment ---
(no ACP2MD_* environment variables set)

--- Recent Log (last 50 lines) ---
(no log file configured — re-run your command with --debug --log-file app.log)

================================

To get help, email support@climakers.com with subject:
  "acp2md support — <brief description of your issue>"
and include the output above in the email body.

Los tokens API, IDs de licencia, IDs de máquina y nombres de usuario se anonimizan automáticamente en la salida. Solo se muestran los primeros y ultimos caracteres para que soporte pueda identificar la credencial sin ver el valor completo.

Ejemplos


# Imprimir el paquete por stdout
acp2md support
 
# Guardar el paquete en un archivo
acp2md support --output bundle.txt
 
# Incluir mas contexto del log
acp2md support --log-file app.log --log-lines 200

Flujo recomendado

Reproduce primero el problema con logging en modo debug y despues genera el paquete:


# 1. Reproducir el problema con debug
acp2md page convert by-id 123456 --debug --log-file app.log
 
# 2. Generar el paquete de soporte
acp2md support --log-file app.log --output bundle.txt

El paquete ya incluye información del sistema, contexto de configuración, comprobaciones tipo doctor, variables de entorno con secretos anonimizados y lineas recientes del log. Normalmente es la forma mas rápida de dar al soporte suficiente contexto sin un largo intercambio de correos.

Por que los equipos usan el comando support

Recopilar todo el contexto diagnostico en un solo paso al abrir un caso de soporte
Compartir detalles de configuración y entorno de forma segura sin exponer tokens API ni contraseñas
Incluir salida de log en modo debug junto con información del sistema y la configuración para una resolución mas rápida

Contactar con soporte

Para soporte tecnico, reportes de errores o solicitudes de funcionalidades, escribenos a support@climakers.com.

Nunca envies secretos ni contenido sensible. No compartas tokens API, contraseñas, cookies de sesion, claves de licencia, documentos privados de clientes, contenido confidencial exportado ni ningun material que no estes autorizado a divulgar. Anonimiza dominios, IDs, títulos de página, rutas de archivos, capturas de pantalla y argumentos de comandos cuando sea necesario.

Cuando contactar con soporte

La instalación, activacion o validacion falla
doctor reporta un problema de configuración, máquina o conectividad
Un comando devuelve un error inesperado o se comporta de forma incorrecta
La salida es incompleta, malformada o inconsistente con la documentación
Necesitas ayuda para entender la forma mas segura de ejecutar un flujo de trabajo
Una licencia necesita ser movida, restablecida o revisada

Que incluir en tu correo

El nombre del producto y la versión, por ejemplo acp2md v1.0.0
Tu sistema operativo y arquitectura, por ejemplo macOS arm64 o Linux amd64
El comando exacto que ejecutaste, con valores sensibles eliminados
El mensaje de error completo o el comportamiento inesperado observado
Si el problema ocurre siempre o solo en un caso especifico
La salida de doctor si es relevante y ya esta anonimizada
El paquete de soporte generado cuando este disponible
Cualquier cambio reciente que pueda importar, como una nueva máquina, nuevo token, cambio de proxy o nueva activacion de licencia

Antes de escribir

Ejecuta acp2md doctor para comprobar tu configuración.
Confirma la versión instalada con acp2md --version.
Genera un paquete de soporte con acp2md support.
Reproduce el problema con el comando seguro mas pequeno que puedas compartir.
Anonimiza secretos, URLs privadas y contenido confidencial.

Ejemplo de solicitud de soporte


Asunto: acp2md v1.0.0 - page convert falla en macOS arm64

Producto: acp2md v1.0.0
Plataforma: macOS 15, arm64
Comando: acp2md page convert by-id 123456
Problema observado: la conversion falla con error "unexpected ADF node"
Reproducible: si, siempre para esta página especifica
Salida anonimizada: <pegar error anonimizado aqui>
Cambios recientes: ninguno
Adjunto: bundle.txt (generado con acp2md support)

Solicitudes de funcionalidades

Usa la misma dirección support@climakers.com cuando quieras solicitar una nueva funcionalidad.

Cuando enviar una solicitud

El conjunto actual de comandos no cubre un flujo de trabajo real que necesitas
Un flag o formato de salida existente bloquea automatizacion o trabajo de migración
Un workaround manual repetido deberia convertirse en una funcionalidad compatible
Necesitas compatibilidad con otra plataforma, sistema o modelo operativo

Como solicitar una funcionalidad

Usa un asunto claro, por ejemplo Feature Request: acp2md export summary report.
Indica el nombre del producto y la versión que usas actualmente.
Describe el flujo de trabajo o problema de negocio, no solo el flag o la opción deseada.
Explica que haces ahora como workaround y por que es insuficiente.
Incluye un ejemplo anonimizado pequeno de la entrada, salida o flujo de comandos cuando sea útil.

Expectativas de respuesta

El equipo de soporte de Climakers revisa las solicitudes entrantes y responde lo antes posible. Pasos claros de reproduccion, salida de comandos anonimizada y detalles precisos de producto/versión reducen el intercambio de mensajes y normalmente llevan a una respuesta mas rápida.