メインコンテンツまでスキップ

トラブルシューティング

Chimrで問題が発生した場合、このガイドが一般的な問題の解決に役立ちます。

前提条件​

具体的な問題のトラブルシューティングを行う前に、以下の基本要件を確認してください：

  1. システム要件

    • macOS 14.0 (Sonoma) 以降
    • TestFlightアプリがインストール済み（ベータ版の場合）

  2. 必要な権限

    • カレンダーアクセス: システム設定 → プライバシーとセキュリティ → カレンダー → Chimr ✓
    • 通知: システム設定 → 通知 → Chimr → 通知を許可 ✓

  3. カレンダーアプリの設定

    • カレンダー.appを開く → 表示メニュー
    • 「終日イベントを表示」を有効化 ✓
    • 「参加を辞退したイベントを表示」を有効化 ✓

一般的な問題​

カレンダーの問題​

カレンダーが表示されない​

Chimrにカレンダーが表示されない場合：

  1. 前提条件を確認 - 上記の権限と設定を確認
  2. カレンダーアカウントを確認 - カレンダー.appでアカウントが設定されているか確認
  3. Chimrを再起動 - メニューバーアイコンを右クリック → 終了 → 再度起動

イベントが同期されない​

イベントが更新されない場合：

  1. カレンダーの同期を確認

    • カレンダー.appを開く
    • プルして更新またはCmd+R
    • まずそこにイベントが表示されることを確認

  2. アカウント設定

    • カレンダー.app → 設定 → アカウント
    • アカウントが正しく設定されていることを確認
    • 「このアカウントを有効にする」がオンになっていることを確認

  3. 再起動が必要

    • Chimrは現在、新しいカレンダーを追加した後に再起動が必要です
    • アプリを終了して再起動してください

通知の問題​

通知が表示されない​

通知を受け取れない場合：

  1. 前提条件を確認 - 通知権限が付与されているか確認（上記参照）
  2. Chimrの設定を確認
    • 設定 → 通知タブ
    • 通知タイミング（1〜60分）を確認
    • 通知用のカレンダーが選択されているか確認
  3. システム設定
    • 集中モード/おやすみモードを無効化
    • 通知スケジュール設定を確認

通知タイミングが間違っている​

通知が予期しない時間に表示される場合：

  1. タイムゾーンの問題

    • システムのタイムゾーンが正しいことを確認
    • カレンダー.appのイベントタイムゾーンを確認
    • イベントに適切なタイムゾーン情報があることを確認

  2. 終日イベント

    • 設定 → 通知
    • 「終日イベントを通知」設定を確認
    • 終日イベントの通知時刻を調整

MCP統合の問題​

MCPサーバーが起動しない​

MCP統合で問題がある場合：

  1. 設定を確認 - Claude Desktopの設定で正しいパスが設定されているか確認
  2. Python環境を確認 - uvがインストールされ、chimr.pyに実行権限があるか確認
  3. ログを確認 - Claude Desktopのログで具体的なエラーメッセージを確認

詳細なMCPセットアップ手順については、MCP統合ガイドを参照してください。

パフォーマンスの問題​

高いメモリ/CPU使用率​

Chimrがリソースを多く消費している場合：

  1. カレンダー数を減らす

    • 設定 → カレンダー
    • 不要なカレンダーを無効化
    • 通知カレンダーを制限

  2. 同期頻度を調整

    • 現在は手動（再起動が必要）
    • 将来のバージョンでは調整可能な同期

  3. キャッシュをクリア

    • Chimrを終了
    • アプリを再起動
    • これにより一時データがクリアされます

一般的なエラーメッセージ​

「カレンダーアクセスが拒否されました」​

これは、Chimrがカレンダーにアクセスする権限を持っていないことを意味します。上記の前提条件セクションを参照してカレンダーアクセスを許可してください。

「イベントの読み込みに失敗しました」​

これは通常、同期の問題を示しています：

  1. インターネット接続を確認
  2. カレンダーアカウントがオンラインであることを確認
  3. カレンダー.appを開いて更新
  4. Chimrを再起動

「通知権限が必要です」​

Chimrは通知を表示する権限が必要です。上記の前提条件セクションを参照して通知アクセスを許可してください。

デバッグモード​

高度なトラブルシューティングのために：

  1. 設定 → 詳細設定でデバッグモードを有効化
  2. Console.appでログを確認
  3. 問題を報告する際にログを共有

パフォーマンスに影響する可能性があるため、トラブルシューティング後はデバッグモードを無効にすることを忘れないでください。

さらなるヘルプ​

問題が続く場合：

  1. 詳細なログのためにデバッグモードを有効化（設定 → 詳細設定）
  2. 問題を引き起こす正確な手順を文書化
  3. エラーメッセージをメモ
  4. FAQで一般的な質問を確認
  5. サポートページに記載されているチャンネルからサポートに連絡

既知の問題と制限事項​

現在のベータ版の制限事項​

  • フルスクリーン通知でボタン以外の場所をクリックしても反応しない場合がある
  • 一部のビデオ会議URLパターンが認識されない
  • 大量のイベントがある場合のパフォーマンス問題
  • 通知音のカスタマイズはまだ利用できません（システム音を使用）