Unified AI Gateway

Visão Geral

Use o servidor MCP oficial unified-ai-system para inspecionar e operar um gateway de IA local sem credenciais de provedor. Este arquivo de skill fornece orientação operacional; ele não instala o servidor nem altera a configuração do Codex por si só. O plugin Codex oficial agrupa a definição do MCP, enquanto instalações apenas de skill exigem a configuração manual abaixo.

Nota de Versão

Estas são duas coisas diferentes e não são iguais hoje:

• Versão atual: v0.8.0. Ela declara e envia quinze nomes de ferramentas, e o comando de demonstração de 60 segundos no README nomeia essa versão. Leia-a ao vivo com node tools/verify-image-roster.mjs 0.8.0, que relata a lista a partir dos bytes da imagem em vez deste arquivo.
• Revisado e fixado abaixo: 0.4.9. O procedimento de inspeção neste arquivo fixa os digests registrados da imagem porque 0.4.9 é a versão mais recente com uma revisão de conteúdo concluída. Ela carrega 9 dos quinze nomes: as ferramentas de aprimoramento baseado em modelo, recuperação de conhecimento e execução de fluxo de trabalho chegaram em 0.5.0, e as três ferramentas de governança em 0.8.0.

Não substitua uma tag mutável por um digest fixado, e não mova a fixação para uma versão mais nova apenas porque este arquivo parece desatualizado: uma nova revisão de conteúdo é necessária primeiro, e a identidade fixada é tão boa quanto a revisão que a suporta.

Pré-requisitos e Configuração

1. Confirme que o Codex CLI e o Docker estão instalados e que o Docker está em execução.
2. Se as nove ferramentas já estiverem visíveis, pule a configuração e não registre um servidor duplicado.
3. Explique a primeira etapa: ela baixa uma plataforma revisada do índice de plataformas múltiplas imutável 0.4.9 para o cache do Docker, inspeciona seus metadados e histórico de camadas, cria, mas nunca inicia, um contêiner temporário, exporta seu sistema de arquivos raiz, remove esse contêiner temporário e grava um inventário de inspeção em um diretório temporário. As plataformas revisadas são linux/amd64 e linux/arm64. Obtenha aprovação explícita do usuário apenas para essas alterações de download e inspeção.
4. Após essa primeira aprovação, puxe o manifesto da plataforma revisada e complete a inspeção. Não execute a imagem nem a registre ainda:

IMAGE='ghcr.io/happy520ai/unified-ai-system/mcp-server@sha256:751a0d32acd2d6b1da6ad9ac67987fbd1ff36ce26b7160014d8605f18b7907b3'
PLATFORM='linux/amd64' # Use linux/arm64 apenas em um motor ARM64 revisado.
REVIEW_DIR="$(mktemp -d)"

docker pull --platform "$PLATFORM" "$IMAGE"
docker image inspect "$IMAGE" --format 'Id={{.Id}} OS={{.Os}} Architecture={{.Architecture}} User={{json .Config.User}} Entrypoint={{json .Config.Entrypoint}} Cmd={{json .Config.Cmd}} Labels={{json .Config.Labels}}'
docker image history --no-trunc "$IMAGE" > "$REVIEW_DIR/image-history.txt"

REVIEW_CONTAINER="$(docker create --platform "$PLATFORM" --pull never --entrypoint /bin/true "$IMAGE")"
docker export --output "$REVIEW_DIR/rootfs.tar" "$REVIEW_CONTAINER"
docker rm "$REVIEW_CONTAINER"

tar -tf "$REVIEW_DIR/rootfs.tar" > "$REVIEW_DIR/rootfs-files.txt"
mkdir -p "$REVIEW_DIR/rootfs"
tar --same-permissions -xf "$REVIEW_DIR/rootfs.tar" -C "$REVIEW_DIR/rootfs"
find "$REVIEW_DIR/rootfs/app" -type f -print > "$REVIEW_DIR/app-files.txt"
: > "$REVIEW_DIR/app-links.txt"
while IFS= read -r -d '' APP_LINK; do
  ls -ld -- "$APP_LINK" >> "$REVIEW_DIR/app-links.txt"
done < <(find "$REVIEW_DIR/rootfs/app" \( -type l -o -type f -links +1 \) -print0)
: > "$REVIEW_DIR/native-binaries.sha256"
while IFS= read -r -d '' NATIVE_BINARY; do
  sha256sum -- "$NATIVE_BINARY" >> "$REVIEW_DIR/native-binaries.sha256"
done < <(find "$REVIEW_DIR/rootfs/app" -type f -name '*.node' -print0)
find "$REVIEW_DIR/rootfs" -type f \( -perm -0100 -o -perm -0010 -o -perm -0001 \) -print > "$REVIEW_DIR/executable-files.txt"
find "$REVIEW_DIR/rootfs" -type f \( -perm -4000 -o -perm -2000 \) -print > "$REVIEW_DIR/suid-sgid-files.txt"
find "$REVIEW_DIR/rootfs/app" -type f \( -name '.env' -o -name '.env.*' -o -name '*.pem' -o -name '*.key' -o -name '*.p12' -o -name '*.pfx' -o -path '*/.ssh/id_*' \) -print > "$REVIEW_DIR/credential-like-files.txt"
find "$REVIEW_DIR/rootfs/app" -type f -name 'package.json' \
  -exec grep -nHE '"(preinstall|install|postinstall|prepare|prepack|postpack)"' -- {} + \

…