安裝外掛

EmDash 外掛可以透過兩種方式安裝：從市場透過後台儀表板安裝，或直接在 Astro 組態中新增。市場外掛在隔離的沙盒中執行；基於組態的外掛在處理程序中執行。

從市場安裝

後台儀表板包含一個市場瀏覽器，你可以在其中搜尋、安裝和管理外掛。

前提條件

要安裝市場外掛，你的網站需要：

1. 設定沙盒執行器 — 市場外掛在隔離的 V8 worker 中執行，這需要沙盒執行時：

   import { emdash } from "emdash/astro";
   
   export default defineConfig({
     integrations: [
       emdash({
         marketplace: "https://marketplace.emdashcms.com",
         sandboxRunner: true,
       }),
     ],
   });

2. 後台存取權限 — 只有管理員可以安裝或刪除外掛。

瀏覽和安裝

外掛將被下載，儲存在你網站的 R2 bucket 中，並載入到沙盒執行器中。它立即生效。

功能同意

在安裝之前，你會看到一個對話方塊，列出外掛需要存取的內容：

安全稽核

市場中的每個外掛版本都經過了自動安全稽核。稽核結果顯示在外掛卡片上：

• 通過 — 未發現問題
• 警告 — 標記了小問題（檢視詳情）
• 失敗 — 偵測到嚴重的安全問題

你可以在外掛的詳細資訊頁面上檢視完整的稽核報告，包括各個發現及其嚴重性。

更新

當已安裝外掛有新版本可用時：

1. 轉到後台面板中的 外掛
2. 市場外掛顯示 有可用更新 徽章
3. 點選 更新 檢視變更日誌和任何功能變更
4. 如果新版本需要額外的功能，你會看到差異並需要核准
5. 確認以更新

解除安裝

1. 轉到後台面板中的 外掛
2. 點選要移除的市場外掛
3. 點選 解除安裝
4. 選擇是保留還是刪除外掛的儲存資料
5. 確認

外掛的沙盒程式碼將從你的 R2 bucket 中刪除，並立即停止執行。

從組態安裝

對於原生外掛（你自己的程式碼，或透過 npm 安裝的套件），直接將它們新增到你的 Astro 組態中：

import { defineConfig } from "astro/config";
import { emdash } from "emdash/astro";
import seoPlugin from "@emdash-cms/plugin-seo";

export default defineConfig({
  integrations: [
    emdash({
      plugins: [
        seoPlugin({ generateSitemap: true }),
      ],
    }),
  ],
});

原生外掛：

• 在處理程序中執行（不沙盒化）
• 擁有對 Node.js API 的完全存取權限
• 在建置時和每次伺服器啟動時載入
• 無法從後台 UI 安裝或移除

市場與組態：何時使用哪個