用途:这是编辑 PolyStella 包源码的贡献者技能,按常见贡献任务给出分步配方。若你是把 PolyStella 集成进下游 Astro 项目,应改用 polystella-consumer 技能。
主要能力与结构:包所有权遵循进程内直连流程 source/record -> adapter -> core -> provider -> core -> adapter -> output。core 负责底层翻译契约与编排,adapter 负责可移植格式,provider 负责传输,Astro 负责宿主策略。可复用包使用标准 Web API,必须在不启用 nodejs_compat 时可用,消费者可自行启用。
配方涵盖:新增文件格式适配器(实现 FileAdapter,注册到 registry,先注册者优先)、新增 CLI 子命令(各自解析 argv 并提供 run<Name> 处理器)、新增翻译提供方(在 zod schema 加配置变体并实现 Translator 工厂)、变更缓存契约(会全量失效缓存,需与负责人协调并做 major 版本升级)、调试翻译回归、修改运行时 API、编辑 UI 字符串处理、严格 tsconfig 模式与测试约定。
使用方式:先阅读 AGENTS.md 与 ARCHITECTURE.md,再按配方操作。验证通常运行 pnpm test、pnpm typecheck,部分任务还需 pnpm build。
限制:缓存哈希公式变更属 Invariant 1,需 major 版本与 CHANGELOG 说明;适配器不得改动 run.ts 或 cache.ts;提供方永久错误集为 {400,401,403,404,422},5xx、408、425、429 可重试,新增状态码需先询问;UI 字符串的 {{token}} 校验在 translateBatch 之外运行,不要加第二层重试;队列化 locale 必须内部捕获错误,重抛会终止整轮运行。资料未提供具体版本号、价格与平台支持细节。