用途:为 SvelteKit 项目提供远程函数(Remote Functions)的编写指导,帮助在 .remote.ts 文件中正确使用 command()、query()、form() 三种模式。
主要能力与选择原则:一次性动作使用 command();重复读取使用 query();表单场景使用 form()。远程函数文件以 *.remote.ts 命名。示例中从 '$app/server' 导入 command,并用 valibot 做参数校验,导出后可在客户端直接调用,如 await delete_user({ id: '123' })。
使用方式与要点:远程函数在浏览器调用时于服务端执行;参数与返回值必须可 JSON 序列化;通过 StandardSchemaV1(Valibot/Zod)进行模式校验;可用 getRequestEvent() 访问 cookies 与 headers。查询结果会被缓存,需要最新数据时使用 .refresh()。注意不要把 .remote 文件放在 src/lib/server/ 目录下,否则无法工作。
适用场景:SvelteKit 全栈开发中需要从客户端安全调用服务端逻辑、读取数据或处理表单的场景。
限制:资料未提供安装命令、版本要求、完整 API 参考与更多示例;详细模式说明指向 references/remote-functions.md。最后验证时间为 2025-12-19。