Claude Archive Converter
Загрузите zip-файл экспорта данных Claude (Settings → Privacy → Export data).
Вы получите красивый HTML-архив всех ваших чатов и проектов.
```
---
## static/claude_archive.js
```javascript
const BASE = "/tools/claude-archive";
// Drag & drop
const dropZone = document.getElementById("dropZone");
const fileInput = document.getElementById("fileInput");
dropZone.addEventListener("click", () => fileInput.click());
dropZone.addEventListener("dragover", (e) => { e.preventDefault(); dropZone.classList.add("drag-over"); });
dropZone.addEventListener("dragleave", () => dropZone.classList.remove("drag-over"));
dropZone.addEventListener("drop", (e) => {
e.preventDefault();
dropZone.classList.remove("drag-over");
const file = e.dataTransfer.files[0];
if (file) handleFile(file);
});
fileInput.addEventListener("change", () => {
if (fileInput.files[0]) handleFile(fileInput.files[0]);
});
function handleFile(file) {
if (!file.name.endsWith(".zip")) {
showError("Ожидается файл .zip");
return;
}
uploadFile(file);
}
function uploadFile(file) {
showProgress(5, "Загрузка файла на сервер...");
const formData = new FormData();
formData.append("file", file);
fetch(`${BASE}/upload`, { method: "POST", body: formData })
.then((r) => {
if (!r.ok) return r.json().then((d) => { throw new Error(d.detail || "Ошибка загрузки"); });
return r.json();
})
.then((data) => pollStatus(data.job_id))
.catch((err) => showError(err.message));
}
let pollTimer = null;
function pollStatus(jobId) {
const STATUS_LABELS = {
queued: "В очереди...",
extracting: "Распаковка архива...",
loading: "Загрузка данных...",
building: "Генерация HTML-страниц...",
packing: "Упаковка результата...",
done: "Готово!",
error: "Ошибка",
};
fetch(`${BASE}/status/${jobId}`)
.then((r) => r.json())
.then((data) => {
const label = STATUS_LABELS[data.status] || data.status;
showProgress(data.progress || 0, label);
if (data.status === "done") {
showDone(jobId);
} else if (data.status === "error") {
showError(data.error || "Неизвестная ошибка");
} else {
// Продолжаем polling каждые 1.5 секунды
pollTimer = setTimeout(() => pollStatus(jobId), 1500);
}
})
.catch((err) => showError("Ошибка polling: " + err.message));
}
// UI helpers
function showProgress(pct, msg) {
document.getElementById("dropZone").style.display = "none";
document.getElementById("progressSection").style.display = "block";
document.getElementById("errorSection").style.display = "none";
document.getElementById("doneSection").style.display = "none";
document.getElementById("progressFill").style.width = pct + "%";
document.getElementById("statusMsg").textContent = msg;
}
function showDone(jobId) {
document.getElementById("progressSection").style.display = "none";
document.getElementById("doneSection").style.display = "block";
document.getElementById("downloadLink").href = `${BASE}/download/${jobId}`;
}
function showError(msg) {
clearTimeout(pollTimer);
document.getElementById("progressSection").style.display = "none";
document.getElementById("dropZone").style.display = "block";
document.getElementById("errorSection").style.display = "block";
document.getElementById("errorMsg").textContent = msg;
}
function resetForm() {
document.getElementById("errorSection").style.display = "none";
document.getElementById("doneSection").style.display = "none";
document.getElementById("dropZone").style.display = "block";
document.getElementById("progressFill").style.width = "0%";
}
```
---
## Зависимости
Ничего нового — всё уже есть в FastAPI. Только убедись что в `requirements.txt` есть:
```
fastapi
uvicorn
python-multipart # нужен для UploadFile
```
`python-multipart` нужен FastAPI для обработки `multipart/form-data` (загрузка файлов). Без него `UploadFile` не работает.
---
## Важные решения и ограничения
### Хранилище состояний задач
В коде выше `jobs` — это обычный Python dict в памяти. Это работает для **одного воркера**. Если у тебя несколько воркеров uvicorn (`--workers N`), состояние будет разделено между процессами и polling сломается.
**Если используешь несколько воркеров:** замени `jobs` dict на Redis:
```python
import redis, json
r = redis.Redis()
# запись: r.setex(f"job:{job_id}", 700, json.dumps(state))
# чтение: json.loads(r.get(f"job:{job_id}"))
```
### Очистка файлов
Временные файлы удаляются через `asyncio.sleep(600)` после завершения задачи. Если сервер перезапустится в процессе — файлы останутся. Добавь startup-хук для очистки старых папок:
```python
@app.on_event("startup")
async def cleanup_old_jobs():
shutil.rmtree(WORK_DIR, ignore_errors=True)
WORK_DIR.mkdir(parents=True)
```
### Размер архива и таймауты
Conversations.json может весить 300+ MB. Обработка 950 диалогов занимает ~70 секунд. Убедись что у nginx/proxy нет таймаута на загрузку файла. Рекомендуемые настройки nginx:
```nginx
client_max_body_size 600M;
proxy_read_timeout 600s;
proxy_send_timeout 600s;
```
### Параллельные задачи
`run_in_executor` использует `ThreadPoolExecutor` по умолчанию (количество потоков = CPU * 5). При высокой нагрузке создай явный executor с ограничением:
```python
from concurrent.futures import ThreadPoolExecutor
executor = ThreadPoolExecutor(max_workers=3)
await loop.run_in_executor(executor, _build_archive, ...)
```
---
## Порядок реализации для Claude Code
1. Скопировать `declaude.py` в корень проекта (или настроить `sys.path` в `claude_converter.py`)
2. Создать `routers/claude_archive.py` по шаблону выше
3. Создать `services/claude_converter.py`, импортировать `run_conversion` в роутер
4. Создать `templates/claude_archive.html` и `static/claude_archive.js`
5. Добавить `app.include_router(...)` в `main.py`
6. Добавить `python-multipart` в зависимости
7. Проверить что nginx разрешает загрузку файлов до 500 MB