用途:在 XerahS 桌面端新增一个符合当前插件架构的上传目标插件,而非配置已有插件。
主要能力:指导完成服务与鉴权调研、选择最接近的现有插件作为起点(如 Bitly.Plugin 用于简单令牌配置、Dropbox.Plugin 用于浏览器登录或 OAuth、AmazonS3.Plugin 或 Nextcloud.Plugin 用于文件存储与资源管理器),再用脚手架生成插件骨架并填入服务逻辑。
使用方式:运行 .ai\skills\create-uploader-plugin\scripts\new-uploader-plugin.ps1 并传入 -PluginName、-PluginId、-DisplayName、-AddToSolution,生成 src/desktop/plugins/MyService.Plugin/ 目录下的 csproj、plugin.json、配置模型、提供程序、上传器及 Avalonia 配置视图与 ViewModel。约定要求插件置于 src/desktop/plugins/<Name>.Plugin/,目标框架 net10.0,复用 Directory.Build.props,命名空间用 ShareX.<Name>.Plugin、程序集名用 XerahS.<Name>.Plugin,共享依赖设 ExcludeAssets=runtime,复制 plugin.json,凭据经 ISecretStore 保存,旧明文设置实现 IInstanceSecretMigrator。实现时通常继承 UploaderProviderBase,由 CreateInstance 返回 Uploader 或 GenericUploader,按需重写 CreateConfigView()/CreateConfigViewModel(),仅在服务支持远程列表/内容操作时实现 IUploaderExplorer。
验证:分别构建插件工程与 src/desktop/XerahS.sln,并在完成前对照 references/review-checklist.md。配置界面的 Avalonia 控件、绑定与样式规则参见 ../avalonia-guidelines/SKILL.md。