mirror of
https://github.com/EDeev/declaude.git
synced 2026-10-08 04:59:30 +03:00
91 lines
5.7 KiB
Markdown
91 lines
5.7 KiB
Markdown
# declaude
|
||
|
||
Автономная утилита для преобразования официального экспорта данных Claude.ai в интерактивный статический HTML-архив.
|
||
|
||
Позволяет локально хранить, просматривать и быстро искать диалоги без внешних зависимостей и необходимости поднимать базы данных или веб-серверы.
|
||
|
||
## Онлайн-версия
|
||
|
||
Не хочется устанавливать Python и разбираться руками — есть готовая веб-версия:
|
||
**https://fe0.ru/declaude/**. Загружаете zip-экспорт, получаете готовый архив — без установки
|
||
чего-либо. Если важна приватность данных, запустите скрипт локально по инструкции ниже.
|
||
|
||
## Возможности
|
||
|
||
- **Полная автономность:** генерирует чистые HTML-страницы для каждого диалога, которые открываются в любом браузере.
|
||
- **Страницы проектов:** рендеринг контекстных документов и шаблонов системных промптов для каждого проекта.
|
||
- **Полноценная поддержка Markdown:** заголовки, списки, таблицы, цитаты, блоки кода.
|
||
- **Подсветка синтаксиса без сторонних библиотек:** встроенная поддержка Python, JavaScript, TypeScript, SQL, Bash, Go и Rust.
|
||
- **Темы оформления и языки:** переключение между светлой и тёмной темой, а также интерфейс на русском и английском языках (выбор сохраняется в LocalStorage).
|
||
- **Маппинг проектов:** возможность связывать диалоги с проектами прямо в браузере с выгрузкой файла `mapping.json` и быстрой пересборкой.
|
||
- **Инкрементальные обновления:** режим `--update` обновляет только добавленные или изменённые диалоги.
|
||
- **Нулевые зависимости:** работает исключительно на стандартной библиотеке Python 3.8+.
|
||
|
||
## Подготовка данных
|
||
|
||
1. Откройте **claude.ai → Settings → Privacy → Export data**.
|
||
2. Дождитесь письма со ссылкой и скачайте zip-архив с выгрузкой.
|
||
3. Распакуйте архив в отдельную папку. Внутри находятся файлы `conversations.json`, `users.json` и каталог `projects/`.
|
||
|
||
## Использование
|
||
|
||
### Первая сборка архива
|
||
|
||
```bash
|
||
python declaude.py --build --source ./claude-export
|
||
```
|
||
|
||
После завершения откройте файл `claude_archive/index.html` в браузере.
|
||
|
||
### Указание своей папки для архива
|
||
|
||
```bash
|
||
python declaude.py --build --source ./claude-export --output ./my-archive
|
||
```
|
||
|
||
### Инкрементальное обновление из нового архива
|
||
|
||
```bash
|
||
python declaude.py --update new_export.zip
|
||
```
|
||
|
||
Регенерируются только новые и отредактированные страницы, текущая привязка диалогов к проектам в `mapping.json` сохраняется.
|
||
|
||
### Назначение диалога проекту через консоль
|
||
|
||
```bash
|
||
python declaude.py --map <conversation_uuid> <project_uuid>
|
||
python declaude.py --remap
|
||
```
|
||
|
||
Быстрая пересборка страниц проектов (`--remap`) занимает секунды, так как не пересобирает неизменённые диалоги.
|
||
|
||
## Структура сгенерированного архива
|
||
|
||
```
|
||
claude_archive/
|
||
├── index.html # Главная страница: статистика, проекты, последние чаты
|
||
├── all_conversations.html # Полный список диалогов с поиском и фильтрацией
|
||
├── conversations/
|
||
│ └── <uuid>.html # Страницы отдельных диалогов
|
||
├── projects/
|
||
│ └── <uuid>/
|
||
│ └── index.html # Страницы проектов с документами и диалогами
|
||
└── assets/
|
||
├── style.css
|
||
└── app.js
|
||
```
|
||
|
||
## Параметры командной строки
|
||
|
||
- `--build` — полная сборка архива из исходного каталога.
|
||
- `--source ПУТЬ` — путь к каталогу с распакованным экспортом (по умолчанию: `claude-backup-v1`).
|
||
- `--output ПУТЬ` — каталог для сохранения HTML-архива (по умолчанию: `claude_archive`).
|
||
- `--update АРХИВ.ZIP` — добавление данных из нового zip-архива с сохранением маппинга.
|
||
- `--remap` — быстрая пересборка индексной страницы и страниц проектов.
|
||
- `--map CONV_ID PROJ_ID` — ручное сопоставление диалога с проектом.
|
||
- `--mapping ПУТЬ` — путь к файлу сопоставлений (по умолчанию: `./mapping.json`).
|
||
|
||
## Лицензия
|
||
|
||
MIT
|