Skip to content
| Marketplace
Sign in
Visual Studio Code>SCM Providers>OneDev IntegrationNew to Visual Studio Code? Get it now.
OneDev Integration

OneDev Integration

Nochnik

| (0) | Free
An intermediary layer between OneDev and local projects: project trees, cloning, folder linking, issues/pull requests/builds, and auto-synchronization.
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
Copied to clipboard
More Info

OneDev Bridge

Расширение VS Code — прослойка между сервером OneDev (проверено по исходникам 16.9.6) и вашими локальными проектами: задачи, Pull Request, сборки, комментарии, diff и безопасная синхронизация репозиториев — из редактора, без браузера.

История версий

Что вошло в каждый релиз — в файле CHANGELOG.md (на странице расширения — вкладка «Changelog»).

Что умеет

Все возможности собраны в одной панели OneDev → «Обзор»: это одно дерево с общей прокруткой (как в проводнике), разделы — сворачиваемые группы. Версия расширения показана в шапке панели.

Раздел Возможности
Моя работа Все проекты сразу: PR, ожидающие ваших действий (ревью, правки, merge); ваши открытые PR; назначенные вам задачи. Бейдж с числом дел и уведомления о новом.
Проекты Дерево проектов OneDev с учётом вложенности; клонирование в один клик; открыть в браузере; скопировать URL клонирования. Уже склонированные проекты помечены «локально». По умолчанию свёрнут: список может быть длинным.
Локальные проекты Репозитории, связанные с OneDev (из рабочей области и клонированные расширением): ветка, ↑ahead / ↓behind, признак незакоммиченных изменений, пометка «⏸» у проектов с выключенной авто-синхронизацией. Кнопки fetch / pull / push и «Коммит и push».
Задачи / Pull Requests / Сборки Списки по активному проекту (определяется по репозиторию в редакторе или выбирается вручную в строке состояния). Создание задачи, ветки под задачу (с переключением), Pull Request из текущей ветки, переключение на ветку PR, комментарии, diff PR. Статусы сборок цветными иконками.
Привязка папок «Привязать папку к проекту OneDev…»: выбрать существующий проект или создать новый на сервере, настроить origin (или отдельный remote), отправить текущую ветку. Если папка ещё не git-репозиторий — предложит git init.
Сборки Индикатор статуса сборок текущей ветки в строке состояния, уведомление о провале, лог сборки в редакторе (с живым обновлением), перезапуск, отмена, запуск job на текущем коммите.
Авто-синхронизация По таймеру, при возврате фокуса в окно и (опционально) сразу после коммита: fetch → (опционально) pull → (опционально) push. Включается и выключается отдельно для каждого проекта. Уведомления о расхождении истории.

