Slug сменён у текущего сайта второго аккаунта, в новом браузере страница открывается по прямой ссылке. AGENTS.md и скилл vault-note: новый адрес, пометка не возвращать slug zapret, проверка зеркала в приватном окне; в скилле исправлено, что сайт пересобирается после push, а не после локального коммита. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
26 KiB
| publish |
|---|
| false |
AGENTS.md — правила работы с этим репозиторием
Это Obsidian-хранилище проекта ZapretKVN (приватность, обход DPI и цензуры). Его Git-репозиторий хранится в Forgejo: zapretdiscordyoutube/todo на git2.zapret.moe (старое имя git.zapret.moe в России заблокировано); материалы публикуются на сайт https://uwrmkvouze.fuckingspeedtest.com (self-hosted Quartz 4; с 7 ноября 2026 живёт не на этом хосте, а в контейнере CT 204 на US2-7, каталог /srv/wiki-quartz, схема — в ~/pve-admin/servers.md). Публикация привязана к Git: каждый push в main автоматически пересобирает сайт. У сайта свой клон vault в CT 204: wiki-autopull.timer раз в минуту подтягивает main с Forgejo, а wiki-rebuild.path следит за .git/logs/HEAD этого клона и запускает wiki-rebuild.service. Один локальный коммит без push на сайт не попадает. Отдельного шага «опубликовать» больше нет.
Git-процесс: коммитим прямо в main
Ветки и pull request'ы не используются. Готовые правки коммитятся напрямую в main и пушатся — это решение владелицы репозитория (25 июля 2026), принятое взамен прежней схемы «ветка → PR → merge».
Почему так: репозиторий ведёт один человек, ревьюить PR некому, а Forgejo Actions здесь запускают проверку на push в main (см. ниже). PR не давал дополнительного ревью, а только добавлял лишний шаг.
Порядок работы:
git fetch originперед началом, чтобы не разойтись с remote;- добавлять в staging только подтверждённые файлы, не
git add -Aвслепую; git diff --checkперед коммитом;- осмысленное сообщение коммита на русском: первая строка — суть, дальше абзац с деталями;
git pushвmain.
Не коммитить: .obsidian/ и служебные файлы .claude/ (настройки, worktrees, файлы задач) — они в .gitignore.
Скиллы и память коммить всегда, вместе с остальными правками (решение владелицы от 1 ноября 2026, только для этого vault). Изменения в .claude/skills/, .agents/skills/ и .memory/ идут в коммит и push тем же порядком, без отдельной просьбы; это касается и сторонних скиллов (avoid-ai-writing, stop-slop). Репозиторий публичный, поэтому перед таким коммитом проверь эти файлы на реальные адреса и секреты: IP хостов заменяй ссылкой на ~/pve-admin/servers.md, токены и пароли не пиши вовсе. Pre-commit хук проверяет их на заблокированные имена сайта, как и статьи: в заметках памяти старое имя не переписывай через zapret-links rewrite, а перефразируй без буквального имени. На сайт эти папки не попадают: .claude, .agents и .memory стоят в ignorePatterns Quartz.
Новую статью публикуй сам, не спрашивая (решение владелицы от 7 октября 2026). Когда статья дописана и проверки пройдены, сразу коммить её с вложениями в main, пушь и заливай на зеркало Obsidian Publish — отдельного подтверждения «публиковать?» не нужно. Обложку не жди: статья публикуется сразу, обложка ставится отдельной правкой, когда придёт (решение владелицы от 31 октября 2026, см. «Обложки статей»). В рабочем дереве часто лежат чужие незакоммиченные правки: в коммит бери только файлы своей статьи, а на зеркало заливай их по одному через obsidian publish:add path=<путь>, потому что publish:add changed выгрузит с диска и чужие черновики.
Forgejo Actions
На каждый push в main срабатывает workflow .forgejo/workflows/content-check.yml. Он получает текущий commit и его непосредственного родителя, чтобы проверять именно новая правка, а не всю историю хранилища. Workflow проверяет:
- что в последнем опубликованном commit нет проблем с пробелами и концами строк через
git diff --check HEAD^ HEAD; - что корневой
index.htmlсуществует и не пуст.
Публикацию на сайт этот workflow не выполняет — сайт собирается локальным systemd-юнитом, см. ниже.
Публикация на сайт (wiki2.zapret.moe)
Адреса вики и git — рабочие имена из реестров хоста (решения владелицы от 24 и 30 октября 2026). Старые wiki.zapret.moe и git.zapret.moe в России заблокированы по имени; nginx уводит с них на рабочие имена, но читатель за блокировкой до редиректа не доходит. С 30 октября людям раздаются зеркала со случайными именами (сейчас вики jzesawgjsz.zapret.moe, git cwdnvtsqdc.zapret.moe; wiki2…wiki6 и git2…git6 работают, но больше не раздаются), а посты для Telegram наш домен не называют вовсе: ссылка в посте ведёт на входную страницу на большой платформе (сейчас Google Apps Script), она отправляет на рабочее зеркало; md2tghtml.py делает это сам. В статьях, плашках [!mirror], на картинках и в Forgejo-футере пиши рабочие имена (zapret-links link wiki / link git), не вписывай номер зеркала по памяти.
Какое имя рабочее, решают не правила в тексте, а реестры хоста /etc/zapret-wiki-domains.conf и /etc/zapret-git-domains.conf (их ведут zapret-*-domains, а когда их звать, решает контроллер имён zapret-links names; флаг blocked). Единая точка — служба zapret-links (~/zapret-links): zapret-links link wiki / link git печатает имя для ссылок, zapret-links rewrite ФАЙЛ… заменяет в файлах все заблокированные имена на рабочие, zapret-links check ФАЙЛ… их находит. На него опираются:
- pre-commit хук vault (
.git/hooks/pre-commit): коммит с заблокированным именем в добавленных строках отклоняется; - сборка Quartz:
baseUrlи ссылки статей на заблокированные имена git и вики берутся из реестров (transformerSiteLinks); render.pyскиллаvault-chart: заблокированное имя в HTML диаграммы заменяется на рабочее;md2tghtml.pyскиллаvault-note: каждая ссылка на вики и git в посте становится входной (zapret-links rewrite --entry);wiki-rebuild(robots.txt) иwiki-indexnow.
Если заблокируют и wiki2/git2, контроллер сам пометит имя blocked, сборка вики и рендер переключатся сами; в тексте vault останется прогнать zapret-links rewrite по всем .md одним коммитом и перерендерить картинки, где имя впечатано в пиксели, — после этого обнови эту строку.
Сайт — статический, собирается Quartz 4 из клона vault в CT 204 (npx quartz build -d /home/codex-pve/Privacy в /srv/wiki-quartz внутри контейнера). Запускать руками ничего не нужно: любой push в main триггерит пересборку (задержка до минуты на wiki-autopull). Принудительная пересборка без нового коммита выполняется в CT 204: systemctl start wiki-rebuild.service или /usr/local/bin/wiki-rebuild; на этот хост (pve) она больше не распространяется.
URL заметки = путь в vault со слагами Quartz (пробелы → -, кириллица сохраняется): Zapret/home.md → https://uwrmkvouze.fuckingspeedtest.com/Zapret/home. Главная / — это alias index в frontmatter Zapret/home.md.
Как исключить файл из публикации: добавить в его frontmatter publish: false — фильтр RemoveNoPublish в Quartz не пропустит такую заметку на сайт, при этом она остаётся в Git. Так исключён сам AGENTS.md.
Закрытые разделы. Папки VPS/, scripts/, .obsidian/, .claude/, .agents/, .forgejo/ и корневые index.html, AGENTS.md вырезаются на уровне ignorePatterns в /srv/wiki-quartz/quartz.config.ts — в сборку не попадают ни заметки, ни вложения из них. В VPS/ лежат IP, пароли и детали инфраструктуры — новые закрытые папки добавлять именно в ignorePatterns, а не полагаться только на publish: false (frontmatter не защищает вложения).
При переименовании заметки старый путь исчезает с сайта сам при следующей пересборке; чтобы старые внешние ссылки не ломались, можно добавить старый слаг в aliases: frontmatter — Quartz сделает редирект.
Зеркало на Obsidian Publish. До 20 августа 2026 основной сайт жил на Obsidian Publish; теперь основная вики — wiki2.zapret.moe, а Obsidian Publish остаётся резервным зеркалом (https://publish.obsidian.md/zapretwiki, с 19 ноября 2026; прежний slug zapret отдавал 404 на прямые ссылки к страницам, см. скилл) и должен быть в актуальном состоянии. После коммита и пуша заливай изменения командами obsidian publish:* (порядок, исключения и настройки сайта — в разделе «Публикация в Obsidian Publish (зеркало)» скилла .claude/skills/vault-note/SKILL.md). Скрипт scripts/publish-safe.sh устарел и оставлен только как история. В ссылках на вики используй основной адрес wiki2.zapret.moe, а не зеркало.
Проверка перед публикацией
Вместо ручных grep-скриптов используйте встроенные проверки CLI:
"$HOME/.local/bin/obsidian" vault="Privacy" unresolved counts # битые [[wikilinks]] по всему хранилищу
"$HOME/.local/bin/obsidian" vault="Privacy" orphans # заметки без входящих ссылок (сироты)
"$HOME/.local/bin/obsidian" vault="Privacy" links path=… # исходящие ссылки конкретной заметки
"$HOME/.local/bin/obsidian" vault="Privacy" backlinks path=… # кто ссылается на заметку
После добавления новой заметки unresolved не должен приобретать новых записей из-за неё, а сама заметка не должна оставаться в orphans — если осталась, не хватает ссылки из соседней заметки или из обзора раздела.
Заметки
Правила написания заметок вынесены в скилл vault-note (.claude/skills/vault-note/SKILL.md) — он обязателен при создании, правке и публикации любой .md в этом хранилище: самодостаточность, атомарность, frontmatter, callout-ы, [[wikilinks]], Forgejo-футер, запрет ручных переносов прозы.
Источники в заметке — кликабельные ссылки внутри текста плюс список внизу (решение владелицы от 7 октября 2026). Каждое утверждение, взятое из источника, несёт ссылку прямо на словах фразы — [«Ведомости» сообщили](https://…), без голых URL и без упоминаний издания без ссылки. Дополнительно перед «См. также» идёт раздел «Источники» с теми же ссылками одним кликабельным списком. Подробности и исключение для репозитория Flowseal — в скилле vault-note.
Пост для Telegram отдавай отрендеренной HTML-страницей (решение владелицы от 7 октября 2026, способ передачи уточнён 4 ноября 2026): текст в блоке кода плюс путь к файлу страницы в обратных кавычках отдельной строкой, например /var/tmp/school-post/post-school-recording.html. Панель показывает такой путь кликабельным, и владелица открывает файл сама; страницу с кнопкой «Скопировать» собирает скрипт .claude/skills/vault-note/scripts/md2tghtml.py. Если в сессии есть инструмент Artifact, дополнительно дай ссылку claude.ai/artifact/… отдельной строкой. Блок кода без страницы выдачей не считается; фразу «файл до вас не дойдёт» не пиши. Порядок — в разделе «Выдача поста» скилла vault-note.
Женский род — только для голоса владелицы (решение владелицы от 1 ноября 2026). Где текст говорит от лица владелицы, то есть от первого лица в единственном числе (обычно в постах для Telegram), глаголы и прилагательные стоят в женском роде: «я нашла», «я увидела», «я проверила». В правилах, заметках памяти, коммитах и файлах задач о ней пишут «владелица», «пользовательница», «она». Читатель рода не имеет: статью может открыть кто угодно. Поэтому обращение к читателю строится без рода: «вы задали», «если у тебя стоит Zapret», «проверь», но не «ты установил» и не «ты установила». Запрет на первое лицо ассистента в статьях остаётся в силе. Подробности — в скилле vault-note.
Отдельное правило: Zapret/home.md не трогать — навигацию на главной ведёт владелица вручную.
Актуальность статей про Zapret GUI
Решение владелицы от 4 ноября 2026: интерфейс Zapret 2 GUI меняется каждые одну-две версии, и статьи со скриншотами устаревают быстрее всего, поэтому ассистент сам держит их в соответствии с программой, не дожидаясь отдельной просьбы.
- Когда обновлять. При выходе новой версии GUI (релиз на Git-сервере, пост в Telegram-канале, статья-changelog в вики), когда владелица присылает скриншот или описание нового интерфейса, а также когда по ходу любой другой работы замечено, что статья описывает разделы, кнопки или пути, которых в программе уже нет. Нашёл расхождение — исправь в этой же сессии или оставь заметку в файле задачи, но не проходи мимо.
- Что обновлять. Скриншоты, названия разделов бокового меню и кнопок, пути к файлам и папкам, перечень вкладок и параметров, версию программы в тексте. Затем ссылки на соседние заметки: когда раздел переименован или исчез (как «Прямой запуск», который в версии 21 стал «Профилями пресета»), исправь все упоминания по всему хранилищу, а не в одной статье. Найти их помогает
grep -rIn "старое название" --include=*.md .и поиск по именам старых скриншотов (Pasted image 2025…,2026022…). - Скриншоты клади в
attachmentsсвоего раздела (Zapret/attachments,Zapret2/attachments) под именами по смыслу (guide-gui-my-presets.png, а неPasted image …). Старые файлы, на которые больше нет ссылок, не удаляй без просьбы: вики сама перестаёт их показывать, а проверить, не нужны ли они где-то ещё, дольше, чем оставить. - Пиши версию программы рядом со скриншотами («скриншоты сняты в версии 21.1.7.228»), чтобы читатель и следующая сессия видели, на что опиралась статья.
- Не описывай интерфейс по памяти. Если свежего скриншота нужного экрана нет, не переписывай раздел наугад: оставь прежний текст, пометь версию, на которой он сверен, и попроси скриншот. Выдуманная кнопка хуже устаревшей.
- Публикуй сразу по обычному порядку (проверка сборки, коммит своих файлов, push, зеркало Obsidian Publish): обновление скриншотов не требует отдельного подтверждения.
- Какие статьи затрагивает интерфейс в первую очередь:
Zapret/download,Zapret/Как пользоваться Zapret,Zapret2/guide,Zapret2/preset,Zapret2/profile,Zapret2/add-profile,Zapret2/log-analyzer,Zapret/Blockcheck,Zapret/hosts,Zapret/Ошибка запуска - Не удалось запустить DPI,Zapret2/find-game-strategy,Zapret2/exclusions.
Обложки статей: Запрет-тян и РКН-тян
Решение владелицы от 24 октября 2026.
- У каждой новой статьи три части: сама статья, пост для Telegram и промпт обложки. Пост и промпт готовь сам, без просьбы, в том же ответе, где статья готова. Пост выдавай по правилу из раздела «Заметки» (блок кода плюс путь к HTML-странице в обратных кавычках), промпт — блоком кода, и сохрани его в
gptimage/. - Статью публикуй сразу, обложку ставь потом (решение владелицы от 31 октября 2026, заменило правило от 24 октября «сначала обложка, потом публикация»). Как только статья, пост и промпт готовы и проверки пройдены, коммить статью с диаграммами, пушь и заливай на зеркало, не дожидаясь картинки; поле
image:и embed обложки пока не ставь. Картинку по промпту генерирует владелица и присылает в чат. Пока её нет,✔ DONEне пиши и держи в файле задачи пункт «You: сгенерировать обложку по промпту и прислать её». Когда обложка пришла, поставь её шапкой статьи по скиллуvault-image(embed и полеimage:во frontmatter), сохрани картинку и рядом с промптом вgptimage/, затем коммить, пушь и заливай на зеркало. Таймер на это ожидание не ставь: сессию разбудит сообщение владелицы с картинкой. - Как придумать обложку. Реши, что делают Запрет-тян и РКН-тян так, чтобы сцена отражала тему статьи, где это происходит и какой камерой снимать. Камеру выбирай из двух вариантов: дальний план в полный рост с ногами в кадре или средний план до середины бедра. Средний план используй время от времени, а не всегда дальний.
- Промпт пиши по шаблону из папки
gptimage/. В начале две строки на русском об эмоциях Image 1 и Image 2. Дальше блоки Scene, Composition, Style, Constraints на английском. Ограничения: правильная анатомия, никаких лишних персонажей и водяных знаков, ни одной читаемой надписи. Требования «скромного кадра» нет: владелица убрала его 3 ноября 2026 как добавленное по ошибке. - В каждый промпт вставляй блок персонажей из
gptimage/characters.md. Он идёт сразу после строк об эмоциях: кто на каком референсе, их приметы и запрет менять лица, причёски, одежду и цвета. Одежду героинь текстом не описывай, она берётся только с приложенных референсов. Для Хэллоуина это чёрно-оранжевые листы персонажей, для остальных сцен повседневный вид. Текстом называй лишь то, что не меняется: волосы, глаза, клыки, а также возраст и сложение. Обе героини — взрослые девушки лет двадцати пяти, высокие, с длинными ногами и взрослыми пропорциями. Без этой строки генератор рисует их детскими. Слова «cute», «tiny», «playful» рядом с героинями не пиши. Иначе текст перевешивает картинки, и генератор переодевает героинь. - В каждой сцене стоит белая кружка с эмблемой Роскомнадзора, без надписей. В Constraints она указана единственным разрешённым логотипом.
- Каждый новый промпт сохраняй в
gptimage/. Одна сцена в одном.mdсpublish: false, рядом картинка-результат под тем же именем. Готовые локации и пресеты камеры (camera-presets.md) лежат там же. Сначала бери их, чтобы не писать заново. - Папку
gptimage/не коммить без отдельной просьбы. Любой push вmainпересобирает публичный сайт, аpublish: falseне защищает картинки.
Response format
The response format rules are common to all projects: the "Response format" section in /home/codex-pve/AGENTS.md. Read it and follow it in every session; change the rules only there.