todo/AGENTS.md
loop-uh eab4599a64
Some checks failed
Published content check / validate (push) Failing after 7s
Зеркало Obsidian Publish переехало на slug zapretwiki: на zapret прямые ссылки отдавали 404
Slug сменён у текущего сайта второго аккаунта, в новом браузере страница открывается по прямой ссылке. AGENTS.md и скилл vault-note: новый адрес, пометка не возвращать slug zapret, проверка зеркала в приватном окне; в скилле исправлено, что сайт пересобирается после push, а не после локального коммита.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-19 14:10:56 -05:00

115 lines
26 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
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.