Some checks failed
Published content check / validate (push) Failing after 23s
Решение владелицы от 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>
164 lines
25 KiB
Markdown
164 lines
25 KiB
Markdown
---
|
||
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-коммитом
|