All API HubAll API Hub
ホーム
はじめに
よくある質問
更新ログ
  • 简体中文
  • English
  • 日本語
ホーム
はじめに
よくある質問
更新ログ
  • 简体中文
  • English
  • 日本語
  • 🚀 導入ガイド

    • はじめに
    • 権限管理(オプション権限)
    • Safari 拡張機能のインストールガイド
    • QQ / 360 等ブラウザへのインストールガイド
  • 🔑 アカウントと認証情報

    • API 認証情報
    • ブックマーク管理
    • ソート優先順位設定
  • 📊 統計とダッシュボード

    • 残高履歴
    • 利用状況分析
    • 自動更新とリアルタイムデータ
  • 🤖 自動化アシスタント

    • 自動チェックインとチェックイン監視
    • 引き換えアシスタント(Redemption Assist)
    • Cloudflare シールド回避アシスタント
  • 🔌 エコシステムと連携

    • サポートされているサイトのリスト
    • サポートされているエクスポートツールリスト
    • サイト設定の高速エクスポート
    • CLIProxyAPI の統合とワンクリックインポート
  • 🛠️ 管理者向けツール

    • New API モデルリスト同期
    • New API チャネル管理
    • Octopus チャネル管理
    • モデルリダイレクト(Model Redirect)
  • 🛡️ データとサポート

    • データのエクスポートとインポート
    • WebDAV バックアップと自動同期
    • All API Hub プライバシーポリシー
    • 自動認識トラブルシューティングガイド
    • よくある質問
  • 更新ログ

残高履歴

アカウントの毎日の残高と収入/支出のスナップショットを記録し、グラフで長期的な変化傾向を観察します。残高照合、チャージと消費のペース確認、または「残高がなぜ急に増減するのか」の調査に適しています。

機能概要

  • 日次スナップショット記録: 各アカウントは1日あたり最大1件のスナップショットを記録します。
  • 残高と収入/支出の記録: 残高、今日の収入、今日の支出、記録時間、およびソースを保存できます。
  • 複数アカウントの集計: タグ、アカウント、および時間範囲で集計して表示できます。
  • グラフ分析: 概要、トレンド、アカウント分布、およびアカウント集計表を提供します。
  • 手動メンテナンス: 即時リフレッシュと古いデータの即時クリーンアップをサポートします。

記録されるデータ

各アカウントは1日あたり最大1件の集計スナップショットを保持します。一般的なフィールドは次のとおりです。

  • 残高 / クオータ: quota
  • 今日の収入: today_income
  • 今日の支出: today_quota_consumption
  • 記録時間: capturedAt
  • ソース: source

source は現在主に2つのタイプがあります。

  • リフレッシュ駆動: アカウントのリフレッシュが成功した後にその日のスナップショットを更新します。
  • 終日取得: その日の終わりに近づいたときにバックグラウンドで補完取得します。

有効化方法

  1. 設定 → 基本設定 → 残高履歴 を開きます。
  2. 残高履歴を有効にする をオンにします。
  3. 必要に応じて 保持日数 を設定します。
  4. 毎日の収入/支出をできるだけ補完したい場合は、終日取得 をオンにします。

有効化後、任意のアカウントをリフレッシュすると、最初のエントリが書き込まれ始めます。

2つの記録方法

1. リフレッシュ駆動

アカウントのリフレッシュが成功すると、その日のスナップショットが更新されます。

特徴:

  • 追加のタイマー処理を待つ必要がありません。
  • プラグインを開いた際の日常的なデータ蓄積に適しています。
  • 「今日の収入/支出を表示」関連のスイッチに従い、残高履歴のためにログを強制的に取得することはありません。

2. 終日取得

有効にすると、プラグインは毎日 23:55 に近づくと、その日のデータを1回取得しようと試みます。

特徴:

  • 収入/支出履歴をできるだけ補完したい人に適しています。
  • ブラウザの Alarms API のサポートに依存します。
  • ベストエフォートであり、毎日必ず成功するとは限りません。

使用前の注意点

