> ## Documentation index
> Fetch the complete documentation index at: https://tgcloud.docs7.io/llms.txt
> Ask it with GET https://tgcloud.docs7.io/ask?q=<keywords or question>. Short keywords rank best.
> Use these to discover all available pages before exploring further.

# 资源

> tgcloud://docs/* 上的内置平台文档

# 资源

服务器把平台参考作为 MCP 资源暴露出来。助手不调用工具就能阅读。正文是英文，与 core.telegram.org/bots/serverless 相同，便于对照官方页面。

| URI | 内容 |
|---|---|
| `tgcloud://docs/project-structure` | `tgcloud/` 布局、handlers、endpoints、lib、schema.js。项目导入是**带** `.js` 的相对路径。Mini App 静态托管 |
| `tgcloud://docs/cli` | CLI 参考：命令、`--dry-run` / `--safe` / `--yes` / `--local`、upgrade、webhook |
| `tgcloud://docs/sdk-db` | `sdk/db`：列类型（`text`、`integer`、`real`、`numeric`、`blob`、`boolean`、`json`）与 mode、查询构造器、原始 SQL、无外键、通过 `.deprecated` 删除 |
| `tgcloud://docs/sdk-api` | `sdk/api`：完整 Bot API、`BotApiError`、`InputFile` |
| `tgcloud://docs/sdk-fetch` | `sdk/fetch`：HTTP 客户端、body 辅助函数、32 MB 上限 |
| `tgcloud://docs/limits` | 已记录的限制，以及尚未公布的配额 |

在脚手架项目里，先读 `AGENTS.md` 和 `docs/tgcloud-sdk.md`。它们与创建该项目的 CLI 一致。不在项目目录中时，再用这些资源。

仓库中的原文是 `resources/docs/*.md`。`npm run docs:check` 检查每个文件都已注册、两份 skill 副本一致，以及每个英文页面都有 ru、zh、ar、de、fr 对应页。

## 平台限制

`tgcloud://docs/limits` 汇总已公布的限制：Bot API 每次上传 50 MB（照片 10 MB）、`getFile` 每次下载 20 MB、`fetch` 响应体 32 MB。`console` 输出由 `tgcloud run` 显示，没有公布大小上限。

运行时配额——内存、CPU、handler 与 endpoint 的墙钟超时、调用频率、数据库大小——**尚未公布**。不要臆测数字。`run_handler` 会打印一次运行的耗时：用它测量你的路径，让 handler 保持简短，并把重活移出更新路径、改用 `fetch` 发出。具体数值请到 @BotFather → 机器人 → Serverless，或平台的官方渠道询问。

同一资源还列出运行时**不提供**的能力：数据库事务与原子批处理、自定义入站
HTTP 端点（webhook 由平台拥有）、密钥存储与环境变量、定时任务——并给出各自
受支持的替代方案。