ReadAware

發布外掛程式

公開外掛程式儲存庫 承載市場套件並透過合併請求接受變更。準備提交時,請依照其目前的貢獻說明與驗證器操作。

配合您支援的應用程式

開發目錄可能領先最新發布的應用程式。請同時核對公開宣告與目標應用程式。需要新功能的套件必須等待相容的主程式發布,或明確鎖定相符的開發版本;僅變更 minAppVersion 並不會建立缺少的 API。

使用 功能總覽 檢查方法與版本,然後宣告您實際測試過的最小相容集合。

讓套件可受審查

提交 manifest.json、可讀的原始碼、建置後的獨立 main.js,以及所需的執行時期資源。保持資料夾名稱與清單 ID 相同。請勿載入遠端可執行程式碼,或依賴套件之外的檔案。

tree
plugins/my-plugin/
  manifest.json
  main.js
  package.json
  tsconfig.json
  src/main.ts
  assets/

檢查行為與權限

  • 說明功能、其進入點,以及每個權限的必要原因。
  • 宣告確切的 Settings 授權與所需的網路來源。說明哪些資料會傳送至外部服務。
  • 測試書籍範圍、缺少權限、取消、停用/重新啟用,以及實際的桌面 UI。
  • 保持啟用為宣告式,遷移僅限儲存。
  • 檢查私人資料保留、配額,以及作用中資源的清理。
  • 對於更新,請以真實資料演練現有安裝,包括失敗的遷移與復原。

本機清單預覽有助於找出相容性與權限錯誤。它不能取代儲存庫驗證器、桌面測試或審查。

建置並提交

遵循簽出儲存庫中的腳本。公開儲存庫的套件檢查如下:

bash
bun run build
bun run typecheck
bun test
bun run validate

依照儲存庫目前的結構與排序,加入相符的註冊表項目。開啟合併請求,說明最終行為、測試過的應用程式與功能版本、私人資料、外部服務及權限變更。附上可重現的驗證步驟。

更新

在清單與註冊表中遞增套件版本。僅在私人資料結構變更時變更 schemaVersion,並在同一個套件中附上其遷移。要求更多權限時,需要清楚的說明與可用的拒絕途徑。

簽署、發布者身分、套件完整性、審查來源追溯與撤銷是各自獨立的發布考量。請說明實際適用於套件的控管措施;僅靠 Worker 隔離並不能保證任意程式碼的安全。

建立外掛程式 · API 參考