From 07edbc6326a9a536e99a732da2c19aa2ae0b9f4c Mon Sep 17 00:00:00 2001 From: binichallein <132759743+binichallein@users.noreply.github.com> Date: Fri, 15 May 2026 13:21:26 +0800 Subject: [PATCH] docs: clarify quota estimates for usage limits --- docs/en/faq.md | 2 ++ docs/en/reference/slash-commands.md | 2 ++ docs/zh/faq.md | 2 ++ docs/zh/reference/slash-commands.md | 2 ++ 4 files changed, 8 insertions(+) diff --git a/docs/en/faq.md b/docs/en/faq.md index 4cb33d388..cb9f8e527 100644 --- a/docs/en/faq.md +++ b/docs/en/faq.md @@ -21,6 +21,8 @@ Possible reasons for an invalid API key: If you're using the Kimi Code platform, you can check your current quota and membership status with the `/usage` command. If the quota is exhausted or membership expired, you need to renew or upgrade at [Kimi Code](https://kimi.com/coding). +Request counts shown for a membership time window are rough estimates derived from token consumption, not a fixed per-request allowance. The actual number of turns varies with the task: long context, large files, images, tool output, subagents, and repeated edits all consume more tokens, so complex engineering work can reach the limit much faster than short Q&A. When troubleshooting quota usage, treat `/usage` as the source of truth for remaining quota and check the current session's context usage to decide whether to compact context or start a new session. + ## Interaction issues ### `cd` command doesn't work in shell mode diff --git a/docs/en/reference/slash-commands.md b/docs/en/reference/slash-commands.md index 29a37fc0a..52d1ce660 100644 --- a/docs/en/reference/slash-commands.md +++ b/docs/en/reference/slash-commands.md @@ -100,6 +100,8 @@ Alias: `/status` This command only works with the Kimi Code platform. ::: +Request counts on membership pages are rough estimates derived from token consumption, not a fixed number of independent requests for each plan. Long context, large files, images, and tool output increase the cost of a turn, so use `/usage` as the source of truth for remaining quota. + ### `/mcp` Display currently connected MCP servers and loaded tools. See [Model Context Protocol](../customization/mcp.md) for details. diff --git a/docs/zh/faq.md b/docs/zh/faq.md index a82d0b9b0..5610072fb 100644 --- a/docs/zh/faq.md +++ b/docs/zh/faq.md @@ -21,6 +21,8 @@ API 密钥无效可能的原因： 如果你使用 Kimi Code 平台，可以通过 `/usage` 命令查看当前的配额和会员状态。如果配额用尽或会员过期，需要在 [Kimi Code](https://kimi.com/coding) 续费或升级。 +会员权益页中按时间窗口展示的请求次数是基于 token 消耗折算的粗略估算，不是固定的逐次请求额度。实际可用轮次数会随任务内容变化：长上下文、大文件、图片、工具输出、子 Agent 和多轮修改都会增加 token 消耗，因此复杂工程任务可能比简单问答更快触达限制。排查用量问题时，以 `/usage` 显示的剩余配额为准，并结合当前会话的上下文用量判断是否需要压缩上下文或开启新会话。 + ## 交互问题 ### Shell 模式中 `cd` 命令无效 diff --git a/docs/zh/reference/slash-commands.md b/docs/zh/reference/slash-commands.md index 53120d341..113960d23 100644 --- a/docs/zh/reference/slash-commands.md +++ b/docs/zh/reference/slash-commands.md @@ -100,6 +100,8 @@ 此命令仅适用于 Kimi Code 平台。 ::: +会员页中的请求次数是基于 token 消耗折算的粗略估算，不代表每个套餐都有固定数量的独立请求。长上下文、大文件、图片和工具输出会提高单轮消耗，因此请以 `/usage` 展示的剩余配额为准。 + ### `/mcp` 显示当前连接的 MCP 服务器和加载的工具。详见 [Model Context Protocol](../customization/mcp.md)。