SuperAPI AI 工具集

hyper-architecture-tauri

智能体与模型

查看项目

更新于 11-04 21:28

技能介绍

用途

本技能面向 Tauri v2 桌面应用,用于采用、审查或修改受支持的 Vite + React + TanStack Router 文件式路由 + TanStack Query 技术栈。涉及的架构面包括前端打包、IPC、能力(capabilities)、命令边界、路由、数据缓存和测试。

适用判断

使用前先确认项目是否为 Tauri v2 应用,并识别前端构建与打包配置,例如 Vite 配置、package 脚本、beforeDevCommand、beforeBuildCommand、devUrl、frontendDist;再检测已安装并使用的 React、@tanstack/react-router、@tanstack/router-plugin、@tanstack/react-query、路由文件、生成的路由树、query client 以及 Tauri invoke/event/plugin 调用。

技能定义三种运行模式:

  • 不完整采用:存在 Tauri v2,但 Vite、React、Router、Router 插件或 Query 中一层或多层缺失或未使用。此时应制定增量采用计划,不强行套用完整技术栈布局。
  • 完整打包 Vite SPA:Tauri 为 React SPA 打包 Vite 静态资源;Router 生成并负责文件式路由;Query 负责异步数据缓存与新鲜度。浏览器 UI 与 Tauri IPC 保持分离,原生权限保留在经审查的 Rust 命令中。
  • 路由转出:缺少 Tauri v2 或相关架构面,或项目使用全栈 TanStack 运行时。此时应转到相应的非 Tauri、Rust 专用或全栈架构流程。

主要能力

技能以 SKILL.md 为核心,配合架构规则文件与六个主题规则文件:项目结构、平台、Tauri IPC、安全、路由与查询、测试;另附有日期的官方参考文档,覆盖 Tauri v2 以及 TanStack/Vite/React 的版本敏感事实;还包含触发与行为用例数据。

工作流程分为六个阶段:检查项目与采用标识并选择运行模式;梳理被触及的前端、src-tauri、配置和测试面;把每个发现归类为官方要求、安全要求或 Hypercore 约定,并识别阻断性门禁;仅实施安全、可逆的请求改动;对声明的门禁做验证,必要时最多对同一门禁再做一次修复;最后以韩语报告结果、例外、延后的迁移工作和需要授权的操作。

使用方式

先阅读架构规则,了解分类、支持模式和阻断门禁,再按被触及表面加载对应主题规则文件,计划或声称验证前阅读测试规则,仅在版本敏感时查阅官方参考。验证最多进行两轮,且每轮需有命令或测试证据,或具体审查标准。

适用场景

例如在本桌面应用中采用 Tauri v2 技术栈;审计 invoke 命令、能力和前端安全边界;检查路由文件是否由 Router 的 Vite 插件生成;把打包客户端中的路由数据获取迁移到 TanStack Query;为 Tauri WebView 配置打包 Vite SPA 的资源路径;设计可扩展的目录结构。

限制

纯浏览器 React/Vite 站点、仅需 Tauri 文档摘要、无前端或运行时边界决策的 Rust 子系统,以及全栈 TanStack 运行时,都不属于本技能范围,应转出。没有安装 Router 或 Query 的通用 Tauri 应用按不完整采用模式处理,不假设这些层已存在。技能要求不将静态 Vite 资源、生成路由、Query 缓存与 Tauri 原生权限混为一谈,不向渲染层暴露凭据或特权调用,不在缺少窄能力、权限、作用域、输入校验和调用方边界时使用 IPC 或插件能力,不在未经用户授权时执行不可逆原生副作用、发布或破坏性操作。默认输出语言为韩语,代码标识符、路径、命令和配置键保留原文。