feat(wordpress): nova skill mcp-webp-express + doc MCP webpx na skill webp-express
Skill mcp-webp-express: MCP dedicado (webpx) para WebP Express multi-site via WP-CLI/SSH, mesmo padrao mcp-wpfc. webp-express/SKILL.md: nova seccao 14 documentando o MCP construido e testado ao vivo em emanuelalmeida.pt.
This commit is contained in:
Claude Code
@@ -1,6 +1,6 @@
|
||||
---
|
||||
name: webp-express
|
||||
description: Gestão do plugin WebP Express (conversão automática de imagens para WebP) via WP-CLI e ficheiro de config em servidores CWP. Cobre localizar o ficheiro de config com hash variável, modos de operação (CDN friendly, Varied image responses, No conversion, Tweaked), reconversão em massa via `wp webp-express convert`, flush de webps, conversores disponíveis (imagemagick/imagick/gd vs cwebp/vips/ffmpeg/graphicsmagick/wpc/ewww) e as respectivas opções próprias, estrutura JSON completa do ficheiro de configuração (qualidade/encoding/near-lossless/alpha-quality por tipo de imagem, cache-control, alter HTML, redirection rules, web service), regras `.htaccess` e a fronteira com o Cloudflare. Usar quando "webp express", "converter imagens webp", "webp nao funciona", "reconverter imagens", "flush webp", "conversor imagemagick gd", "operation mode webp", "cdn friendly webp", "webp quality", "near lossless", "alter html webp", "cache control webp", "web service webp express".
|
||||
description: Gestão do plugin WebP Express (conversão automática de imagens para WebP) via WP-CLI e ficheiro de config em servidores CWP. Cobre localizar o ficheiro de config com hash variável, modos de operação (CDN friendly, Varied image responses, No conversion, Tweaked), reconversão em massa via `wp webp-express convert`, flush de webps, conversores disponíveis (imagemagick/imagick/gd vs cwebp/vips/ffmpeg/graphicsmagick/wpc/ewww) e as respectivas opções próprias, estrutura JSON completa do ficheiro de configuração (qualidade/encoding/near-lossless/alpha-quality por tipo de imagem, cache-control, alter HTML, redirection rules, web service), regras `.htaccess`, a fronteira com o Cloudflare, e o MCP `webpx` construído para gestão programática multi-site (§14). Usar quando "webp express", "converter imagens webp", "webp nao funciona", "reconverter imagens", "flush webp", "conversor imagemagick gd", "operation mode webp", "cdn friendly webp", "webp quality", "near lossless", "alter html webp", "cache control webp", "web service webp express", "mcp webp express", "webpx".
|
||||
---
|
||||
|
||||
# /webp-express — Conversão de imagens para WebP via WP-CLI
|
||||
@@ -621,6 +621,59 @@ ratio alto no cache do Cloudflare independentemente do plano.
|
||||
|
||||
---
|
||||
|
||||
## 14. MCP `webpx` — gestão programática (construído 19-08-2026)
|
||||
|
||||
Existe um MCP dedicado (`mcp-webp-express`, registado como `webpx` em
|
||||
`~/.omp/agent/mcp.json`) que expõe as operações deste documento como tools,
|
||||
multi-site (todos os 8 aliases do bundle Descomplicar, mesmo padrão do
|
||||
`wpfc`/`mcp-element-pack`): `spawn("ssh", ...)`, valor em base64 sobre
|
||||
stdin, sem ledger/rollback (fora do âmbito — ver `emcp-tools` para mudanças
|
||||
que precisem disso).
|
||||
|
||||
**Diferença chave vs os outros MCPs da frota:** a config deste plugin vive
|
||||
num ficheiro com hash no nome (§1), não numa `wp_option` — o MCP resolve o
|
||||
hash via `webp-express-config-hash` em cada chamada (nunca hardcoded) e
|
||||
preserva owner:group:permissões do ficheiro ao escrever (a ligação SSH
|
||||
corre como root; sem isto o wp-admin do site deixaria de conseguir gravar
|
||||
as próprias definições). `webp-express-state` também exigiu tratamento
|
||||
especial: o plugin grava-a como STRING JSON, não como array — um
|
||||
`--format=json` ingénuo devolve JSON duas vezes codificado.
|
||||
|
||||
### Tools (9)
|
||||
|
||||
- `webpx_list_sites` — sites conhecidos.
|
||||
- `webpx_get_status` / `webpx_get_state` — plugin instalado/activo/versão +
|
||||
`webp-express-state` (workingConverterIds, configured, htaccess-rules-
|
||||
saved-at-some-point).
|
||||
- `webpx_get_config` / `webpx_set_config` — ficheiro `config.<hash>.json`
|
||||
completo (§6).
|
||||
- `webpx_get_converters` / `webpx_set_converter_options` — stack de
|
||||
conversores (§4), opções por conversor + reordenação.
|
||||
- `webpx_convert` — `wp webp-express convert` (§3).
|
||||
- `webpx_flushwebp` — `wp webp-express flushwebp` (§3).
|
||||
|
||||
### Guarda-corpos
|
||||
|
||||
- `webpx_set_config` recusa gravar as chaves de diagnóstico só-leitura de
|
||||
§6 (`environment-when-config-was-saved`,
|
||||
`base-htaccess-on-these-capability-tests`, `document-root`,
|
||||
`paths-used-in-htaccess`).
|
||||
- `webpx_set_config` devolve um aviso explícito quando a chave alterada só
|
||||
tem efeito via `.htaccess` (operation-mode, scope, image-types,
|
||||
destination-*, redirection rules) — regenerar essas regras continua a
|
||||
exigir abrir wp-admin → Save uma vez (§12), sem equivalente WP-CLI.
|
||||
|
||||
**Testado ao vivo em `emanuelalmeida.pt` (19-08-2026):** leitura completa
|
||||
da config, escrita+leitura de volta com `enable-logging` (revertido),
|
||||
escrita+leitura de volta de `gd.skip-pngs` via `webpx_set_converter_options`
|
||||
(revertido), bloqueio confirmado ao tentar gravar `document-root`, `convert`
|
||||
em modo preview (0 ficheiros por converter, config já estável). Owner:group
|
||||
do ficheiro de config confirmado `ealmeida:ealmeida 644` antes e depois da
|
||||
escrita. `webpx_flushwebp` e `convert` com `location`/`reconvert` reais não
|
||||
foram exercidos contra produção (mesmo padrão de comando já validado via
|
||||
`convert` em dry-run — risco desnecessário para a validação).
|
||||
|
||||
|
||||
## Erros comuns
|
||||
|
||||
| Sintoma | Causa | Solução |
|
||||
|
||||
Reference in New Issue
Block a user