概览Creght AI 编程指南

Creght AI 编程指南

面向 AI 编程智能体的 Creght 实现文档与配置指南。

这里收录面向 AI 编程智能体的 Creght 实现文档。选择与当前需求对应的文档,获取可直接执行的配置方式、代码约定和验收规则。

文档

如何优化 llms.txt →

把扁平的网址列表整理成清晰、有优先级的站点地图,帮助 AI 系统先找到最重要的 Creght 页面。

配置 talizen.config.ts →

面向 AI 智能体的站点配置规范:字段分组与求值时机、html/body 标签属性、head/bodyEnd 注入代码、按请求的 (ctx) => 值。

实现基于域名的多语言路由 →

面向 AI 智能体的实现规范:配置语言归属、跨域重定向、多语言链接和 CMS 多语言行为。

在服务端调用外部 API 并管理缓存 →

在 getServerSideProps 里取站点之外的数据,用 ctx.cacheDepends 声明依赖,再通过发布接口作废页面缓存——不声明依赖,页面会一直停在第一次渲染的结果上。

使用 Func 构建站点后端能力 →

面向 AI 编程智能体的 Func 总览:适用范围、文件与方法、运行时规则、ctx 能力全貌、返回值与错误、鉴权与密钥、SSR 边界与验收流程。JSON 表、资源上传、超时与流式各有专题文档。

JSON 表:定义、读写与查询 →

Func 持久化层的完整说明:表定义文件格式与落库前校验、记录的真实形状、where 与 filter 的算子及静默失效的陷阱、分页排序上限、合并式更新,以及「表属于 project 而不属于站点版本」这条容易踩空的边界。

上传文件:直传与 Func 内生成 →

站点里的两条上传路径怎么选:浏览器选择的文件走 CDN 签名直传,Func 内生成的字节走 ctx.assets.upload(单次 20 MiB)。含为什么 base64 中转必然失败,以及文件在 JSON 表里该怎么存。

超时配置与流式响应 →

invoke 默认 5 秒、执行上限 300 秒、返回体积约 1 MiB——长任务撞的到底是哪一条,以及 context deadline exceeded 的诊断顺序。含 ctx.sse.send 加原生 Fetch 的完整 SSE 解析写法,和「流式不是后台任务」这条边界。

使用 Func 接入支付宝电脑网站支付 →

支付宝电脑网站支付的完整 Func 示例:公钥模式、RSA2、可选 AES 内容加密、可信订单、异步通知验签与幂等更新。

使用集成发送邮件与验证码 →

连接 Resend 集成后在 Func 里用 ctx.email 发送事务邮件与邮箱验证码:密钥留在服务端,验证码的位数、有效期、一次性、常数时间比对、错误次数与限频由平台保证。

使用集成接入支付宝支付 →

连接支付宝集成后在 Func 里用 ctx.payment.alipay 发起电脑网站支付并验签异步通知:应用私钥留在服务端,签名、通知验签与内容加密由平台完成,订单、金额核对与幂等发货仍由站点代码负责。

注册时验证邮箱 →

打开「注册必须验证邮箱」后,验证变成一次独立的服务端动作:验码通过即落一条一次性证明,注册只检查本次请求带没带它。页面代码里没有验证码参数,也没有「已验证」这个布尔值。

实现找回密码与修改密码 →

站点的「忘记密码」和「修改密码」写在 Func 里:ctx.users.find 决定要不要发验证码,ctx.email.verifyCode 验码,ctx.users.setPassword 改密码。含两个场景的完整代码、三条不写就会出问题的规则,以及哪些事不用自己实现。

在 Func 里实现登录 →

ctx.auth.login 给已有用户签发会话,用来做 SDK 表达不了的免密码验证码登录,或者在登录时跑封禁、实名、多租户这类自己的规则。含完整代码、一条不能写错的规则,以及每次登录的审计在哪看。

在 Func 里查询用户 →

ctx.users 是项目的用户目录:find 按标识符精确找一个人,query 按条件分页翻名单。含用户对象的完整字段表、find 的三个陷阱、query 的过滤与排序规则,以及最关键的一节——平台不做角色判断,门禁必须由站点代码自己写。

Render diagnostics