収入/支出履歴を記録したい場合は、以下のいずれかの条件を満たすことをお勧めします。

  • 「今日の収入/支出を表示」をオンにして、リフレッシュ時に今日の収入/支出も取得できるようにする。
  • 「終日取得」をオンにして、プラグインが毎日終了前に1回取得するようにする。

これら両方が有効になっていない場合、残高履歴では通常、残高のスナップショットのみが安定して表示され、収入/支出のグラフは空になる可能性があります。

ページの閲覧方法

設定 → 残高履歴 に入ると、よく使われる領域は次のとおりです。

フィルタリングエリア

以下のディメンションでフィルタリングできます。

  • タグ
  • アカウント
  • 時間範囲
  • クイック期間 (過去7日間、30日間、90日間、180日間、1年間)
  • 通貨単位 (グローバル通貨設定に準拠)

概要

現在のフィルタリング期間内の主要な集計指標を表示します。例:

  • 終了残高
  • 期間内純変動
  • 期間内収入
  • 期間内支出
  • 対象アカウント数

トレンドグラフ

以下を切り替えて表示できます。

  • 残高
  • 収入
  • 支出
  • 純変動

ビューの範囲も切り替えられます。

  • アカウント別: 各アカウントの曲線を表示します。
  • 集計: 選択したアカウントを日ごとに集計して合計します。

グラフは以下をサポートします。

  • 折れ線グラフ / 棒グラフの切り替え
  • 複数アカウントの比較
  • 対象範囲不足のヒント

アカウント分布

特定の日または特定の指標がアカウント間でどのように分布しているかを表示します。

サポート:

  • 円グラフ / ヒストグラムの切り替え
  • 参考日の選択
  • 残高 / 収入 / 支出 / 純変動の切り替え

現在の指標に負の値が存在する場合、円グラフは自動的に適用されなくなります。これは通常の制限です。

アカウント集計表

表には、現在の期間における各アカウントの以下の情報が集計されます。

  • 開始残高
  • 終了残高
  • 期間内収入
  • 期間内支出
  • 期間内純変動
  • スナップショットカバレッジ率
  • 収入/支出カバレッジ率

手動での残高照合や異常なアカウントの迅速な特定に非常に適しています。

よくある操作

即時リフレッシュ

即時リフレッシュ をクリックすると、現在選択されているアカウントの最新スナップショットが積極的に取得されます。以下の場合に適しています。

  • 残高履歴を有効にした直後に最初のデータを補完する場合。
  • 今日のデータをすぐに更新したい場合。
  • チャージ/消費の前後の変化を比較する場合。

即時クリーンアップ

即時クリーンアップ をクリックすると、保持日数に基づいて古い記録が削除されます。保持日数を短縮した後に手動でデータを整理したい場合に便利です。

重要事項

  • ベストエフォート: ブラウザのスリープ、ネットワーク異常、サイト制限などにより、特定の日付のスナップショットが存在しない場合があります。
  • 履歴のバックフィルなし: 過去の日付を補完するために、履歴ログ全体を遡って検索することはありません。これにより、大量のリクエストが発生するのを防ぎます。
  • ローカル保存のみ: 現在のバージョンでは、残高履歴データはローカルに保存され、通常のデータのエクスポート/インポートやWebDAVと一緒に移行されることはありません。
  • 無効化されたアカウントはスキップされます: 関連するリフレッシュとタイマー処理は、無効化されたアカウントを自動的にスキップします。

使用上の推奨事項

  • 長期的なトレンドを見たい場合は、保持日数を長めに設定してください。
  • 収入/支出をより完全なものにしたい場合は、終日取得を有効にしてください。
  • 残高照合を行う際は、まず特定のタグまたはアカウントでフィルタリングしてから集計表を確認すると、効率が向上します。
  • リクエスト量、モデル分布、遅延に、残高の変動よりも関心がある場合は、利用状況分析 を参照してください。

関連ドキュメント

  • 利用状況分析
  • 自動リフレッシュとリアルタイムデータ
  • よくある質問
最終更新: 2026/05/03 10:39
Contributors: github-actions[bot], qixing-jk
Next
利用状況分析