Redirector
Расширение для VS Code и Cursor: просмотр, поиск и навигация по URL-редиректам из YAML-файла в workspace.
Redirector читает правила редиректов, показывает их в дереве боковой панели и позволяет одним кликом перейти к нужной строке в исходном файле.
Возможности
- Дерево редиректов — целевые пути (
to) и исходные (from) в иерархическом виде
- Группировка — по первому сегменту целевого URL (например,
account, cloud-servers)
- Поиск — фильтрация по
to или from без перезагрузки файла
- Переход к строке — клик по правилу или пути открывает YAML на нужной строке
- Автообновление — дерево обновляется при сохранении файла редиректов
- Фильтр второстепенного языка — опциональное отображение путей
/en и en/...
Требования
Откройте workspace с YAML-файлом редиректов в следующей структуре:
app:
config:
redirects:
- to: "/account/"
from:
- "/old-account-path/"
- "/legacy/account/"
- to: "/cloud-servers/"
from:
- "/cloud/"
По умолчанию используется путь helm/values/common.yaml относительно корня workspace.
Быстрый старт
- Установите расширение
- Откройте проект с файлом редиректов
- Нажмите иконку Redirector на Activity Bar
- Раскройте группы и правила в дереве
Действия в дереве
| Кнопка |
Действие |
| Поиск |
Фильтр по пути to или from |
| Сброс поиска |
Убрать активный фильтр |
| Обновить |
Перечитать редиректы с диска |
| Настройки |
Открыть настройки расширения |
Клик по целевому пути (to) — переход к строке правила в YAML.
Клик по исходному пути (from) — переход к соответствующей записи в списке from.
Настройки
| Параметр |
По умолчанию |
Описание |
redirector.filePath |
helm/values/common.yaml |
Путь к YAML-файлу (относительно корня workspace) |
redirector.groupTargetPaths |
true |
Группировать целевые пути по первому сегменту URL |
redirector.showSecondaryLanguageRedirects |
false |
Показывать редиректы с путями второстепенного языка (/en, en/...) |
Пример settings.json:
{
"redirector.filePath": "helm/values/common.yaml",
"redirector.groupTargetPaths": true,
"redirector.showSecondaryLanguageRedirects": false
}
Разработка
npm install
npm run watch
Нажмите F5 для запуска Extension Development Host. Чтобы отладить расширение на другом проекте, укажите нужный workspace в .vscode/launch.json.
Сборка
npm run compile
npm run package
Упаковка VSIX
npx @vscode/vsce package
Архитектура
Подробное описание модулей, потоков данных и точек расширения — в ARCHITECTURE.md.
Лицензия
MIT
