---
title: "Usar paquetes de forma segura | StudioMeyer Academy"
description: "Aprobación, hashes, planes de instalación y actualizaciones que protegen tu trabajo."
canonical: "https://studiomeyer.academy/es/entwickler/paketformat"
language: es
markdown_versions: ["https://studiomeyer.academy/entwickler/paketformat.md", "https://studiomeyer.academy/en/entwickler/paketformat.md", "https://studiomeyer.academy/es/entwickler/paketformat.md"]
publisher: "StudioMeyer Academy, https://studiomeyer.academy (llms.txt: https://studiomeyer.academy/llms.txt)"
---

## Aprobación antes de los archivos

El catálogo público de paquetes de instalación aprobados está vacío. Una biblioteca privada no es una fuente pública de paquetes. No se debe suponer una licencia. Sin un paquete aprobado expresamente no hay nada que instalar.

El mecanismo devuelve un plan de instalación JSON, no una instalación ejecutada. GET /v1/me/installs lista planes registrados y no confirma archivos instalados en tu dispositivo. El servidor no puede ver tu sistema de archivos.

## Respuesta y archivo de bloqueo

La respuesta real contiene status: plan, files y lockfile. Cada archivo lleva relativePath, content, sha256 y executable. El archivo de bloqueo contiene schemaVersion: 1 y entries. Cada entrada tiene id, version, status, access, sha256, license, source e installedAt. access es free o premium; installedAt puede ser null. El esquema JSON es la referencia, no un borrador YAML anterior.

```
{
  "status": "plan",
  "files": [],
  "lockfile": {
    "schemaVersion": 1,
    "entries": []
  }
}
```

- [JSON Schema](https://studiomeyer.academy/v1/schema/package.json)

## Estado y consentimiento

Solo active puede entrar automáticamente en un plan autorizado. candidate exige consentCandidate: true; draft exige consentDraft: true y debe seguir identificado como borrador. deprecated no se instala e indica un sucesor. Los scripts ejecutables necesitan consentScripts: true por separado tras revisarlos. Prémium requiere el acceso adquirido correspondiente; el archivo de bloqueo no concede acceso por sí mismo.

## Observar archivos antes de sustituirlos

Envía lockfile y observedFiles con entradas { id, relativePath, sha256: string | null } al comprobar actualizaciones. Usa el SHA-256 real de cada archivo existente y null si falta. El servicio compara las observaciones con copias históricas aprobadas de los archivos; un hash del archivo de bloqueo no basta.

Solo archivos observados por completo y sin cambios producen localChanges: false y verification: unchanged. Las diferencias reales producen true/modified; observaciones incompletas, null/unverified. modified y unverified bloquean la sustitución. Muestra el conflicto y pide una decisión separada. Vuelve a comprobar rutas y hashes justo antes de escribir localmente, incluso tras recibir unchanged.

## Sitemap

Páginas públicas de este sitio como Markdown: [sitemap](https://studiomeyer.academy/sitemap.md). Punto de entrada curado: [llms.txt](https://studiomeyer.academy/llms.txt), texto completo: [llms-full.txt](https://studiomeyer.academy/llms-full.txt).