AI Disk Doctor Integrations

Universelle lokale Agent-Skill und schreibgeschützter MCP-Server für AI Disk Doctor Core.

Dieses Repository ist eine Integrations- und Verteilungsebene. Es implementiert keinen zweiten Scanner, keine Bereinigung, keine Risiko-Engine, kein Wiederherstellungsmodell und kein Richtliniensystem. Das lokale Core bleibt die maßgebliche Quelle für Ausführung und Richtlinien.

Alpha-Umfang

Der MCP-Server stellt vier Tools bereit:

I0 stellt kein clean-, restore-, quarantine-, delete-, kein beliebiges Shell- und kein beliebiges Dateisystem-Mutations-Tool bereit. explain_storage ist absichtlich nicht enthalten, bis der zusammengeführte M1C-Erklärbarkeitsvertrag im öffentlichen Core verfügbar ist.

Installation

Voraussetzungen

• Node.js 18 oder neuer.

• AI Disk Doctor Core v1.7.0 oder ein kompatibles neueres Core auf PATH als aidisk/aidisk.exe.

• Setzen Sie AIDISK_EXE, wenn die Core-Binärdatei an anderer Stelle installiert ist.

Installation aus einem Checkout:

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

Für eine deterministische lokale Installation pinnen Sie den Repository-Checkout oder verwenden Sie ein getaggtes Release. Die npm-Abhängigkeit ist in package-lock.json auf @modelcontextprotocol/sdk 1.30.0 gepinnt.

Der Prozess verwendet den MCP-stdio-Transport und sollte von einem MCP-Client gestartet werden, nicht als eigenständiges interaktives Programm geöffnet werden.

OpenCode

OpenCode unterstützt projektlokale MCP-Deklarationen in opencode.json oder 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
    }
  }
}

Für eine globale Installation verwenden Sie absolute Pfade für command-Argumente und setzen Sie bei Bedarf AIDISK_EXE in environment. Setzen Sie cwd auf den Benutzerarbeitsbereich, in dem Core-Snapshots gespeichert werden sollen, und nicht auf den Integrations-Checkout. Verwenden Sie dann opencode mcp list oder bitten Sie den Agenten, core_status zu prüfen. Das eingecheckte Beispiel befindet sich unter adapters/opencode/opencode.jsonc.

OpenCode-Agent-Skills werden aus .opencode/skills, .claude/skills oder .agents/skills erkannt. Kopieren oder verlinken Sie skills/ai-disk-doctor für eine Projekt- oder Benutzerinstallation in einen dieser Speicherorte.

Qwen Code

Qwen Code unterstützt lokale stdio-MCP-Server über qwen mcp oder settings.json:

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

Entsprechender Eintrag in .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
    }
  }
}

Das Repository-Root ist über seine qwen-extension.json ein Qwen-Erweiterungspaket. Installieren Sie das Repository nach npm install als lokale Erweiterung; siehe adapters/qwen/README.md. Die kanonische Skill bleibt dieselbe Skill, keine Qwen-spezifische Governance-Implementierung.

CodeBuddy / WorkBuddy

Verwenden Sie die vom installierten Produkt unterstützte lokale MCP-Konfigurationsoberfläche und richten Sie sie auf denselben node ./src/server.js-stdio-Prozess. Setzen Sie das Arbeitsverzeichnis auf den Arbeitsbereich, in dem die Core-Snapshot-Verlauf gespeichert werden soll. Es ist keine Expert-Persona oder anbieterspezifische Risikologik enthalten. Die genaue Paketierung wird verschoben, bis ein offizieller, lokal testbarer CodeBuddy-/WorkBuddy-Clientvertrag verfügbar ist; siehe adapters/codebuddy/README.md.

TRAE

Verwenden Sie die dokumentierte Projekt-MCP-Konfiguration von TRAE und fügen Sie denselben lokalen stdio-Prozess hinzu. Setzen Sie das Arbeitsverzeichnis auf den Arbeitsbereich, in dem die Core-Snapshot-Verlauf gespeichert werden soll. Die genaue Projektpaketierung wird verschoben, bis ein TRAE-Client lokal zur Validierung verfügbar ist; siehe adapters/trae/README.md.

Core-Diagnose

# 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

Wenn Core fehlt oder fehlerhafte/inkompatible Ausgaben zurückgibt, meldet core_status einen strukturierten Fehler. Der MCP-Prozess lädt kein Core herunter, klont keine Repositorys, kontaktiert keinen Cloud-Dienst und ersetzt stillschweigend keinen anderen Scanner.

Sicherheitsgrenze

• Der MCP-Transport ist ausschließlich lokales stdio.

• Der Server startet nur die konfigurierte aidisk-ausführbare Datei mit festen, leseorientierten Unterbefehlen.

• Es existiert kein Tool für beliebige Shell- oder beliebige Befehle.

• Es existiert kein Tool für Bereinigung, Quarantäne-Ausführung, Wiederherstellung, Löschung oder Mutation.

• scan_summary ist als readOnlyHint: false markiert, da die aktuelle Core-Scan-Persistenz einen AI-Disk-Doctor-eigenen Snapshot schreiben kann. Es ist weiterhin destructiveHint: false und ändert keine Benutzer-/Arbeitsbereichsdateien.

• Die Modellinventur ist gemäß dem Core-Vertrag rein metadatenbasiert; diese Integration liest keine Prompt-, Transkript-, Quell-, Dokument-, Token-, Cookie- oder Anmeldedateninhalte.

• Pfade, die an Tools übergeben werden, werden nur an den entsprechenden Core-Befehl oder den Verlaufsmetadaten-Leser weitergegeben. Sie werden von dieser Integration nicht rekursiv gelesen.

Agenten dürfen diese Regeln niemals umgehen, indem sie Pfade mit Shell-Befehlen löschen. Wenn ein zukünftiger Mutationsablauf genehmigt wird, muss er eine separate Autorisierungsoberfläche verwenden.

Entwicklung

npm install
npm run check
npm test

Für einen echten Core-Smoke-Test installieren/erstellen Sie die gepinnte Core-Revision, setzen Sie aidisk auf PATH oder setzen Sie AIDISK_EXE, und führen Sie npm test aus. Der echte-Core-Test wird übersprungen, wenn AIDISK_EXE nicht gesetzt ist. Die übrigen Protokolltests verwenden temporäre Verzeichnisse und einen Fall mit fehlendem Core; sie tun nicht so, als wären Anbieter-Clients installiert.

Lizenz

Der Integrationsquellcode ist unter MIT oder Apache-2.0 dual-lizenziert. Siehe LICENSE-MIT und LICENSE-APACHE. Die Core-Lizenzierung unterliegt weiterhin dem öffentlichen Core-Repository.

Status

I0 Alpha. Dieses Repository ist nicht der kommerzielle Desktop und enthält keine Konten, Abrechnung, Berechtigungen, Telemetrie, Cloudsynchronisierung oder proprietären Desktop-Code.