<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="ru">
    <title>Антон Васильев - keebs</title>
    <subtitle>Тривиальные заметки о разработке программ</subtitle>
    <link rel="self" type="application/atom+xml" href="https://antono.info/ru/tags/keebs/atom.xml"/>
    <link rel="alternate" type="text/html" href="https://antono.info"/>
    <generator uri="https://www.getzola.org/">Zola</generator>
    <updated>2026-06-25T13:34:21+00:00</updated>
    <id>https://antono.info/ru/tags/keebs/atom.xml</id>
    <entry xml:lang="ru">
        <title>Один флейк, чтоб собрать их все: как я управляю пятью сплитами через Nix</title>
        <published>2026-06-25T13:26:52+00:00</published>
        <updated>2026-06-25T13:34:21+00:00</updated>
        
        <author>
          <name>Unknown</name>
        </author>
        
        <link rel="alternate" type="text/html" href="https://antono.info/ru/blog/2026/06/25/keebs-nix/"/>
        <id>https://antono.info/ru/blog/2026/06/25/keebs-nix/</id>
        
        <content type="html" xml:base="https://antono.info/ru/blog/2026/06/25/keebs-nix/">&lt;h2 id=&quot;moia-istoriia-s-mekhanicheskimi-klaviaturami&quot;&gt;Моя история с механическими клавиатурами&lt;/h2&gt;
