SuperAPI AI 工具集

tauri-errors-permissions

通用与其它

查看项目

更新于 10-15 22:18

技能介绍

该技能用于在 Tauri 2 中诊断与权限相关的错误,核心是一棵诊断决策树:当出现 "command <name> not allowed" 时,按插件命令、自定义 #[tauri::command]、核心功能(window、event、path、menu、tray)分别定位;出现 CSP 违规(控制台显示 "Refused to ...")时定位 CSP;出现 scope 违规或路径访问被拒时定位作用域;无报错但功能静默失效时定位静默权限失败;构建期权限/能力相关报错时定位配置格式错误。

主要能力:区分插件权限、自定义命令权限、核心权限;说明权限命名约定 <plugin>:default、<plugin>:allow-<command>、<plugin>:deny-<command>;列出 :default 未覆盖的常见命令(如 fs 写操作、shell 的 execute/spawn、clipboard-manager 全部操作、http 的 URL 作用域等);给出 CSP 指令与错误信息映射、Tauri 专用协议(ipc:、asset:)要求;列出作用域路径变量($APPDATA、$RESOURCE 等)并强调 deny 优先于 allow;汇总配置格式规则(能力文件用 JSON 或 TOML、应用权限文件仅 TOML)及分步权限配置流程。

使用方式:按错误类型进入对应章节,逐项核对插件注册、capability 文件位置与 windows 数组、权限标识、作用域与 CSP 设置;应用权限文件放在 src-tauri/permissions/,能力文件放在 src-tauri/capabilities/,修改后重新构建以生成 schema。

适用场景:插件或自定义命令权限被拒、CSP 阻止脚本/请求/资源、文件或 HTTP 作用域受限、功能无报错但无效、能力或权限文件解析失败。

限制:内容面向 Tauri 2,未覆盖 Tauri 1 的 allowlist 模式;具体项目仍需结合实际版本与生成 schema 验证;资料未提供安装命令、价格或平台信息。