todo/.claude/skills/vault-note/SKILL.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

548 lines
98 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.

---
name: vault-note
description: >-
Конвенции написания и публикации заметок в этом Obsidian-хранилище (vault про
приватность, обход DPI и цензуры). Обязательно используй этот скилл каждый раз,
когда создаёшь, дополняешь, переписываешь или «публикуешь» любую .md-заметку в
этом vault — даже если пользовательница не просит явно «по правилам». Скилл делает
заметку атомарной и самодостаточной: понятной читателю, который открыл её
первой и не видел переписки. Убирает отсылки к чату и первое лицо ассистента,
встраивает весь нужный контекст в текст, проставляет frontmatter,
Obsidian-callout-ы, [[wikilinks]] и кросс-ссылки. Типичные триггеры: «создай
заметку», «добавь/обнови/перепиши заметку», «запиши в vault», «оформи как
заметку», «опубликуй», а также любое редактирование .md-файла внутри этого
хранилища.
---
# Публикация заметок в этом Obsidian vault
Заметку пишет один человек, а читают её многие — спустя недели и месяцы, по
прямой ссылке или из поиска, **не видя нашего разговора**. Поэтому единственный
надёжный приём: писать так, будто читатель открыл эту заметку первой и не имеет
никакого внешнего контекста. Всё ниже — следствия этого принципа.
## Доставка без вопросов (стоящее решение владелицы от 19 ноября 2026)
Когда статья или правка готова и проверки пройдены, **всегда** проходи всю цепочку сам и не спрашивай «коммитить?», «публиковать?», «готовить пост?»:
1. коммит только своих файлов и push в `main` (порядок и защита от чужих правок — в `AGENTS.md`, раздел «Git-процесс»);
2. заливка этих же файлов на зеркало Obsidian Publish по одному (`obsidian publish:add path=…`);
3. для новой статьи: пост для Telegram (HTML-страница по разделу «Выдача поста», путь к файлу в ответе) и промпт обложки (сохрани в `gptimage/`, эту папку не коммить);
4. проверка живой страницы после пересборки сайта.
Пост в канал агент не отправляет: готовую страницу владелица открывает и вставляет в Telegram сама, твоя часть — собрать её и отдать путь. Разрешение действует для содержимого этого vault. Спрашивать стоит только о том, чего правила не решают (спорный факт, чужие правки в файле). Повтор разрешения на каждую статью не нужен.
## Принципы (и почему они важны)
**Никаких отсылок к разговору.** Читатель не видел чат, поэтому «как я говорил
выше», «ты прислал», «как мы выяснили», «ранее в обсуждении» для него — мёртвые
ссылки в пустоту. Если факт из разговора важен — перенеси сам факт в текст
заметки, а не указатель на его источник.
**Никакого первого лица ассистента.** «Я считаю», «сначала я назвал это вредным»,
«мой вывод» привязывают заметку к конкретной сессии и конкретному автору, которого
читатель не знает. Пиши безлично и от сути: «приём часто называют вредным — на деле
сложнее», «по наблюдениям», «вывод:». Обращение к читателю на «ты/вы» в советах —
нормально, это живой стиль vault.
**Женский род — только для голоса владелицы** (решение владелицы от 1 ноября 2026). Текст от её лица, от первого лица в единственном числе (посты для Telegram, где такой голос разрешён), пишется в женском роде: «я нашла», «я увидела», «я проверила». Читатель рода не имеет, потому что статью может открыть кто угодно. Обращайся к нему конструкциями без рода: «вы задали» (у «вы» рода нет), настоящее время и повелительное наклонение («проверь», «если у тебя стоит Zapret», «когда hostlist уже знаком»). Прошедшее время и краткие прилагательные после «ты» («ты установил», «ты установила», «ты готов») не используй. Первое лицо ассистента в статье это правило не разрешает.
**Самодостаточность.** Читатель не догадается, что значит аббревиатура или на что
указывает «этот приём». Раскрывай термин при первом употреблении (`ТСПУ
(Технические Средства Противодействия Угрозам)`), а любое «это / тот приём /
упомянутое правило» заменяй конкретикой. Проверка: перечитай готовый текст так,
будто видишь тему впервые — осталось ли что-то непонятное без догадок?
**Англоязычный термин сначала объясни по-русски в контексте.** До первого самостоятельного употребления англицизма, английского сокращения или названия структуры дай хотя бы один понятный русский абзац: что это такое, какую роль выполняет и как проявляется для читателя. Одной расшифровки в скобках или буквального перевода недостаточно. Например, до `discoverable credential` объясни, что аутентификатор сам хранит запись об учётной записи и способен предложить её без заранее введённого логина; затем назови эту запись обнаруживаемыми учётными данными (`discoverable credential`). До `credential source` объясни, что это хранимая запись с закрытым ключом и служебными данными. До `client platform` объясни роль браузера и операционной системы между сайтом и аутентификатором. До `origin` объясни, что браузер фиксирует сочетание схемы, домена и порта страницы, с которой начат вход. После такого введения используй один точный термин последовательно. Названия в заголовке, frontmatter, URL, коде и дословные имена полей API не считаются введением и не освобождают основной текст от объяснения.
**Не выноси определения в стартовый словарь.** Заметка должна оставаться статьёй с вопросом, развитием мысли и выводом, а не справочником или набором переставляемых фактов. Не создавай в начале разделы «Термины перед чтением», «Словарь перед схемами» и похожие свалки определений. Вводи понятие непосредственно в том тематическом разделе, где без него уже нельзя продолжить: сначала объясни текущую ситуацию обычным русским языком, затем назови точный термин и сразу используй его для следующего шага рассуждения. Отдельный глоссарий допустим только по прямой просьбе пользовательницы и не заменяет контекстного введения в основном тексте.
**Атомарность.** Одна заметка раскрывает одну тему — так её проще найти,
переиспользовать и связать. Если тем несколько, раздели на отдельные заметки и
свяжи их `[[wikilinks]]`, а не сваливай разнородное в один файл.
**Разворачивай разделы полно, не сжимай.** Лучше объяснить каждый раздел
подробно и понятно — с введением «что вообще происходит», простым переобъяснением
сложной мысли, разбором по шагам — чем уместить мысль в одну плотную строку,
которую новичок не развернёт сам.
Краткость TL;DR — для тех, кто торопится; основной текст должен быть терпеливым и
разжёванным. Это **не** противоречит «без воды»: разворачивать — значит добавлять
поясняющий контекст и примеры, а не лить пустые слова. Если ловишь себя на сжатой
формулировке, которую поймёт только знаток, — разверни её.
**Без дублей — делегируй соседней заметке.** Разворачивать подробно, но **не
повторять** то, что уже раскрыто в другой заметке. Если тема детально описана
рядом (напр. механика `--lua-desync` — в [[desync]]), дай **краткую суть на месте
плюс `[[ссылку]]`** на полный разбор, а не переписывай его второй раз. Дубль
устаревает несогласованно: правят один экземпляр, второй врёт. Правило: полнота
**внутри** темы заметки, ссылка — **на чужую** тему.
**Абсолютные даты.** «Сейчас», «недавно», «в этом месяце» устаревают молча и
вводят будущего читателя в заблуждение. Пиши конкретику: `июнь 2026`, `с 22 мая
2026`.
**Контекст к непроверенному.** Данные из реверс-инжиниринга, логов, ИИ-обработки
или наблюдений одного источника читатель примет за факт, если не предупредить.
Помечай их дисклеймером (callout `> [!warning]`): что это, насколько достоверно,
чем перепроверить. На авторитетный источник (RFC, официальный issue) ссылайся явно
— это повышает доверие к заметке.
**Каждый источник — кликабельная ссылка внутри текста, и дополнительно список ссылок внизу** (решение владелицы от 7 октября 2026). Там, где утверждение опирается на источник, часть самой фразы становится ссылкой: `[«Ведомости» сообщили](https://…)`, `[по данным проекта Filterwatch](https://…)`, `[55,5 рубля в декабре 2018 года](https://…)`. Ссылочный текст — естественные слова предложения (кто сказал, что измерено, само число), а не «тут», «источник» или «ссылка»; голый URL посреди абзаца и сноски вида `[1]` не используются. Упоминание источника без ссылки («по данным РБК») считается недоделкой: либо найди адрес, либо напиши, что первоисточник не открыт и цифра дана в пересказе такого-то издания — со ссылкой на это издание. Одно и то же издание с разными материалами получает разные ссылки. Внизу, перед «См. также», остаётся раздел `## Источники` со всеми теми же ссылками одним списком, тоже кликабельными: `- [«Коммерсантъ», 5 октября 2026 — «Трафик вернулся в график»](https://…)`. Список не заменяет ссылок в тексте, а ссылки в тексте не отменяют списка. Перед сохранением сверь два набора адресов: каждый URL из списка должен встречаться в тексте, и наоборот. Каждую ссылку, которую не открывал сам, проверь хотя бы на ответ сервера (`curl -sL -o /dev/null -w '%{http_code}'` с браузерным User-Agent; 403 у сайтов с защитой от ботов допустим, 404 — нет). Исключение одно, и оно описано ниже: ссылки на репозиторий `Flowseal/zapret-discord-youtube` пишутся с видимым URL. Образец — `DPI/paid-international-traffic-5g-50gb-october-2026.md`.
**Точность важнее авторского акцента.** Даже в публицистическом посте факт важнее
красивой формулировки — если правка делает текст точнее, она побеждает «как
звучит». Абсолютизмы («только и исключительно», «весь/вся», «никогда»,
«единственный», «вовсе не осталось») почти всегда сильнее доказанного: смягчай их
или обосновывай. Сильное число, процент или дату давай **с источником** или явной
атрибуцией («по оценкам рынка», «по сообщениям СМИ, июнь 2026»), а не как голый
факт; не приписывай источнику больше, чем в нём сказано. Различай **факт / оценку /
прогноз / мотив**: прогнозы и особенно приписывание мотивов и намерений хеджируй
прямо в предложении, а не только общим дисклеймером в начале раздела. Держи
внутреннюю согласованность: повторяющиеся числа не должны расходиться, а указатели
(«верхняя строка таблицы», «см. выше») — попадать точно в цель. Когда замечание
по точности конфликтует с авторским акцентом — выбирай точность.
## Скелет заметки
```markdown
---
date: 2026-06-07
tags:
- тег1
- тег2
aliases:
- Человекочитаемое имя
- Альтернативное название
description: 1–2 предложения до ~150 знаков — что внутри и для кого, с главными ключевыми словами
image: Папка/attachments/обложка.png
link: https://первоисточник (если есть)
---
> [!mirror] Резервное зеркало
> Актуальная версия этой страницы — на основной вики: [wiki2.zapret.moe/Папка/имя-заметки](https://otukcszfwr.zapret.moe/Папка/имя-заметки)
# 🦎 Заголовок с эмодзи
> [!info] О чём заметка
> 1-2 предложения: что это и для кого. Если есть парная заметка —
> «теория тут, практика в [[...]]».
## TL;DR
Суть в 3-5 пунктах — для тех, кто не дочитает до конца.
## Основной текст
Разделы `##`/`###`. Сложное переобъясняй отдельным простым абзацем («Проще говоря: …»).
## Источники
- [Издание, дата — о чём материал](url) — те же ссылки, что стоят в тексте
## 📚 См. также
- [[Folder/note|Читаемый алиас]] — чем полезна
```
Опорный стиль frontmatter — как в `VLESS/dpi-tls-june-2026.md`: `date` (ISO),
`tags` (список), `aliases` (человекочитаемые имена для поиска), `description`
(SEO-описание, см. ниже), `image` (обложка для соцпревью, если у заметки она есть),
`link` (первоисточник). Делай полный frontmatter даже если соседние старые заметки без
него — это будущий стандарт хранилища. Встречающийся в старых заметках пустой ключ
`img:` — легаси, движки его не читают; при правке такой заметки заменяй на `image:`
с путём или удаляй.
## Ключевые слова: как заметку найдут
Читатель приходит не по официальному названию продукта, а по тому, как он это называет сам: «амнезия впн», «почему сбербанк не открывается в хроме», «ошибка 1000 амнезия». Если таких слов в заметке нет, поиск — и внутренний по vault, и внешний — её не найдёт, каким бы точным ни был текст. Поэтому ключевые слова закладываются в двух местах.
**`aliases` во frontmatter — это поисковые фразы, а не синонимы заголовка.** Пиши 4–8 строк так, как читатель формулирует вопрос или название: кириллические написания продукта («Амнезия 3.0», «АмнезияВГ», «Амнезия ВПН»), латиница и сокращения (`AmneziaWG 3.0`, `AWG 3`), формулировки-вопросы («Чем AmneziaWG 3.0 отличается от 2.0», «Стоит ли обновлять Amnezia VPN»), точные тексты ошибок («Parameter jc is undefined ошибка 1000») и имена параметров, которые будут гуглить дословно (`HeaderProtectionKey что это`). Ориентир — `nuc/*.md`, где алиасы прямо повторяют запросы вроде «Как удалить сертификат Минцифры».
**`description` во frontmatter — сниппет для поисковиков, обязателен в новых заметках.** Один и тот же ключ читают оба сайта: Quartz (wiki2.zapret.moe) подставляет его в meta description вместо автовыжимки первых 150 знаков, Obsidian Publish (зеркало) — в meta description и og:description вместо случайного начала текста. Пиши 1–2 предложения до ~150 знаков: что внутри и для кого, с главными поисковыми словами, без обрыва на полуслове. Это текст, который читатель видит в выдаче Google/Яндекса под заголовком — он должен продавать клик, а не пересказывать frontmatter. Плохо: «Заметка про настройку». Хорошо: «Пошаговая настройка Zapret 2 под себя: выбор стратегии, автообновление, исключения для банков и госсайтов».
**`image` во frontmatter — превью для соцсетей и мессенджеров.** Тоже общий ключ: Quartz принимает `image`/`cover`/`socialImage`, Obsidian Publish — `image`. Указывай путь к обложке заметки от корня vault (`Папка/attachments/….png`), если обложка есть; выдумывать картинку ради ключа не нужно. Если ключа нет, сайт сам берёт в превью картинку, вставленную сразу после заголовка `#` (так сделано в Quartz 8 октября 2026 года: `frontmatter.ts` ищет embed, `ogImage.tsx` строит адрес по слагу вложения); на зеркале Obsidian Publish этого нет, поэтому `image:` в новых статьях всё равно заполняй.
**Ссылки на репозиторий `Flowseal/zapret-discord-youtube` — всегда с видимым URL.** Не прячь адрес за текстом ссылки (`[issue #123](https://…)`): пиши явное описание, а затем голый URL отдельно — «Issue #123 у Flowseal про X: https://github.com/Flowseal/zapret-discord-youtube/issues/123». Голый URL Obsidian, Quartz и Publish автолинкуют сами. Причина: читатели ищут в поисковиках сам адрес репозитория, и страницы вики и зеркала должны находиться по запросу `github.com/Flowseal/zapret-discord-youtube` — а в скрытом тексте ссылки поисковик этой строки не видит. Правило касается и глубоких ссылок (issues, discussions, releases) этого репозитория.
**Варианты написания — один раз в теле, при первом употреблении.** Оформляй курсивом в скобках, как в `amnezia-2-0/reference.md`: `AmneziaWG (*AWG, АмнезияВГ 2.0, Амнезия ВПН*)`. Одного такого перечисления на заметку достаточно.
Дальше по тексту используй **один** точный термин. Разбрасывать ключевые слова по абзацам ради частоты нельзя: это ухудшает текст, а правило «точность важнее акцента» действует и здесь. Не выдумывай запросов, которых не бывает, и не добавляй в алиасы темы, которых в заметке нет, — алиас, обещающий больше содержимого, чем есть, работает против доверия к vault.
Старым заметкам без frontmatter ключевые слова добавляй тем же приёмом, когда правишь их по другому поводу.
## Стиль: объясняй «на пальцах»
Основной приём разжёвывания — **переобъяснение**: сложную мысль изложи один раз
технически точно, а затем **ещё раз, понятнее, отдельным абзацем** — то же самое
утверждение более простыми словами, без новых сущностей и без метафор (удобно
начинать с «Проще говоря: …»). НЕ оборачивай сложное в бытовую аналогию по
умолчанию: аналогия (callout `> [!example]`) — вспомогательный и необязательный
инструмент, только для мест, где механика без образа действительно не заходит
(например, внутренности протокола); лишние аналогии раздувают текст и уводят от
сути. Жаргон (DNAT, retransmit, stateful) либо раскрывай одной фразой, либо
дублируй блоком «Простыми словами» рядом. Сравнения оформляй таблицами,
пошаговые инструкции — чек-листами `- [ ]`.
Пример уместной (редкой) аналогии из vault (`VLESS/dpi-tls-june-2026.md`):
TCP-рукопожатие = звонок (SYN — «Алло, можем говорить?», SYN-ACK — «Да, говори»,
ACK — «Ок») — механика протокола новичку без образа не заходит. Для остальных
случаев достаточно абзаца «Проще говоря».
## Редактура без ИИ-штампов
Для статей и публицистических заметок применяй правила локальных навыков [`stop-slop`](../stop-slop/SKILL.md) и [`avoid-ai-writing`](../avoid-ai-writing/SKILL.md) как редакторские эвристики. Они помогают заметить машинный ритм и пустые формулы, но не доказывают, что текст написал ИИ. Англоязычные запреты нельзя механически переносить в русский текст: тире, пассивный залог, наречие, риторический вопрос или перечисление из трёх пунктов сами по себе не являются ошибкой. Исправляй повторяющиеся шаблоны и их скопления, а не отдельный знак или слово вне контекста.
Работай в два прохода. На первом выстрой аргумент и проверь факты: каждый раздел должен добавлять новый факт, технический механизм, пример, следствие или обоснованный вывод. На втором перечитай текст именно как редактор: убери чатовые вступления, мета-комментарии о том, что «сейчас разберём», пустые заявления о важности, рекламные эпитеты, безымянные ссылки на «экспертов», одинаковые переходы, навязчивые конструкции «не X, а Y», цепочки коротких драматических фраз и одинаковую длину соседних абзацев. После правок перечитай ещё раз и убедись, что чистка не исказила смысл и не сделала речь стерильной.
Главный тест — плотность смысла и связность. У каждого абзаца должна быть своя работа, а его место в тексте должно вытекать из предыдущего. Если абзацы можно свободно переставить или сократить текст вдвое без потери информации, статья пока состоит из самостоятельных тезисов и повторов, а не из развивающегося объяснения. Добавь причинно-следственные переходы, конкретные данные и технические примеры; пустые повторы удали.
Сохраняй голос автора и уже удачные фрагменты. Не заменяй точный термин более «простым» синонимом ради анти-ИИ-проверки, не убирай оговорку о неопределённости из прогноза и не переписывай цитаты, код или чужой текст. Повтор правильного технического термина обычно честнее, чем искусственная ротация синонимов. Если формулировка спорная, приоритет всегда такой: фактическая точность и замысел пользовательницы → правила этого vault → редакторские эвристики `stop-slop` и `avoid-ai-writing`.
Основной материал пиши связными абзацами с осмысленными подзаголовками. Списки нужны для настоящих перечней, шагов и параметров; таблицы — для точного сравнения повторяющихся полей; callout-ы — для оговорок, рисков и ключевых выводов. Не дроби обычное объяснение на карточки, однотипные пункты и цитатные обрывки только ради визуального разнообразия. При этом не превращай всю статью в один сплошной абзац: новый смысловой поворот получает новый абзац, а крупная часть аргумента — подзаголовок.
## Форматирование: НЕ переноси прозу вручную
**Главное правило вёрстки: один абзац — одна физическая строка. Никаких ручных
переносов прозы по ширине (~80 символов).** В Obsidian по умолчанию («Strict line
breaks» выключен) **каждый одиночный `\n` в исходнике рендерится как разрыв
строки**. Поэтому абзац, разбитый на строки по 80 символов, выходит рваными
короткими строками с пустым полем справа вместо текста на всю ширину блока — это и
есть «сломанное форматирование». Пиши абзац, пункт списка и **каждую строку
callout-а** одной длинной строкой; перенос на экране сделает сам редактор.
- ❌ Так (ручной перенос ломает рендер):
```
> [!warning] Заголовок
> `client_mss` и rate-limit не меняют JA4-почерк. `client_mss`
> лишь мешает цензору извлечь почерк из первого пакета (а сам
> малый MSS — уже аномалия).
```
- ✅ Так (одна строка на абзац):
```
> [!warning] Заголовок
> `client_mss` и rate-limit не меняют JA4-почерк. `client_mss` лишь мешает цензору извлечь почерк из первого пакета (а сам малый MSS — уже аномалия).
```
Многоабзацный callout: между абзацами строка-разделитель `>` (а не пустая).
Маркированный/нумерованный список: каждый пункт — одна строка, без переноса
продолжения на следующую с отступом. **Код-блоки (```), строки таблиц и frontmatter
переносы внутри сохраняют как есть** — правило про переносы касается только прозы.
## Obsidian-callout-ы
`> [!info]` обзор · `> [!tip]` совет/вердикт · `> [!warning]` оговорка/риск ·
`> [!danger]` «не делай так» · `> [!note]` нюанс · `> [!example]` «на пальцах» ·
`> [!important]` ключевой вывод · `> [!summary]` итог · `> [!quote]` цитата
источника.
## Ссылки `[[wikilinks]]` — частые грабли
- Формат: `[[Полный/Путь/note|Читаемый алиас]]` — путь от корня vault, без `.md`.
- **В таблицах экранируй пайп внутри ссылки**: `[[VPS/VPS\|VPS]]`, иначе пайп
разорвёт колонку таблицы.
- **Код-форматирование внутри алиаса НЕ рендерится.** `` [[desync|`--lua-desync`]] ``
покажет буквальные backtick-символы вокруг текста, а не моноширинный код. Не
клади backticks в алиас. Варианты: алиас без кода — `[[desync|--lua-desync]]`
(флаг и так читается, а подчёркивание ссылки уже выделяет его); либо код
оставь вне ссылки — `` `--lua-desync` `` рядом со ссылкой `[[desync]]`. То же
касается **`**, `*`, `==` и прочей разметки внутри `[[…|алиас]]` — внутри алиаса
это просто текст.
- **Якоря на заголовки матчатся буквально.** Если в заголовке есть `:` `.` `()` —
либо повтори их в якоре точь-в-точь, либо убери пунктуацию из заголовка и
ссылайся на чистый текст (em-dash `—` в якоре работает). Сомневаешься — ссылайся
на заметку целиком, без `#`.
- **Линкуй щедро и активно — по всему тексту, а не только в «См. также».** Как
только в абзаце всплывает понятие, у которого есть (или должна быть) своя
заметка — ставь `[[ссылку]]` прямо там, при первом упоминании. **Ссылка в
шапке-callout или в «См. также» НЕ заменяет ссылок в теле текста** — читатель
часто входит в заметку с середины (из поиска, по якорю на раздел), поэтому
первое упоминание ключевого термина в каждом крупном разделе `##` тоже делай
ссылкой. **Особая ловушка — дописывание готовой заметки:** новый или
переписанный раздел часто остаётся вовсе без ссылок («выше же уже слинковано»)
— так нельзя; после каждой правки перечитай именно добавленные абзацы и
проверь их на голые ключевые термины (профиль, пресет, стратегия и т.п.). Чем
плотнее сеть перекрёстных ссылок, тем легче читателю прыгать между связанными
темами и тем меньше соблазн дублировать чужой материал (см. принцип «Без
дублей»). Связи делай **двусторонними**: добавил ссылку A→B — проверь, нужна
ли B→A.
- **Перед тем как объяснять понятие подробно — проверь, нет ли уже обзорной
заметки по нему** (поиском по vault). Если есть — ссылайся на неё как на
«общую/обзорную», а свою заметку посвящай своему срезу темы.
- **Линкуй щедро.** Ссылка на ещё не созданную заметку допустима — она помечает
будущую тему, а не является ошибкой.
- **Встраивание картинок — ВСЕГДА с расширением файла.** Пиши `![[имя.png]]`, а
не `![[имя]]`: без расширения картинка в заметке **не отображается**. То же для
`.jpg`/`.gif`/`.webp`. Имя должно точно совпадать с файлом в папке
`attachments` (учитывай регистр). После добавления нового изображения проверь,
что файл реально лежит в `attachments` и что embed содержит расширение.
- **Для новой статьи используй собственную локальную обложку.** Храни её в
`attachments` того же раздела и добавляй в Git вместе с `.md`; не заменяй файл
ссылкой на GitHub, Forgejo Raw, CDN или фотохостинг. Проверенный формат новой
обложки — **1672 × 941 пиксель**; эталон:
`mtproxy/attachments/faketls-relay-diagnosis-header.png`. Вставляй обложку после
заголовка как `![[имя.png]]`, без `|ширина`, HTML-размеров и принудительного
растягивания. Если пользовательница задала другой формат, сохраняй её замысел; не
растягивай готовый меньший исходник до 1672 × 941. Полный порядок подготовки,
проверки и публикации находится в [`vault-image`](../vault-image/SKILL.md).
- **В каждой новой статье — минимум 2–3 собственные диаграммы, это обязательно** (решение владелицы от 30 сентября 2026 года). Строй их по скиллу [`vault-chart`](../vault-chart/SKILL.md) и рендери только через headless Chromium его скриптом `render.py` (HTML/SVG → PNG), не matplotlib. Если в статье мало чисел, диаграммой всё равно можно показать главное: таймлайн для хроники событий, схему «было → стало» для закона или изменения настроек, сравнение вариантов, пошаговую схему механизма. Каждая диаграмма должна отвечать на один вопрос: заголовок-вывод вместо темы, подписи прямо на данных вместо легенды, база для каждого процента («0 = как в 2025 году»). Диаграмму часто видят отдельно от статьи, в посте Telegram, поэтому понятна она должна быть без текста вокруг.
- **Картинку видно ТОЛЬКО там, где стоит сам embed — это обязательно.** Изображение
отображается лишь в той заметке, где физически написан `![[имя.png]]`. Обычная
ссылка `[[другая-заметка]]` или упоминание картинки из соседней заметки её **не
покажет**. Поэтому если одно и то же изображение должно быть видно в нескольких
заметках — в **каждую** из них вставляй свой `![[имя.png]]` (это не дубль контента,
а необходимый визуальный элемент). Файл при этом может лежать в одной общей папке
`attachments` — Obsidian находит его по всему vault, дублировать сам файл не нужно.
- **Картинки, которые пользовательница вставила в чат, раскладывай по `attachments` САМ — не проси сделать это вручную.** В этом окружении присланное изображение на диск не сохраняется (директории `~/.claude/image-cache/` тут нет) — оно приходит base64-строкой внутри транскрипта сессии, откуда его нужно извлечь скриптом, сверить через Read и скопировать в `attachments` под описательным именем. Полный разбор — где лежит транскрипт, чем извлекать, какой формат и качество выбирать, как вложения попадают на сайт — в скилле [`vault-image`](../vault-image/SKILL.md); при любой работе с изображениями открывай его.
## После создания НОВОЙ заметки — обнови окружение
Заметка-сирота не находится. Поэтому:
- Добавь строку в индексную/обзорную заметку раздела (напр.
`Zapret/mtproto/00-overview.md`).
- Если новая заметка дополняет старую — добавь ссылку **в обе стороны**.
- Если новая информация делает старое утверждение неточным (напр. «4 реализации»
→ «5») — поправь старое там же.
**НЕ трогай `Zapret/home.md` (главную) — её навигацию пользовательница ведёт сама.** Не
добавляй туда ссылки на новые заметки и вообще ничего не правь в `home.md`, даже
когда создаёшь новую заметку и обновляешь окружение. Для обнаружения новой заметки
используй обычные кросс-ссылки из соседних заметок и раздел «См. также», а не
главную страницу. (Правило по прямому указанию пользовательницы — она несколько раз
откатывала автоматические добавления в `home.md`.)
## Статья по новости: субагенты, сверка и честные сравнения
Порядок выработан 7 октября 2026 года на статье `DPI/paid-international-traffic-5g-50gb-october-2026.md` (плата за зарубежный трафик в 5G) и одобрен владелицей. Применяй его, когда статья строится на свежей новости или когда владелица просит «разобраться субагентами».
**Субагенты запускаются на Sonnet** (`model: "sonnet"`, правило из глобального `CLAUDE.md`), все разом в одном сообщении. Сколько их — решает владелица («с 10 субагентами»); если число не названо, бери столько, сколько набирается срезов темы без пересечений: хроника, сама новость и реакция, интересанты, техника, числа, зарубежные прецеденты, право, экономика, сценарии. Одному агенту — один срез, в задании слово «ТОЛЬКО».
**В каждом задании обязательно:** сегодняшняя дата и оговорка, что событие позже среза знаний модели; требование у каждой цифры давать URL, год и пометку «открыл страницу сам» или «из выдачи поиска»; требование различать факт, заявление и версию; фраза «если не нашёл — так и напиши»; лимит объёма и формат ответа. Агентам, которые читают vault, пиши «НИЧЕГО НЕ ИЗМЕНЯТЬ».
**Требуй от агентов точный URL каждого утверждения** — он понадобится для ссылки внутри текста, а не только для списка внизу. **Отчётам агентов не верь на слово.** Перед тем как писать, сам открой опорные первоисточники — те, на которых держатся цитаты, хроника и числа для диаграмм. WebFetch отдаёт пересказ маленькой модели, поэтому текст бери напрямую: `curl -sL -A '<браузерный User-Agent>' <url>`, затем вырежи теги и найди нужные фразы регулярным выражением. Что не удалось открыть (403, защита от ботов) — в статью идёт с атрибуцией «в пересказе …» либо не идёт вовсе; в отчёте владелице перечисли, что сверено лично, а что взято со слов агента.
**Цены и тарифы — только с сайта оператора или первичного документа.** Агрегаторы тарифов расходятся с официальными страницами: 7 октября 2026 года раздел о стоимости пришлось переписывать, потому что агрегатор показывал «30 ГБ за 690–900 ₽», а на сайте оператора безлимит стоил 700 ₽. Если официальная страница не открывается — так и напиши в тексте и на диаграмме, от чьего имени цифра.
**Проверь рамку самой новости.** Пересказ в Telegram-чате часто сильнее источника: «власти отказались от идеи» при том, что был перенос срока; «закон» при том, что нет даже проекта акта; «10 млн абонентов» при том, что это люди в зоне покрытия. Пиши так, как подтверждается, а расхождения с исходным постом перечисли владелице отдельным списком. Слово «закон» не употребляй ни в тексте, ни на картинках, пока нет принятого акта: «мера», «плата», «обсуждали».
**Когда владелица просит «показать неадекватность».** Сила картинки — в точном сравнении, а не в отборе удобных столбцов. Оставляй на диаграмме и те значения, которые ослабляют тезис (страны, где дороже; годы, когда было хуже), и подписывай, что с чем сравнивается: цена сверх лимита против средней цены в пакете — не одно и то же. Сильнее всего работают сравнения не размера цены, а направления: «регулятор ограничивает доплату сверху» против «предлагали назначить её снизу»; доплата в процентах от минимальной зарплаты; «пять гигабайт дороже месяца безлимита».
**Дописывание после публикации.** Просьбы «напишем, сколько это стоит», «сравни, как было и как в других странах» — это новые разделы той же статьи, а не новые заметки, пока тема одна. Каждый раздел получает свои диаграммы, строку в TL;DR, источники в конце и публикуется сразу тем же порядком, что и статья.
## Инвентаризация и публикация vault
Сайт `https://otukcszfwr.zapret.moe` (self-hosted Quartz 4) собирается из этого vault автоматически после каждого push в `main` (клон vault в CT 204 на US2-7 подтягивает `wiki-autopull` раз в минуту, затем срабатывает `wiki-rebuild.path`). Поэтому «опубликовано на сайте» = «запушено» (с задержкой до минуты), а один локальный коммит на сайт не попадает — уточняй канал, если состояние расходится. Третий канал — зеркало на Obsidian Publish (`https://publish.obsidian.md/zapretwiki`): оно **не** обновляется автоматически, туда нужно отдельно заливать изменения через Obsidian CLI (см. ниже). «Опубликовать» без уточнения = все три канала: коммит, push и `publish:add changed`.
**Готовую новую статью публикуй сам, без вопроса «публиковать?»** (решение владелицы от 7 октября 2026): коммит только своих файлов в `main`, push, затем зеркало. Если в рабочем дереве есть чужие незакоммиченные правки или черновики, вместо `publish:add changed` заливай свои файлы по одному: `obsidian publish:add path=<путь>` для заметки, каждого её вложения и каждой затронутой соседней заметки — `changed` берёт файлы с диска и выгрузит чужое.
### Как искать неопубликованные материалы
В frontmatter нет обязательного поля `published` или `draft`. Используй фактическое состояние Git:
- новые заметки, которых ещё нет в Git: `git ls-files --others --exclude-standard -- '*.md'`;
- правки уже отслеживаемых заметок: `git diff --name-only -- '*.md'`;
- уже подготовленные к коммиту правки: `git diff --cached --name-only -- '*.md'`;
- незапушенные коммиты: `git log origin/main..HEAD --oneline`.
В отчёте разделяй **новые неопубликованные заметки** и **опубликованные заметки с локальными правками**. Не считай содержимым vault файлы из `.agents/`.
### Локальные и служебные файлы
- `/.obsidian` уже находится в `.gitignore`. Не дублируй правило и не добавляй настройки Obsidian в Git.
- `.agents/` содержит локальные навыки Codex. Не включай её в публикацию заметок, если пользовательница отдельно не просит опубликовать сами навыки.
- Вместе с заметками публикуй используемые ими изображения и другие вложения из `attachments/`.
- Для новой статьи проверь, что собственная обложка находится внутри репозитория, вставлена без принудительного размера и включена в тот же staging, что и заметка.
- Перед staging всегда проверяй `git status -sb` и состав diff. В смешанном worktree добавляй только подтверждённые файлы, не используй бездумно `git add -A`.
### Публикация на wiki2.zapret.moe
Отдельной команды публикации нет: сайт пересобирается сам после каждого локального коммита в vault. Порядок — просто закоммить заметку вместе с её вложениями; примерно через полминуты страница появится на `https://otukcszfwr.zapret.moe/<путь-заметки>` (слаги Quartz: пробелы → `-`, кириллица сохраняется). Принудительная пересборка без коммита: `sudo systemctl start wiki-rebuild.service`; статус последней сборки: `systemctl status wiki-rebuild.service`.
Служебные `.md`, которые нужны в репозитории, но не на сайте (например `AGENTS.md`), исключаются строкой `publish: false` в frontmatter — фильтр Quartz не пропустит их в сборку. Целые закрытые папки (как `VPS/`) вырезаются через `ignorePatterns` в `/srv/wiki-quartz/quartz.config.ts` — это единственный способ не публиковать и вложения тоже.
**Если владелица пишет «вики не работает».** Сначала отдели поломку сайта от проблемы на стороне читателя — 7 октября 2026 года сайт был исправен, а жалоба относилась к сети владелицы. Проверь по порядку: `curl -s -o /dev/null -w "%{http_code}"` главной, свежей статьи и `index.css`; `systemctl status wiki-rebuild.service` и `journalctl -u wiki-rebuild.service -n 30`; срок и цепочку сертификата (`openssl s_client -connect wiki2.zapret.moe:443 -servername wiki2.zapret.moe -showcerts`); доступность снаружи через API `https://check-host.net/check-http?host=https://otukcszfwr.zapret.moe/&max_nodes=14` (заголовок `Accept: application/json`, результат через ~10 секунд по `/check-result/<id>`; отдельно узлы `ru1`–`ru3`); отрисовку страницы headless-Chromium из `~/.cache/ms-playwright/` со снимком экрана; хвост `/var/log/nginx/error.log` и коды ответов в `access.log`. Ошибки `SSL_read() failed … bad record mac` и `SSL_do_handshake() failed` от отдельных клиентов идут ровным фоном весь день (читатели сидят через средства обхода, их поддельные пакеты долетают до сервера) — поломкой это считается только при резком всплеске. Узлы check-host стоят в дата-центрах: домашнюю и мобильную сеть отсюда не проверить, поэтому, если на сервере всё чисто, спроси у владелицы симптом, сеть и включён ли обход, а не чини наугад.
**Страницы папок (folder notes).** URL папки (`/DPI/`, `/Zapret2/`) показывает не голый список файлов, а заметку-оглавление, если она есть. Quartz ищет её в таком приоритете: `Папка/index.md` → `Папка/Папка.md` (одноимённая) → `Папка/00-overview.md`; подходит и «сестринская» одноимённая заметка рядом с папкой (`Zapret2/desync.md` для папки `Zapret2/desync/`). **При создании новой папки сразу заводи ей одноимённую обзорную заметку** со ссылками на содержимое и краткими аннотациями (образцы: `DPI/DPI.md`, `Clash/00-overview.md`); при добавлении заметки в папку — дописывай её в этот обзор.
**Виджет комментариев** добавляется на каждую страницу автоматически при сборке — вставлять его в заметку не нужно. Отключить на конкретной странице: `comments: false` во frontmatter.
**SEO-механика сайта:** если у заметки нет `title` во frontmatter, её первый `# H1` автоматически становится `<title>` страницы, og:title и последним элементом хлебных крошек — поэтому H1 должен быть самодостаточным и содержать ключевые слова запроса (не «reference», а «AmneziaWG 3.0 — шифрование заголовков поверх WireGuard»). `aliases` и `tags` из frontmatter попадают в `<meta name="keywords">` (его учитывает Яндекс) — поисковые фразы в aliases работают не только на внутренний поиск, но и на внешнюю выдачу. Sitemap и RSS пересоздаются при каждой сборке сами.
### Публикация в Obsidian Publish (зеркало)
Второе зеркало вики — `https://publish.obsidian.md/zapretwiki` (Obsidian Publish, siteId в `.obsidian/publish.json`). **Slug `zapretwiki` с 19 ноября 2026, не `zapret`:** при slug `zapret` каждая прямая ссылка на страницу (`/zapret/<путь>`) перенаправлялась на `publish.obsidian.md/404`, хотя корень `/zapret` и навигация внутри сайта работали, а тот же сайт под другим slug открывался нормально (проверено и на старом сайте первого аккаунта, и на новом сайте второго, созданном 15 ноября). Обычный браузер мог показывать страницу из кэша, поэтому проверяй зеркало в приватном окне; ответ 200 у `curl` ничего не доказывает, потому что Publish отдаёт 200 на любой путь живого сайта. Публикуется через официальный Obsidian CLI: команда `obsidian` (обёртка `~/.local/bin/obsidian` → `/opt/Obsidian/obsidian-cli`) работает только при запущенном приложении — на этом хосте Obsidian постоянно крутится headless под `xvfb-run`.
Порядок после коммита и пуша:
- `obsidian publish:status total` — сколько файлов ждёт заливки (new/changed/deleted подробнее: `publish:status new` и т.д.);
- `obsidian publish:add changed` — залить все изменённые файлы разом (вложения включаются автоматически);
- `obsidian publish:list total` и `obsidian publish:site` — проверить итог.
Исключения задаются в `excluded` в `.obsidian/publish.json` и должны зеркалить `ignorePatterns` Quartz (сейчас: `VPS`, `scripts`, `AGENTS.md`, `index.html`); при добавлении новой закрытой папки в Quartz-конфиг добавляй её и сюда. Удалённую из vault заметку снимай с зеркала через `obsidian publish:remove path=<путь>`. Команда работает только пока файл ещё лежит на диске: если он уже удалён, она отвечает `File … not found`, а файл остаётся на зеркале со статусом `deleted`. Тогда снимай его через API: `obsidian eval code="app.internalPlugins.plugins.publish.instance.apiRemoveFile('<путь>')"` и проверь `publish:list` (так было 7 октября 2026 при замене обложки с PNG на JPG).
**Callout-шапка `[!mirror]` — в каждой заметке, сразу после frontmatter.** Каждая публикуемая заметка начинается с плашки, ведущей на ту же страницу основной вики (формат — в скелете заметки выше). URL строится из пути файла от корня vault: убрать `.md`, пробелы заменить на `-`, кириллица и регистр сохраняются; в href не-ASCII процент-кодируется, в тексте ссылки остаётся читаемый вид `wiki2.zapret.moe/<путь>`. На wiki2.zapret.moe эта плашка **не попадает**: самописный transformer `RemoveMirrorCallout` (`/srv/wiki-quartz/quartz/plugins/transformers/removeMirrorCallout.ts`, зарегистрирован первым в `quartz.config.ts`) вырезает callout до парсинга. Видна она только на зеркале Obsidian Publish и в Forgejo — там она и нужна: помечает копию как резервную и передаёт ссылочный вес основной вики. При переименовании или переносе заметки обнови URL в её плашке.
**Настройки сайта (site options).** Утверждённый владелицей набор (применён 26 августа 2026, не сбрасывать):
```
siteName: "Zapret 2 (Запрет 2) | Обходы блокировок Дискорд и Ютуб"
indexFile: "Zapret/home.md" — главная, как у wiki2.zapret.moe
defaultTheme: "dark" — тёмная тема по умолчанию (обязательно)
showThemeToggle: true
readableLineLength: false — текст на всю ширину страницы (обязательно)
noindex: false — решение владелицы: зеркало индексируется, «обсидиан отлично ищется»
showNavigation: true
showGraph: true
showOutline: true
showSearch: true
showBacklinks: true
showHoverPreview: true
hideTitle: true
strictLineBreaks: false
slidingWindowMode: false
```
API options **перезаписывает объект целиком** — при любом изменении отправляй полный набор ключей. UI-модалки в headless-Obsidian недоступны, настройки меняются из `obsidian eval` вызовом `app.internalPlugins.plugins.publish.instance.apiOptions({...полный объект...})`; текущие сохранённые значения возвращает `apiOptions()` без аргумента.
Прочие поддерживаемые ключи (в скобках — заводское значение): `logo` ("" — логотип в шапке), `googleAnalytics` (""), `navigationOrdering` ([]), `navigationHiddenItems` ([]); `defaultTheme` также принимает `light` и `system`; `slidingWindowMode` — режим «скользящих панелей», когда заметки открываются горизонтальным стеком рядом друг с другом, а не заменяют страницу. Отдельными API управляются пароль сайта (`apiGetPassword`/`apiAddPassword`/`apiDelPassword`), кастомный домен (`apiCustomUrl`) и slug (`publish.obsidian.md/api/slug`).
**Восстановление сайта после истечения подписки.** Когда тариф Publish истекает, Obsidian удаляет сайт целиком: `publish:*` отвечают `Error: Site not found.`, `publish.obsidian.md/<slug>` отдаёт 404, slug освобождается. После продления сайт сам не возвращается (так было 7 октября 2026). CLI создать сайт не умеет, UI-модалка в headless недоступна — всё делается из `obsidian eval` теми же запросами, что шлёт приложение (POST, JSON, токен — `JSON.parse(localStorage.getItem('obsidian-account')).token`, не выводить его в лог):
- `https://api.obsidian.md/publish/list` `{token}` — убедиться, что `sites` пуст; `https://publish.obsidian.md/api/site` `{token, slug:'zapretwiki'}` — `NOTFOUND` значит slug свободен (имя `zapret` не используй: на нём прямые ссылки отдают 404);
- `https://api.obsidian.md/publish/create` `{token}` → `{id, host}`; затем `https://publish.obsidian.md/api/slug` `{token, id, host, slug:'zapretwiki'}`;
- `app.internalPlugins.plugins.publish.instance.setup(id, host)` — записывает новый siteId в `.obsidian/publish.json`, `excluded` при этом сохраняется;
- `apiOptions({...})` с полным набором настроек выше, затем `obsidian publish:add changed` (около 700 файлов, пара минут).
Publish заливает файлы с диска, а не из Git: перед полной заливкой убери незакоммиченное (`git stash` для правок, новые черновики временно вынеси из vault — `excluded` работает по папкам, не по отдельным файлам), потом верни. Проверяй итог по `publish:list`, а не по HTTP-коду: сайт — SPA и отвечает 200 на любой путь.
### Публикация в Forgejo
Когда пользовательница просит опубликовать всё, включай все новые и изменённые заметки плюс их вложения, но исключай `.obsidian/`, `.agents/` и прочие служебные файлы. Перед коммитом:
- синхронизируй remote refs через `git fetch origin`;
- проверь авторизацию Forgejo и точный состав staging;
- выполни `git diff --check`;
- проверь у новых содержательных заметок frontmatter, Forgejo-футер и существование встроенных изображений;
- коммить **напрямую в `main`**: ветки и pull request'ы в этом репозитории не используются (решение владелицы от 25 июля 2026). Сообщение коммита — осмысленное, на русском.
После `git push` изменения сразу находятся в `main`. Учитывай, что каждый push в `main` запускает Forgejo Actions, поэтому связанные правки собирай в один push. Общие правила репозитория — в `AGENTS.md` в корне хранилища. После пуша не забудь синхронизировать зеркало Obsidian Publish (`obsidian publish:add changed`, раздел выше).
## Футер со ссылкой на Forgejo (в конце каждой заметки)
Vault хранится в Forgejo-репозитории `zapretdiscordyoutube/todo`, и читателю предлагают
скачать исходники (например, чтобы обучить на них ИИ). Поэтому каждая
**содержательная** заметка заканчивается единым футером — callout `> [!quote]` со
ссылкой на свой исходник и на весь репозиторий:
```markdown
---
> [!quote] 🤖 Эти статьи открыты — можно обучать на них ИИ
> При желании вы можете натренировать ИИ на наших статьях. Исходное форматирование доступно в Forgejo: [исходник этой заметки](https://<рабочее имя git>/zapretdiscordyoutube/todo/src/branch/main/<ОТНОСИТЕЛЬНЫЙ/ПУТЬ>.md) · [скачать весь репозиторий одним zip-архивом](https://<рабочее имя git>/zapretdiscordyoutube/todo/archive/main.zip).
```
- **Путь к файлу = путь от корня vault** (корень репо = корень хранилища). Напр.
`Zapret2/profile.md` → `…/src/branch/main/Zapret2/profile.md`.
- **Пробелы и кириллицу в пути URL-кодируй** (` ` → `%20`, и т.д.), иначе ссылка
на файл с пробелами/русским именем ломается.
- **Размещение:** в самом конце файла, после раздела «См. также». Виджет
комментариев вставлять в заметку не нужно — он добавляется на все страницы
автоматически при сборке сайта (компонент WikiComments в Quartz).
- База репозитория — `https://<рабочее имя git>/zapretdiscordyoutube/todo/src/branch/main`, где имя печатает `zapret-links link git` (номер зеркала по памяти не вписывай).
## «Напиши пост» — анонс заметки для Telegram
**К каждой новой статье пост пишется сам, без просьбы** (решение владелицы от 24 октября 2026). Вместе с ним выдаётся промпт обложки. Статья публикуется сразу, не дожидаясь обложки; обложка ставится отдельной правкой, когда владелица её пришлёт (решение от 31 октября 2026). Порядок — в разделе «Обложки статей» файла `AGENTS.md`.
Иногда пользовательница просит **«напиши пост»** / «сделай анонс статьи» / «текст для телеги». Это **отдельный жанр**, не заметка vault: нужен готовый к копированию текст для Telegram-канала, который анонсирует уже написанную заметку и зовёт её прочитать. Правила другие, чем для заметки:
- **Пост не пишется в vault**: НЕ создавай для него .md-файл и НЕ применяй frontmatter/футер/`[[wikilinks]]`, если об этом не попросили отдельно. Как именно его выдать — в «Выдача поста» ниже.
- **Образец стиля** — пост про Steam, одобренный владелицей 28 сентября 2026: `.claude/skills/vault-note/references/tg-post-example-steam.txt`. Перед новым постом перечитай его: заголовок, вводные абзацы, смайлики, ссылки и моноширинные домены должны выглядеть так же. Финальная строка образца 30 сентября 2026 переведена в новый формат — цитату с 🏃 (см. правило о финальном призыве ниже).
- **Объём — не менее 10 абзацев** (больше можно, меньше — только если пользовательница прямо попросила короткий пост). Абзацы короткие, Telegram-стиль: живо, по делу, с обращением к читателю на «ты/вы»; от первого лица — голосом владелицы в женском роде («я нашла», «я проверила»), к читателю — без рода («если у тебя стоит», а не «ты настроил» или «ты настроила»), см. правило о женском роде выше. Десять абзацев набираются не водой, а содержанием: каждый несёт свой факт, механизм, следствие или пример из заметки. Если материала на десять абзацев не хватает — значит, взято слишком мало срезов темы, а не «пост должен быть короче».
- **Длина — не больше 4096 символов вместе с заголовком, эмодзи и ссылкой.** Это жёсткий лимит одного текстового сообщения в Telegram: всё сверх него клиент обрезает на полуслове (пост на 4716 знаков, написанный 20 сентября 2026, оборвался в середине одиннадцатого абзаца). Целься в **3500–3900 знаков**, чтобы у автора канала остался запас на свой заголовок и хвост со ссылками. Если пост пойдёт подписью к картинке или видео, лимит другой — **1024 символа**, и нужен отдельный сокращённый вариант; уточни формат, когда это неочевидно.
- **Перед выдачей посчитай длину и назови число в ответе.** Telegram считает не символы Python, а единицы UTF-16, и каждый эмодзи вне основной плоскости весит **две** единицы — на посте с дюжиной эмодзи набегает лишняя сотня. Правильная формула: `python3 -c "t=open('post.txt',encoding='utf-8').read().rstrip(); print(len(t.encode('utf-16-le'))//2)"`. Глазомер не работает: десять содержательных абзацев легко дают и 3500, и 4800 единиц. В ответе пользовательнице пиши прямо — «пост на 3806 единиц, с вашим заголовком 3911, лимит 4096».
- **Как совместить с требованием десяти абзацев:** 10–12 абзацев по 300–350 знаков как раз укладываются в 3500–3900. Если материал не влезает, убирай **целые срезы темы** (один инструмент, один механизм, один пример), а не разбавляй оставшиеся абзацы до лозунгов: вырезанное всё равно есть в статье, на которую ведёт ссылка. Дробить длинный пост на два сообщения — только по просьбе пользовательницы.
- **Никаких `[[wikilinks]]` и Obsidian-разметки** — в Telegram они не работают.
- **Ссылки — inline, `[несколько слов](https://…)`**: `разобрано [в статье про desync](https://<рабочее имя вики>/Zapret2/desync)` (имя — `zapret-links link wiki`). В Telegram они становятся словами-ссылками только через HTML-файл (см. «Выдача поста»), и `md2tghtml.py` там же заменяет каждую ссылку на вики и git входной (наш домен в посте не появляется, решение владелицы от 30 октября 2026). Правила:
- Ссылочный текст — естественная часть фразы («как добавить свой профиль», «одно соединение — один профиль»), а не «тут», «здесь», «по ссылке».
- Каждое упоминание статьи vault — и новой, и прошлых — со ссылкой при первом упоминании темы; одну статью дважды не линкуй. Прошлые статьи ищи в vault по темам поста (профиль, пресет, исключения, проверка стратегии, CDN, игры и т.п.).
- URL строится как для плашки `[!mirror]`: путь файла от корня vault без `.md`, пробелы → `-`, кириллица процент-кодируется (иначе скобки и пробелы сломают разметку). Ссылайся только на опубликованные заметки (не из `VPS/`, `scripts/`, не с `publish: false`) и проверь, что страница отвечает 200.
- Финальный призыв — отдельной строкой-цитатой: `> 🏃 [Полный разбор: <тема>](https://…)`. Префикс `> ` скрипт `md2tghtml.py` превращает в `<blockquote>`, и при вставке в Telegram Desktop / ZaStoGram Desktop строка сразу становится цитатой: lib_ui разбирает этот тег в `ui/text/text_html_tags.cpp`. Формат выбрал владелица 30 сентября 2026 года, до этого было `👉` без цитаты.
- **Домены, порты, имена файлов и процессов — в одинарных обратных кавычках**: `` `steamserver.net` ``, `` `*.fastly.steamstatic.com` ``, `` `80,443-65535` ``, `` `steam.exe` ``. Скрипт превращает их в `<code>`, и Telegram показывает их моноширинным текстом и **не делает кликабельными**: голый `steamcommunity.com` в посте стал бы ссылкой, а упоминание домена — не приглашение на него переходить. Бонус: моноширинный текст копируется в буфер по тапу. Ссылки `[текст](url)` в кавычки не заключай. Внутри кавычек не должно быть `_`, `*`, `~`: Telegram Desktop применяет к ним markdown даже в моноширинном тексте. Другую разметку (`**жирный**` и т.п.) без просьбы не добавляй.
- При подсчёте длины называй два числа: как есть и видимый текст — URL и скобки ссылок, обратные кавычки и префикс цитаты `> ` в лимит 4096 не входят. Для второго числа: ``re.sub(r'\[([^\]]+)\]\([^)]+\)', r'\1', t).replace('`', '').replace('\n> ', '\n')``.
- **Эмодзи — по одному в начале каждого содержательного абзаца, разные и эмоциональные**: смайлики-лица и жесты (😁 👀 😺 😩 😏 😐 ☝️ 🥴), а не тематические пиктограммы (🔌 📦 ⚙️ 🔍) — так пост звучит живым голосом канала, а не справочником. Заголовок — с праздничным эмодзи (🥳); вводные абзацы сразу после заголовка и финальная цитата-призыв (она с 🏃) идут без эмоционального смайлика в начале.
- **Заголовок и голос — от лица канала «мы»**, разговорно, как рассказ о собственной находке, а не как название статьи: «🥳 Как чинить Steam? Мы взяли и рассмотрели его трафик сами!» вместо «Steam и Zapret 2: почему профиль с портами 80 и 443 не спасает». Первые абзацы — зачем канал взялся за тему и что именно сделал, а не пересказ боли читателя. Короткие авторские ремарки в скобках уместны («Fastly (его чаще всего и блокируют)»), если они верны.
- **Структура поста:** заголовок-вопрос/восклицание → 1–2 вводных абзаца без эмодзи (почему тема, что сделали) → разбор сути, по одному срезу темы на абзац: механизм, следствия, частые заблуждения, практические рекомендации → сразу финальный призыв цитатой `> 🏃 [Полный разбор: …](url)`. Отдельного абзаца «что вы найдёте в статье» **не пиши** — владелица его вырезает.
- **Содержательная точность сохраняется** даже в публицистике: те же правила про абсолютизмы, атрибуцию чисел и хеджирование, что и для заметок (см. «Принципы»). Анонс не обещает больше, чем есть в статье.
- Тон бери из самого канала/заметки; если есть сомнение в платформе — по умолчанию Telegram.
### Выдача поста: блок кода + путь к HTML-странице
Telegram Desktop **не разбирает** `[текст](url)` в простом тексте: 28 сентября 2026 разметка ушла в пост как есть (`[в статье про desync] (https://…)`), а вариант `текст (url)` оставляет голый URL рядом со словами. Зато с апреля 2026 (lib_ui, коммит «Copy / paste formatting to / from HTML») он при вставке берёт форматирование из **HTML в буфере обмена**: `<a href>` становится словом-ссылкой, `<code>` — моноширинным текстом, `<blockquote>` — цитатой. Полный список тегов, которые понимает вставка (`b`, `i`, `u`, `s`, `code`, `pre`, `blockquote`, `tg-spoiler`, `a` и др.), — в `ui/text/text_html_tags.cpp` исходников lib_ui; копия лежит в `/home/codex-pve/zastogram/windows/Telegram/lib_ui`. ZaStoGram Desktop, из которого владелица публикует посты, использует тот же lib_ui. На этом и построена выдача, проверенная владелицей 28 сентября 2026:
1. Сохрани пост в файл в scratchpad (`post.txt`) с разметкой `[текст](url)`, `` `домен` `` и финальной строкой-цитатой `> 🏃 […](url)`, посчитай длину.
2. Собери HTML: `python3 .claude/skills/vault-note/scripts/md2tghtml.py post.txt post-<тема>.html "Пост о <теме>" "Подпись картинки|https://otukcszfwr.zapret.moe/…png" …`. Третий аргумент — название страницы (2–4 слова, своё для каждого поста), дальше необязательные картинки для поста в виде «подпись|URL на вики»: они выводятся списком ссылок под постом и в буфер не попадают. Скрипт превращает ссылки в `<a>`, обратные кавычки в `<code>`, подряд идущие строки с префиксом `> ` — в одну цитату `<blockquote>`, переводы строк в `<br>` и добавляет кнопку «Скопировать», которая кладёт пост в буфер как HTML. После цитаты скрипт ставит один `<br>`, а не два: цитата — блочный элемент и сама начинается с новой строки.
3. Выведи пост в чат **одним блоком кода** (для чтения и правок) и **обязательно** отдай отрендеренную HTML-страницу: положи файл в `/var/tmp/<папка-поста>/` (не в `/tmp`: права там сбрасываются) и напиши его полный путь в обратных кавычках отдельной строкой, например `/var/tmp/school-post/post-school-recording.html`. Панель ccweb показывает такой путь кликабельным, и владелица открывает файл сама (решение владелицы от 4 ноября 2026: «я сама открою этот файл», «я всегда вижу, если ты присылаешь так»). Если в сессии есть инструмент Artifact, дополнительно опубликуй файл (`file_path` — собранный HTML, `icon: "message"`, одна фраза в `description`) и дай ссылку `claude.ai/artifact/…` отдельной строкой, голым URL без текста вокруг (решение от 31 октября 2026); перед первой публикацией в сессии загрузи скилл `artifact-design`. Если инструмента нет, достаточно пути: не пиши, что страница «не дойдёт», и не спрашивай, как её отдать. SendUserFile в веб-панели ccweb нет. Скрипт уже выдаёт страницу в нужном виде (без `<!doctype>`/`<html>`/`<body>`, с `<title>` и цветами через токены), переделывать её не нужно. Правка поста — пересобери тот же файл по тому же пути.
4. В ответе коротко: «Скопировать» (или выделить пост и Ctrl+C) → **Ctrl+V** в Telegram Desktop или ZaStoGram Desktop; Ctrl+Shift+V вставит без оформления, и цитата со ссылками пропадут.
Чего не делать:
- **Не заканчивай выдачу на одном блоке кода без пути к странице.** Путь вида `/var/tmp/…/post.html` в обратных кавычках — рабочий способ передачи: владелица открывает его из панели (так принято с 4 ноября 2026; прежняя запись «такой файл не доходит» была неверной). Прежний запрет «не публикуй пост через Artifacts» снят 7 октября 2026.
- **Не предлагай копировать отрендеренный markdown из чата**: соседние `<p>` Telegram склеит одиночным переводом строки, и пустые строки между абзацами пропадут. В HTML-файле абзацы разделены `<br><br>`, поэтому они сохраняются.
- **Не принимай формат образца за формат вставки**: пост, скопированный владелицей из Telegram, показывает ссылки как «текст (url)» — это выгрузка при копировании, а не то, что нужно отдавать.
## Примеры: до → после
**Отсылка к чату**
❌ `Как я говорил выше, лимит SYN-ACK сначала казался вредным.`
✅ `Лимит SYN-ACK часто называют вредным приёмом — на деле всё сложнее (см. ниже).`
**Первое лицо ассистента**
❌ `Я был неправ и пересмотрел вывод.`
✅ `Вывод (уточнённый по наблюдениям): приём рабочий, но с оговорками.`
**Висячая отсылка без контекста**
❌ `Это помогает против того детекта.`
✅ `Дробление ClientHello помогает против пассивного DPI, который не пересобирает
TCP-поток.`
**Относительная дата**
❌ `Блокировки начались недавно.`
✅ `Блокировки начались с 22 мая 2026 (issue #30733).`
**Оверклейм без атрибуции (точность важнее акцента)**
❌ `Западного пути за сертификатом не осталось вовсе — только госцентр.`
✅ `Для подсанкционных удобные крупные западные УЦ сужаются, но «вовсе не осталось»
неверно: выданные сертификаты ещё живут, а оператор найдёт другой УЦ (по
сообщениям, июнь 2026).`
## Чек-лист перед сохранением
- [ ] Нет упоминаний чата/разговора и первого лица ассистента
- [ ] Голос владелицы от первого лица — в женском роде («я нашла»); к читателю — без рода («вы задали», «если у тебя стоит»), нет «ты установил» и «ты установила»
- [ ] Каждый англоязычный термин, сокращение и название структуры введены по ходу статьи непосредственно перед первым нужным употреблением: сначала понятный русский контекст (роль и проявление), затем точное название; стартового словаря или свалки определений нет
- [ ] Нет висячих «это / тот приём / упомянутое» без конкретики
- [ ] Относительные даты заменены на абсолютные
- [ ] Непроверенное помечено дисклеймером, источник указан
- [ ] Абсолютизмы («только», «весь/вся», «никогда», «единственный», «вовсе») смягчены или обоснованы
- [ ] Сильные числа/проценты/даты — с источником или явной атрибуцией («по оценкам…», «по сообщениям СМИ…»)
- [ ] Источнику не приписано больше, чем в нём сказано
- [ ] Каждый источник стоит кликабельной ссылкой внутри текста — на словах самой фразы, без голых URL и без упоминаний издания без ссылки; внизу есть раздел «Источники» с теми же ссылками списком, и наборы адресов в тексте и в списке совпадают
- [ ] Оценки, прогнозы и мотивы хеджированы в самом предложении, а не только общим дисклеймером
- [ ] Числа и указатели внутренне согласованы (повторы совпадают; «верхняя строка», «см. выше» бьют точно в цель)
- [ ] При конфликте точности и авторского акцента выбрана точность
- [ ] Выполнены два прохода: сначала факты и аргумент, затем точечная чистка ИИ-штампов; после правок смысл перепроверен
- [ ] Нет чатовых вступлений, мета-фраз, пустого пафоса, рекламных эпитетов, безымянных «экспертов» и шаблонных выводов без проверяемого содержания
- [ ] Абзацы связаны причинно-следственно, каждый добавляет новую информацию; текст не разваливается на переставляемый набор тезисов
- [ ] Ритм живой, но не нарочитый: нет серии одинаковых по длине абзацев, навязчивых «не X, а Y» и драматических фраз-обрывков
- [ ] Оформление сбалансировано: основа статьи — абзацы; списки, таблицы и callout-ы используются по функции, а не для декора
- [ ] Англоязычные анти-ИИ-правила не применены механически; сохранены точные термины, необходимые оговорки, цитаты и авторский голос
- [ ] Сложная мысль переобъяснена отдельным простым абзацем («Проще говоря: …»); аналогии — только там, где без образа никак
- [ ] Каждый раздел развёрнут полно (введение + простое переобъяснение + разбор), а не сжат в плотную строку для знатока
- [ ] Чужая тема не переписана заново — дана краткая суть + `[[ссылка]]` на обзорную заметку (проверил поиском, что её ещё нет)
- [ ] Ссылки стоят в теле текста: первое упоминание ключевого понятия в каждом крупном разделе — `[[ссылка]]` (шапка-callout и «См. также» не в счёт); дописанные/переписанные разделы отдельно проверены на голые термины; связи двусторонние
- [ ] Frontmatter заполнен, включая `description` (1–2 предложения до ~150 знаков с ключевыми словами) и `image` при наличии обложки; есть раздел «См. также»
- [ ] Сразу после frontmatter стоит callout `[!mirror]` со ссылкой на страницу этой заметки на wiki2.zapret.moe (путь без `.md`, пробелы → `-`)
- [ ] В новой статье есть 2–3 собственные диаграммы по скиллу `vault-chart`, отрендеренные `render.py` через Chromium, встроены после абзацев, которые они иллюстрируют, и лежат в `attachments` того же раздела
- [ ] У новой статьи есть собственная локальная обложка из `attachments`; для стандартной новой обложки использован холст 1672 × 941, embed не задаёт принудительный размер, `.md` и изображение подготовлены к одному Git-коммиту
- [ ] `aliases` — 4–8 реальных поисковых фраз (кириллица и латиница, вопросы читателя, тексты ошибок), а не пересказ заголовка; варианты написания названия даны один раз курсивом при первом употреблении, а не рассыпаны по тексту
- [ ] Якоря ссылок проверены; пайпы в таблицах экранированы
- [ ] Проза НЕ перенесена вручную: абзац/пункт/строка callout — одной строкой (код-блоки и таблицы не трогаем)
- [ ] Индекс/обзор обновлён; проставлены обратные ссылки
- [ ] Тема атомарна — одна заметка раскрывает один вопрос
- [ ] В конце есть Forgejo-футер `[!quote]` со ссылкой на свой исходник (путь от корня vault, пробелы/кириллица URL-кодированы) и на zip-архив репозитория; стоит перед виджетом комментариев, если он есть