Some checks failed
Published content check / validate (push) Failing after 7s
Slug сменён у текущего сайта второго аккаунта, в новом браузере страница открывается по прямой ссылке. AGENTS.md и скилл vault-note: новый адрес, пометка не возвращать slug zapret, проверка зеркала в приватном окне; в скилле исправлено, что сайт пересобирается после push, а не после локального коммита. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
115 lines
26 KiB
Markdown
115 lines
26 KiB
Markdown
---
|
||
publish: false
|
||
---
|
||
|
||
# AGENTS.md — правила работы с этим репозиторием
|
||
|
||
Это Obsidian-хранилище проекта ZapretKVN (приватность, обход DPI и цензуры). Его Git-репозиторий хранится в Forgejo: `zapretdiscordyoutube/todo` на `git2.zapret.moe` (старое имя `git.zapret.moe` в России заблокировано); материалы публикуются на сайт `https://otukcszfwr.zapret.moe` (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 и вики берутся из реестров (transformer `SiteLinks`);
|
||
- `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://otukcszfwr.zapret.moe/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:
|
||
|
||
```bash
|
||
"$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.
|