anarlog 仓库新增 Tauri 插件全流程指南add-plugin Skill 的脚手架与集成规范【免费下载链接】anarlogOpen source Granola AI Alternative项目地址: https://gitcode.com/GitHub_Trending/hy/anarlog导读本文面向需要在 anarlog 开源仓库中新增 Tauri 插件的开发者完整梳理.agents/skills/add-plugin/SKILL.md中定义的插件生成、代码规约与仓库集成流程从tauri-apps/cli plugin new脚手架开始到以plugins/analytics为范本整理目录结构与依赖再到通过 specta 生成 TypeScript 绑定最后完成 Cargo 工作区、桌面端 Tauri 工程与能力capabilities声明的四处集成。读完本文你将能够按仓库统一规范新增一个可被apps/desktop前端直接调用的 Tauri 插件并理解每一步背后的实现依据。一、技能定位何时使用 add-plugin.agents/skills/add-plugin/SKILL.md在 frontmatter 中明确将自身定位为internal: true的内部技能适用于两类场景当需求是在plugins/目录下新增或创建插件时使用该技能完成插件生成与仓库集成当需求是把一份刚生成的插件接入项目既有约定时同样适用。反之如果需求是修改已有插件例如为plugins/analytics增加新的事件命令则不应使用本技能说明仓库对脚手架生成与存量维护做了明确的责任切分避免生成器覆盖手工改动。二、脚手架生成一条命令产出插件骨架技能给出的生成命令无需手写任何 boilerplatenpx tauri-apps/cli plugin new NAME \ --no-example \ --directory ./plugins/NAME其中NAME由 Agent 根据用户请求决定如analytics、fs-sync生成器会把它写入 crate 名、npm 包名与源码模块中。--no-example跳过示例应用--directory ./plugins/NAME把插件直接生成到仓库统一的plugins/目录下。生成后插件应立即能通过仓库根 Cargo.toml 中的 workspace 依赖例如tauri-plugin-analytics { path plugins/analytics }被引用——这正是第 5 节集成步骤之一。三、以 plugins/analytics 为范本的代码规约技能要求Follow the style and conventions used inplugins/analytics生成后需做四项清理/调整操作说明删除生成的rollup.config.js本项目不采用 rollup 打包前端绑定删除生成的README.md插件说明统一由仓库文档体系承载更新tsconfig.json改为继承仓库基础配置并限定js/目录更新package.json对齐anlg/plugin-NAME命名与 codegen 脚本以plugins/analytics为参照整理后的形态是package.jsonname: anlg/plugin-analytics、private: true、main: ./js/index.ts脚本codegen: cargo test -p tauri-plugin-analytics与typecheck: tsc --noEmit依赖仅tauri-apps/api见 plugins/analytics/package.jsontsconfig.jsonextends ../tsconfig.base.jsoninclude: [./js/*.ts]见 plugins/analytics/tsconfig.json与仓库根 tsconfig.base.json 对齐Rust 侧标准布局src/lib.rs、src/commands.rs#[tauri::command]#[specta::specta]命令、src/ext.rsRust 扩展 trait、src/error.rs、src/permissions能力描述目录与js/TypeScript 绑定目录。默认保留 ping 函数技能特别强调除非用户要求不同的命令行为否则应在ext.rs与commands.rs中同时保留生成器产出的单个ping命令。这一约定保证新插件开箱即用前端可直接调用ping验证插件注入成功后续再按需增补业务命令与plugins/analytics中event、identify、set_properties等命令同构演进。四、生成 TypeScript 绑定codegen 流程代码落位后执行绑定生成pnpm -F anlg/plugin-NAME codegen-F anlg/plugin-NAME指定 pnpm workspace 过滤目标。该脚本最终执行cargo test -p tauri-plugin-NAME其原理可从 plugins/analytics/src/lib.rs 的export_types测试看出make_specta_builder收集commands::event、commands::set_disabled等全部命令通过tauri_specta::Builder::export配合specta_typescript的 prettier formatter 输出到./js/bindings.gen.ts并自动写入// ts-nocheck头。apps/desktop侧则通过import { commands } from anlg/plugin-analytics直接使用这些绑定见 apps/desktop/src/analytics.ts 与 apps/desktop/src/auth/auth-analytics.ts。因此 codegen 本质是以测试驱动的方式导出类型新增命令后重跑该脚本即可让前端类型与 Rust 端保持一致。五、四处集成点把插件接入桌面端技能列出的集成点共四处缺一不可集成点作用analytics 实例根 Cargo.toml声明插件 crate 为 workspace 依赖tauri-plugin-analytics { path plugins/analytics }apps/desktop/src-tauri/Cargo.toml让桌面端可链接该插件tauri-plugin-analytics { workspace true }apps/desktop/package.json让前端可 import 绑定包anlg/plugin-analytics: workspace:*apps/desktop/src-tauri/capabilities/default.json为主窗口授予插件权限analytics:default能力声明Tauri 2 权限模型的关键一环最后一步常被忽略却至关重要Tauri 2 的命令调用受 capabilities 权限约束未在default.json的permissions数组中声明analytics:default即plugins/analytics/permissions/default.toml与autogenerated/commands/*.toml定义的能力集合前端调用会被拒绝。新插件需在 apps/desktop/src-tauri/capabilities/default.json 追加形如NAME:default的条目并同步维护plugins/NAME/permissions/下的能力定义。六、收尾依赖安装与验证完成apps/desktop/package.json更新后必须执行pnpm i以更新 pnpm-lock 并链接新 workspace 包。随后可依次验证pnpm -F anlg/plugin-NAME codegen生成绑定、pnpm -F anlg/plugin-NAME typecheck通过类型检查、cargo check -p tauri-plugin-NAME通过编译以及plugins/analytics中test_analytics、fire_and_forget_admission_is_bounded这类 Rust 单测见 plugins/analytics/src/lib.rs在桌面端mock_builder环境下验证插件生命周期与状态管理的范式。七、快速核对清单按.agents/skills/add-plugin/SKILL.md收尾时逐项确认npx tauri-apps/cli plugin new NAME --no-example --directory ./plugins/NAME已执行已删除生成的rollup.config.js与README.mdtsconfig.json继承../tsconfig.base.json且只包含js/package.json命名为anlg/plugin-NAME含codegen/typecheck脚本ext.rs与commands.rs保留默认ping命令pnpm -F anlg/plugin-NAME codegen已生成js/bindings.gen.ts根Cargo.toml、apps/desktop/src-tauri/Cargo.toml、apps/desktop/package.json、apps/desktop/src-tauri/capabilities/default.json四处已更新更新apps/desktop/package.json后已执行pnpm i。【免费下载链接】anarlogOpen source Granola AI Alternative项目地址: https://gitcode.com/GitHub_Trending/hy/anarlog创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
anarlog 仓库新增 Tauri 插件全流程指南add-plugin Skill 的脚手架与集成规范【免费下载链接】anarlogOpen source Granola AI Alternative项目地址: https://gitcode.com/GitHub_Trending/hy/anarlog导读本文面向需要在 anarlog 开源仓库中新增 Tauri 插件的开发者完整梳理.agents/skills/add-plugin/SKILL.md中定义的插件生成、代码规约与仓库集成流程从tauri-apps/cli plugin new脚手架开始到以plugins/analytics为范本整理目录结构与依赖再到通过 specta 生成 TypeScript 绑定最后完成 Cargo 工作区、桌面端 Tauri 工程与能力capabilities声明的四处集成。读完本文你将能够按仓库统一规范新增一个可被apps/desktop前端直接调用的 Tauri 插件并理解每一步背后的实现依据。一、技能定位何时使用 add-plugin.agents/skills/add-plugin/SKILL.md在 frontmatter 中明确将自身定位为internal: true的内部技能适用于两类场景当需求是在plugins/目录下新增或创建插件时使用该技能完成插件生成与仓库集成当需求是把一份刚生成的插件接入项目既有约定时同样适用。反之如果需求是修改已有插件例如为plugins/analytics增加新的事件命令则不应使用本技能说明仓库对脚手架生成与存量维护做了明确的责任切分避免生成器覆盖手工改动。二、脚手架生成一条命令产出插件骨架技能给出的生成命令无需手写任何 boilerplatenpx tauri-apps/cli plugin new NAME \ --no-example \ --directory ./plugins/NAME其中NAME由 Agent 根据用户请求决定如analytics、fs-sync生成器会把它写入 crate 名、npm 包名与源码模块中。--no-example跳过示例应用--directory ./plugins/NAME把插件直接生成到仓库统一的plugins/目录下。生成后插件应立即能通过仓库根 Cargo.toml 中的 workspace 依赖例如tauri-plugin-analytics { path plugins/analytics }被引用——这正是第 5 节集成步骤之一。三、以 plugins/analytics 为范本的代码规约技能要求Follow the style and conventions used inplugins/analytics生成后需做四项清理/调整操作说明删除生成的rollup.config.js本项目不采用 rollup 打包前端绑定删除生成的README.md插件说明统一由仓库文档体系承载更新tsconfig.json改为继承仓库基础配置并限定js/目录更新package.json对齐anlg/plugin-NAME命名与 codegen 脚本以plugins/analytics为参照整理后的形态是package.jsonname: anlg/plugin-analytics、private: true、main: ./js/index.ts脚本codegen: cargo test -p tauri-plugin-analytics与typecheck: tsc --noEmit依赖仅tauri-apps/api见 plugins/analytics/package.jsontsconfig.jsonextends ../tsconfig.base.jsoninclude: [./js/*.ts]见 plugins/analytics/tsconfig.json与仓库根 tsconfig.base.json 对齐Rust 侧标准布局src/lib.rs、src/commands.rs#[tauri::command]#[specta::specta]命令、src/ext.rsRust 扩展 trait、src/error.rs、src/permissions能力描述目录与js/TypeScript 绑定目录。默认保留 ping 函数技能特别强调除非用户要求不同的命令行为否则应在ext.rs与commands.rs中同时保留生成器产出的单个ping命令。这一约定保证新插件开箱即用前端可直接调用ping验证插件注入成功后续再按需增补业务命令与plugins/analytics中event、identify、set_properties等命令同构演进。四、生成 TypeScript 绑定codegen 流程代码落位后执行绑定生成pnpm -F anlg/plugin-NAME codegen-F anlg/plugin-NAME指定 pnpm workspace 过滤目标。该脚本最终执行cargo test -p tauri-plugin-NAME其原理可从 plugins/analytics/src/lib.rs 的export_types测试看出make_specta_builder收集commands::event、commands::set_disabled等全部命令通过tauri_specta::Builder::export配合specta_typescript的 prettier formatter 输出到./js/bindings.gen.ts并自动写入// ts-nocheck头。apps/desktop侧则通过import { commands } from anlg/plugin-analytics直接使用这些绑定见 apps/desktop/src/analytics.ts 与 apps/desktop/src/auth/auth-analytics.ts。因此 codegen 本质是以测试驱动的方式导出类型新增命令后重跑该脚本即可让前端类型与 Rust 端保持一致。五、四处集成点把插件接入桌面端技能列出的集成点共四处缺一不可集成点作用analytics 实例根 Cargo.toml声明插件 crate 为 workspace 依赖tauri-plugin-analytics { path plugins/analytics }apps/desktop/src-tauri/Cargo.toml让桌面端可链接该插件tauri-plugin-analytics { workspace true }apps/desktop/package.json让前端可 import 绑定包anlg/plugin-analytics: workspace:*apps/desktop/src-tauri/capabilities/default.json为主窗口授予插件权限analytics:default能力声明Tauri 2 权限模型的关键一环最后一步常被忽略却至关重要Tauri 2 的命令调用受 capabilities 权限约束未在default.json的permissions数组中声明analytics:default即plugins/analytics/permissions/default.toml与autogenerated/commands/*.toml定义的能力集合前端调用会被拒绝。新插件需在 apps/desktop/src-tauri/capabilities/default.json 追加形如NAME:default的条目并同步维护plugins/NAME/permissions/下的能力定义。六、收尾依赖安装与验证完成apps/desktop/package.json更新后必须执行pnpm i以更新 pnpm-lock 并链接新 workspace 包。随后可依次验证pnpm -F anlg/plugin-NAME codegen生成绑定、pnpm -F anlg/plugin-NAME typecheck通过类型检查、cargo check -p tauri-plugin-NAME通过编译以及plugins/analytics中test_analytics、fire_and_forget_admission_is_bounded这类 Rust 单测见 plugins/analytics/src/lib.rs在桌面端mock_builder环境下验证插件生命周期与状态管理的范式。七、快速核对清单按.agents/skills/add-plugin/SKILL.md收尾时逐项确认npx tauri-apps/cli plugin new NAME --no-example --directory ./plugins/NAME已执行已删除生成的rollup.config.js与README.mdtsconfig.json继承../tsconfig.base.json且只包含js/package.json命名为anlg/plugin-NAME含codegen/typecheck脚本ext.rs与commands.rs保留默认ping命令pnpm -F anlg/plugin-NAME codegen已生成js/bindings.gen.ts根Cargo.toml、apps/desktop/src-tauri/Cargo.toml、apps/desktop/package.json、apps/desktop/src-tauri/capabilities/default.json四处已更新更新apps/desktop/package.json后已执行pnpm i。【免费下载链接】anarlogOpen source Granola AI Alternative项目地址: https://gitcode.com/GitHub_Trending/hy/anarlog创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
