89bc69cf3b
## Summary
- New **Support CodeNomad** help page (10 languages): what sponsorship
pays for, the funding policy (a contribution, not a purchase; never
required to download, use or update) and one button per funding channel
naming who receives the money.
- **Download page** ends with a short *Support development* section with
the same buttons; the help **header** gains a *Sponsor* link; the former
support page is retitled **Bug reports and source builds** (ids
unchanged) so the two are not confused.
- **App**: *Support CodeNomad* in Settings → Info (secondary button
between Updates and Diagnostics), in the Help menu after *CodeNomad
Help* (Electron and Tauri, English help-page fallback) and as a palette
command without a default shortcut. All open the localized help page.
- **Repository**: `.github/FUNDING.yml` lists the maintainer's GitHub
Sponsors profile and the Support page (the Sponsor button needs
*Settings → General → Features → Sponsorships*).
Channels live in `docs/help/funding.json` and render through a
`{{funding}}` directive allowed only on the download and sponsor pages,
so adding a channel needs no retranslation. Entries are validated (exact
keys, unique ids, `https://github.com/sponsors/<login>` only) and
escaped; a page using `{{funding}}` with no channel fails the build. CSP
unchanged.
Agreed with the co-maintainer before publishing.
## Validation
- `npm run test:help`: 31/31 (27 pages × 10 locales, funding validation
and placement).
- `node scripts/test-help-browser.mjs`: 47/47 (header overflow at 390 px
in en/he/ne/ja/zh-Hans, button geometry).
- `npm run typecheck`; unit tests help-url, hotkey-bindings,
menu-labels; browser tests help-command, server-info, view-menu-electron
(22/22); `cargo test` for the Tauri crate (291/291, including the
English sponsor fallback).
- Independent review: zero findings.
12 KiB
Горячие клавиши
Поиск команд и открытие справки
- Откройте Палитра команд через
Ctrl+Shift+Pв Windows/Linux илиCmd+Shift+Pв macOS либо видимой кнопкой/пунктом меню. - Введите название действия. Палитра включает действия приложения и пользовательские команды текущей Location; доступность зависит от активного вида.
- Выполните Открыть справку для открытия этого руководства на текущем языке интерфейса во внешнем браузерном контексте. Нативное Справка → Справка CodeNomad открывает то же руководство. Поддержать CodeNomad (нативное Справка → Поддержать CodeNomad) так же открывает страницу Поддержать CodeNomad.
Справка не меняет вид приложения и черновик. При сбое открытия посетите справку CodeNomad напрямую. Наличие команды в поиске не означает настраиваемое сочетание: менеджер охватывает фиксированный каталог из 75 действий интерфейса, не все действия палитры или нативного меню. В него входят команды палитры, например Компактировать сессию, Отменить последнее сообщение или Открыть справку, у которых изначально Нет сочетания; действия с папкой проекта, терминалом и редактором работают только в локальных настольных окнах.
Запись, отключение и сброс
- Откройте Настройки → Горячие клавиши и найдите действие или сочетание клавиш через Фильтр сочетаний.
- Выберите Изменить, затем нажмите нужное сочетание в Нажмите сочетание клавиш. Запись сохраняет привязку.
- Используйте Очистить сочетание (×) для удаления привязки интерфейса этого действия, Сбросить для восстановления по умолчанию или Сбросить все для всех привязок интерфейса.
- Разрешите предупреждения каждой конфликтующей строки; конфликты сообщаются, не отключаются незаметно.
Привязки сохраняются в конфигурации интерфейса CodeNomad и влияют на клиентов с общей конфигурацией. Не меняют CLI/TUI-привязки OpenCode и ускорители нативного меню. Запись подавляет сочетания интерфейса приложения, но не может подавить ОС или нативное меню. Отмена, потеря фокуса, закрытие раздела или уход из окна завершает запись. Отдельные модификаторы и композиция IME игнорируются; обычные Tab/Shift+Tab перемещают фокус.
При сбое сохранения держите старое сочетание доступным и повторите после проверки показанной привязки. Сброс — безопасное восстановление после случайного назначения.
Значения интерфейса по умолчанию
Mod означает Ctrl в Windows/Linux и Cmd в macOS. Это значения по умолчанию, не гарантия доставки клавиши ОС/нативным хостом. Область важна: одна клавиша может выполнять разные действия на главной странице, в поле ввода или поиске.
| Действие | По умолчанию |
|---|---|
| Открыть палитру команд | Mod+Shift+P |
| Новый экземпляр / обзор папки на главной странице | Mod+N |
| Закрыть вкладку приложения | Mod+W |
| Предыдущая / следующая вкладка приложения | Mod+[ / Mod+] |
| Вкладка приложения 1–9 | От Mod+1 до Mod+9 |
| Переименовать экземпляр (контекст вкладки) | F2 |
| Новая сессия | Mod+Shift+N |
| Закрыть сессию | Mod+Shift+W |
| Предыдущая / следующая сессия | Mod+Shift+[ / Mod+Shift+] |
| Вкладка сессии 1–9 | От Mod+Shift+1 до Mod+Shift+9 |
| Информация об экземпляре | Mod+Shift+L |
| Поиск по истории сессии | Mod+F |
| Предыдущее / следующее сообщение пользователя | Alt+ArrowUp / Alt+ArrowDown (Windows, Linux) или Mod+Alt+ArrowUp / Mod+Alt+ArrowDown (macOS) |
| Следующий / предыдущий результат (фокус в поиске) | Enter / Shift+Enter |
| Фокус на запрос / очистить запрос | Mod+P / Mod+K |
| Открыть выбор модели / агента | Mod+Shift+M / Mod+Shift+A |
| Выбрать вариант модели | Mod+Shift+T |
| Переместить блокирующие инструменты в фон (поле ввода) | Mod+B |
| Отправить запрос | Enter |
| Отправить с альтернативным поведением последующего запроса | Alt+Enter (Windows, Linux) или Mod+Shift+Enter |
| Вставить новую строку | Shift+Enter или Mod+Enter |
| Предыдущий / следующий запрос (поле ввода) | ArrowUp / ArrowDown |
| Убрать фокус с запроса / выйти из режима Shell | Escape, по контексту поля ввода |
| Остановить сессию | Дважды Escape; первое нажатие показывает подтверждение |
Отправить побочный вопрос (окно /btw) |
Mod+Enter |
| Сохранить файл (редактор рабочей области) | Mod+S |
Если отправка по Enter отключена, Отправить запрос по умолчанию — Mod+Enter, Вставить новую строку — Enter или Shift+Enter. Явное переопределение заменяет это значение. Смотрите фактическую привязку в менеджере. В macOS Option+Return остаётся переводом строки, поэтому с альтернативным поведением отправляет только Cmd+Shift+Return; меню Больше действий поля ввода предлагает тот же выбор (Поставить сообщение в очередь или Направить сейчас), пока сессия работает. Очистить ввод выполняет собственное действие очистки поля ввода, в том числе в первом черновике нового разговора. Предыдущая/следующая сессия перебирает список; это не браузерная история Назад/Вперёд боковой панели, у которой нет сочетания.
Нативные клавиши и перехват платформой
Нативные клавиши фиксированы и остаются активными после изменения или отключения соответствующей привязки интерфейса. В частности, нативное Новое окно использует Mod+Shift+N — значение интерфейса для новой сессии. Используйте видимый элемент новой сессии или переназначьте действие, если нативное меню перехватывает его. Аналогично нативное Mod+W может закрыть окно вместо вкладки приложения.
| Нативное действие | Electron | Tauri |
|---|---|---|
| New Window | Mod+Shift+N |
Mod+Shift+N |
| New Instance / Command Palette | Mod+N / Mod+Shift+P |
Mod+N / Mod+Shift+P |
| Reload / Force Reload | Mod+R / Mod+Shift+R |
Mod+R / Mod+Shift+R |
| Actual Size | Mod+0 |
Mod+0 |
| Zoom | Mod+Plus / Mod+- |
Управление меню «Вид» и масштабирование webview платформы |
| Full Screen | F11 в Windows/Linux; Ctrl+Cmd+F в macOS |
Ускоритель меню Ctrl+Cmd+F в macOS; на других платформах используйте меню |
| Developer Tools | Ctrl+Shift+I в Windows/Linux; Alt+Cmd+I в macOS |
Alt+Mod+I |
Обычные окна браузера тоже сохраняют свои сочетания. Если привязка не достигает CodeNomad, выберите другую комбинацию вместо отключения защиты или изменения системных клавиш.
Раскладки клавиатуры и ввод текста
Сочетания цифрового ряда и квадратных скобок используют физические позиции клавиш для записи, выполнения и проверки конфликтов, включая AZERTY/QWERTZ. Другие клавиши используют логические значения. Записывайте на нужной клавиатуре, затем проверьте результат.
Во время композиции IME ввод текста приоритетен. История запросов и Escape тоже зависят от фокуса, состояния выбора/оболочки и текущей операции; не считайте каждый ArrowUp или Escape безусловным глобальным действием. На настольных устройствах отправка переводит фокус на разговор, чтобы стрелки, клавиши листания и пробел прокручивали его; ввод символа возвращает в поле ввода вместе с этим символом, а Перейти к вводу возвращает туда перед использованием истории запросов. Подсказки называют текущее сочетание таких элементов, как палитра команд, поиск, новая сессия, информация и переключатели поля ввода; вместе с менеджером сочетаний они показывают назначения без постоянной полосы клавиатурной справки.