外掛

說明如何安裝與管理為編輯器增加功能的外掛，以及製作並上傳外掛的開發者頁面。在編輯器中使用外掛的方法，請參閱「編輯器外掛」文件。

外掛分頁

儀表板的外掛程式分頁用於管理已安裝的外掛，新外掛請到作品集尋找。

• 我的外掛程式——我安裝的外掛。會顯示名稱、版本、開發者和該外掛使用的權限，右側有開啟/關閉開關和刪除按鈕（垃圾桶）。
• 作品集 › 外掛——經過審查後公開的外掛卡片。可從分頁右上角的瀏覽外掛連結或頁首的作品集進入（不必登入即可瀏覽）。外掛本身目前全部免費，但安裝需要付費方案（Starter 或 Pro）。免費方案下，詳細資料視窗中的安裝按鈕會呈灰色，並附上方案說明。方案到期後，已安裝的外掛也不會在編輯器中載入；它們仍留在清單中，升級到付費方案後即可立即再次使用。已安裝的卡片會標示已安裝。

安裝不是下載檔案，而是綁定到帳號。安裝並開啟的外掛會在每次開啟編輯器時載入，因此不論在哪台電腦登入，都有相同的外掛。已經開啟的編輯器不會立刻出現，請重新整理分頁或重新開啟版面。

相關問題

• 外掛要在哪裡安裝？
• 可以加裝擴充功能嗎？
• 外掛要付費嗎？

安裝外掛

1. 在作品集 › 外掛中按一下卡片，會開啟詳細資料視窗。
2. 確認開發者、版本、所需編輯器、價格與此外掛程式可以做什麼清單。
3. 按安裝。若是會連線到外部伺服器的外掛，按鈕會是同意並安裝（見下方「連線到外部伺服器的外掛」）。
4. 出現在我的外掛程式中就完成了。重新開啟編輯器時，外掛就會在裡面。

標有所需編輯器的外掛，只會在該版本以上的編輯器中載入。若帳號選擇的編輯器版本比它低，請在版面作業設定中提高版本（「儀表板」文件的「編輯器版本」）。

相關問題

• 外掛裝好了，編輯器裡卻沒有
• 怎麼安裝外掛？
• 「需要的編輯器」是什麼意思？

權限

外掛只能做詳細資料視窗中列出的權限範圍內的事。權限如下：

• 讀取版面——讀取開啟中版面的頁面、物件、文字內容。
• 修改版面——建立、修改或刪除物件、文字、圖片、頁面。所有變更都能還原，也會照常儲存。
• 選取——得知目前選取的物件，並變更選取。
• 介面——在編輯器中加入工具按鈕、選單、面板、對話框。
• 儲存設定——將該外掛的設定儲存在我的帳號中（最多 64KB）。
• 外部伺服器連線——權限名稱後面會附上伺服器位址。可與該伺服器交換資料。

外掛在與編輯器分開的隔離環境（沙箱）中執行。它碰不到我的登入資訊、其他版面和編輯器畫面；沒有外部伺服器連線權限的外掛完全無法連上網路。外掛顯示的面板和視窗也只在另外隔離的視窗中繪製。

相關問題

• 外掛可以隨意看我的版面嗎？
• 外掛的權限是什麼意思？
• 外掛會拿走我的帳號資料嗎？

連線到外部伺服器的外掛

具有外部伺服器連線權限的外掛（例如從商品資訊服務取得資料來填入版面的外掛），詳細資料視窗中會一併顯示警告。「此外掛程式可以將版面內容傳送到以下伺服器：」下方列有伺服器位址和開發者的隱私權政策連結。

• 只能連線到列出的伺服器，無法傳送任何東西到其他位址。
• 連線後版面內容可能會傳到該伺服器，因此請閱讀伺服器位址和隱私權政策，確認可信任後才按同意並安裝。

相關問題

• 外部伺服器連線權限危險嗎？
• 外掛會上網嗎？
• 「同意並安裝」是什麼？

開啟、關閉與刪除

• 關閉開關後，從下次開啟編輯器起就不再載入該外掛。重新開啟就會再次載入。
• 按刪除並確認後，就會從我的外掛程式中移除。用該外掛建立的物件會原樣留在版面中，以儲存的樣子顯示和列印（「編輯器外掛」文件的「外掛物件」）。
• 標有已被管理員封鎖的外掛是管理員封鎖的，無法開啟，編輯器也不會載入。沒有可用版本表示目前沒有公開的版本。

相關問題

• 想暫時停用外掛
• 刪除外掛後，用它做的物件會怎樣？
• 顯示被管理員封鎖

升級外掛

已安裝的外掛會一直使用安裝時的版本。開發者上傳新版本並通過審核後，外掛不會自動切換，只有自己升級後才會使用新版本。

1. 有新版本時，我的外掛程式中該外掛下方會顯示新版本號的提示。若新版本使用的權限比目前版本多，提示中也會說明需要新權限。編輯器的外掛選單中也會出現可以升級的項目。
2. 按升級，升級外掛程式視窗會顯示目前版本號、新版本號與新使用的權限。
3. 按升級後，下次開啟編輯器時開始載入新版本。

不升級時，編輯器會繼續載入目前使用的版本。若目前版本被撤回，會使用比它低的版本中最高的一個；只有沒有更低版本時才會使用最接近的新版本。

相關問題

• 外掛會自動更新嗎？
• 要怎麼使用外掛的新版本？
• 不升級的話外掛還能用嗎？

外掛開發者頁面

若要自己製作並上傳外掛，請前往我的帳號左側選單下方的開發者。

1. 一開始會看到申請成為開發者表單。填寫顯示名稱（在商店中以開發者身分顯示的名稱）和聯絡方式（電子郵件或網址），同意開發者條款後按申請。
2. 管理員確認後，結果會以通知送達。若被退回，可以修改內容後重新申請。
3. 核准後，此頁面會顯示開始使用。用下載 SDK下載 SDK（zip）。其中包含工具、型別定義、範例和開發者指南（README.md），需要 Node 18 以上。
4. 在自己的電腦上製作外掛並啟動 SDK 的開發伺服器，再在編輯器網址後面加上 pluginDev 開啟，就能立刻測試該外掛（僅限已核准的開發者帳號和這台電腦（localhost））。用 --open 啟動開發伺服器時，編輯器會免登入開啟一個不向伺服器儲存任何內容的新測試版面（沙盒編輯器）。AI 代理可以透過終端機指令在該編輯器中執行指令並取回頁面圖像確認。詳細指令請看開始使用的步驟和 SDK 內的 README.md。
5. 完成後用 SDK 建立 zip，以上傳版本的上傳 zip上傳（5MB、200 個檔案以內）。上傳的版本會留在草稿狀態。
6. 在版本清單中按申請審核，管理員就會審查。審查期間無法修改或刪除該版本。核准、退回的結果和審查備註會以通知送達，也會顯示在版本清單中。
7. 核准後會公開在作品集 › 外掛中。用在商店中顯示開關決定是否在商店中顯示。

要修改時，請提高版本號碼以新版本上傳，並再次接受審查。外掛 API、外部伺服器連線權限、審查標準都寫在 SDK 內的 README.md 中。

相關問題

• 可以自己寫外掛嗎？
• 外掛開發者要在哪裡申請？
• SDK 要去哪裡下載？
• 做好的外掛要怎麼上架到商店？