SuperAPI AI 工具集

platform-engineering

编程与开发

查看项目

更新于 10-15 09:53

技能介绍

用途

platform-engineering 是一份跨平台开发规则手册,用于在构建或评审 SPA、PWA、移动端(iOS/Android)和桌面端应用时,提供统一的安全、架构与性能规则。每条规则都标注严重级别(MUST/DO/DON'T)和适用平台,并附有真实世界事故参考。

主要能力

三大支柱

规则手册由三个支柱构成:安全(Security)、架构(Architecture)、性能(Performance)。

平台决策矩阵

提供快速平台决策矩阵,覆盖 SPA、PWA、Mobile、Electron、Tauri 五类平台,针对以下关注点给出建议:

  • 认证令牌存储:SPA/PWA 使用 JS 内存 + httpOnly cookies;移动端使用平台 Keychain/Keystore;Electron/Tauri 使用操作系统凭据存储。
  • OAuth 流程:SPA/PWA 使用 Auth Code + PKCE;移动端使用系统浏览器 + PKCE;Electron/Tauri 使用标准 PKCE。
  • XSS 影响:SPA 为会话劫持;PWA 额外包含持久化 Service Worker 劫持;移动端为 WebView 桥接访问;Electron 可从 XSS 升级到 RCE;Tauri 限于 Web 上下文。
  • CSP:SPA/PWA/Electron 为关键;移动端仅 WebView 相关;Tauri 相关。
  • 离线策略:PWA 使用 IndexedDB + Cache API + Service Worker;移动端使用 Room/CoreData + 同步队列;其余为可选。
  • 包体积目标:SPA/PWA 压缩后 JS <170KB;移动端 APK/IPA <20MB;Electron 80-150MB(Chromium);Tauri 总计 <10MB。
  • API 风格:SPA 使用 REST 或 GraphQL;PWA 使用 REST(Service Worker 缓存);移动端使用 GraphQL(减少往返);Electron 使用 REST(服务端聚合);Tauri 使用 REST。
  • 状态管理:SPA 使用 Zustand/Redux + TanStack Query;PWA 使用 IndexedDB + Cache API;移动端使用 ViewModel+StateFlow / SwiftUI;Electron 使用 IPC + 上下文隔离;Tauri 使用 Rust invoke 命令。

参考文档加载指引

  • 安全评审或审计:加载 server-validation、auth-tokens、passkeys-webauthn、api-security、xss-csp、secrets-management、platform-security。
  • 架构决策:加载 client-server-architecture、api-design、offline-first、infrastructure。
  • 性能优化:加载 frontend-performance、backend-and-platform-performance。
  • 完整平台评审:加载全部 13 份参考。

参考材料

安全(第一部分)

  • server-validation.md:服务端校验规则、信任边界、真实绕过事故。
  • auth-tokens.md:各平台令牌存储、OAuth 2.1 流程、JWT 最佳实践、安全存储 API。
  • passkeys-webauthn.md:WebAuthn Level 3 / passkey 模式、服务端验证、跨平台支持、克隆认证器检测。
  • api-security.md:端点认证、速率限制、CORS、OWASP API 风险、Peloton/Parler 案例研究。
  • xss-csp.md:各平台 XSS 严重性、CSP 指令、反 CSRF、净化、British Airways 事故。
  • secrets-management.md:密钥暴露风险、环境变量、保险库服务、GitGuardian 统计。
  • platform-security.md:移动端(Keychain/Keystore、证书固定)、Electron(nodeIntegration、contextIsolation、sandbox)、Tauri(默认拒绝)、PWA(Service Worker 作用域、Cache API 风险)、安全头矩阵。

架构(第二部分)

  • client-server-architecture.md:瘦客户端原则、BFF 模式、服务端权威设计。
  • api-design.md:按平台划分的 REST 与 GraphQL 权衡、分页策略、各平台状态管理。
  • offline-first.md:冲突解决策略(LWW、CRDT、OT)、乐观 UI、同步模式。
  • infrastructure.md:单体优先原则、数据库访问模式、各平台 CI/CD 流水线、可观测性、功能开关生命周期。

性能(第三部分)

  • frontend-performance.md:包体积优化、图片格式与响应式加载、Core Web Vitals(LCP、INP、CLS)及业务影响数据。
  • backend-and-platform-performance.md:API/数据库性能(分页、索引、连接池)、移动端电池/内存、SSR/SSG/ISR 渲染策略、CDN 缓存模式。

使用方式

根据当前任务类型(安全评审、架构决策、性能优化或完整平台评审)加载对应的参考文档。规则以 MUST/DO/DON'T 标注,可直接用于构建或评审流程中的检查清单。

适用场景

适用于构建或评审 SPA、PWA、移动端(iOS/Android)和桌面端应用时的安全、架构与性能决策。

限制

资料未提供具体安装命令、收费方式、价格、平台支持范围或使用效果数据,这些内容暂未提供。