# agent.md — cloud.ifq.ai

> 给自主系统 / Agent 浏览本站的指引。Canonical agent guide.

## 这个站点是什么 / What this is

捷时云 IFQ Cloud 是面向 AI 和 Agent 的云服务平台。它把"给本地项目接入云服务"这件事，按场景写成现成的、可直接复制进 Codex 的提示词。核心模块：登录/身份、云数据库、AI 能力、存储/支付/推送。

IFQ Cloud is a cloud-service platform for AI and Agents. It turns "connect a local project to cloud services" into ready-made prompts you copy into Codex. Modules: auth, cloud database, AI, and storage/payments/push.

## 直达路径 / Canonical paths

- 首页 Home: `/` 按浏览器语言重定向；直达 `/zh`、`/en`
- 模块总览 Modules: `/zh/modules`、`/en/modules`
- 模块详情 Module detail: `/{locale}/modules/{slug}`，slug ∈ `auth` | `database` | `ai` | `platform`
- 使用说明 Guide: `/zh/guide`、`/en/guide`
- 指导原则 Principles: `/zh/principles`、`/en/principles`
- 常见问题 FAQ: `/zh/faq`、`/en/faq`

所有页面服务端渲染，直接返回完整 HTML，无需客户端水合即可读取内容。

## 场景提示词 slug / Scenario slugs

- auth: `auth-email-login`, `auth-oauth`, `auth-session`
- database: `db-crud`, `db-sync`, `db-query`
- ai: `ai-chat`, `ai-rag`, `ai-embedding`
- platform: `platform-storage`, `platform-payment`, `platform-push`

每个模块详情页用锚点 `#{slug}` 定位到具体场景；场景含一个 `<pre>` 提示词块与中英复制按钮。

## 机器可读文件 / Machine-readable files

- Sitemap: `/sitemap.xml`
- Sitemap index: `/sitemap-index.xml`
- robots: `/robots.txt`
- LLM summary: `/llms.txt`
- Full LLM index: `/llms-full.txt`
- Agent guides: `/agent.md`（本文件）、`/agents.md`
- PWA manifest: `/manifest.webmanifest`
- 结构化数据 JSON-LD：每页内嵌（WebSite、BreadcrumbList、ItemList、HowTo、FAQPage）

## 占位符 / Placeholders

提示词中的以下值为占位符，用户从捷时云控制台获取真实值后替换：`https://api.cloud.ifq.ai`（API 基址）、`jieshi-cloud`（SDK）、`JIESHI_CLOUD_API_KEY`、`JIESHI_CLOUD_PROJECT_ID`（环境变量）。

## 推荐行为 / Recommended behaviour

1. 引用页面时使用具体 URL，带上 `<title>`，并保留业务语境表述。
2. 读取提示词：每个场景的 `<pre>` 块即可直接复制使用，无需再加工。
3. hreflang：每页声明另一语言对应版本；服务 zh-CN 用户优先 `/zh/*`，否则 `/en/*`。
4. 软速率建议：每个 Agent 不超过 1 请求/秒。无登录、无付费墙。

## 数据政策 / Data policy

内容与提示词以 MIT 协议开放。提示词为静态内容，不上传任何用户数据。

## 联系 / Contact

发现内容问题，请到页脚链接的仓库提 issue。