为什么值得关注

它将博客重新想象成一个自包含、可携带的文件，无需后端却仍具备加密、主题和更新前备份等丰富功能。

适合谁使用

注重隐私、希望完全掌控数据的用户
对单文件应用感兴趣的技术爱好者
需要离线、便携日记的写作者或日记使用者
寻求无需服务器的简单博客替代方案的用户

典型使用场景

在 U 盘上保存加密的私密日记
写笔记或日记而不依赖云服务
创建可在多台电脑间携带的个人博客
测试或学习 File System Access API 和客户端加密

项目优势

完全离线运行，无需服务器、数据库或账号
通过 Web Crypto API 支持 AES‑GCM‑256 加密
每次更新前强制创建并验证备份
提供多种皮肤、标签、可视化编辑器和自动保存

使用前须知

完全的直接保存功能仅支持采用 File System Access API 的 Chromium 浏览器（Chrome、Edge）
忘记密码将永久丢失数据，无法恢复
单个文件可能因包含大量图片和笔记而变得很大；除文件本身外没有内置内容导出功能

README 快速开始

Флог (от «файловый лог»)

Персональный блог, который живёт в одном HTML-файле

Флог выглядит как сайт и работает в браузере, но лежит не в интернете, а у вас на компьютере или флешке. Сервер, база данных и аккаунт не нужны: браузер с разрешения пользователя записывает заметки прямо в файл.

Внутри одного index.html находятся интерфейс, настройки, тексты и изображения. Файл можно перенести на другой компьютер и продолжить писать.

Возможности

визуальный редактор с заголовками, списками, цитатами, ссылками, кодом, изображениями и подписями;
автоматическое сохранение черновиков;
поиск, теги, цвета заметок и статистика текста;
пять скинов: «Нормкор», «Сердечки», «Манга», «Строгий» и «Консоль»;
цветные фоны, светлая и тёмная темы;
шифрование заметок, черновиков и изображений паролем;
обновление внутренней программы перетаскиванием нового файла;
обязательная проверенная резервная копия перед обновлением.

Как начать

Скачайте index.html.
Откройте его в браузере как обычный файл.
Нажмите + и создайте первую заметку.
При первой записи выберите этот же index.html в системном окне.

Прямая запись в файл работает в настольных Chrome, Edge и других Chromium-браузерах с поддержкой File System Access API. В остальных браузерах Флог предложит скачать обновлённую копию.

Шифрование

Флог использует браузерный Web Crypto API: содержимое шифруется алгоритмом AES-GCM-256, а ключ выводится из пароля через PBKDF2-HMAC-SHA-256. Пароль нигде не сохраняется и не отправляется в сеть.

Если забыть пароль, восстановить заметки невозможно. Перед включением шифрования стоит убедиться, что пароль сохранён в надёжном месте.

Обновление

Обычная замена файла здесь не подходит: файл Флога одновременно является и программой, и вашим дневником.

Чтобы обновиться:

скачайте новый index.html из этого репозитория;
откройте свой текущий Флог;
перетащите новый файл в окно браузера;
подтвердите обновление.

Флог сначала предложит сохранить резервную копию через системное окно и проверит записанный файл. Только после этого отдельным нажатием можно установить обновление. Заметки, изображения, черновики и настройки будут перенесены в новую версию. Используйте для обновления только файл, которому доверяете.

Разработка

Читаемые исходники и инструменты сборки находятся в скрытой папке .src. Готовое приложение

项目描述

Флог — персональный блог, умещающийся в файле

flog