Напоминание для Windows

Неофициальный десктопный клиент и локальный MCP-сервер в стиле Samsung One UI для чтения и записи данных Samsung Reminder без синхронизации Microsoft Reminders.

[!ВАЖНО] Этот экспериментальный проект не связан с Samsung, не одобрен и не поддерживается Samsung. Он зависит от частного поведения Samsung Browser и Samsung Cloud, которое может измениться без предупреждения.

Скриншоты

Все изображения показывают встроенный предварительный просмотр браузера с прилагаемыми образцами данных.

Related MCP server: Reminders MCP Server

Требования

Для готовой сборки:

• 64-разрядная Windows 10 версии 1809 или новее, или Windows 11, на x64 или ARM64. Сборки CI и тесты выполняются на обеих архитектурах нативно.

• Samsung Browser для Windows, установленный с помощью официального 64-разрядного установщика Samsung.

• Учётная запись Samsung, выполнившая вход через Samsung Browser. Откройте браузер хотя бы один раз, чтобы он создал профиль по умолчанию.

• Сетевой доступ к Samsung Cloud. Установщик также может загрузить Microsoft Edge WebView2, если он недоступен.

В настоящее время проект ожидает стандартную общесистемную установку Samsung и пути к профилям по умолчанию:

• C:\Program Files\Samsung\Internet\Application\samsunginternet.exe

• %LOCALAPPDATA%\Samsung\Internet\User Data\Default

Пользовательские пути установки и профилей в настоящее время не определяются. Samsung Browser должен быть полностью закрыт перед первой синхронизацией. В противном случае Chromium направляет запуск помощника в существующий процесс, не включая частный мост localhost. После того как приложение кэширует действительные учётные данные, обычные операции с напоминаниями больше не держат браузер открытым.

Samsung в настоящее время предлагает отдельные официальные x64 и ARM64 постоянно обновляемые установщики. Этот проект публикует соответствующие сборки приложения для x64 и ARM64.

Установка

Загрузите текущий установщик NSIS, MSI или портативный ZIP из GitHub Releases.

Scoop

Этот репозиторий также является bucket'ом Scoop:

scoop bucket add samsung-reminder https://github.com/eliasblume/samsung-reminder-desktop
scoop install samsung-reminder/samsung-reminder

Локальный MCP-сервер — это отдельный пакет, поэтому установки только для рабочего стола не добавляют двоичный файл командной строки в PATH:

scoop install samsung-reminder/samsung-reminder-mcp

При обновлении с v0.1.1 или более старой версии сначала обновите samsung-reminder, прежде чем устанавливать пакет MCP, чтобы Scoop сначала удалил ранее включённый shim MCP.

Конвейер выпуска обновляет оба пакета Scoop из их отдельных сборок x64 и ARM64. Будущие выпуски затем можно установить с помощью:

scoop update samsung-reminder
scoop update samsung-reminder-mcp

Запуск из исходного кода

Сборка из исходного кода требует Node.js 22.12 или новее, pnpm 11.17, Rust 1.97.1, предварительные требования Tauri для Windows и Visual Studio Build Tools с рабочей нагрузкой "Разработка классических приложений на C++".

pnpm install --frozen-lockfile
pnpm tauri:dev

Тёмный режим включён по умолчанию при первом запуске. Переключатель внешнего вида сохраняется локально.

Редактор поддерживает списки Samsung, заметки и контрольные списки, важность, завершение, силу оповещения, ранние оповещения, расписания на весь день и по времени, триггеры по местоположению, а также повторение с шагом минута/час/день/неделя/месяц/год. Цвета списков и все 42 индекса значков категорий синхронизируются через Samsung Cloud. Ежемесячные правила используют день месяца, а ежегодные — месяц и день, что соответствует мобильной модели данных.

Сборка

pnpm typecheck
pnpm tauri:build
pnpm build:mcp

Tauri создаёт установщики NSIS и MSI в каталоге src-tauri/target/release/bundle. См. RELEASING.md для автоматизированного процесса выпуска SemVer.

MCP-сервер

