自動起動仕様 (Autostart Specification)

1. 概要

OS にユーザーがログインしたタイミングで TelosDB を自動的に起動し、システムトレイで待機させる。ユーザーが手動で起動しなくても MCP サーバーや検索機能を利用可能にする。

flowchart LR
  subgraph ユーザー操作なし
    A[OS ログイン] --> B[TelosDB 自動起動]
    B --> C[トレイで待機]
    C --> D[MCP / 検索 利用可能]
  end

2. スコープ

3. 技術構成

3.1 プラグイン

tauri-plugin-autostart を使用する。

Rust 側と JS 側のバージョンは揃えること。

3.2 プラットフォーム別の登録先

プラグインが各 OS のネイティブ機構を使って自動起動を登録する。

flowchart TB
  subgraph プラットフォーム別の実体
    W[Windows: レジストリ Run]
    M[macOS: LaunchAgents]
    L[Linux: autostart .desktop]
  end
  P[tauri-plugin-autostart] --> W
  P --> M
  P --> L
  U[ユーザー: enable/disable] --> P

3.3 Rust 側プラグイン登録

tauri::Builder に以下を登録する:

.plugin(tauri_plugin_autostart::init(MacosLauncher::LaunchAgent, None))

3.4 Tauri capability

capabilities/default.json に以下の権限を追加する:

• autostart:allow-enable
• autostart:allow-disable
• autostart:allow-is-enabled

3.5 起動引数

プラグインの Builder で .args([...]) を指定可能。自動起動時に --minimized を渡すことで、トレイのみ起動を実現する。

4. API

フロントエンドから利用する API は以下の 3 つ。

5. 設定との連携

5.1 起動時の同期

アプリ起動時に保存済み設定と OS の実状態を同期する。

stateDiagram-v2
  [*] --> 設定ファイル読み込み
  設定ファイル読み込み --> スキップ: 読み込み失敗 (null)
  設定ファイル読み込み --> isEnabledチェック: 読み込み成功
  isEnabledチェック --> 同期: 設定値と isEnabled() が不一致
  isEnabledチェック --> 待機: 一致
  同期 --> enableまたはdisable
  enableまたはdisable --> 待機
  待機 --> ユーザーがトグル変更
  ユーザーがトグル変更 --> 保存してenable/disable
  保存してenable/disable --> 待機

5.2 アップデート時のパス変更

再インストールで実行ファイルのパスが変わると、既存の Run キー等は無効になる。次回起動時の同期処理で設定がオンの場合は enable() を呼び直し、新しいパスで再登録する。

5.3 エラーハンドリング

• enable() / disable() が失敗した場合: console.error に出力し、UI にエラーメッセージを表示する。
• autostart 登録失敗時の保存メッセージ: 「保存しました（自動起動の登録に失敗しました。次回起動時に再試行します）」を 5 秒間表示する。

6. UI 仕様

6.1 設定パネルの表示

設定パネルに「ログイン時自動起動」fieldset を表示する。

6.2 HTML 構造

<fieldset class="settings-fieldset">
  <legend>ログイン時自動起動</legend>
  <div class="setting-row">
    <label for="setting-run-on-login">有効にする</label>
    <input type="checkbox" id="setting-run-on-login"
           aria-describedby="setting-run-on-login-desc">
    <span id="setting-run-on-login-desc" class="setting-hint">
      OS にサインインしたときに TelosDB を自動で起動します
    </span>
  </div>
</fieldset>

6.3 操作フロー

設定の反映は保存ボタンのクリック時に行う。チェックボックスの操作だけでは enable() / disable() は呼ばれない。

flowchart LR
  subgraph 設定パネル
    A[設定ボタン] --> B[パネル開く]
    B --> C["loadSettingsFromFile()"]
    C --> D[フォームに反映]
    D --> E[ユーザーがチェックボックスを操作]
    E --> F[保存ボタンをクリック]
  end
  F --> G{"run_on_login?"}
  G -->|true| H["autostart.enable()"]
  G -->|false| I["autostart.disable()"]
  H --> J[settings.json に保存]
  I --> J
  J --> K[UI フィードバック表示]

6.4 表示値の更新タイミング

7. 注意事項

8. テスト

9. 実装ファイル一覧

10. 外部リファレンス

• tauri-plugin-autostart — 公式プラグイン
• Tauri v2 Autostart プラグイン

11. 関連計画

• cross_platform.md — macOS / Linux での動作検証、アンインストール時のエントリ残留確認

12. 修正履歴

v0.3.3

初期実装のバグにより「自動起動がレジストリに登録されない（またはすぐ消える）」問題が発生し、以下を修正。