SuperAPI AI 工具集

paraglide-js

智能体与模型

查看项目

更新于 10-16 01:13

技能介绍

用途:Paraglide JS 是基于编译器的国际化(i18n)库,会生成带类型的消息函数和运行时辅助工具。本技能适用于为项目添加或修改 Paraglide 集成、语言检测策略、本地化路由,以及在 Vite、SSR 等场景中使用生成的消息。

主要能力:支持在新建或现有应用中接入 Paraglide;调整语言策略顺序或自定义策略;通过 paraglideMiddleware() 接入 SSR 语言检测;集成到 TanStack Start;在 monorepo 中复用同一份 project.inlang。注意:本技能面向代码集成与运行时行为,不适用于通用文案写作或翻译质量审校。

使用方式:先判断应用形态(Vite 应用、SSR 应用、TanStack Start 应用或 monorepo)。Vite 类项目优先使用 Vite 插件;无法使用打包器集成或包需要显式编译脚本时,改用 CLI 编译。仅在 SSR/服务端请求流程中添加服务端中间件。以 project.inlang 和消息文件为唯一事实来源,将生成的 paraglide/ 输出视为构建产物。修改消息、语言、策略或输出设置后需重新编译。

经验规则:Vite 项目优先使用 paraglideVitePlugin(),不要手写生成输出;优先使用内置策略再考虑自定义;策略顺序需有意设计,靠前的策略优先;URL 重写只保留一个负责方,避免同时使用路由级 URL 重写与中间件驱动的 URL 本地化而产生重定向循环;monorepo 中默认“各包自行编译”,除非所有使用方都能共享完全相同的策略与运行时。

常见错误:直接编辑生成的 src/paraglide/* 文件而非修改源消息或配置;修改 messages/*.json 或 project.inlang/settings.json 后忘记重新编译;在纯客户端 SPA 中添加 paraglideMiddleware();把偏好策略放在 url 之前却未预期重定向行为;同时使用 TanStack Router 重写与基于 URL 的中间件本地化而未测试循环。

限制:资料未提供具体收费、价格、平台支持范围或效果数据。参考文档包括官方文档、Vite 指南、monorepo 指南、中间件指南与 TanStack Router i18n 指南。