Установка пакета Scoop samsung-reminder-mcp добавляет samsung-reminder-mcp в PATH. Таким образом, локальная конфигурация MCP может использовать:

[mcp_servers.samsung-reminders]
command = "samsung-reminder-mcp"
env = { CDP_ENDPOINT = "http://127.0.0.1:9226" }

Для сборки из исходного кода укажите command как src-tauri/target/release/samsung-reminder-mcp.exe.

Сервер stdio предоставляет:

• samsung_reminders_status

• samsung_reminders_list

• samsung_reminder_categories_list

• samsung_reminder_category_create

• samsung_reminder_category_update

• samsung_reminder_category_delete

• samsung_reminders_get

• samsung_reminders_create

• samsung_reminders_update

• samsung_reminders_delete

Для удаления напоминания или категории требуется, чтобы confirmId точно совпадал с целевым ID. При удалении категории её напоминания сначала перемещаются в "Мои напоминания". Статус MCP намеренно опускает адрес электронной почты учётной записи Samsung и подсказку ID учётной записи, которые может отображать локальный интерфейс рабочего стола.

Архитектура

• React, TanStack DB и TanStack Query для живых коллекций, оптимистичных мутаций и кэширования облачных операций

• Tailwind CSS, примитивы Radix и иконки Lucide для интерфейса в стиле One UI

• Tauri 2 и Rust для оболочки рабочего стола, управления жизненным циклом браузера и прямого клиента Samsung Cloud

• Небольшая загрузка JavaScript, выполняемая только внутри подписанного расширения Calendar от Samsung

• Windows Credential Manager плюс кэш учётных данных Rust в памяти

• Родственный двоичный файл MCP stdio на Rust, использующий ту же реализацию моста

Конфиденциальность и безопасность

Учётные данные Samsung Cloud остаются в Rust и шифруются для текущего пользователя Windows с помощью Windows Credential Manager. Они никогда не возвращаются через React или MCP и не записываются в журналы или файлы в открытом виде. Конечная точка CDP ограничена явным источником http://127.0.0.1:<port>.

Используйте Настройки → Отключить учётную запись Samsung, чтобы удалить кэшированные учётные данные и вернуться к первоначальному раскрытию. Настройки → Стереть все данные приложения дополнительно очищает сохранённый выбор согласия и все локальные настройки для полного сброса к заводским настройкам. Ни одно из этих действий не удаляет напоминания, хранящиеся в Samsung Cloud.

Репозиторий не содержит APK-файлов Samsung, декомпилированного исходного кода Samsung, данных учётных записей Samsung, захваченных полезных нагрузок API, пользовательских скриншотов, токенов доступа или графических материалов Samsung. Идентификатор расширения, идентификатор облачного приложения, конечная точка и имена таблиц в исходном коде являются константами протокола, а не учётными данными пользователя.

Перед первым облачным запросом приложение отображает явное раскрытие и требует локального согласия. См. LEGAL.md, PROVENANCE.md и THIRD_PARTY_NOTICES.md для получения информации об оговорке частного интерфейса, происхождении реализации и уведомлениях о зависимостях.

См. SECURITY.md перед сообщением об уязвимости. Никогда не прикрепляйте токены, содержимое напоминаний, данные профиля браузера или неотредактированные дампы сбоев к публичной проблеме.

Область применения и оговорки

Обновление Samsung Browser, подписанного расширения или Cloud API может нарушить работу этого проекта. Текущая концепция охватывает просмотр списка, чтение, создание, редактирование, завершение, добавление в избранное, пользовательские списки, контрольные списки, повторение, будильники по месту/времени, ранние оповещения, напоминания на весь день, силу оповещения, общий доступ и защищённое удаление.

Загрузка вложений, запись голоса, поиск на карте/геокодирование и шаблоны предлагаемых напоминаний Samsung не реализованы. Установщики Windows изначально не подписаны, поэтому Windows может отображать предупреждение об издателе. Контрольные суммы проверяют загруженные байты, но не устанавливают личность издателя.

Лицензия

MIT © 2026 eliasblume