iScope .ajs Debugger

Розширення для Visual Studio Code і Cursor: запуск і відладка скриптів .ajs / .ts і панелей аналізатора .apn / .aps у Oscilloscope.exe (iScope Platform).

Встановлення

Потрібні Windows, Oscilloscope і Visual Studio Code або Cursor. Linux ще немає.

З Marketplace

1. Відкрити панель Extensions (Ctrl+Shift+X).
2. Знайти iScope .ajs Debugger (publisher iScope) і натиснути Install.
3. За запиту редактора — палітра команд (Ctrl+Shift+P) → Developer: Reload Window у Cursor або VS Code (не Oscilloscope).

Сторінка: marketplace.visualstudio.com/items?itemName=i-scope.iscope-debugger

З командного рядка (якщо у PATH є cursor або code):

cursor --install-extension i-scope.iscope-debugger
code --install-extension i-scope.iscope-debugger

MCP для AI-агентів

Розширення дає F5 / Ctrl+F5 у редакторі. Щоб агент керував тією ж сесією Oscilloscope:

1. Палітра команд (Ctrl+Shift+P) → iScope: Enable MCP. Підтвердь merge у .cursor/mcp.json (Cursor) або .vscode/mcp.json (VS Code). Інші MCP-сервери в файлі не чіпаються.
2. Перезавантаж вікно цього редактора (не Oscilloscope): палітра → Developer: Reload Window, або кнопка Reload editor після Enable.

Якщо редактор підтримує mcpServerDefinitionProviders, сервер також з’являється в панелі MCP без запису у файл — увімкни його там.

Пакет: npmjs.com/package/@i-scope/mcp-server

Файл .vsix (офлайн або збірка з репо)

Панель Extensions → ⋯ → Install from VSIX…, або:

cursor --install-extension шлях\до\iscope-debugger.vsix --force
code --install-extension шлях\до\iscope-debugger.vsix --force

Можливості

• Ctrl+F5 — швидкий запуск активного .ajs без повної DAP-сесії; вивід Host.ReportOut у каналі iScope Trace.
• F5 — відладка через DAP: зупинки, кроки, стек, змінні, watch; підтримка source maps (TypeScript → згенерований .ajs).
• Команди палітри (iScope:) — підключення / відключення моста, вибір .mwf, перегляд трейсу.
• За потреби — автозапуск Oscilloscope і завантаження осцилограми перед запуском скрипта.

Вимоги

• Windows (нативний міст до Oscilloscope через COM).
• Встановлений Oscilloscope. Шлях до Oscilloscope.exe зазвичай визначається автоматично (асоціація .mwf у реєстрі Windows MultiWave.File → shell\\open\\command, далі стандартні теки встановлення). Явно задайте iScopeAjs.oscilloscopePath лише для portable-копії або нестандартного розташування.
• У пакет входить iScopeBridge.exe — окремо завантажувати не потрібно, якщо не потрібен власний збір моста.

Швидкий старт

1. Відкрити workspace з файлами .ajs (і за потреби з .ts, якщо використовуються source maps).
2. Додати конфігурацію Run and Debug з типом iscope-ajs або натиснути F5 у відкритому .ajs.
3. У Settings за потреби перевірити iScopeAjs.mwfPath, iScopeAjs.helperPath (для моста — лише нестандартний випадок). iScopeAjs.oscilloscopePath залишити порожнім, якщо Oscilloscope встановлений звичайним інсталятором; інакше вказати шлях або обрати файл у діалозі після помилки запуску.

Підказки для полів launch.json з’являються в автодоповненні редактора (JSON schema з package.json розширення).

Основні налаштування

Типові проблеми

• Oscilloscope показує діалог «завантажте осцилограму» — задати mwfPath або відкрити .mwf вручну; за потреби вимкнути openFileBeforeRun, якщо файл уже відкритий у програмі.
• F5 у .ajs не запускає відладку — переконатися, що обрано конфігурацію з типом iscope-ajs, а не стандартний Node debugger.
• Після зупинки відладки Oscilloscope лишається відкритою — так задумано, щоб переглянути результати; повне закриття залежить від closePolicy і того, хто запускав процес.

Ліцензія

MIT © 2026 iScope