OneDev BridgeРасширение VS Code — прослойка между сервером OneDev (проверено по исходникам 16.9.6) и вашими локальными проектами: задачи, Pull Request, сборки, комментарии, diff и безопасная синхронизация репозиториев — из редактора, без браузера. История версийЧто вошло в каждый релиз — в файле CHANGELOG.md (на странице расширения — вкладка «Changelog»). Что умеетВсе возможности собраны в одной панели OneDev → «Обзор»: это одно дерево с общей прокруткой (как в проводнике), разделы — сворачиваемые группы. Версия расширения показана в шапке панели.
Связь локальной папки с проектом определяется по URL remote ( Кнопки и горячие клавишиКнопки в шапке панели (слева направо): Авто-коммит и push (облако), Настройка (шестерёнка), Перейти по номеру, Обновить, Выбрать проект, Журнал. На заголовке каждого раздела — его кнопки (создать задачу, создать PR, запустить job, привязать папку, клонировать проект и т. д.), на элементах — действия по наведению и в контекстном меню. Горячие клавиши — аккорд: нажмите
Сочетания переназначаются стандартным способом: Ctrl+K Ctrl+S → поиск «OneDev». Задачи, комментарии, diff
Коммит и push
Меню «Настройка»Шестерёнка в шапке панели (или Уведомления и журналПосле fetch / pull / push (кнопки в «Локальных проектах», «Синхронизировать сейчас» и авто-синхронизация) показывается подробный отчёт:
В отчёте: ветка и upstream, что обновилось на сервере, какие коммиты подтянуты/отправлены (последние 5 + остаток), итоговое состояние (↑/↓, незакоммиченные изменения) и проблемы. Кнопки: Подробности (открывает журнал) и Открыть коммит (страница коммита в OneDev). Ручная синхронизация всех проектов выводит сводку по строке на проект. Автоматические pull/push всегда сопровождаются уведомлением — «тихих» изменений нет. Журнал: панель Output → OneDev Bridge (или команда ПодключениеЧек-лист проверки. Для проверки сделанного заведите задачу с названием «Чек-лист проверки…» и пунктами При «Подключиться» и по команде «Диагностика подключения…» расширение проходит проверки: адрес → сервер отвечает → токен принят → доступ к проектам → git установлен → git читает репозиторий по токену. В отчёте у каждой проблемы есть подсказка и кнопка быстрого исправления. Активный проект помечен ★ в разделах «Проекты» и «Локальные проекты».
Токен хранится в защищённом хранилище VS Code ( Если токен отозван или просрочен (сервер ответил 401), расширение один раз предупредит уведомлением с кнопкой Изменить токен…, покажет предупреждение в строке состояния и в начале дерева и приостановит фоновые обновления. Команда OneDev: Изменить токен… (также в меню «Настройка») спрашивает только новый токен, проверяет его и сразу возобновляет работу, адрес сервера вводить не нужно. Остальные ошибки тоже сопровождаются быстрым исправлением: 403 — открыть страницу токенов (нужны права записи), ошибка сертификата — принять сертификат ( Безопасность авто-синхронизации
Настройки (
|
| Ключ | По умолчанию | Смысл |
|---|---|---|
serverUrl |
— | Адрес сервера |
cloneProtocol |
http |
http (токен расширения) или ssh (ваши ключи) |
cloneDirectory |
— | Куда клонировать; пусто — спрашивать |
allowInsecureTls |
false |
Принять самоподписанный сертификат (REST и git) |
pageSize |
100 |
Размер страницы и лимит записей в списках (макс. 100 на сервере) |
issues.query / pulls.query / builds.query |
"State" is not "Closed" / open / пусто |
Дополнительное условие запроса OneDev (добавляется через and к условию по проекту) |
autoSync.mode |
fetch |
off / fetch / pull |
autoSync.push |
false |
Отправлять локальные коммиты |
autoSync.intervalMinutes |
10 |
Период |
autoSync.onFocus |
true |
Синхронизировать при возврате фокуса (не чаще раза в 2 минуты) |
autoSync.pushOnCommit |
false |
Отправлять коммит сразу после git commit (безопасные правила — см. «Безопасность авто-синхронизации») |
autoSync.pushDelaySeconds |
5 |
Пауза после коммита перед push; новый коммит перезапускает отсчёт |
builds.statusBar |
true |
Статус сборок текущей ветки в строке состояния |
builds.notify |
failed |
Уведомлять о сборках: failed / all / off |
builds.pollSeconds |
120 |
Период опроса сборок (пока сборка идёт — каждые 20 с) |
myWork.pollMinutes |
5 |
Период опроса «Моей работы»; 0 — не опрашивать |
myWork.issuesQuery |
"Assignees" is me and "State" is not "Closed" |
Запрос для «Задач, назначенных мне» (поле и состояния настраиваются в OneDev) |
myWork.notify |
true |
Уведомлять о новых PR и задачах (одной строкой: «Вам назначено 3 задачи — #53 … · #44 …») |
autoCommit.messageTemplate |
Auto-commit: {files} — {datetime} |
Шаблон сообщения «Авто-коммита и push»: {files}, {count}, {date}, {time}, {datetime}, {branch}, {project} |
userLogin |
пусто | Ваш логин для токена, ограниченного проектами (такой токен не отвечает на /users/me; логин нужен для комментариев и пометки «это вы») |
changelogCommit.enabled / .file |
false / CHANGELOG.md |
Сохранение CHANGELOG в редакторе → автоматический коммит и push; сообщение — из добавленных пунктов (версия и заголовок первого пункта в теме); в коммит попадает всё изменённое |
checklist.enabled / .title / .project / .pollMinutes |
true / «Чек-лист проверки» / активный проект / 5 |
Чек-лист проверки: галочка в задаче-чек-листе (- [ ] #39 …) закрывает указанную задачу; опрос раз в N минут (0 — только по команде) |
maxProjects |
1000 |
Сколько проектов загружать с сервера; при обрезке в разделе «Проекты» появляется заметка |
comments.maxShown |
100 |
Сколько последних комментариев показывать в документе (остальное — в браузере) |
iterations.statusBar |
true |
Текущая итерация активного проекта (название, готово/всего, дни до срока) в строке состояния |
autoCommit.confirm |
false |
Спрашивать подтверждение (сообщение и список файлов) перед авто-коммитом |
projects.visibility |
all |
Какие проекты показывать в разделе «Проекты»: all / local (с локальной копией и активный) / active (только активный) |
local.visibility |
all |
Какие локальные проекты показывать: all / workspace (открытые в окне) / active (только активный проект). Скрытые не отвязываются и синхронизируются |
Основные из них можно менять не заходя в настройки — через меню «Настройка».
Сборка и установка
На сервере OneDev сборка описана в .onedev-buildspec.yml (формат версии 56; для запуска в OneDev должен быть настроен исполнитель заданий — Administration → Job Executors): на каждый push в master выполняются npm ci, компиляция, тесты и npm run package, .vsix сохраняется артефактом сборки.
npm install
npm run compile # сборка в out/
npm test # юнит-тесты чистой логики
npm run package # создаёт onedev-bridge-<версия>.vsix
code --install-extension onedev-bridge-<версия>.vsix
После установки выполните «Developer: Reload Window». Для отладки: откройте папку в VS Code и нажмите F5 (Extension Development Host), либо code --extensionDevelopmentPath=<путь к папке>.
Устройство
src/extension.ts точка входа, сборка зависимостей, события
src/api.ts REST-клиент OneDev (/~api, Bearer-токен): проекты, задачи, PR, сборки, комментарии, итерации
src/connection.ts подключение: адрес, токен (SecretStorage), чтение настроек
src/git.ts обёртка над git CLI
src/syncOps.ts безопасная синхронизация одного репозитория
src/autoSync.ts таймер, фокус окна, push после коммита, индикатор в строке состояния
src/commitWatcher.ts слежение за .git/logs/HEAD (новые коммиты)
src/localProjects.ts реестр локальных проектов (по URL remote), флаг авто-синхронизации
src/projectContext.ts активный проект для списков задач, PR и сборок
src/projectDirectory.ts кэш списка проектов сервера
src/myWork.ts опрос и уведомления «Моей работы»
src/buildStatus.ts статус сборок в строке состояния; buildLog.ts, logStream.ts — лог сборки
src/diffView.ts содержимое файлов коммита для diff Pull Request
src/iterationDirectory.ts кэш итераций проекта; iterationFilter.ts, iterationStatus.ts — фильтр задач и строка состояния
src/commands/ команды по модулям: common, connection, projects, issues, iterations, builds, sync, settings; index — регистрация
src/localLogic.ts выбор активного проекта, флаг авто-синхронизации (без vscode, с тестами)
src/treeLogic.ts маршрутизация корня дерева и подсказки пустых разделов (без vscode, с тестами)
src/diagnostics.ts диагностика подключения (мастер первого входа)
src/views/* единое дерево «Обзор» (mainView) и провайдеры разделов
src/util.ts чистая логика (разбор URL, дерево, статус git, даты итераций и т. п.) + тесты в src/test
Если что-то не работает
- Все папки показываются как один и тот же проект. Проверьте глобальный конфиг:
git config --global --get-all remote.origin.url. Глобальныйremote.origin.urlподмешивается в каждый репозиторий; расширение его игнорирует (читает только локальный.git/config), но обычныйgit fetchв таких репозиториях может обращаться не туда. - 401 / «Неверный токен», в строке состояния «токен недействителен». Токен просрочен или отозван — выполните OneDev: Изменить токен…. Если
git pushиз терминала тоже не проходит, обновите сохранённые данные для сервера в диспетчере учётных данных Windows. git pushв терминале: «Cannot prompt because user interactivity has been disabled» / «unable to get password». Git Credential Manager не может спросить пароль: проверьтеgit config --global --get credential.interactive(значениеneverзапрещает запросы; снимаетсяgit config --global --unset credential.interactive) и переменные окруженияGCM_INTERACTIVE,GIT_TERMINAL_PROMPT. После входа (логин и access token в качестве пароля) данные сохраняются.- Ошибка сертификата. Для самоподписанного сертификата в сообщении об ошибке нажмите «Принять сертификат…» (или включите
onedev.allowInsecureTlsв настройках; небезопасно за пределами доверенной сети). - «Нет связи» в строке состояния. Сервер недоступен: проверьте адрес и сеть, нажмите на индикатор для проверки подключения или выполните OneDev: Изменить адрес сервера….
- Список задач пуст при непустом проекте. Поменяйте
onedev.issues.query— состояния задач в OneDev настраиваются, и «Closed» может называться иначе. Закрытые задачи по умолчанию скрыты. - Создание задачи или комментария: «Недостаточно прав (403)». Токену нужны права записи; комментарии от чужого имени сервер не принимает (автор — владелец токена).
- Нет локальной копии при diff или переключении на ветку PR. Клонируйте проект или привяжите папку («Привязать папку к проекту OneDev…»).