SMB — Sutady Moneybook

SMB (Sutady Moneybook) 2.4.1 — это полнофункциональная система личного учёта финансов на основе SQLite и MCP (Model Context Protocol). Она изначально поддерживает локальную автономную работу и офлайн-сохранение, а также позволяет безопасный доступ через сеть с помощью Cloudflare Tunnel; единственным источником данных для книги учёта является локальная SQLite, без зависимости от внешних облачных баз данных — данные полностью под вашим контролем.

Реализовано

• Быстрый учёт доходов/расходов: записывается только дата операции, сумма хранится в целых «фэнях».

• Полностью настраиваемые категории: отключение, перенос или окончательное удаление категорий, месячные/годовые счета, поиск и фильтрация, глобальная корзина на 30 дней, экспорт в CSV/JSON.

• Недельные, месячные и годовые тенденции, детализация по категориям, структура категорий и сравнение с аналогичным периодом прошлого цикла.

• Обзор расходов DeepSeek, аномальный рост, советы по экономии, структура категорий и пользовательские вопросы; программа отвечает за цифры, модель — только за интерпретацию, в настоящее время примечания к записям не отправляются внешним моделям.

• Стандартный Streamable HTTP MCP; на веб-странице можно переключаться между «режимом подтверждения» и «режимом прямого управления». Прямой режим позволяет управлять записями, категориями, займами, подписками, ИИ, резервными копиями и часовым поясом, сохраняя 30-дневную историю отменяемых операций.

• SQLite WAL＋synchronous=FULL, снимки перед миграцией, ежедневные резервные копии с проверкой целостности/внешних ключей, шифрование открытым ключом age и загрузка в Google Drive.

• Двухуровневая защита Cloudflare Access, установка PWA, автозапуск при входе в Windows и вспомогательные скрипты перезапуска при сбоях.

• Четыре темы, четыре встроенных фона страницы и личные фоновые изображения, хранящиеся только на текущем устройстве. Личные изображения сжимаются в браузере и очищаются от метаданных; можно временно переключиться на встроенный фон, не удаляя их.

• Домашняя страница аналитики с приоритетом запросов: период и тип доходов/расходов сохраняются в URL, после обновления или возврата из счетов по категориям сохраняется прежняя позиция просмотра.

• На мобильных устройствах — компактная сводка, переключение детализация/структура, нижняя навигация и выдвижная панель фильтрации счетов; во время поиска сохраняется старый список, чтобы избежать мерцания контента.

• Даты на всём сайте определяются часовым поясом книги учёта из настроек; даже если часовые пояса компьютера и Android различаются, «сегодня», месяц по умолчанию и период анализа ИИ остаются согласованными.

• Отдельный модуль «Дела» управляет займами, которые мне должны, частичными погашениями и подписками в CNY/USD. Дела по умолчанию не попадают в статистику расходов; только обычные записи, связанные вручную или созданные одновременно, влияют на графики.

• Займы поддерживают отключение заёмщика, частичное погашение, автоматическое закрытие и 30-дневную корзину; подписки поддерживают скидку на первый период, месячные/годовые/пользовательские циклы, подтверждение истечения, историю платежей и напоминания в приложении.

• Ежемесячно можно задавать общий бюджет в юанях и бюджеты по категориям; бюджет не переносится и не блокирует запись, страница аналитики показывает использованное, остаток, прогноз и риски по категориям.

• «Проверка книги учёта» с помощью детерминированных правил выявляет подозрительные дубликаты, крупные расходы, бюджетные риски, ожидающие подтверждения продления и аномалии связей; проверка не изменяет записи автоматически, ИИ лишь объясняет факты, обнаруженные программой.

• В меню приложения после установки на Android/Windows есть быстрый доступ «Записать операцию»; OpenClaw поддерживает атомарную запись до 20 записей за раз и пакетную отмену.

• Для записи займов используется единый выбиратель заёмщика с поиском; новый заёмщик сохраняется в той же транзакции, что и заём. Активные записи с тем же именем переиспользуются, отключённые необходимо сначала восстановить.

• Повторные попытки предложений OpenClaw не создают дублирующих элементов, ожидающих подтверждения; в центре операций можно просматривать изменения полей и статусы сбоев. Проверка книги учёта также доступна через MCP в режиме только для чтения и не возвращает примечания.

• Опциональный модуль «Средства» ведёт учёт счетов в юанях, движения остатков, переводов между счетами, комиссий, калибровки остатков и полных возвратов; общая сумма средств не включает ожидаемые займы, инвестиции или будущие доходы.

• Исторические записи до включения отслеживания средств не ретроспективно изменяются; после включения обычные доходы/расходы привязываются к счетам, остаток вычисляется из начального остатка и последующих движений средств, без ведения второго источника истины по остаткам.

• OpenClaw может точно запрашивать и управлять счетами, переводами, калибровкой и возвратами; все прямые записи продолжают использовать идемпотентный requestId, неоднозначные названия счетов отклоняются.

Практические операции с «Делами», правила взаимодействия до и после включения средств и права OpenClaw см. в Руководстве по займам и подпискам. Включение счетов, влияние на средства, возвраты и подсказки проверки см. в Руководстве по отслеживанию и обслуживанию средств.

Related MCP server: ExpenseTracker MCP Server

Аналитика и счета

