AI-first 插件开发

AI 外掛開發中心

把想法告訴 AI,SwiftBiuX Skill 會引導它選擇外掛類型、宣告最小權限、生成 manifest.json / script.js / Web UI,並打包成可安裝的 .swiftbiux 外掛。需要精細調整時,再查看模組化文檔。

左侧点模块即可直接打开正文,无需二次跳转。

用 AI 开发:展开起始 Prompt
复制给 AI 的起始 Prompt
仓库地址:
https://github.com/SwiftBiu/SwiftBiuX-Template

阅读 SwiftBiuX Skill:
https://raw.githubusercontent.com/SwiftBiu/SwiftBiuX-Template/main/AI_SKILL.md

打包脚本:
https://github.com/SwiftBiu/SwiftBiuX-Template/blob/main/scripts/build_plugin.sh

请帮我创建一个 SwiftBiu 插件:
插件名称:
输入类型:选中文本 / 选中文件 / 手动输入 / Web UI
功能目标:
输出方式:粘贴回原处 / 复制到剪贴板 / 显示通知 / 保存文件 / 打开窗口

要求:
- 自动选择 textAction 或 fileAction
- 只声明必要权限
- 生成 manifest.json 和 script.js
- 如果需要界面,再生成 ui/index.html
- 完成后在 SwiftBiuX-Template 仓库根目录运行 ./scripts/build_plugin.sh <插件目录>

先看一遍,再動手

先走通流程,再深入 API。

看清擴充功能在用戶端的原始碼安裝與設定入口,再結合 API 參考完成實作。

真實截圖導覽0:08

從 Manifest 到一次動作

跟著 HelloText 範例,理解 textAction 宣告、選取範圍輸入和結果寫回。

用戶端真實介面截圖與範例設定;藍框為教學標註。

繼續閱讀參考文件
真實截圖導覽0:30

授權資料夾並壓縮圖片

授權工作資料夾,選取圖片壓縮並查看產生的檔案。

系統授權視窗及 Finder 使用真實簡體中文截圖。示範在隔離範例資料夾中執行實際壓縮;輸出格式與位置依設定而定。

繼續閱讀參考文件

选择入口

你现在想做什么?

推荐流程

AI 开发三步

  1. 01

    描述想法

    告诉 AI 输入是什么、要做什么、结果放到哪里。

  2. 02

    读取 Skill

    AI 根据 SwiftBiuX Skill 选择架构、权限和最小文档上下文。

  3. 03

    生成插件

    输出 manifest.json、script.js、可选 Web UI,并打包 .swiftbiux。

SwiftBiu 1.3.9 · 原生运行入口

一次开发,在用户需要的位置出现

同一个扩展可以响应选中文字、剪切板内容、OCR 结果和文件输入。宿主会按内容类型分发动作;开发者只需定义能力、图标和所需权限。

文档结构

概覽

这里与左侧主菜单一一对应。左侧负责跨页面导航,右侧只显示当前页面目录。

开发插件

从 AI 快速开始、常见场景到完整示例,完成第一个插件。

API 与界面

区分后台 API、原生工作流、Web UI、翻译引擎与平台兼容能力。

测试与发布

查看日志、排查问题,并选择正确的 Stable 或 Beta 发布通道。

参考与帮助

集中查看最佳实践、常见问题和容易忽略的开发细节。