Связь локальной папки с проектом определяется по URL remote (https://сервер/путь/проекта, ssh://…), поэтому никаких служебных файлов в репозитории не создаётся и связь переживает перемещение папки.

Кнопки и горячие клавиши

Кнопки в шапке панели (слева направо): Авто-коммит и push (облако), Настройка (шестерёнка), Перейти по номеру, Обновить, Выбрать проект, Журнал. На заголовке каждого раздела — его кнопки (создать задачу, создать PR, запустить job, привязать папку, клонировать проект и т. д.), на элементах — действия по наведению и в контекстном меню.

Горячие клавиши — аккорд: нажмите Ctrl+Alt+O, отпустите, затем букву (на Mac Cmd+Alt+O):

Клавиши Действие
Ctrl+Alt+O, C Коммит и push (с вопросами)
Ctrl+Alt+O, P Авто-коммит и push (всё сразу, без вопросов)
Ctrl+Alt+O, S Синхронизировать все локальные проекты сейчас
Ctrl+Alt+O, A Включить/выключить авто-синхронизацию проекта
Ctrl+Alt+O, G Перейти к задаче или PR по номеру
Ctrl+Alt+O, O Меню «Настройка»

Сочетания переназначаются стандартным способом: Ctrl+K Ctrl+S → поиск «OneDev».

Задачи, комментарии, diff

  • Итерации: воронка в заголовке раздела «Задачи» фильтрует задачи по итерации; текущая итерация и прогресс — в строке состояния; «Спланировать итерацию…» переносит задачи из бэклога (или из закончившегося спринта) пачкой; «+» в заголовке раздела создаёт итерацию, контекстное меню итерации — изменить, закрыть/открыть, удалить; в меню задачи «Запланировать в итерацию…» (или «Без итерации»). Раздел «Итерации» показывает итерации активного проекта (текущая помечена, у каждой период и срок), их задачи и «Бэклог» — задачи без итерации; закрытые итерации — в свёрнутой группе.
  • Переход по номеру (OneDev: Перейти к задаче / PR по номеру…): #123 — задача, !123 — Pull Request, просто число — поиск среди обоих (если найдены оба, предложит выбрать), группа/проект#123 — другой проект. Затем меню действий: открыть в браузере, комментарии, создать ветку (для задачи), diff или переключиться на ветку (для PR).
  • Комментарии к задачам и PR: «Показать комментарии» открывает Markdown-документ; «Добавить комментарий…» открывает редактор для многострочного текста (напишите и нажмите «Отправить»); «Ответить на комментарий…» подставляет цитату; «Изменить свой комментарий…» и «Удалить свой комментарий…» работают с вашими комментариями (автор — владелец токена).
  • Diff Pull Request: расширение получает refs/pulls/N/head, показывает список изменённых файлов со статистикой строк (+добавлено −удалено) и итогом по PR, открывает выбранный во встроенном diff-редакторе, а пункт «Все изменения одним diff» — весь PR одним документом. Нужна локальная копия проекта; PR из форков не поддерживаются.
  • Состояние задачи: «Сменить состояние задачи…» (контекстное меню задачи) — выбор из состояний сервера и необязательный комментарий. Правила переходов задаёт проект; если перехода нет, расширение скажет об этом.
  • Ответственные: «Назначить ответственных…» — галочки по списку пользователей (пустой выбор снимает всех).
  • Цвета состояний: иконки окрашены по смыслу (задачи — по состоянию, PR — по статусу, сборки, локальные проекты — по синхронности с сервером); цвета берутся из темы VS Code.
  • Создание задачи: если в проекте обязательны поля (например, Type и Priority), расширение само спросит их значения и повторит создание.

Коммит и push

  • Коммит и push: если ничего не проиндексировано — предложит добавить все изменения (включая новые файлы), спросит сообщение, закоммитит и отправит.
  • Авто-коммит и push: без вопросов добавляет все изменения (с учётом .gitignore), формирует сообщение вида Auto-commit: a.ts, b.ts (+2 ещё) — 2026-11-15 12:30, коммитит и отправляет. Секреты и лишние файлы держите в .gitignore.
  • Правила push у обеих команд: без force; ветка без upstream публикуется с upstream; отстающая от сервера ветка не отправляется (коммит остаётся, показывается предупреждение).
  • Если локальных проектов несколько, берётся тот, чей файл открыт в редакторе, иначе расширение спросит.

Меню «Настройка»

Шестерёнка в шапке панели (или Ctrl+Alt+O, O): подключение (подключиться / переподключиться / изменить токен / изменить адрес сервера / проверить подключение / отключиться), режим авто-синхронизации, какие локальные проекты показывать (все / открытые в окне / только активный), push по таймеру, push сразу после коммита, синхронизация при возврате в окно, флаг авто-синхронизации текущего проекта, подтверждение авто-коммита, коммит и push при сохранении CHANGELOG, слежение за чек-листом проверки, уведомления о сборках и «Моей работы», статус сборки в строке состояния, переход к горячим клавишам и ко всем настройкам расширения. Переключатели меняются по Enter, меню остаётся открытым; закрывается по Esc.

Уведомления и журнал

После fetch / pull / push (кнопки в «Локальных проектах», «Синхронизировать сейчас» и авто-синхронизация) показывается подробный отчёт:

OneDev · ilo-telegram-bot  (проект team/ilo-telegram-bot)
Ветка: main ⇄ origin/main
Fetch: на сервере без изменений
Push: отправлено 11 коммитов
      027f381 исправлена отправка уведомлений
      …
      …и ещё 6
Сейчас: синхронизировано

В отчёте: ветка и upstream, что обновилось на сервере, какие коммиты подтянуты/отправлены (последние 5 + остаток), итоговое состояние (↑/↓, незакоммиченные изменения) и проблемы. Кнопки: Подробности (открывает журнал) и Открыть коммит (страница коммита в OneDev). Ручная синхронизация всех проектов выводит сводку по строке на проект. Автоматические pull/push всегда сопровождаются уведомлением — «тихих» изменений нет.

Журнал: панель Output → OneDev Bridge (или команда OneDev: Показать журнал). Туда пишутся каждый git-вызов (команда, папка, время, вывод) и каждый REST-запрос (метод, путь, статус, время) и полные отчёты. Токен и тела запросов в журнал не попадают, учётные данные в URL маскируются.

Подключение

Чек-лист проверки. Для проверки сделанного заведите задачу с названием «Чек-лист проверки…» и пунктами - [ ] #39 Что проверить. Поставили галочку в OneDev — расширение закроет задачу #39 (раз в 5 минут или командой «Чек-лист проверки: закрыть отмеченные задачи»); когда отмечено всё, закроется и сам чек-лист.

При «Подключиться» и по команде «Диагностика подключения…» расширение проходит проверки: адрес → сервер отвечает → токен принят → доступ к проектам → git установлен → git читает репозиторий по токену. В отчёте у каждой проблемы есть подсказка и кнопка быстрого исправления. Активный проект помечен ★ в разделах «Проекты» и «Локальные проекты».

  1. В OneDev: профиль → Access Tokens → создайте токен. Для чтения достаточно права чтения кода; для push, создания задач/PR/проектов и комментариев нужны права записи (токен действует с правами вашего пользователя).
  2. В VS Code: значок OneDev на боковой панели → Подключиться к OneDev… (или команда OneDev: Подключиться к OneDev…, или пункт в меню «Настройка»). Введите адрес сервера и токен.

Токен хранится в защищённом хранилище VS Code (SecretStorage) и не записывается ни в settings.json, ни в URL, ни в .git/config. Для git-команд расширение передаёт его через переменные окружения процесса (http.extraHeader) и только для remote, который указывает на ваш сервер OneDev.

Если токен отозван или просрочен (сервер ответил 401), расширение один раз предупредит уведомлением с кнопкой Изменить токен…, покажет предупреждение в строке состояния и в начале дерева и приостановит фоновые обновления. Команда OneDev: Изменить токен… (также в меню «Настройка») спрашивает только новый токен, проверяет его и сразу возобновляет работу, адрес сервера вводить не нужно. Остальные ошибки тоже сопровождаются быстрым исправлением: 403 — открыть страницу токенов (нужны права записи), ошибка сертификата — принять сертификат (onedev.allowInsecureTls), нет связи — повторить или Изменить адрес сервера…. Когда сервер недоступен, в строке состояния появляется «нет связи» (клик — проверить подключение); пока он не ответил, фоновые опросы молчат и повторяют попытки.

Безопасность авто-синхронизации

  • Никакого force-push и никаких автоматических merge/rebase.
  • pull — только --ff-only; в авто-режиме пропускается, если в отслеживаемых файлах есть незакоммиченные изменения.
  • push — только если локальная ветка строго впереди сервера и у неё уже есть upstream. Новые ветки автоматически не публикуются (только вручную кнопкой push или командой «Коммит и push»).
  • При расхождении истории расширение лишь сообщает об этом (один раз, пока ситуация не изменится).
  • По умолчанию включён только fetch; pull, push и push после коммита включаются в настройках.
  • Флаг по проекту: у проекта можно выключить авто-синхронизацию (контекстное меню, Ctrl+Alt+O, A). Такой проект пропускается таймером, возвратом фокуса и push после коммита; ручная синхронизация работает всегда. Флаг хранится в состоянии VS Code, а не в настройках и не в репозитории.
  • Push после коммита срабатывает только на новые коммиты (commit, commit --amend, merge-коммит, cherry-pick, revert) — не на переключение веток, pull или rebase. Следит за .git/logs/HEAD, поэтому работает и для репозиториев, не открытых в окне, и для коммитов из внешнего терминала. Серия коммитов подряд отправляется одним push.
  • Запуск и перезапуск job, отмена сборки всегда требуют подтверждения в модальном окне: job может выполнять развёртывание. Запуск job возможен только на коммите, который уже есть на сервере (после push). Токен при этом передаётся в заголовке, а не в URL (отдельный эндпоинт OneDev trigger-job требует токен в адресе, поэтому не используется).

Настройки (onedev.*)

Ключ По умолчанию Смысл
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…»).
  • Contact us
  • Jobs
  • Privacy
  • Manage cookies
  • Terms of use
  • Trademarks
  • Your Privacy Choices
  • Consumer Health Privacy
© 2026 Microsoft