Slug сменён у текущего сайта второго аккаунта, в новом браузере страница открывается по прямой ссылке. AGENTS.md и скилл vault-note: новый адрес, пометка не возвращать slug zapret, проверка зеркала в приватном окне; в скилле исправлено, что сайт пересобирается после push, а не после локального коммита. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
98 KiB
| name | description |
|---|---|
| vault-note | Конвенции написания и публикации заметок в этом Obsidian-хранилище (vault про приватность, обход DPI и цензуры). Обязательно используй этот скилл каждый раз, когда создаёшь, дополняешь, переписываешь или «публикуешь» любую .md-заметку в этом vault — даже если пользовательница не просит явно «по правилам». Скилл делает заметку атомарной и самодостаточной: понятной читателю, который открыл её первой и не видел переписки. Убирает отсылки к чату и первое лицо ассистента, встраивает весь нужный контекст в текст, проставляет frontmatter, Obsidian-callout-ы, wikilinks и кросс-ссылки. Типичные триггеры: «создай заметку», «добавь/обнови/перепиши заметку», «запиши в vault», «оформи как заметку», «опубликуй», а также любое редактирование .md-файла внутри этого хранилища. |
Публикация заметок в этом Obsidian vault
Заметку пишет один человек, а читают её многие — спустя недели и месяцы, по прямой ссылке или из поиска, не видя нашего разговора. Поэтому единственный надёжный приём: писать так, будто читатель открыл эту заметку первой и не имеет никакого внешнего контекста. Всё ниже — следствия этого принципа.
Доставка без вопросов (стоящее решение владелицы от 19 ноября 2026)
Когда статья или правка готова и проверки пройдены, всегда проходи всю цепочку сам и не спрашивай «коммитить?», «публиковать?», «готовить пост?»:
- коммит только своих файлов и push в
main(порядок и защита от чужих правок — вAGENTS.md, раздел «Git-процесс»); - заливка этих же файлов на зеркало Obsidian Publish по одному (
obsidian publish:add path=…); - для новой статьи: пост для Telegram (HTML-страница по разделу «Выдача поста», путь к файлу в ответе) и промпт обложки (сохрани в
gptimage/, эту папку не коммить); - проверка живой страницы после пересборки сайта.
Пост в канал агент не отправляет: готовую страницу владелица открывает и вставляет в 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] цитата
источника.
Ссылки [[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. - В каждой новой статье — минимум 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:
- Сохрани пост в файл в scratchpad (
post.txt) с разметкой[текст](url),`домен`и финальной строкой-цитатой> 🏃 […](url), посчитай длину. - Собери 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>, а не два: цитата — блочный элемент и сама начинается с новой строки. - Выведи пост в чат одним блоком кода (для чтения и правок) и обязательно отдай отрендеренную 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>и цветами через токены), переделывать её не нужно. Правка поста — пересобери тот же файл по тому же пути. - В ответе коротко: «Скопировать» (или выделить пост и 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-архив репозитория; стоит перед виджетом комментариев, если он есть