doc-operacion-MarkeUp

Tabla de Contenidos 20 secciones

Orden de lectura recomendado: doc-readme → doc-guia → doc-arquitectura → doc-operacion → doc-auditoria

Hermes Agent es el asistente IA que gestiona el vault. Corre sobre Ollama (modelo qwen2.5-coder:7b-64k). El sistema de reglas y skills vive en src/content/posts/hermes/.

# Iniciar Hermes (requiere Ollama corriendo)
hermes chat

# Estado del sistema
hermes status

Comando	Skill usado	Resultado
`Crea un post sobre [tema] en [categoría]`	`crear-post.md`	Post nuevo con frontmatter 21 campos + wikilinks
`Amplía [slug] con [tema]`	`ampliar-post.md`	Sección nueva en nota existente
`Revisa los wikilinks de [slug]`	`generar-wikilinks.md`	Escanea y enriquece enlaces `[[slug
`Audita el vault`	`auditar-vault.md`	Informe de salud con huérfanos y recomendaciones
`Revisa la documentación`	`documentar.md`	Verifica que los 5 docs reflejen la realidad
`¿Qué posts debería crear?`	—	Consulta `memory/backlog.md` (22 ideas priorizadas)

Error	Causa	Solución
Hermes no responde	Ollama no está corriendo	`ollama serve` o `brew services start ollama`
`model not found`	Modelo no descargado	`ollama pull qwen2.5-coder:7b-64k`
Error `Connection refused`	Ollama en otro puerto	Verificar `~/.hermes/config.yaml`: `base_url: http://127.0.0.1:11434/v1`
Hermes lento	Modelo pesado para el hardware	Cerrar otras apps. `ollama ps` para ver uso

npm run dev            # Servidor local en localhost:4321 con hot reload
npm run dev -- --host  # Servidor accesible desde otros dispositivos en la red
npm run preview        # Previsualiza el build de producción localmente
npm test               # Ejecuta tests unitarios (Vitest, 6 tests)
npm run test:watch     # Tests en modo watch (re-ejecuta al guardar)

npm run build          # Build completo: images + astro + pagefind
npm run build:astro    # Solo build de Astro (HTML estático)
npm run build:search   # Solo regenerar índice Pagefind

El build completo genera 192 páginas HTML en dist/. Tiempo típico: ~4.5s en local.

npm run images         # Procesa imágenes: crop 1920×1080 + variantes responsivas + WebP
npm run images:watch   # Modo vigilancia continua
npm run images -- --force  # Reprocesa todas (ignora caché)

npm run compress-audio            # Comprime audios >10MB (límite Cloudflare Pages)
npm run compress-audio:watch      # Modo vigilancia
npm run compress-audio:force      # Recomprime todos

Script	Propósito
`process-images.js`	Crop 1920×1080 + variantes WebP (640w/1024w/1280w)
`optimize-images.js`	Conversión batch a WebP
`sync-images.js`	Sincronizar src/content/img ↔ public/img
`compress-audio.js`	Compresión ffmpeg (límite 10MB Cloudflare)
`export-blog.js`	Exportar posts por categoría
`dev-search.js`	Índice Pagefind para desarrollo
`generar_articulo.py`	Posts automáticos desde URLs con Ollama

# Con URL como argumento
uv run python src/generar_articulo.py "https://es.wikipedia.org/wiki/Inteligencia_artificial"

# Modo interactivo
uv run python src/generar_articulo.py

Parámetro	Valor
`model`	`qwen2.5-coder:7b-64k`
`num_ctx`	`65536`
`temperature`	`0.7`
`timeout`	`600s` (10 min)

Escribir/editar en Obsidian o generar con generar_articulo.py
Syncthing sincroniza al Mac
Si hay imágenes nuevas: npm run images
Verificar: npm run build (debe dar 0 errores)
Publicar: git add . && git commit -m "mensaje" && git push origin main
GitHub Actions → Cloudflare Pages

Error	Causa probable	Solución
`ZodError` en frontmatter	Campo inválido o faltante	Revisar schema en `content.config.ts`
`Cannot find module`	Dependencia no instalada	`npm ci`
`ENOENT` en imagen	Imagen referenciada no existe	Verificar `public/img/`
Error en wikilink	Slug inexistente	Corregir enlace o crear el post destino

curl http://localhost:11434/api/tags   # ¿Responde?
ollama list                              # Modelos instalados
ollama ps                                # Modelos en ejecución
ollama logs                              # Logs recientes

Servicio	Función	Estado
`com.markeup.process-images`	Procesa imágenes al detectar cambios	✅ Activo
`com.user.watchexec`	Auto-commit al detectar cambios	❌ Descargado

launchctl load ~/Library/LaunchAgents/com.markeup.process-images.plist
launchctl unload ~/Library/LaunchAgents/com.markeup.process-images.plist
launchctl list | grep markeup

Variable	Uso	Dónde se configura
`ADMIN_PASSWORD`	Hash de contraseña del panel admin	GitHub Secrets
`JWT_SECRET`	Clave para firmar tokens JWT	GitHub Secrets

Documento	Contenido
doc-readme	Visión general y stack
doc-guia	Instalación y configuración
doc-arquitectura	Arquitectura y componentes
doc-auditoria	Auditoría y deuda técnica

1  PROCESOS
├── 1.1 PROCESOS OLLAMA         (iniciar, cambiar modelo, estado, detener)
├── 1.2 PROCESOS TELEGRAM       (iniciar/detener bot)
├── 1.3 PROCESOS HERMES         (lanzar, reanudar, cambiar modelo)
└── 1.4 ARRANCAR Ollama + Telegram

2  VAULT → 2.1 ANÁLISIS DEL VAULT (auditar, huérfanos, stats, docs...)

3  CONTENIDO DEL VAULT          (crear, generar artículo, ampliar, wikilinks...)

4  BUILD & ASSETS
├── 4.1 PROCESAR IMÁGENES Y AUDIOS
├── 4.2 BUILD (completo, preview, pagefind)
├── 4.3 DEV SERVER (local, network)
└── 4.4 NPM (8 comandos útiles)

5  GIT
├── 5.1 Ramas (creación y cambio)
├── 5.2 Ramas (limpieza y fusión)
├── 5.3 Estado y preparación
├── 5.4 Commits y deshacer
├── 5.5 Stash
└── 5.6 Remoto

6  CLOUDFLARE
├── 6.1 Autenticación y proyectos
└── 6.2 Despliegues (preview, producción, rama)

7  MANTENIMIENTO                (renombrar, mover, limpiar, exportar, docs)

8  STATUS                       (posts, git, build, Ollama, assets)

Comando	Acción	Equivalente en menú
`npm run tools`	Menú interactivo completo	—
`npm run tools:crear`	Crear post directamente	3.1
`npm run tools:auditar`	Auditar vault directamente	2.1.1
`npm run tools:stats`	Dashboard stats	2.1.3
`npm run tools:hermes`	Iniciar Hermes Agent	1.3.1
`npm run tools:ollama`	Estado Ollama (JSON)	1.1.3
`npm run tools:telegram`	Iniciar bot Telegram	1.2.1

doc-operacion-MarkeUp

Posts que enlazan a este artículo