kineti-fe-gdk-update

更新 Kineti 前端中的 GDK

范围

将 @geodome/gdk 更新到最新稳定版或指定版本，并调整代码和翻译、验证结果。仅在选定的前端使用方检出中操作；不要提交更改。不要推送、发布 PR、更改计划或修改 GDK 源码。通知调度器不授权更新。编辑此技能不会调用它。

依赖项

无技能依赖项

工作流

确定目标

• 根据远程仓库和 package.json 验证检出身份和使用方依赖；拒绝将 GDK 自身作为目标，以避免自依赖。仅在目标不明确时提问。阅读仓库/嵌套说明和翻译指南。
• 获取远程默认分支；记录 SHA 和依赖项/锁文件基线。检查任务更改，并使用最新基线，不要重置、丢弃或暗中暂存更改。如果无法保留用户的工作，报告阻碍。
• 从配置的注册表中一次性解析最高稳定 SemVer 版本，排除预发布版本，除非用户指定了版本。不要依赖标签、通过安装来比较版本、隐式降级，或将访问失败称为“已是最新”。即使目标版本已安装/锁定，仍需完成尚未完成的翻译、适配和验证。

更新

每次 AWS/CodeArtifact 身份验证以及依赖安装/更新命令（包括重试）都设置 AWS_PROFILE=kineti。安装/更新前，运行 AWS_PROFILE=kineti pnpm run preinstall。使用项目的 pnpm/注册表和钩子；切勿泄露令牌或更改全局凭据。使用 AWS_PROFILE=kineti aws sts get-caller-identity 诊断身份验证失败。

• 仅更新 package.json 和 pnpm-lock.yaml 中的 GDK，保留版本格式，避免无关升级或锁文件变动。
• 检查发布说明、已发布的 API/类型和使用方用法。遵循仓库惯例，适配破坏性 API 变更、模板、运行时行为和模拟对象。切勿削弱类型、抑制错误、禁用测试/检查或移除有用的断言。
• 通过现有的提取、同步、翻译、美化和验证流程，完成所有受支持区域设置的翻译。从更新后的软件包/应用中提取内容；保留生成的 ID、占位符和现有译文。仅同步键是不够的。

验证

安装、适配和翻译生成完成后，并行运行彼此独立的检查。将前置步骤以及共享可变资源的检查串行执行；收集所有结果后再修复失败。

阅读 CI 工作流/脚本。运行完整类型检查和完整的非监听模式 CI 单元测试套件；仅当 PR CI 要求时，才运行其他非 E2E 检查。将未提交的更改纳入受影响范围。运行前检查聚合脚本/Nx 目标。绝不运行本地或远程 E2E/浏览器测试套件，包括 Playwright/Cypress，即使仓库说明提及也不例外。选择非 E2E 目标；报告 E2E 是有意未运行，而不是已通过或阻塞。不要修改 CI 检查。

查找项目命令；drones-frontend 示例： lint、typecheck、format-check-all、test-ci；翻译使用 drone-fe:extract-i18n、sync-locales、prettify-locales、verify-locales。 重新运行翻译流程；确认区域设置不再有变化。仅当 PR CI 要求时，才构建生产环境/受支持的区域设置；绝不发布镜像或部署。

Nx 检查使用 NX_SKIP_NX_CACHE=true NX_NO_CLOUD=true。如果后续类型检查阶段受前序阶段阻塞，分别运行。修复升级导致的问题；对最终更改重新运行失败/失效的检查，并检查差异。针对预期行为更新测试，但不要放宽验证。

即使遇到可修复的失败，也要继续完成工作。已有问题、需要修复 GDK 源码的问题，或不可用的凭据/服务/基础设施，都意味着结果不完整，需提供证据。不要进行无关修复，也不要搜索其他人的分支、PR、对话、Slack 或 Jira 来协调；由用户负责处理。

结果

用波兰语简要回复，列出旧版本／目标版本、基础 SHA、变更区域、适配内容、实际检查结果和阻碍，包括失败或未运行的检查。 只有最终本地更改通过所有必需检查，才算准备就绪。部分安装不完整；仅靠类型检查无法证明运行时兼容性。