Интеграции AI Disk Doctor

Универсальный локальный Agent Skill и MCP-сервер только для чтения для AI Disk Doctor Core.

Этот репозиторий является слоем интеграции и распространения. Он не реализует второй сканер, очиститель, механизм рисков, модель восстановления или систему политик. Локальное ядро (Core) остаётся источником истины для выполнения и политик.

Объём Alpha

MCP-сервер предоставляет четыре инструмента:

I0 не предоставляет инструментов clean, restore, quarantine, delete, произвольного shell или произвольной мутации файловой системы. explain_storage намеренно не включён до тех пор, пока объединённый контракт объяснимости M1C не станет доступен в публичном Core.

Установка

Предварительные требования

• Node.js 18 или новее.

• AI Disk Doctor Core v1.7.0 или совместимая более поздняя версия Core в PATH как aidisk/aidisk.exe.

• Установите AIDISK_EXE, если бинарный файл Core установлен в другом месте.

Установка из клона:

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

Для детерминированной локальной установки зафиксируйте клон репозитория или используйте тегированный релиз. Зависимость npm зафиксирована на @modelcontextprotocol/sdk 1.30.0 в package-lock.json.

Процесс использует MCP-транспорт stdio и должен запускаться MCP-клиентом, а не открываться как отдельная интерактивная программа.

OpenCode

OpenCode поддерживает проектно-локальные объявления MCP в opencode.json или 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
    }
  }
}

Для глобальной установки используйте абсолютные пути для аргументов command и при необходимости задайте AIDISK_EXE в environment. Установите cwd в рабочее пространство пользователя, где должны храниться снимки Core, а не в каталог интеграции. Затем используйте opencode mcp list или попросите агента проверить core_status. Проверенный пример находится в adapters/opencode/opencode.jsonc.

OpenCode Agent Skills обнаруживаются из .opencode/skills, .claude/skills или .agents/skills. Скопируйте или создайте симлинк skills/ai-disk-doctor в одно из этих мест для проектной или пользовательской установки.

Qwen Code

Qwen Code поддерживает локальные stdio MCP-серверы через qwen mcp или settings.json:

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

Эквивалентная запись в .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
    }
  }
}

Корень репозитория является пакетом расширения Qwen через его qwen-extension.json. Установите репозиторий как локальное расширение после npm install; см. adapters/qwen/README.md. Канонический Skill остаётся тем же Skill, а не специфичной для Qwen реализацией управления.

CodeBuddy / WorkBuddy

Используйте локальную поверхность конфигурации MCP, поддерживаемую установленным продуктом, и укажите её на тот же процесс stdio node ./src/server.js. Установите его рабочий каталог в рабочее пространство, где должна храниться история снимков Core. Никакая экспертная персона или специфичная для вендора логика рисков не включена. Точная упаковка откладывается до появления официального, локально тестируемого контракта клиента CodeBuddy / WorkBuddy; см. adapters/codebuddy/README.md.

TRAE

Используйте документированную проектную конфигурацию MCP от TRAE и добавьте тот же локальный процесс stdio. Установите его рабочий каталог в рабочее пространство, где должна храниться история снимков Core. Точная упаковка проекта откладывается до появления локально доступного клиента TRAE для проверки; см. adapters/trae/README.md.

Диагностика 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

Если Core отсутствует или возвращает некорректный/несовместимый вывод, core_status сообщает о структурированном сбое. Процесс MCP не загружает Core, не клонирует репозитории, не связывается с облачным сервисом и не подставляет молча другой сканер.

Границы безопасности

• MCP-транспорт — только локальный stdio.

• Сервер запускает только настроенный исполняемый файл aidisk с фиксированными подкомандами, ориентированными на чтение.

• Не существует инструмента произвольного shell или произвольной команды.

• Не существует инструмента очистки, выполнения карантина, восстановления, удаления или мутации.

• scan_summary помечен как readOnlyHint: false, потому что текущее сохранение сканирования Core может записать снимок, принадлежащий AI Disk Doctor. Он по-прежнему destructiveHint: false и не изменяет пользовательские/рабочие файлы.

• Инвентаризация моделей — только метаданные согласно контракту Core; эта интеграция не читает содержимое подсказок, транскриптов, исходников, документов, токенов, cookie или учётных данных.

• Пути, передаваемые инструментам, передаются только соответствующей команде Core или считывателю метаданных истории. Они не рекурсивно читаются этой интеграцией.

Агенты никогда не должны обходить эти правила, удаляя пути с помощью shell-команд. Если будущий поток мутации будет одобрен, он должен использовать отдельную поверхность авторизации.

Разработка

npm install
npm run check
npm test

Для реального смоук-теста Core установите/соберите зафиксированную ревизию Core, поместите aidisk в PATH или задайте AIDISK_EXE и запустите npm test. Тест с реальным Core пропускается, если AIDISK_EXE не задан. Остальные протокольные тесты используют временные каталоги и случай отсутствующего Core; они не делают вид, что вендорные клиенты установлены.

Лицензия

Исходный код интеграции распространяется под двойной лицензией MIT или Apache-2.0. См. LICENSE-MIT и LICENSE-APACHE. Лицензирование Core остаётся регулируемым публичным репозиторием Core.

Статус

I0 Alpha. Этот репозиторий не является коммерческим Desktop и не содержит учётных записей, биллинга, прав доступа, телеметрии, облачной синхронизации или проприетарного кода Desktop.