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). Запис запускає node і файл dist/mcp-server.js з цього розширення. Інші MCP-сервери в файлі не чіпаються. Окремий пакет з npm не скачується.
2. На комп’ютері має бути Node.js, і команда node має відкриватися з командного рядка. F5 і Ctrl+F5 Node.js не потребують.
3. Та сама команда записує в цю теку проєкту одне правило агента: .cursor/rules/iscope-mcp.mdc. Інші правила не змінюються. Разом із розширенням це правило не ставиться.
4. Перезавантаж вікно цього редактора (не Oscilloscope): палітра → Developer: Reload Window, або кнопка Reload editor після Enable.

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

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

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

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

Можливості

• Ctrl+F5 і Ctrl+Shift+Enter — швидкий запуск активного .ajs без повної DAP-сесії, та сама дія, що й запуск скрипта в Oscilloscope. Вивід Host.ReportOut іде в канал iScope Trace. Коли скрипт закінчився, з’єднання відпускається, і після цього знову можна натиснути F5.
• 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-копії або нестандартного розташування.
• Відкритий файл осцилограм .mwf у вікні Oscilloscope перед F5 і Ctrl+F5. Без нього скрипт не стартує: з’являється «Please load oscillogram file…».
• У пакет входить iScopeBridge.exe — окремо завантажувати не потрібно, якщо не потрібен власний збір моста.

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

1. Відкрити workspace з файлами .ajs (і за потреби з .ts, якщо використовуються source maps). Якщо редактор питає «Do you want to allow untrusted files in this window?», натиснути Open. Open in Restricted Mode вимикає iScope.
2. У вікні Oscilloscope.exe відкрити файл осцилограм .mwf. Якщо вікно ще не запущене, його можна не відкривати вручну: F5 запустить Oscilloscope сам, коли в налаштуваннях заданий шлях до .mwf.
3. Натиснути F5 у відкритому .ajs.
4. У Settings за потреби перевірити iScopeAjs.mwfPath, iScopeAjs.helperPath (для моста — лише нестандартний випадок). iScopeAjs.oscilloscopePath залишити порожнім, якщо Oscilloscope встановлений звичайним інсталятором; інакше вказати шлях або обрати файл у діалозі після помилки запуску.

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

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

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

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

Ліцензія

MIT © 2026 iScope