跳到主要內容

命令參考

本參考列出了 AIGNE WebSmith CLI 的所有可用命令，包括別名、參數和使用範例。

CLI 操作的標準語法如下：

Run Command

bash
aigne web <command> [subcommand] [parameters]

執行 aigne web 而不帶指令將會啟動互動模式。

主要指令

下表總結了主要的指令。每個指令在以下各節中都有更詳細的說明。

指令別名描述
generategen, g根據設定檔產生一個完整的網站。
publishpub, p將產生的網站發布到 Pages Kit 執行個體。
updateup根據使用者回饋修改現有網站內容。
translate將網站頁面翻譯成不同語言。
theme管理網站視覺主題，包括產生和套用。
componentcomp管理用於建構網站的元件庫。
chat啟動互動模式以進行網站管理（預設）。
prefs管理從回饋中學習到的已儲存使用者偏好設定。
history顯示對網站所做的先前更新日誌。
clear移除產生的檔案、工作區資料或設定。

generate

generate 指令負責協調建立一個完整的網站，從規劃網站結構到根據指定的設定檔產生頁面內容和範本。

別名： gen, g

用法：

生成

bash
aigne web generate

參數：

  • config string — 指定網站設定的檔案路徑。這通常是自動提供的。
  • glossary string — 詞彙檔案的路徑，以確保術語一致。使用格式 @。
  • forceRegenerate boolean — 強制重新產生所有頁面，覆寫任何現有的已產生內容。

publish

publish 指令會將產生的網站檔案上傳到 Pages Kit 執行個體。它管理批次上傳過程並提供狀態監控。

別名： pub, p

用法：

發布

bash
aigne web publish --appUrl "https://example.com"

參數：

  • appUrl string — 將要發布頁面的目標 Pages Kit 網站的基礎 URL。
  • with-navigations string (default: menu) — 發布導覽資料。可接受的值為 'flat' 或 'menu'。
  • with-locales boolean — 設定為 true 時，發布網站的地區設定和語言設定。

update

update 指令根據使用者提供的回饋修改現有網站的內容。它可用於修改文字、新增或移除區塊，或變更頁面結構。

別名： up

用法：

更新

bash
aigne web update --pages "/about" --feedback "Add a mission statement."

參數：

  • pages array — 要更新的頁面路徑陣列（例如：[\
  • feedback string — 對指定頁面所需變更或改進的描述。
  • glossary string — 詞彙檔案的路徑，以確保術語一致。使用格式 @。

translate

translate 指令將現有網站頁面的內容翻譯成一種或多種指定語言。

用法：

翻譯

bash
aigne web translate --pages "/home" --langs "fr,de,es"

參數：

  • pages array — 要翻譯的頁面路徑陣列。
  • langs array — 語言代碼的陣列。可用語言：en, zh, zh-TW, ja, fr, de, es, it, ru, ko, pt, ar。
  • feedback string — 用於指導和改善翻譯品質的具體說明。
  • glossary string — 詞彙檔案的路徑，以確保翻譯一致。使用格式 @。

theme

theme 指令管理網站的視覺主題，包括其產生和套用。

子指令

generate 根據網站的設計和使用者建議產生一個新主題。

別名： gen

用法：

主題生成

bash
aigne web theme generate --name "CustomTheme"
  • name string — 新主題的名稱。
  • config string — 用作主題基礎的網站設定檔案路徑。

apply 將先前產生的主題套用到網站上。

別名： a

用法：

Apply Theme

bash
aigne web theme apply

此子指令沒有任何特定參數。它會套用目前設定的主題。

component

component 指令管理網站的元件庫。

別名： comp

子指令

pull 從指定的 URL 拉取元件以更新本地元件庫。

用法：

元件拉取

bash
aigne web component pull --url "https://your-pages-kit/api/..."
  • url string (required) — 要從中拉取元件庫的完整 URL。

list 列出目前元件庫中可用的元件。

別名： ls, l

用法：

Component List

bash
aigne web component list

此子指令不接受任何參數。

chat

chat 指令啟動一個互動式會話，以對話方式產生、更新和管理網站。這是執行 aigne web 而未指定其他指令時執行的預設指令。

用法：

Command

bash
aigne web

此指令不接受任何參數。

prefs

prefs 指令管理 WebSmith 從回饋中學習到的使用者偏好設定，以自訂 AI 行為。

子指令

list 列出所有已儲存的使用者偏好設定。

別名： ls

用法：

List Preferences

bash
aigne web prefs list

此子指令不接受任何參數。

remove 移除一個或多個指定的偏好設定。

別名： rm

用法：

移除偏好

bash
aigne web prefs remove --id "pref_abc123"
  • id array (required) — 要移除的偏好設定 ID 陣列。

toggle 切換一個或多個偏好設定的啟用狀態。

別名： t

用法：

切換偏好

bash
aigne web prefs toggle --id "pref_abc123"
  • id array (required) — 將要切換狀態的偏好設定 ID 陣列。

history

history 指令用於查看網站內容和結構的更新歷史。

子指令

view 以緊湊的日誌樣式格式顯示更新歷史。每個條目包括一個雜湊值、日期、操作以及相關的回饋。

別名： log, list

用法：

查看歷史

bash
aigne web history view

此子指令不接受任何參數。

clear

clear 指令從專案目錄中移除產生的檔案、工作區資料或設定。

用法：

清除

bash
aigne web clear --targets "generatedPages" "websiteConfig"

參數：

  • targets array — 要清除而無需提示的項目陣列。有效項目為：websiteStructure, generatedPages, websiteConfig, deploymentConfig, authTokens, mediaDescription, translationCaches。
  • pagesDir string — 覆寫來源頁面的預設目錄路徑。
  • tmpDir string — 覆寫暫存工作區的預設目錄路徑。
  • outputDir string — 覆寫已產生頁面的預設目錄路徑。
  • configPath string — 覆寫設定檔的預設路徑。

總結

本參考指南詳細介紹了 AIGNE WebSmith CLI 的主要指令和參數。如需以任務為導向的說明，請參閱文件中的指南部分。