# 捷时云 IFQ Cloud · cloud.ifq.ai

> 面向 AI 和 Agent 的云服务平台（中英双语）。按场景挑选准备好的提示词，一键复制到 Codex，为本地项目加上联网能力与登录、云数据库、AI、支付推送等模块。公开内容用业务语言书写，业务专家也能看懂、上手。

A bilingual (Chinese + English) cloud-service platform for AI and Agents. Pick a ready-made prompt by scenario, copy it into Codex, and let it add networking plus modules — auth, cloud database, AI, payments/push — to your local project. Public content is written in plain business language so non-technical experts can follow it.

根路径按浏览器语言重定向到中文或英文，直达地址固定在 `/zh/*` 与 `/en/*`。

## 主要内容 / Primary content

- [首页 / Home](https://cloud.ifq.ai/zh): 三步流程（选场景 → 一键复制提示词 → 粘贴进 Codex）、四大模块、指导原则入口。
- [云服务模块 / Modules](https://cloud.ifq.ai/zh/modules): 四大模块总览，每个模块附场景提示词。
- [使用说明 / How it works](https://cloud.ifq.ai/zh/guide): 面向业务专家的 6 步上手指南。
- [指导原则 / Principles](https://cloud.ifq.ai/zh/principles): 安全、成本、数据边界等上云原则。
- [常见问题 / FAQ](https://cloud.ifq.ai/zh/faq): 业务专家最常问的问题。

## 四大云服务模块 / Cloud modules

每个模块页都包含场景列表，每个场景含"现在的问题 / 接入后能得到"说明，以及一段可直接复制进 Codex 的完整提示词（中英双语）。提示词统一附带接入契约：占位符密钥放环境变量、联网超时与失败降级、本地 demo/mock 模式、最小测试与回滚说明。

- [登录 / 身份模块 · Auth](https://cloud.ifq.ai/zh/modules/auth): 注册登录、第三方登录、会话与权限。场景：`auth-email-login`、`auth-oauth`、`auth-session`。
- [云数据库模块 · Database](https://cloud.ifq.ai/zh/modules/database): 数据读写、本地数据上云、条件查询分页。场景：`db-crud`、`db-sync`、`db-query`。
- [AI 能力模块 · AI](https://cloud.ifq.ai/zh/modules/ai): 大模型对话、RAG 精准问答、语义检索。场景：`ai-chat`、`ai-rag`、`ai-embedding`。
- [存储/支付/推送 · Platform](https://cloud.ifq.ai/zh/modules/platform): 文件上传、在线支付、消息推送。场景：`platform-storage`、`platform-payment`、`platform-push`。

## 占位符约定 / Placeholders

提示词使用占位符，用户从捷时云控制台获取真实值后替换：
- API 基址 / API base: `https://api.cloud.ifq.ai`
- SDK 占位名 / SDK: `jieshi-cloud`
- 环境变量 / Env: `JIESHI_CLOUD_API_KEY`、`JIESHI_CLOUD_PROJECT_ID`

## 中英文镜像 / Chinese-English mirror

以上每个页面都有完全对应的另一语言版本，例如 `https://cloud.ifq.ai/en/modules/auth`。

## AI 可读资源 / AI-readable resources

- LLM summary: https://cloud.ifq.ai/llms.txt
- Full LLM index: https://cloud.ifq.ai/llms-full.txt
- Agent guide: https://cloud.ifq.ai/agent.md
- Compatibility agent guide: https://cloud.ifq.ai/agents.md
- Sitemap: https://cloud.ifq.ai/sitemap.xml
- Robots: https://cloud.ifq.ai/robots.txt

## 使用政策 / Use policy

内容与提示词以 MIT 协议开放，欢迎在保留业务语境的前提下引用并注明 cloud.ifq.ai。

## 托管与性能 / Hosting & performance

为中国大陆访问做了优化：加载快、稳定可靠，不依赖境外第三方资源。
Optimized for access from mainland China: fast, reliable, no reliance on third-party offshore resources.