Propcore catalog
將你 Propcore 工作區中的專案、單位和即時可用狀況帶到你的 EmDash 網站。
外掛
Propcore catalog
將你 Propcore 工作區中的專案、單位和即時可用狀況帶到你的 EmDash 網站。
說明
你的 Propcore 專案、單位和即時可用狀況，直接呈現在 EmDash 網站中。從 EmDash 註冊表安裝，輸入你的 Propcore 網站 slug 和來源金鑰，你的頁面就可以透過三條路由讀取目錄。projects 最多回傳 100 個專案。units 每頁回傳 100 個單位；傳入 cursor= 可取得下一頁。availability 每次呼叫都會向 Propcore 發出一次即時請求，並且僅適用於已同步的專案。同步會在一次請求中讀取整個目錄；已用 119 個單位進行測試，更大的目錄已在規劃中。
路由
GET /_emdash/api/plugins/propcore/projects GET /_emdash/api/plugins/propcore/units?project= GET /_emdash/api/plugins/propcore/availability?project= (live)
回應為 “。欄位與 Propcore 回傳的完全一致（snake_case）。
安裝
- 在 Propcore Admin 中，依序進入 Storefronts、New，然後選擇 AI Source。選取要公開的 Views，建立後，從抽屜面板中複製網站 slug 和來源金鑰。slug 是
.propcore.page之前的部分。位於工作區子網域下的網站，其 slug 帶有點號，例如astra-demo.demo.propcore.page對應astra-demo.demo。 - 在 EmDash 管理後台中，進入 Plugins，然後進入 Registry。安裝 Propcore catalog 並核准其能力（對
*.propcore.page的網路存取）。 - 在管理後台側邊欄中開啟 Propcore，輸入 slug 和金鑰，Save，然後點擊 Sync now。此後外掛每小時同步一次。
常見問題
金鑰會被洩露嗎？ 不會。它以加密方式儲存，只傳送到你的 Propcore 網站，任何路由都不會回傳它。
某個單位已從 Propcore 中消失，但仍在我的網站上。 每小時同步會新增和更新單位。在 Propcore 中被移除的單位目前尚不會從網站快取中刪除；這已在規劃中。
需要哪種 Propcore 方案？ 任何帶有 storefronts 的工作區。
“Sync now” 與每小時同步有區別嗎？ 沒有，它只是立即執行同一個同步。
疑難排解
儲存失敗，或金鑰未被儲存。 網站需要 EMDASH_ENCRYPTION_KEY 環境變數（格式為 emdash_enc_v1_...）來儲存機密設定。請在網站的環境中設定它。使用 astro dev 時，.env 檔案不會被載入到處理程序中，因此請先匯出它：set -a; . ./.env; set +a; pnpm dev。
沙盒外掛無法啟動。 沙盒外掛執行在 workerd 套件上。使用 pnpm 時，請允許其建置指令碼（allowBuilds: ）並安裝它。
本機 pnpm add file: 安裝已過時。 file: 會複製外掛而不是連結它。每次建置後請重新加入。
狀態顯示 401 ...。 來源金鑰已被輪替或撤銷。請貼上新金鑰並 Save。
我應該輸入哪個 slug？ .propcore.page 之前的部分，例如 astra-demo.demo。貼上的網址會自動為你縮短。