AI Disk Doctor Integraciones

Agent Skill local universal y servidor MCP de solo lectura para AI Disk Doctor Core.

Este repositorio es una capa de integración y distribución. No implementa un segundo escáner, limpiador, motor de riesgos, modelo de recuperación ni sistema de políticas. El Core local sigue siendo la fuente de ejecución y de políticas.

Alcance Alpha

El servidor MCP expone cuatro herramientas:

I0 no expone ninguna herramienta de clean, restore, quarantine, delete, shell arbitrario o mutación arbitraria del sistema de archivos. explain_storage no se incluye intencionadamente hasta que el M1C Explainability Contract fusionado esté disponible en el Core público.

Instalación

Requisitos previos

• Node.js 18 o superior.

• AI Disk Doctor Core v1.7.0 o un Core posterior compatible en PATH como aidisk/aidisk.exe.

• Establece AIDISK_EXE cuando el binario de Core esté instalado en otra ubicación.

Instalar desde un checkout:

git clone https://github.com/quzhiii/ai-disk-doctor-integrations.git
cd ai-disk-doctor-integrations
npm install
npm start

Para una instalación local determinista, fija el checkout del repositorio o usa una release etiquetada. La dependencia npm está fijada a @modelcontextprotocol/sdk 1.30.0 en package-lock.json.

El proceso usa el transporte stdio de MCP y debe ser iniciado por un cliente MCP, no abierto como programa interactivo independiente.

OpenCode

OpenCode admite declaraciones MCP locales de proyecto en opencode.json o opencode.jsonc:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "ai-disk-doctor": {
      "type": "local",
      "command": ["node", "C:/absolute/path/to/ai-disk-doctor-integrations/src/server.js"],
      "cwd": "C:/absolute/path/to/your-workspace",
      "enabled": true
    }
  }
}

Para una instalación global, usa rutas absolutas para los argumentos de command y establece AIDISK_EXE en environment si es necesario. Establece cwd en el espacio de trabajo del usuario donde deban almacenarse las instantáneas de Core, en lugar del checkout de integración. Luego usa opencode mcp list o pide al agente que compruebe core_status. El ejemplo incluido está en adapters/opencode/opencode.jsonc.

Las Agent Skills de OpenCode se descubren desde .opencode/skills, .claude/skills o .agents/skills. Copia o crea un enlace simbólico de skills/ai-disk-doctor en una de esas ubicaciones para una instalación de proyecto o de usuario.

Qwen Code

Qwen Code admite servidores MCP stdio locales mediante qwen mcp o settings.json:

qwen mcp add --scope user --transport stdio ai-disk-doctor node ./src/server.js

Entrada equivalente en .qwen/settings.json:

{
  "mcpServers": {
    "ai-disk-doctor": {
      "command": "node",
      "args": ["/absolute/path/to/ai-disk-doctor-integrations/src/server.js"],
      "cwd": "/absolute/path/to/your-workspace",
      "env": { "AIDISK_EXE": "aidisk" },
      "trust": false
    }
  }
}

La raíz del repositorio es un paquete de extensión de Qwen a través de su qwen-extension.json. Instala el repositorio como extensión local después de npm install; consulta adapters/qwen/README.md. La Skill canónica sigue siendo la misma Skill, no una implementación de gobernanza específica de Qwen.

CodeBuddy / WorkBuddy

Usa la superficie de configuración MCP local compatible con el producto instalado y apúntala al mismo proceso stdio node ./src/server.js. Establece su directorio de trabajo en el espacio de trabajo donde deba residir el historial de instantáneas de Core. No se incluye ninguna persona Expert ni lógica de riesgo específica del proveedor. El empaquetado exacto se pospone hasta que exista un contrato de cliente CodeBuddy / WorkBuddy oficial y comprobable localmente; consulta adapters/codebuddy/README.md.

TRAE

Usa la configuración MCP de proyecto documentada de TRAE y añade el mismo proceso stdio local. Establece su directorio de trabajo en el espacio de trabajo donde deba residir el historial de instantáneas de Core. El empaquetado exacto del proyecto se pospone hasta que un cliente TRAE esté disponible localmente para su validación; consulta adapters/trae/README.md.

Diagnóstico de Core

# Verify the Core directly
aidisk --help

# Verify the integration server syntax
npm run check

# Override the Core executable
# Windows PowerShell:
$env:AIDISK_EXE = 'C:\\Tools\\aidisk.exe'
# POSIX shells:
export AIDISK_EXE=/opt/aidisk

Si Core falta o devuelve una salida malformada/incompatible, core_status informa de un fallo estructurado. El proceso MCP no descarga Core, no clona repositorios, no contacta con un servicio en la nube ni sustituye silenciosamente a otro escáner.

Límite de seguridad

• El transporte MCP es solo stdio local.

• El servidor inicia únicamente el ejecutable aidisk configurado con subcomandos fijos orientados a lectura.

• No existe ninguna herramienta de shell arbitrario ni de comando arbitrario.

• No existe ninguna herramienta de limpieza, ejecución de cuarentena, restauración, eliminación o mutación.

• scan_summary está marcado como readOnlyHint: false porque la persistencia actual de escaneos de Core puede escribir una instantánea propiedad de AI Disk Doctor. Sigue siendo destructiveHint: false y no modifica archivos de usuario o del espacio de trabajo.

• El inventario de modelos contiene solo metadatos según el contrato de Core; esta integración no lee contenido de prompts, transcripciones, fuentes, documentos, tokens, cookies ni credenciales.

• Las rutas proporcionadas a las herramientas se pasan únicamente al comando de Core correspondiente o al lector de metadatos de historial. Esta integración no las lee recursivamente.

Los agentes nunca deben eludir estas reglas eliminando rutas con comandos de shell. Si se aprueba un flujo de mutación futuro, debe usar una superficie de autorización separada.

Desarrollo

npm install
npm run check
npm test

Para una prueba de humo real de Core, instala/compila la revisión fijada de Core, pon aidisk en PATH o establece AIDISK_EXE, y ejecuta npm test. La prueba con Core real se omite cuando AIDISK_EXE no está establecido. El resto de pruebas de protocolo usan directorios temporales y un caso con Core ausente; no simulan que los clientes del proveedor estén instalados.

Licencia

El código fuente de la integración tiene doble licencia MIT o Apache-2.0. Consulta LICENSE-MIT y LICENSE-APACHE. La licencia de Core sigue regulada por el repositorio público de Core.

Estado

I0 Alpha. Este repositorio no es el Desktop comercial y no contiene cuentas, facturación, derechos de uso, telemetría, sincronización en la nube ni código propietario de Desktop.