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

164 lines
25 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
name: vault-image
description: >-
Работа с изображениями в этом 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):
```bash
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`, а прикреплённые к нему изображения — нет: они остаются в файле предыдущей сессии. Внешне это выглядит так, будто пользовательница прислала только текст, хотя картинки были. Поэтому ищи по всем свежим транскриптам проекта, а не только по своему:
```bash
ls -lt ~/.claude/projects/-home-codex-pve-Privacy/*.jsonl | head -5
```
Файл с временем изменения незадолго до начала твоей сессии — тот самый предшественник; прогони по нему тот же скрипт извлечения. Признак попадания: первое сообщение там дословно совпадает с тем, с которого начался твой разговор, но содержит вложения.
**Отличить присланное от своего по роли сообщения нельзя.** Результат каждого вызова Read с изображением записывается в транскрипт тем же способом и с той же ролью `user`, что и вложение пользовательницы. То есть собственная сгенерированная обложка, которую ты открыл для проверки, выглядит в выгрузке точно так же, как присланный скриншот, а повторный Read того же файла даёт вторую копию с идентичным размером. Отделяй одно от другого по содержимому (Read показывает картинку — сравни глазами), по совпадению байтового размера с файлом, который ты сам только что создал, и по дублям: две записи одинакового веса — это один кадр, прочитанный дважды.
### Инвентаризация присланного: ни одна картинка не должна потеряться
Пользовательница присылает изображение с намерением увидеть его в заметке. Молча использовать одно и забыть про второе — типичная и заметная ошибка: человек помнит, что отправлял, и спрашивает «почему не добавил». Поэтому **перед тем как объявить работу над заметкой законченной, пересчитай все вложения пользовательницы в транскрипте и сверь их со списком `![[…]]` в заметках**.
Правило простое: каждое присланное изображение либо встроено в заметку, либо ты явно объясняешь, почему оно не подошло, — умолчание не допускается. Если картинок несколько и они относятся к разным темам, разложи их по соответствующим заметкам, а не складывай все в одну.
В отчёте пользовательнице пиши **куда именно легла каждая картинка** — файл в `attachments`, заметка и раздел. Так расхождение «я прислала две, вижу одну» обнаруживается сразу, а не через несколько сообщений.
Побочные пути, где иногда находятся свежие изображения этой машины: `~/.codex/attachments/<uuid>/`, `~/.claude/paste-cache`, `~/.claude/downloads`. Быстрый поиск:
```bash
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`](../vault-chart/SKILL.md): там правила смысла и подачи — заголовок-вывод, подписи на данных, кегль под телефон. Здесь к ним относится только то, куда положить готовый 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 % зуме):
```bash
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`](../vault-note/SKILL.md) и `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-коммитом