實用比較：安裝、預覽、部署與擴充

本頁比較開發者需要實際操作的命令和檔案，不把一次 benchmark 執行變成普遍排名。表中的命令來自各專案官方文件；Pageskill 命令以本倉庫目前 CLI 為準。

Pageskill 的定位是重用優先：人可以直接使用現成 Pattern、Block 與 Schema，Agent 只是可選的發現助手，頁面作者不必逐頁手寫 HTML。只有目錄確實缺少能力時，才在主題中實作一次可重用擴充。

最短可執行路徑

工具	安裝 / 啟動	本機預覽	生產建置	擴充入口
Pageskill	`npm install`；`npm link`；`pageskill init`	`pageskill s`	`pageskill g` → `dist/public` 公開 snapshot	`themes/<name>/theme.ts`、`theme.yml`、`style.css`、外掛開關
Astro	`npm create astro@latest`	`npm run dev`	`npm run build` → `dist/`	`.astro` 頁面、元件、integrations
Eleventy	`npm install @11ty/eleventy`；`npx @11ty/eleventy --serve`	`npx @11ty/eleventy --serve`	`npx @11ty/eleventy` → `_site/`	範本、shortcodes、Data Cascade
Hugo	安裝 Hugo；`hugo new site`	`hugo server`	`hugo` → `public/`	`layouts/`、shortcodes、modules、resources
VitePress	`npx vitepress init`	`npm run docs:dev`	`npm run docs:build` → `.vitepress/dist/`	Vue 主題、Markdown 中的 Vue 元件
Docusaurus	`npm init docusaurus@latest my-website classic`	`npm run start`	`npm run build` → `build/`	React 主題、plugins、MDX

輸出邊界是部署事實，不是外觀細節：公開 snapshot 位於 dist/public，目標專用的 server 或 Worker 檔案保持私有。Pageskill 從 config.yml 讀取部署目的地。靜態生成是預設渲染方式：一般內容預先產生，需要互動時再呼叫同一個 Worker/Fetch 服務提供的同源 API。單個 Worker/Fetch 服務可以同時承載生成頁面與同源動態 API；/api/* 預設由 Worker 優先處理，其他動態路徑寫入 deployment.dynamicRoutes。不要把含有私有程式碼的建置輸出作為 CDN、Caddy、Nginx 或 GitHub Pages 的公開根目錄。server/、_pagekiln/、.pagekiln/、Worker 檔案和 *.toml 必須留在私有目錄，秘密只在執行時讀取。

Pageskill 任務配方

安裝新網站

npm install
npm run compile-runtime
npm run compile-theme
npm run compile-backend
npm link
pageskill init
pageskill check

Starter 是真實原始碼目錄。它的 config.yml、content/ 和 themes/ 展示 CLI 複製的契約。

預覽並編輯

pageskill s
pageskill s --port=4174

預覽服務監看 config.yml、content/ 和 themes/。Markdown、CSS 或主題編輯會觸發重建和瀏覽器重新整理，診斷錯誤後程序仍保持執行。

部署

deployment:
  targets: [cloudflare-pages, github-pages, vps]
  cloudflare:
    apiTokenEnv: CLOUDFLARE_API_TOKEN
    pages:
      project: example-site
      branch: production
  github:
    remote: origin
    branch: gh-pages
    tokenEnv: GITHUB_TOKEN
  vps:
    host: vps.example.com
    user: deploy
    port: 22
    remotePath: /var/www/example-site
    identityFile: ~/.ssh/id_ed25519

pageskill d --dry-run
pageskill d

支援的 connector 是 cloudflare-pages、cloudflare-workers、github-pages、vps 和可選的 openai-sites handoff。Token 放在環境變數中。VPS 使用本機 SSH agent 或既有私鑰認證，伺服器必須已授權對應公鑰。GitHub Pages 只發佈 dist/public snapshot，不執行 API；動態 VPS 後端應安裝在私有服務目錄。Workers 使用 assets.directory: public，.assetsignore 是額外的排除層；Cloudflare Pages 使用目標專用的部署整理，公開靜態上傳只包含公開資源。Worker/Fetch 服務可以同時提供生成頁面與同源動態 API；/api/* 預設由 Worker 優先處理，其他動態路徑寫入 deployment.dynamicRoutes。

開發 Block

content/pages/guide/zh-tw.md   目前說明
themes/default/theme.ts        Block 渲染器和 schema
themes/default/theme.yml       Block/資源註冊
themes/default/style.css       單一視覺來源

透過 defineTheme 實作 Block，在 theme.yml 註冊，用 Markdown 指令呼叫，再執行：

npm run compile-theme
pageskill catalog
pageskill inspect block:hero
pageskill check
pageskill g

完整範例和安全邊界見二次開發。

各工具需要維護什麼

Pageskill

內容身份明確：content/pages/<id>/<locale>.md 是目前網站內容，content/posts/<id>/<locale>.md 是帶必填 date 的產品筆記。docs 是 pages 內的 Pattern，不是並列 collection。config.yml 負責網站設定和部署目的地；複製的主題負責 Pattern、Block、CSS、瀏覽器 ESM 和外掛呈現。

Astro

Astro官方安裝文件從 npm create astro@latest 開始；開發與建置文件使用 npm run dev 和 npm run build。.astro 頁面、元件、integrations 和 content collections 構成擴充面。需要元件和 integrations 作為主要開發方式時，使用這條路徑。

Eleventy

Eleventy官網展示 Markdown、範本、npx @11ty/eleventy --serve 和 _site/；Data Cascade與Collections是主要組織面。需要多種範本語言和資料組合時，使用這條路徑。

Hugo

Hugo快速開始使用 hugo new site、hugo server 和 hugo，輸出為 public/；內容組織和shortcodes把結構放進內容樹和版面。需要 sections、taxonomies、範本和原生二進位檔時，使用這條路徑。

VitePress

VitePress入門文件使用 npx vitepress init、npm run docs:dev 和 npm run docs:build；在 Markdown 中使用 Vue讓 Vue 元件和用戶端行為成為文件創作的一部分。文件站本身就是 Vue 應用程式時，使用這條路徑。

Docusaurus

Docusaurus安裝文件使用 React starter、npm run start 和 npm run build；i18n 文件處理 locale 目錄以及主題和外掛翻譯。需要 docs sidebar、版本、MDX 和 React plugins 時，使用這條路徑。

按下一個具體任務選擇

需要 Markdown 優先的產品站，並且要明確區分目前頁面、有日期產品筆記、語言、搜尋、歸檔、sitemap 和靜態部署：使用 Pageskill，從 Guide 開始。
需要 .astro 元件或 integrations 生態：使用 Astro starter。
需要範本語言選擇和 Data Cascade：使用 Eleventy starter。
需要 sections、taxonomies、shortcodes 和原生二進位檔：使用 Hugo 快速開始。
需要在文件中使用 Vue 元件：使用 VitePress。
需要帶 sidebar、版本和外掛翻譯的 React/MDX 文件：使用 Docusaurus。

選擇應跟隨下一個需要編寫的檔案。對 Pageskill 來說，目前用法寫入 content/pages/，有日期的變化寫入 content/posts/，新 Block 寫入 themes/<name>/theme.ts。