> For the complete documentation index, see [llms.txt](https://docs.cherryai.com.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cherryai.com.cn/docs/zhong-wen-fan-ti/pre-basic/settings/usage.md).

# 用量統計

用量統計會將你喺 Cherry Studio 裏面嘅 **模型調用情況彙總成可視化面板**：花咗幾多錢、用咗幾多 Token、發咗幾多請求、邊個模型用得最多，一目了然。佢幫你估算成本、發現異常消耗，亦方便你對唔同模型嘅使用作取捨。

打開 `設定 → 用量統計`。頁面分 **概覽 / 探索 / 請求** 三個部分，右上角可切換 **最近 30 日 / 最近 90 日 / 最近一年**，所有數據按所選區間統計。

<figure><img src="/files/d36e8609e5a1c5a033998eb4cbc7fc68de1d2df5" alt=""><figcaption><p>用量統計【概覽】：頂部指標卡 + 下方每日活動熱力圖（圖中總成本已隱去）</p></figcaption></figure>

### 概覽

頂部一組指標卡：

| 指標                | 含義                                |
| ----------------- | --------------------------------- |
| **總成本**           | 區間內嘅估算花費（按各模型公開定價折算，僅供參考）         |
| **請求數**           | 發起嘅請求總次數                          |
| **總 Token 數**     | 輸入 + 輸出嘅 Token 總量                 |
| **快取命中率**         | 命中提示詞快取嘅比例（命中嘅快取讀取 ÷ 可觀測輸入），越高越慳錢 |
| **活躍日數 / 最長連續日數** | 有使用記錄嘅日數同連續使用嘅日數                  |
| **高峰日**           | 單日用量最高嘅日期同其 Token 量               |
| **用量最高模型**        | 區間內消耗最多嘅模型                        |
| **日均**            | 平均每日嘅 Token 量同請求數                 |

下方嘅 **每日活動** 熱力圖按日展示用量強度，可喺 **Token / 成本** 兩個維度之間切換，顏色越深代表當日用得越多。

### 探索 / 分析

切到 **探索** 可以對用量做拆分分析：按 **分組**（供應商 / 模型 / API 密鑰 / 助手·Agent）拆開，揀一個 **指標**，再用 **柱狀圖 / 折線圖 / 餅圖 / 分段** 等圖表查看分佈同趨勢。

### 請求明細

**請求** 列出逐條請求記錄，方便定位係邊啲請求產生咗主要消耗。

> 想按某日睇？喺概覽嘅 **每日活動** 熱力圖上點選某一日，探索區（分析 + 請求）會 **下鑽** 到當日、標題變為「某日 明細」；撳「清除日期篩選」返回。

{% hint style="info" %}
成本係 **估算值**：佢按模型嘅公開定價折算，實際計費仍以各模型服務商嘅賬單為準。免費模型、本地模型唔會產生費用。
{% endhint %}

***

### 攞幫助同提交意見

如果您喺配置或使用過程中遇到任何疑問、Bug 或有功能改善建議，請參考 [反饋與建議](/docs/zhong-wen-fan-ti/question-contact/suggestions.md) 入面提供嘅官方渠道。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.cherryai.com.cn/docs/zhong-wen-fan-ti/pre-basic/settings/usage.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.