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