Решение владелицы от 1 ноября 2026: .claude/skills/, .agents/skills/ и .memory/ коммитятся вместе с остальными правками vault, включая сторонние скиллы avoid-ai-writing и stop-slop. .gitignore теперь пропускает .claude/skills/ (прочие служебные файлы .claude/ по-прежнему закрыты), __pycache__ исключён. Репозиторий публичный, поэтому в заметках памяти реальные адреса хостов заменены ссылкой на pve-admin/servers.md; ключей и паролей в коммите нет. Попутно: шаблон Forgejo-футера в vault-note берёт имя git из zapret-links вместо вписанного git2; в памяти упоминания владельца переведены в женский род, устаревшие заметки об именах сайта и об обложках приведены к текущим правилам. На сайт эти папки не попадают (ignorePatterns Quartz). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
25 KiB
| name | description |
|---|---|
| vault-image | Работа с изображениями в этом Obsidian-хранилище: как подготовить собственную иллюстрацию, достать картинку, присланную в чат, куда её положить, в каком формате и качестве сохранить, как встроить в заметку и как она попадает на сайт wiki2.zapret.moe (публикация = git commit). Используй каждый раз, когда в заметку нужно добавить, заменить или удалить изображение — скриншот, схему, шапку статьи. Типичные триггеры: «добавь картинку/фото/скриншот», «вставь изображение в шапку», «замени картинку», «качество не сжалось», «положи оригинал», «удали вложение», а также любой ответ на присланный в переписку скриншот, который должен попасть в .md-файл. Дополняет скилл vault-note, который отвечает за текст заметки, а не за вложения. Собственные диаграммы и инфографику строй по скиллу vault-chart; здесь — только файл, формат и встраивание. |
Изображения в vault
Картинка живёт в двух местах сразу: файлом в папке attachments и строкой ![[имя.расширение]] в заметке. Плюс к этому у неё есть третье состояние — опубликована она на сайте Obsidian Publish или нет. Расхождение любых двух из трёх и даёт типичные поломки: пустой прямоугольник вместо картинки, битая ссылка на сайте, забытый мусорный файл в репозитории.
1. Достать картинку, присланную в чат
В веб-панели ccweb картинка на диске есть. Там присланное изображение сопровождается строкой [Image: source: /home/codex-pve/.ccweb/c/<чат>/paste/paste-….png] — это готовый файл, извлекать его из транскрипта не нужно. Копируй его в attachments байт в байт и сверяй md5sum; права у него 0600, поставь chmod 644. Так 7 октября 2026 года легли два скриншота «Коммерсанта» и авторская обложка 2000 × 1125. Описанное ниже извлечение из транскрипта нужно только там, где такой строки с путём нет.
Когда пользовательница вставляет изображение в переписку, оно помечается как [Image #N] и до файловой системы в этом окружении не доходит: директории ~/.claude/image-cache/, про которую пишут общие инструкции, здесь нет. Картинка приходит base64-строкой внутри транскрипта текущей сессии.
Транскрипт лежит в ~/.claude/projects/-home-codex-pve-Privacy/<session-id>.jsonl, где <session-id> — тот же идентификатор, что и в пути scratchpad-директории. Извлечение (подставь свой session-id и путь scratchpad):
python3 -c "
import json, base64, os
p='/home/codex-pve/.claude/projects/-home-codex-pve-Privacy/<session-id>.jsonl'
out='<scratchpad>'
def walk(o, acc):
if isinstance(o, dict):
s=o.get('source')
if o.get('type')=='image' and isinstance(s, dict) and s.get('data'):
acc.append((s.get('media_type','image/png'), s['data']))
for v in o.values(): walk(v, acc)
elif isinstance(o, list):
for v in o: walk(v, acc)
for i, line in enumerate(open(p)):
try: o=json.loads(line)
except: continue
acc=[]; walk(o, acc)
for j,(mt,d) in enumerate(acc):
ext=mt.split('/')[-1].replace('jpeg','jpg')
fn=f'{out}/line{i}_{j}.{ext}'
open(fn,'wb').write(base64.b64decode(d))
print(fn, len(base64.b64decode(d)))
"
Дальше обязательно открой каждый извлечённый файл через Read и сопоставь с тем, что пользовательница описывала словами. В транскрипте лежат и картинки из тулов (скриншоты, прочитанные файлы), поэтому порядок строк ≠ порядок [Image #N], и без сверки легко положить в заметку чужой кадр.
Картинки могут лежать не в том транскрипте, который ты читаешь. Когда сессия продолжается или перезапускается, текст первого сообщения переносится в новый .jsonl, а прикреплённые к нему изображения — нет: они остаются в файле предыдущей сессии. Внешне это выглядит так, будто пользовательница прислала только текст, хотя картинки были. Поэтому ищи по всем свежим транскриптам проекта, а не только по своему:
ls -lt ~/.claude/projects/-home-codex-pve-Privacy/*.jsonl | head -5
Файл с временем изменения незадолго до начала твоей сессии — тот самый предшественник; прогони по нему тот же скрипт извлечения. Признак попадания: первое сообщение там дословно совпадает с тем, с которого начался твой разговор, но содержит вложения.
Отличить присланное от своего по роли сообщения нельзя. Результат каждого вызова Read с изображением записывается в транскрипт тем же способом и с той же ролью user, что и вложение пользовательницы. То есть собственная сгенерированная обложка, которую ты открыл для проверки, выглядит в выгрузке точно так же, как присланный скриншот, а повторный Read того же файла даёт вторую копию с идентичным размером. Отделяй одно от другого по содержимому (Read показывает картинку — сравни глазами), по совпадению байтового размера с файлом, который ты сам только что создал, и по дублям: две записи одинакового веса — это один кадр, прочитанный дважды.
Инвентаризация присланного: ни одна картинка не должна потеряться
Пользовательница присылает изображение с намерением увидеть его в заметке. Молча использовать одно и забыть про второе — типичная и заметная ошибка: человек помнит, что отправлял, и спрашивает «почему не добавил». Поэтому перед тем как объявить работу над заметкой законченной, пересчитай все вложения пользовательницы в транскрипте и сверь их со списком ![[…]] в заметках.
Правило простое: каждое присланное изображение либо встроено в заметку, либо ты явно объясняешь, почему оно не подошло, — умолчание не допускается. Если картинок несколько и они относятся к разным темам, разложи их по соответствующим заметкам, а не складывай все в одну.
В отчёте пользовательнице пиши куда именно легла каждая картинка — файл в attachments, заметка и раздел. Так расхождение «я прислала две, вижу одну» обнаруживается сразу, а не через несколько сообщений.
Побочные пути, где иногда находятся свежие изображения этой машины: ~/.codex/attachments/<uuid>/, ~/.claude/paste-cache, ~/.claude/downloads. Быстрый поиск:
find ~ -maxdepth 4 \( -iname '*.png' -o -iname '*.jpg' -o -iname '*.webp' \) -mmin -240 2>/dev/null
[!warning] Картинка из чата — уже пережатая копия Клиент отдаёт изображение в WebP с потерями (типично ~250–300 КБ на кадр 1600×900), даже если у пользовательницы лежит оригинальный PNG на пару мегабайт. Считать эту копию оригиналом нельзя: любое пересохранение добавит второе поколение потерь поверх первого. Если изображение важно (шапка статьи, скриншот с мелким текстом) — спроси у пользовательницы путь к исходному файлу и клади в vault его. Пользовательница часто может дать точный путь или UUID файла — этого достаточно, чтобы найти его через
find.
2. Куда класть файл
В .obsidian/app.json этого хранилища задано "attachmentFolderPath": "./attachments" — то есть папка attachments рядом с заметкой, а не одна общая на весь vault. Для mtproxy/faketls-relay-diagnosis.md это mtproxy/attachments/. Если папки в разделе ещё нет — создай её.
Собственные иллюстрации для новых статей храни только внутри репозитория todo. Не подставляй вместо файла ссылку на GitHub, Forgejo Raw, CDN, фотохостинг или другое внешнее хранилище. Положи изображение в attachments раздела и ссылайся на него локальным Obsidian-embed. Так Git-версия статьи, Obsidian vault и Obsidian Publish используют один и тот же файл, а удаление внешнего аккаунта или изменение URL не ломает материал.
Имя файла — человекочитаемое, уникальное и говорящее: <тема>-<что-на-картинке>[-<дата>].png, например faketls-relay-diagnosis-header.png или domain-owner-rockstar-error-2026-07.png. Не оставляй 2.png, image-43.png и Pasted image 20250914131231.png — такие имена невозможно найти поиском и невозможно понять в diff-е.
Проверь ls, что файл реально лёг на место, прежде чем писать embed.
3. Формат и качество
Правило по умолчанию: не пережимай. Если у тебя на руках оригинал (PNG с генерации, исходный скриншот) — копируй его в attachments байт в байт и убедись, что md5sum совпал с источником. Экономия сотни килобайт не стоит потерянных деталей, а lossless-перепаковка PNG средствами PIL выигрывает всего ~3 %.
Конвертировать имеет смысл только тогда, когда исходник в формате, которого в хранилище ещё нет (в vault исторически только PNG и JPG), либо когда вес реально мешает. В этом случае:
- JPEG бери с
quality=95иsubsampling=0(цветность 4:4:4). Дефолтные настройки PIL включают субдискретизацию 4:2:0 — цвет хранится в половинном разрешении, и на насыщенных краях (неон, подсветка, цветной текст) появляется грязь. Разница на реальном кадре: q=88 4:2:0 → PSNR 40.9 дБ при 306 КБ, q=95 4:4:4 → 46.2 дБ при 596 КБ. - Скриншоты интерфейсов и всё с мелким текстом — только PNG. JPEG звенит по контуру букв, и подписи в GUI становятся мыльными.
- Разрешение не трогай. Ресайз шапки или скриншота под «нормальный вес» лишает читателя возможности рассмотреть детали, ради которых картинку и вставляли.
Собственные диаграммы по данным (графики, плитки, инфографика) подчиняются отдельному скиллу vault-chart: там правила смысла и подачи — заголовок-вывод, подписи на данных, кегль под телефон. Здесь к ним относится только то, куда положить готовый PNG и как его встроить.
Для новой собственной обложки используй проверенный размер 1672 × 941 пиксель, если пользовательница не задала другой формат. Эталон — mtproxy/attachments/faketls-relay-diagnosis-header.png: это PNG 1672 × 941, который хранится в репозитории и используется без принудительного изменения размера. Не растягивай меньший исходник до этого разрешения: размер 1672 × 941 относится к холсту новой обложки, а не к обязательному ресайзу уже готовых изображений.
Обложка-иллюстрация с Запрет-тян и РКН-тян нужна к каждой новой статье (решение владелицы от 24 октября 2026). Придумай, что делают героини по теме статьи, где это происходит и каким планом снимать, дальним или средним. Промпт пиши по шаблону из gptimage/: там готовые локации, camera-presets.md и правило про белую кружку с эмблемой Роскомнадзора без надписей. Новый промпт сохраняй туда же. Промпт выдаётся вместе со статьёй и постом. Статью публикуй сразу, не дожидаясь картинки; когда владелица пришлёт обложку, поставь её шапкой отдельной правкой (решение владелицы от 31 октября 2026). Полные правила лежат в разделе «Обложки статей» файла AGENTS.md.
Проверить, насколько пострадал кадр, можно замером PSNR (Peak Signal-to-Noise Ratio — мера отличия пережатого кадра от исходного, выше значит ближе; ≥46 дБ практически неотличимо, 40 дБ уже видно на резких краях при 100 % зуме):
python3 -c "
from PIL import Image, ImageChops
import math
a=Image.open('src.png').convert('RGB'); b=Image.open('dst.jpg').convert('RGB')
h=ImageChops.difference(a,b).convert('L').histogram()
mse=sum(i*i*n for i,n in enumerate(h))/(a.size[0]*a.size[1])
print('PSNR=%.2f dB' % (10*math.log10(255*255/mse)) if mse else 'идентичны')
"
4. Встроить в заметку
Embed пишется всегда с расширением файла: ![[faketls-relay-diagnosis-header.png]]. Без расширения Obsidian картинку не покажет. Имя должно совпадать с файлом посимвольно, включая регистр.
Картинка видна только там, где физически стоит embed. Ссылка [[другая-заметка]] её не подтянет — если одно изображение нужно в двух заметках, пиши ![[имя.png]] в каждой (сам файл дублировать не нужно, Obsidian ищет его по всему хранилищу).
Место в тексте: шапочная иллюстрация идёт после заголовка # и перед первым callout-ом — так читатель сначала видит, о чём заметка, а не упирается в картинку до заголовка. Иллюстрация к шагу инструкции ставится отдельной строкой сразу после абзаца, который её вводит, с пустой строкой до и после.
По умолчанию не задавай размер в embed. Для обложки 1672 × 941 правильная вставка — ![[имя.png]], без |900, HTML-атрибутов width/height и CSS, который принудительно растягивает картинку. Явную ширину добавляй только по прямой просьбе пользовательницы или после подтверждённой проверки, что исходный размер ломает конкретную вёрстку; задавай только ширину с сохранением пропорций, никогда не растягивай изображение по двум независимым размерам.
5. Публикация на wiki2.zapret.moe
Сайт https://otukcszfwr.zapret.moe (self-hosted Quartz 4) собирается из vault автоматически при каждом локальном коммите — отдельной команды публикации вложений нет. Что из этого следует:
Вложение публикуется коммитом. Закоммить картинку вместе с заметкой — при следующей пересборке (примерно полминуты) она появится на сайте. Ничего «доотправлять» не нужно.
Замена и удаление тоже автоматические. При замене формата достаточно двух шагов: положить новый файл и поправить embed; удалённый локально файл исчезает с сайта сам при пересборке. Старые обходные приёмы с publish:remove и файлами-заглушками больше не нужны.
Замена обложки другим форматом (PNG → JPG). Положи новый файл, поправь оба места в заметке — embed ![[…]] и поле image: во frontmatter, — удали старый через git rm и закоммить всё вместе. С сайта старый файл уйдёт сам, а на зеркале Obsidian Publish останется: obsidian publish:remove для уже удалённого с диска файла отвечает File … not found. Снимай его через API: obsidian eval code="app.internalPlugins.plugins.publish.instance.apiRemoveFile('<путь>')", затем проверь publish:list. После пересборки убедись, что новый адрес отвечает 200, старый 404, а og:image страницы указывает на новый файл.
Закрытые разделы. Вложения из папок, перечисленных в ignorePatterns (/srv/wiki-quartz/quartz.config.ts) — например VPS/ — в сборку не попадают. publish: false во frontmatter действует только на заметки, не на вложения: закрытые картинки держи в закрытых папках.
Принудительная пересборка: sudo systemctl start wiki-rebuild.service.
6. Git
Публикация привязана к Git: пока картинка не закоммичена, её нет ни на сайте, ни в Forgejo. Коммить вложение вместе с заметкой, которая на него ссылается, одним коммитом — иначе в Forgejo заметка ссылается в пустоту. Перед коммитом проверь точный состав staging: там должны быть и .md, и использованный файл из attachments, но не .agents/, .claude/ или .obsidian/. Отдельные правила репозитория (коммит напрямую в main, уведомление в Telegram на каждый push) — в vault-note и AGENTS.md.
Чек-лист
- Извлечённый из транскрипта файл открыт через Read и сверен с тем, что описывал пользовательница
- Проверены все свежие
.jsonlпроекта, а не только транскрипт текущей сессии: при продолжении разговора вложения первого сообщения остаются в файле предыдущей сессии - Собственные сгенерированные картинки не перепутаны с присланными: у Read-результатов та же роль
userв транскрипте, дубли одинакового веса — это один кадр, прочитанный дважды - Все присланные пользовательницей изображения использованы: каждое встроено в подходящую заметку либо явно объяснено, почему не подошло; в отчёте указано, куда легла каждая картинка
- Проверено, не нужен ли оригинал вместо пережатой чатовой копии (если качество важно — путь запрошен у пользовательницы)
- Файл лежит в
attachmentsсвоего раздела, имя описательное,lsподтверждает - Собственная иллюстрация хранится в репозитории
todo, а не подключена URL-ссылкой с GitHub, Forgejo Raw, CDN или фотохостинга - При копировании оригинала
md5sumсовпадает с источником; пережатие — только осознанно, JPEG q=95 + 4:4:4, скриншоты в PNG, разрешение не менялось - Новая собственная обложка подготовлена на холсте 1672 × 941, если пользовательница не задала другой формат; готовый меньший исходник ради этого не растягивался
- Embed написан с расширением, без принудительного размера, имя совпадает посимвольно, стоит после заголовка/абзаца, с пустыми строками вокруг
- При замене формата: embed обновлён, старый файл удалён (с сайта он исчезнет сам при пересборке)
- Вложение и заметка попадают в Forgejo одним Git-коммитом