• «Детализация по категориям» в аналитике используется для сравнения рейтинга категорий, сумм и изменений относительно предыдущего периода; «Структура категорий» — для просмотра кольцевой диаграммы, сумм и долей; они не отображаются одновременно.

• Структура категорий полностью показывает все категории с суммами за текущий период, без объединения в «Прочее»; каждый сектор и элемент легенды позволяют перейти к соответствующим счетам.

• На странице счетов четыре равнозначных входа: «Последние записи», «Месячные счета», «Годовые счета», «Корзина». Корзина упорядочена по времени удаления за все даты и не наследует последний просмотренный месяц.

• Старые URL остаются совместимыми: /bills открывает последние записи; /bills?view=ledger&period=month&anchor=... открывает месячные счета; замена period на year открывает годовые счета; /bills?view=trash открывает глобальную корзину.

• Обычное удаление сохраняет записи на 30 дней и позволяет восстановление. Записи в корзине можно удалить навсегда; управление категориями в настройках также позволяет окончательно удалить категорию и все её записи после показа области влияния и подтверждения названия. Окончательное удаление необратимо, но связанные дела о займах или подписках сохраняются и автоматически отвязываются от книги учёта.

Обновление страницы и личный фон

• Пока страница открыта, данные книги учёта текущей страницы синхронизируются каждые 30 секунд; при повторном фокусировании окна или восстановлении сети синхронизация также выполняется немедленно.

• PWA проверяет новую версию каждую минуту и при обнаружении обновляется автоматически, если нет редактируемых форм. Также можно нажать «Проверить и обновить» в «Настройки → Состояние работы».

• При истечении срока входа Cloudflare используйте «Повторный вход» на странице, не удаляйте Cookie сайта и не очищайте данные сайта. «Повторный вход» и «Проверить и обновить» заменяют только кэш программы PWA, сохраняя Cookie входа, настройки внешнего вида и личный фон в IndexedDB; только полная очистка данных сайта удалит личные изображения на текущем устройстве.

• Выбор «Чистый, Бумага, Текстура, Туман» временно отключает личные изображения, но они остаются на текущем устройстве и могут быть восстановлены в любой момент нажатием «Использовать изображение».

• При первом холодном запуске каждого сеанса браузера кратко показывается заставка бренда SMB; обновление данных и переключение страниц не воспроизводят её повторно, а при включённой системной опции «Уменьшить анимацию» она пропускается.

Быстрый старт и локальный запуск

Требуется Node.js 22 или новее.

Способ 1: запуск в один клик на Windows (рекомендуется)

Просто дважды щёлкните 打开 SMB.cmd в корне проекта.

• При первом запуске автоматически проверяются зависимости, из шаблона создаётся конфигурация .env по умолчанию и выполняется сборка;

• Затем автоматически запускается сервис и в браузере по умолчанию открывается главная страница учёта (по умолчанию http://127.0.0.1:8788, автономный режим без входа).

Способ 2: ручной запуск из командной строки (кроссплатформенно: Windows / Linux / macOS)

Откройте терминал в корне проекта:

# 1. 安装项目依赖
npm install

# 2. 初始化本地配置（默认开启免登录单机模式）
cp .env.example .env

# 3. 运行开发模式（推荐本地体验，支持代码热重载）
npm run dev
# 浏览器访问 http://127.0.0.1:5173

# 或者编译并启动正式生产服务：
npm run build
npm start
# 浏览器访问 http://127.0.0.1:8788

Проверка качества

npm test
npm run typecheck
npm run build

Перед официальным обновлением можно дополнительно создать снимок с проверкой целостности:

npm.cmd run backup:snapshot -- manual-update
npm.cmd run backup:verify-restore

Расширенные возможности и руководство по развёртыванию

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

Если вам нужны следующие расширенные возможности, настройте их по соответствующим руководствам:

• Удалённый учёт с телефона через сеть: проброс без публичного IP и аутентификация Access через Cloudflare Tunnel, подробнее в Руководстве по развёртыванию.

• Интеллектуальный анализ расходов с ИИ: дважды щёлкните 配置DeepSeek密钥.cmd в корне или укажите DeepSeek API Key в .env, чтобы включить аналитику расходов и советы по экономии.

• Зашифрованное автоматическое облачное резервное копирование: настройте Google Drive и ключи шифрования age для ежедневной автоматической загрузки снимков, подробнее в Руководстве по восстановлению.

• Управление средствами и счетами: движение активов по нескольким счетам, переводы и калибровка остатков, подробнее в Руководстве по отслеживанию средств.

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

Структура каталога

• src/: React PWA, общая для телефона и компьютера.

• server/: Node API, MCP, DeepSeek, средства, финансовые дела и службы резервного копирования.

• db/: структура таблиц SQLite и миграции.

• tests/: тесты сумм, дат, дел, интерфейса, ИИ и MCP.

• scripts/: скрипты инициализации, автозапуска, резервного копирования ключей и восстановления.

• deploy/: шаблоны конфигурации без секретов для Cloudflare и OpenClaw.

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

Номер версии поддерживается только в package.json. Исправления и визуальные доработки увеличивают патч-версию, обратно совместимые новые возможности — минорную версию, изменения идентичности продукта или несовместимых контрактов — мажорную версию; журнал релизов см. в CHANGELOG.md. Спецификация логотипа и редактируемые исходники — в Руководстве по бренду.

Отложенные функции — импорт счетов, синхронизация остатков с третьими сторонами и более сложные возможности счетов — см. в ROADMAP.md.