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

98 KiB
Raw Permalink Blame History

name description
vault-note Конвенции написания и публикации заметок в этом 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»), а не как голый факт; не приписывай источнику больше, чем в нём сказано. Различай факт / оценку / прогноз / мотив: прогнозы и особенно приписывание мотивов и намерений хеджируй прямо в предложении, а не только общим дисклеймером в начале раздела. Держи внутреннюю согласованность: повторяющиеся числа не должны расходиться, а указатели («верхняя строка таблицы», «см. выше») — попадать точно в цель. Когда замечание по точности конфликтует с авторским акцентом — выбирай точность.

Скелет заметки

---
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 и avoid-ai-writing как редакторские эвристики. Они помогают заметить машинный ритм и пустые формулы, но не доказывают, что текст написал ИИ. Англоязычные запреты нельзя механически переносить в русский текст: тире, пассивный залог, наречие, риторический вопрос или перечисление из трёх пунктов сами по себе не являются ошибкой. Исправляй повторяющиеся шаблоны и их скопления, а не отдельный знак или слово вне контекста.

Работай в два прохода. На первом выстрой аргумент и проверь факты: каждый раздел должен добавлять новый факт, технический механизм, пример, следствие или обоснованный вывод. На втором перечитай текст именно как редактор: убери чатовые вступления, мета-комментарии о том, что «сейчас разберём», пустые заявления о важности, рекламные эпитеты, безымянные ссылки на «экспертов», одинаковые переходы, навязчивые конструкции «не 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] цитата источника.

  • Формат: [[Полный/Путь/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.
  • В каждой новой статье — минимум 2–3 собственные диаграммы, это обязательно (решение владелицы от 30 сентября 2026 года). Строй их по скиллу vault-chart и рендери только через 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; при любой работе с изображениями открывай его.

После создания НОВОЙ заметки — обнови окружение

Заметка-сирота не находится. Поэтому:

  • Добавь строку в индексную/обзорную заметку раздела (напр. 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] со ссылкой на свой исходник и на весь репозиторий:

---

> [!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-архив репозитория; стоит перед виджетом комментариев, если он есть