&lt;p&gt;Всё началось в декабре 2022-го. Я купил Dao — 42-клавишный сплит с колоночным стаггером на &lt;a rel=&quot;external&quot; href=&quot;https://zmk.dev&quot;&gt;ZMK&lt;/a&gt; — и всё, пропал. Подсел!&lt;/p&gt;
&lt;p&gt;Есть в сплитах что-то такое, что перепрошивает само представление о печати. Руки перестают тянуться к дальним клавишам. Цифровой ряд, ряд символов, блок навигации — всё это заменяют слои. Кеймап превращается в личный артефакт, который ты месяцами подкручиваешь под себя. А как только одну клаву довёл до ума — хочется следующую, чтобы допиливать уже её.&lt;/p&gt;
&lt;p&gt;Три с половиной года спустя у меня их &lt;strong&gt;пять&lt;/strong&gt;:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Ergonaut One — сплит с колоночным стаггером (Seeeduino XIAO BLE + шилд)&lt;/li&gt;
&lt;li&gt;HolySwitch TK44 — моносплит в цельном корпусе (кастомная плата)&lt;/li&gt;
&lt;li&gt;Mriya46 — сплит с колоночным стаггером (две кастомные платы на nRF52840)&lt;/li&gt;
&lt;li&gt;Dao — та самая, с которой всё началось, 42-клавишный сплит (+ ZMK Studio)&lt;/li&gt;
&lt;li&gt;Charybdis Mini — 34-клавишный сплит с трекболом&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;Пять клавиатур — это прекрасно.&lt;/p&gt;
&lt;p&gt;Но пять клавиатур — это ещё и задачка по управлению конфигурацией.&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://antono.info/ru/blog/2026/06/25/keebs-nix/489949bc-5358-4de4-b946-2b2e2012ef72.jpeg&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;p&gt;Каждой клавиатуре на ZMK нужен свой репозиторий &lt;code&gt;zmk-config&lt;/code&gt;. Принятый в сообществе путь хорошо протоптан и, честно говоря, вполне дружелюбен к новичкам:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;Форкаешь чей-нибудь репозиторий &lt;code&gt;*-zmk-config&lt;/code&gt; на GitHub.&lt;/li&gt;
&lt;li&gt;Правишь файл &lt;code&gt;.keymap&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;Пушишь.&lt;/li&gt;
&lt;li&gt;GitHub Actions читает &lt;code&gt;build.yaml&lt;/code&gt;, поднимает раннер, клонирует Zephyr + ZMK, компилирует и выкладывает артефакты &lt;code&gt;.uf2&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;Скачиваешь zip, распаковываешь, прошиваешь каждую половинку.&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;Для новичка это удобно, но есть нюансы:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Любая правка — даже исправление одного кейкода — это коммит → пуш → ждёшь, пока раннер с нуля склонирует Zephyr → качаешь zip → распаковываешь → прошиваешь. Минуты на круг ради правки в один символ.&lt;/li&gt;
&lt;li&gt;Пять репозиториев, пять форков, пять историй. Каждая клава — отдельный форк, каждый потихоньку уползает от своего апстрима, у каждого свои причуды. Чтобы привести все пять кеймапов к одной раскладке, приходилось делать пять PR в пяти местах.&lt;/li&gt;
&lt;li&gt;Никакой воспроизводимости. «В прошлом месяце собиралось» — совсем не то же самое, что «сегодня собирается в те же самые байты». &lt;code&gt;main&lt;/code&gt; в апстриме ZMK уезжает вперёд, раннеры меняются, и в один прекрасный день твой конфиг просто перестаёт компилироваться. На этом последнем пункте я и погорел. ZMK &lt;code&gt;main&lt;/code&gt; переехал на **Hardware Model v2** из Zephyr, а там переименовали те самые платы, от которых зависят мои конфиги (seeeduino_xiao_ble → xiao_ble, nice_nano_v2 → nice_nano). Конфиги, которые прекрасно собирались, внезапно перестали. А на вопрос «как запинить весь мир» у схемы «CI + форк» ответа нет.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;keebs-nix-odin-fleik-chtob-sobrat-ikh-vse&quot;&gt;keebs-nix: один флейк, чтоб собрать их все&lt;/h2&gt;
&lt;p&gt;А вот у Nix ответ на «запинить весь мир» как раз есть. Поэтому я сделал &lt;a rel=&quot;external&quot; href=&quot;https://github.com/antono/keebs-nix&quot;&gt;keebs-nix&lt;/a&gt; — единый самодостаточный флейк поверх &lt;a rel=&quot;external&quot; href=&quot;https://github.com/lilyinstarlight/zmk-nix&quot;&gt;zmk-nix&lt;/a&gt;, который собирает прошивки для всех пяти клавиатур.&lt;/p&gt;
&lt;p&gt;Полный ZMK-конфиг каждой клавиатуры — &lt;code&gt;west.yml&lt;/code&gt;, &lt;code&gt;boards/&lt;/code&gt;, кеймапы, &lt;code&gt;.conf&lt;/code&gt; — &lt;strong&gt;завендорен&lt;/strong&gt; в этот репозиторий как есть, один в один. Никаких форков, внешних репозиториев с конфигами и сабмодулей. У флейка ровно два входа: &lt;code&gt;nixpkgs&lt;/code&gt; и &lt;code&gt;zmk-nix&lt;/code&gt;.&lt;/p&gt;
&lt;h2 id=&quot;chto-umeet-fleik&quot;&gt;Что умеет флейк&lt;/h2&gt;
&lt;p&gt;Собирает всё одной командой.&lt;/p&gt;
&lt;pre class=&quot;giallo&quot; style=&quot;color-scheme: light dark; color: light-dark(#24292E, #E1E4E8); background-color: light-dark(#FFFFFF, #24292E);&quot; &gt;&lt;code data-lang=&quot;shellscript&quot;&gt;&lt;span class=&quot;giallo-l&quot;&gt;&lt;span style=&quot;color: light-dark(#6F42C1, #B392F0);&quot;&gt;nix&lt;/span&gt;&lt;span style=&quot;color: light-dark(#032F62, #9ECBFF);&quot;&gt; build&lt;/span&gt;&lt;span style=&quot;color: light-dark(#6A737D, #6A737D);&quot;&gt;               #&lt;/span&gt;&lt;span style=&quot;color: light-dark(#6A737D, #6A737D);&quot;&gt; all firmware → ./result (combined .uf2 dir)&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span style=&quot;color: light-dark(#6F42C1, #B392F0);&quot;&gt;nix&lt;/span&gt;&lt;span style=&quot;color: light-dark(#032F62, #9ECBFF);&quot;&gt; build&lt;/span&gt;&lt;span style=&quot;color: light-dark(#032F62, #9ECBFF);&quot;&gt; .#dao&lt;/span&gt;&lt;span style=&quot;color: light-dark(#6A737D, #6A737D);&quot;&gt;         #&lt;/span&gt;&lt;span style=&quot;color: light-dark(#6A737D, #6A737D);&quot;&gt; or just one&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;На выходе — одна директория со стабильными, человекочитаемыми именами файлов. Больше не надо копаться в артефактах &lt;code&gt;zmk_left.uf2&lt;/code&gt; и гадать, от какой они клавы:&lt;/p&gt;
&lt;pre class=&quot;giallo&quot; style=&quot;color-scheme: light dark; color: light-dark(#24292E, #E1E4E8); background-color: light-dark(#FFFFFF, #24292E);&quot; &gt;&lt;code data-lang=&quot;plain&quot;&gt;&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt;ergonaut_one_left.uf2   ergonaut_one_right.uf2   ergonaut_one_settings_reset.uf2&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt;tk44.uf2&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt;mriya46_left.uf2        mriya46_right.uf2        mriya46_settings_reset.uf2&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt;dao_left.uf2            dao_right.uf2            dao_studio_left.uf2  ...&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt;charybdis_mini_left.uf2 charybdis_mini_right.uf2 charybdis_mini_settings_reset.uf2&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;Прошивает из командной строки.&lt;/p&gt;
&lt;pre class=&quot;giallo&quot; style=&quot;color-scheme: light dark; color: light-dark(#24292E, #E1E4E8); background-color: light-dark(#FFFFFF, #24292E);&quot; &gt;&lt;code data-lang=&quot;shellscript&quot;&gt;&lt;span class=&quot;giallo-l&quot;&gt;&lt;span style=&quot;color: light-dark(#6F42C1, #B392F0);&quot;&gt;nix&lt;/span&gt;&lt;span style=&quot;color: light-dark(#032F62, #9ECBFF);&quot;&gt; run&lt;/span&gt;&lt;span style=&quot;color: light-dark(#032F62, #9ECBFF);&quot;&gt; .#flash-dao&lt;/span&gt;&lt;span style=&quot;color: light-dark(#6A737D, #6A737D);&quot;&gt;        #&lt;/span&gt;&lt;span style=&quot;color: light-dark(#6A737D, #6A737D);&quot;&gt; prompts for left, then right&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span style=&quot;color: light-dark(#6F42C1, #B392F0);&quot;&gt;nix&lt;/span&gt;&lt;span style=&quot;color: light-dark(#032F62, #9ECBFF);&quot;&gt; run&lt;/span&gt;&lt;span style=&quot;color: light-dark(#032F62, #9ECBFF);&quot;&gt; .#flash-tk44&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span style=&quot;color: light-dark(#6F42C1, #B392F0);&quot;&gt;nix&lt;/span&gt;&lt;span style=&quot;color: light-dark(#032F62, #9ECBFF);&quot;&gt; run&lt;/span&gt;&lt;span style=&quot;color: light-dark(#032F62, #9ECBFF);&quot;&gt; .#flash-dao-reset&lt;/span&gt;&lt;span style=&quot;color: light-dark(#6A737D, #6A737D);&quot;&gt;  #&lt;/span&gt;&lt;span style=&quot;color: light-dark(#6A737D, #6A737D);&quot;&gt; settings reset, built on nice_nano_v2&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;Рисует схемы кеймапов. В README каждой клавиатуры встроена SVG-схема раскладки, которую &lt;a rel=&quot;external&quot; href=&quot;https://github.com/caksoylar/keymap-drawer&quot;&gt;keymap-drawer&lt;/a&gt; генерирует прямо из завендоренного кеймапа:&lt;/p&gt;
&lt;pre class=&quot;giallo&quot; style=&quot;color-scheme: light dark; color: light-dark(#24292E, #E1E4E8); background-color: light-dark(#FFFFFF, #24292E);&quot; &gt;&lt;code data-lang=&quot;shellscript&quot;&gt;&lt;span class=&quot;giallo-l&quot;&gt;&lt;span style=&quot;color: light-dark(#6F42C1, #B392F0);&quot;&gt;nix&lt;/span&gt;&lt;span style=&quot;color: light-dark(#032F62, #9ECBFF);&quot;&gt; run&lt;/span&gt;&lt;span style=&quot;color: light-dark(#032F62, #9ECBFF);&quot;&gt; .#draw-keymaps&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;img src=&quot;https://antono.info/ru/blog/2026/06/25/keebs-nix/d9d57029-2886-4492-b7db-c6b844a8f01b.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;p&gt;Так что документация физически не может разойтись с прошивкой — она парсится из того же файла &lt;code&gt;.keymap&lt;/code&gt;, что и сборка.&lt;/p&gt;
&lt;h2 id=&quot;pochemu-nix-pravil-nyi-instrument-dlia-etoi-zadachi&quot;&gt;Почему Nix — правильный инструмент для этой задачи&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;Воспроизводимость — по-настоящему.&lt;/strong&gt; Завендоренные west.yml пинят ZMK на v0.3-branch плюс Zephyr 3.5 — заведомо рабочую ревизию ещё до HWMv2. Это начисто обходит поломку с переименованием плат. Сборка, которая работает сегодня, и через год выдаст байт в байт то же самое. Nix не «старается» быть воспроизводимым — на этом он целиком и построен.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Одна общая загрузка зависимостей.&lt;/strong&gt; Во всех пяти конфигах лежит побайтово одинаковый west.yml, поэтому вместо того чтобы каждая клавиатура с нуля клонировала многогигабайтные деревья Zephyr и ZMK, одна fixed-output-деривация скачивает West-зависимости один раз, а все клавиатуры её переиспользуют. Один хеш в flake.nix покрывает весь парк. Загрузка к тому же делает неглубокий и узкий апдейт с depth 1, так что на медленном канале данные тянутся минуты, а не часы, — и переживает капризные сбросы HTTP/2-стримов GitHub на большом клоне.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Быстрый локальный цикл «поправил — прошил».&lt;/strong&gt; Правишь кеймап, запускаешь nix build, потом nix flash. Ни пуша, ни раннера, ни zip-архивов. Зависимости лежат в кеше, так что пересборка быстрая. В повседневной жизни это самый большой выигрыш по сравнению с круговоротом «CI + форк».&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Новая клавиатура — одна строчка.&lt;/strong&gt; Новые платы кладутся в директорию keyboards, плюс одна запись в мапе firmwareOutputs. Логика сборки бандла глобом находит реальные uf2-файлы каждой сборки и переименовывает их по общей схеме, так что и сплиты, и платы с единственной прошивкой просто работают — никаких захардкоженных имён файлов.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Самодостаточность.&lt;/strong&gt; Раз каждый конфиг завендорен, а не подключён по ссылке, ничего не может тихо протухнуть у меня за спиной. Dao даже вендорит определение своей платы из ZMK-модуля ergonautkb, а не тянет его через west.yml, так что он ничуть не менее самодостаточен, чем остальные.&lt;/p&gt;
</content>
        
    </entry>
</feed>
