安装插件

EmDash 插件可以通过两种方式安装：通过管理仪表板从市场安装，或直接在 Astro 配置中添加。市场插件始终在沙箱中运行；基于配置的插件根据声明的数组（sandboxed: [] vs plugins: []）在沙箱或进程内运行。

从市场安装

管理仪表板包含一个市场浏览器，您可以在其中搜索、安装和管理插件。

前提条件

要安装市场插件，您的站点需要：

1. 配置沙箱运行器 — 市场插件在隔离的运行时中运行，需要沙箱运行器。以下配置启用它：

   import { defineConfig } from "astro/config";
   import emdash from "emdash/astro";
   
   export default defineConfig({
     integrations: [
       emdash({
         marketplace: "https://marketplace.emdashcms.com",
         sandboxRunner: "@emdash-cms/sandbox-cloudflare",
       }),
     ],
   });

   在 Cloudflare Workers 上，沙箱使用 Dynamic Worker Loader API（无需额外设置）。在 Node.js 上，安装 workerd 沙箱运行器：

   npm install @emdash-cms/sandbox-workerd

   然后显式传递运行器：

   emdash({
     marketplace: "https://marketplace.emdashcms.com",
     sandboxRunner: "@emdash-cms/sandbox-workerd/sandbox",
   })

   在开发中，安装 miniflare 作为开发依赖以加快沙箱启动：

   npm install -D miniflare

2. 管理员访问 — 只有管理员可以安装或移除插件。

浏览和安装

插件将被下载、存储在您站点的 R2 存储桶中，并加载到沙箱运行器中。它会立即激活。

能力同意

安装前，您将看到一个对话框，列出插件需要访问的内容：

安全审计

市场中的每个插件版本都经过了自动安全审计。审计结果显示在插件卡片上：

• 通过 — 未发现问题
• 警告 — 标记了轻微问题（请查看发现结果）
• 未通过 — 检测到重大安全问题

您可以在插件的详情页查看完整的审计报告，包括各项发现及其严重程度。

更新

当已安装插件有新版本时：

1. 在管理面板中转到 插件
2. 市场插件显示 有可用更新 标记
3. 点击 更新 查看变更日志和任何能力变化
4. 如果新版本需要额外能力，您将看到差异并需要批准
5. 确认更新

卸载

1. 在管理面板中转到 插件
2. 点击要移除的市场插件
3. 点击 卸载
4. 选择是保留还是删除插件的存储数据
5. 确认

插件的沙箱代码将从您的 R2 存储桶中移除，并立即停止运行。

从配置安装

原生插件 — 您自己的代码或通过 npm 安装的包 — 直接添加到 Astro 配置中。以下示例注册 SEO 插件：

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 安装或移除

市场 vs. 配置 — 何时使用哪个