todo/.claude/skills/vault-image/SKILL.md
loop-uh 62e0c4bae2
Some checks failed
Published content check / validate (push) Failing after 23s
Скиллы и память агентов — в Git, и так будет всегда
Решение владелицы от 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>
2026-11-01 18:10:54 -05:00

25 KiB
Raw Permalink Blame History

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-коммитом