Memories

Memories / ドキュメント

このページの内容

デスクトップトレイと WebUI

Windows のトレイと macOS のメニューバーアプリは、ローカル Memories デーモンの状態をすばやく確認できます。外部フォント、スクリプト、分析機能を使わない、組み込みの状態ダッシュボードと制限された通常カードエディターを共有します。ダッシュボードは英語、中国語、日本語、ドイツ語、フランス語に対応し、狭いウィンドウにも適応します。

状態の投影は読み取り専用のままです。ロック解除中、カードエディターは保管庫 ID を受け付け、タイプ選択、型付きフィールド、名前変更/削除、ドラッグによる並べ替え、再利用可能なテンプレート作成を提供します。認証済みでオリジンをチェックする POST /api/cards は、意図的に限定されたカード/タイプ許可リストの操作だけを同梱の CLI に転送します。ロック解除、権限昇格、プログラム実行、機密値の開示はできません。機密操作にはネイティブモバイル/CLI の検証が必要で、ブラウザーでの生体認証/PIN 登録はありません。カードタイプを参照してください。

起動

  • Windows: リリース ZIP を展開し、memories-tray.exe をダブルクリックします。memories.exe と同じ場所に置いてください。ランチャーはコンソールウィンドウを開きません。
  • macOS: macOS パッケージの Memories.app を開きます。Dock ウィンドウはなく、メニューバーに表示されます。アプリケーションバンドルには対応する CLI が含まれます。
  • 端末から: memories tray はネイティブトレイとダッシュボードを開きます。memories webui はブラウザーダッシュボードだけを開き、フォアグラウンドに留まります。Linux は webui を使用できます。ネイティブトレイは Windows と macOS のみに対応します。
memories --home /path/to/development-home tray
memories --home /path/to/development-home webui --no-open --port 0
memories-tray --home /path/to/development-home --no-open

--home / MEMORIES_HOME は CLI と同じストアを使用します。上書き指定がない場合、ランチャーは選択した設定の storage_dir、または通常のユーザー別 Memories ホームを使用します。--config PATH / MEMORIES_CONFIG は TOML ファイルを選択します。設定を参照してください。--port 0（既定）は空いているループバックポートを選択します。指定するポートも空いている必要があります。フォアグラウンドの webui コマンドは、フラグメントトークンを含むローカルケイパビリティ URL を出力します。--no-open はブラウザーの自動起動を抑制します。トレイの 状態ダッシュボードを開く メニュー項目で後から開くことができ、設定に desktop.open_browser = false がある場合も同様です。--open は意図的にその設定を上書きします。--lang はトレイの言語を選択します。ブラウザーは最初に自身のロケールに従い、言語選択機能も備えています。

状態とサービスのライフサイクル

トレイメニューは、オフライン、設定が必要、ロック済み、ロック解除済みを表示します。デーモンを起動 は、利用できない場合に同梱 CLI のデーモンを起動します。ストレージの初期化、ロック解除、権限昇格の要求は行いません。通常どおり端末で memories init、memories unlock、memories sudo を使用してください。

ページは 2 秒ごとに更新されます。ロック解除中は、ライブラリ数、アクティブなプロキシ数とリモートセッション数、設定されたクラウドプロバイダーの種類、保留中のアップロード数とダウンロード数、適用/拒否された転送、同期待ちのライブラリを表示します。状態の投影には、メモリ本文、ライブラリ名、認証情報、アカウント ID、ファイルパス、トークンは表示されません。デーモンがロックされたり利用不能になったりすると、ライブラリ/同期の詳細は消去されます。状態のポーリングは保管庫をロック解除したままにしません。

最近の変更は、現在のブラウザーページを開いている間に行われた観測であり、永続的なセキュリティ監査ログではありません。オフライン状態は、デーモンが停止している、プローブ期限を超えて処理中である、または互換性がないことを意味する場合があります。CLI とデーモンを一緒にアップグレードし、アップグレード後にデーモンを再起動してください。

トレイを終了 はアイコンを削除し、そのダッシュボードリスナーを停止します。メニューから起動したデーモンも含め、デーモンは実行を続けます。フォアグラウンド WebUI では Ctrl+C がリスナーを閉じます。ログイン時の自動起動登録はインストールされません。別々の起動には別々のポートとトークンを使います。再起動後にダッシュボードを再度開くには、古いブックマーク URL ではなくトレイメニューを使用してください。

ブラウザーアクセスの境界

ダッシュボードは 127.0.0.1 のみにバインドされ、同じコンピューターでの使用を想定しています。起動ごとに新しいランダムなアクセストークンを使用します。ブラウザーはアドレスバーからトークンを除去し、タブセッション内だけに保存します。状態リクエストにはそのトークンが必要で、Host/Origin チェックを通過する必要があります。通常カードエディターも同じチェックと閉じた操作許可リストを使用します。HTTP のロック解除、権限昇格、認証情報配信、コマンド実行、汎用 IPC エンドポイントはありません。起動 JSON は、カードへの書き込みと読み取り専用の状態投影を区別するために read_only: false、status_read_only: true、card_editor: true を報告します。セキュリティを参照してください。

ビルドとパッケージ化

cargo build --workspace --release --locked は CLI、relay、FFI とともに memories-tray をビルドします。Windows パッケージは、変更がなくコミット済みのチェックアウトから作成します。

pwsh -File scripts/package-windows.ps1

Rust、Xcode Command Line Tools、Python 3 を備えた macOS ホストでは次を実行します。

bash scripts/package-macos.sh

macOS スクリプトはホストアーキテクチャ（Apple Silicon または Intel）をビルドし、Memories.app、CLI/relay/FFI ファイル、追跡対象のすべての docs/、フォントライセンス、ファイル別ビルドマニフェスト、アーカイブチェックサムをパッケージ化します。配布用にアプリを署名または公証しません。Windows ビルドは macOS の実行時動作を検証しません。各リリースで実際に何を試したかは検証を参照してください。

Linux GNU ホストでは、bash scripts/build-linux.sh がリリースワークスペースをビルドし、bash scripts/package-linux.sh が変更のないコミット済みチェックアウトから CLI/relay/FFI の .tar.gz を作成します。Linux の前提条件を参照してください。ダッシュボードには memories webui を使用します。Linux パッケージは未対応のネイティブトレイランチャーを含みません。