# 捷时云 IFQ Cloud — 全量索引 / Full index · cloud.ifq.ai

> 本文件给 AI 与 Agent 提供完整的模块与场景索引。每个场景的完整提示词（中英双语）在对应模块页的 `<pre>` 块中，可直接复制；本文件给出场景含义、适用人群与抓取位置。

This file is a complete module + scenario index for AI and Agents. Each scenario's full bilingual prompt lives in a `<pre>` block on its module page (copy-ready); here we give meaning, audience, and where to fetch.

## 站点结构 / Site structure

- Home: `/zh`, `/en`
- Modules index: `/zh/modules`, `/en/modules`
- Module detail: `/{locale}/modules/{slug}`
- Guide: `/{locale}/guide` · Principles: `/{locale}/principles` · FAQ: `/{locale}/faq`

## 通用接入契约 / Common integration contract

每个场景提示词都要求 Codex：
1. 通过捷时云接入，API 基址 `https://api.cloud.ifq.ai`，SDK `jieshi-cloud`（无 SDK 时用等价 HTTPS 请求）。
2. 密钥放环境变量 `JIESHI_CLOUD_API_KEY`、`JIESHI_CLOUD_PROJECT_ID`，生成 `.env.example`，不硬编码。
3. 占位值先跑通，打印提示告知去哪替换真实值。
4. 网络请求有超时与失败降级，断网友好提示不崩溃。
5. 提供本地 demo / mock 模式。
6. 附最小自测，并说明如何启动与回滚。

---

## 模块 1：登录 / 身份 · Auth — `/{locale}/modules/auth`

让本地项目接入云端账号体系：注册、登录、登录态安全保存。

- `auth-email-login` — 邮箱/手机验证码登录。问题：项目无账号系统，数据不分人。产出：注册/登录/退出、验证码校验、登录后才见自己数据。适合：需区分用户、保护数据的工具。
- `auth-oauth` — 第三方一键登录（微信/GitHub）。问题：单独注册门槛高。产出：一键授权、自动取头像昵称、多方式绑定同一用户。适合：降低注册门槛的 C 端产品。
- `auth-session` — 登录态与权限保护。问题：无有效期管理、无法分角色。产出：有效期与自动续期、安全退出、按角色控制访问。适合：多角色内部系统。

## 模块 2：云数据库 · Database — `/{locale}/modules/database`

把本地数据搬到云端：增删改查、查询、多设备共享。

- `db-crud` — 数据读写（增删改查）。问题：数据存本地文件，换设备就没。产出：云端存储、完整 CRUD、保存即同步。适合：任何需保存共享数据的工具。
- `db-sync` — 本地数据一键上云。问题：历史数据多，怕迁移丢数据。产出：批量导入、迁移前备份可回滚、迁移后一致性校验。适合：有历史数据想平滑上云的团队。
- `db-query` — 条件查询与分页。问题：数据多找记录慢、列表卡。产出：多条件筛选、关键词搜索、分页/滚动加载。适合：数据量大需检索的管理工具。

## 模块 3：AI 能力 · AI — `/{locale}/modules/ai`

让项目用上大模型：对话问答、RAG 精准问答、语义检索。

- `ai-chat` — 接入大模型对话/问答。问题：不知如何接大模型、担心大陆访问。产出：会话式助手、多轮对话、稳定大陆访问。适合：想加智能问答的产品。
- `ai-rag` — 基于自有资料的精准问答（RAG）。问题：通用模型不懂内部资料、易编造。产出：上传文档建知识库、答案有据可溯源、随资料更新。适合：有内部文档要做智能客服的团队。
- `ai-embedding` — 语义搜索/向量检索。问题：关键词搜索太死板。产出：按语义匹配、找近义相关内容、与现有搜索叠加。适合：内容多需更聪明搜索的产品。

## 模块 4：存储/支付/推送 · Platform — `/{locale}/modules/platform`

项目常用云能力：文件上传、在线支付、消息推送。

- `platform-storage` — 文件/图片上传下载。问题：文件只存本地、无法在线展示。产出：拖拽上传、云端存储生成链接、图片自动压缩。适合：处理附件图片文档的工具。
- `platform-payment` — 在线支付与订单。问题：支付涉及钱和安全、自己接太复杂。产出：创建订单发起支付、回调自动确认、订单可查可对账。适合：需在线收款的产品。
- `platform-push` — 消息推送/通知。问题：重要事件用户不知、易错过。产出：事件触发通知、站内/邮件/短信多渠道、通知中心可标已读。适合：有提醒告警需求的产品。

---

## 抓取建议 / Fetching

- 完整提示词：请求模块页 `/{locale}/modules/{slug}`，定位锚点 `#{scenario-slug}`，读取其中的 `<pre>` 块。
- 语言：`/zh/*` 为中文，`/en/*` 为英文，提示词随页面语言提供。
- 速率：建议每个 Agent ≤ 1 请求/秒。内容以 MIT 协议开放。