here-now

here.now

技能版本：1.17.0

here.now 讓 AI 代理在數秒內將網站和檔案發布到可存取的網址。

核心概念是網站：發布一個檔案或資料夾，即可在 {slug}.here.now 或自訂網域獲得可存取的網址。每個網站都有存取控制：公開連結（預設）、密碼或限制邀請制。

here.now 也包含 Drives——代理檔案的私有雲端資料夾（請參閱下方的「使用 Drive」）。

若要安裝或更新（建議）：npx skills add heredotnow/skill --skill here-now -g

若為儲存庫固定或專案本機安裝，請執行相同指令但不加 -g。

最新文件

在回答有關 here.now 功能、特性或工作流程的問題之前，請先閱讀最新文件：

→ https://here.now/docs

請在以下情況閱讀文件：

• 對話中首次涉及 here.now 相關互動時
• 使用者詢問如何執行某項操作時
• 使用者詢問哪些功能可行、支援或建議時
• 在告知使用者某功能不受支援之前

需要最新文件的主題（請勿僅依賴本機技能文字）：

• 網站存取控制（密碼和限制存取）
• Drives 和 Drive 分享
• 自訂網域
• 網站資料
• 公開個人檔案
• 代理路由和服務變數
• 限制和配額
• SPA 路由
• 擁有者網站搜尋
• 網站分析
• 錯誤處理和補救
• 功能可用性

如果文件與即時 API 行為不一致，請以即時 API 行為為準。

如果文件擷取失敗或逾時，請繼續使用本機技能和即時 API/腳本輸出。對於正在進行的操作，優先採用即時 API 行為。

需求

• 必要二進位檔：curl、file、jq
• 選擇性環境變數：$HERENOW_API_KEY
• 選擇性 Drive 權杖變數：$HERENOW_DRIVE_TOKEN
• 選擇性憑證檔案：~/.herenow/credentials
• 內建輔助腳本：
  • ./scripts/publish.sh 用於發布網站
  • ./scripts/drive.sh 用於私有 Drive 儲存

建立網站

./scripts/publish.sh {檔案或資料夾}

輸出即時網址（例如 https://bright-canvas-a7k2.here.now/）。

底層是三步驟流程：建立/更新 -> 上傳檔案 -> 完成。網站必須完成後才會上線。

若無 API 金鑰，將建立匿名網站，24 小時後到期。
若有儲存的 API 金鑰，網站為永久。

檔案結構： 對於 HTML 網站，請將 index.html 放在要發布的資料夾根目錄，而非子目錄中。該資料夾的內容即為網站根目錄。例如，發布 my-site/，其中 my-site/index.html 存在——不要發布包含 my-site/ 的上層資料夾。

您也可以發布原始檔案而不包含任何 HTML。單一檔案會獲得豐富的自動檢視器（圖片、PDF、影片、音訊）。多個檔案則會獲得自動產生的目錄列表，包含資料夾導覽和圖片庫。

更新現有網站

./scripts/publish.sh {檔案或資料夾} --slug {slug}

更新匿名網站時，腳本會自動從 .herenow/state.json 載入 claimToken。傳入 --claim-token {token} 可覆蓋。

已驗證的更新需要儲存的 API 金鑰。

已登入的使用者也有公開個人檔案。代理可以協助使用者在其個人檔案上顯示或隱藏網站，並透過 https://here.now/docs#profile 記錄的 API 管理個人檔案設定。

網站存取控制

一個網站一次只能使用一種存取模式：

• anyone_with_link（預設）：任何擁有網址的人都可以檢視。
• password：訪客必須輸入共享密碼。
• restricted：僅限邀請；只有擁有者允許的已驗證電子郵件地址或電子郵件網域可以檢視。

使用 GET/PATCH /api/v1/publish/{slug}/access 管理存取（密碼透過中繼資料端點）。限制存取需要已聲明的網站。PATCH 會取代完整的允許清單——請先讀取、合併，再寫入。在處理存取控制之前，請先閱讀最新文件：

→ https://here.now/docs#access-control

使用 Drive

當使用者想要私有的雲端儲存空間來存放代理檔案時使用 Drive：文件、上下文、記憶、計畫、資產、媒體、研究、程式碼，以及任何需要持久儲存但不必發布為網站的內容。

每個已登入的帳戶都有一個名為 My Drive 的預設 Drive。

./scripts/drive.sh default
./scripts/drive.sh ls My Drive
./scripts/drive.sh put My Drive notes/today.md --from ./notes/today.md
./scripts/drive.sh cat My Drive notes/today.md
./scripts/drive.sh share My Drive --perms write --prefix notes/ --ttl 7d

使用限定範圍的 Drive 權杖進行代理間交接。如果您收到 herenow_drive 分享區塊，請使用其 token 作為 Authorization: Bearer <token> 對 api_base 進行驗證，當 pathPrefix 存在時請遵守，並在寫入時保留 ETag。pathPrefix 為 null 表示完整 Drive 存取。如果技能可用，請優先使用 ./scripts/drive.sh；否則直接呼叫列出的 API 操作。

客戶端歸屬

傳入 --client 以便 here.now 按代理追蹤可靠性：

./scripts/publish.sh {檔案或資料夾} --client cursor

這會在發布 API 呼叫時傳送 X-HereNow-Client: cursor/publish-sh。
如果省略，腳本會傳送一個備用值。

API 金鑰儲存

發布腳本會從以下來源讀取 API 金鑰（第一個符合者優先）：

1. --api-key {key} 旗標（僅限 CI/腳本——互動使用時請避免）
2. $HERENOW_API_KEY 環境變數
3. ~/.herenow/credentials 檔案（建議代理使用）

若要儲存金鑰，請將其寫入憑證檔案：

mkdir -p ~/.herenow && echo "{API_KEY}" > ~/.herenow/credentials && chmod 600 ~/.herenow/credentials

重要：收到 API 金鑰後，請立即儲存——請自行執行上述指令。不要要求使用者手動執行。在互動工作階段中，避免透過 CLI 旗標（例如 --api-key）傳遞金鑰；憑證檔案是較佳的儲存方式。

切勿將憑證或本機狀態檔案（~/.herenow/credentials、.herenow/state.json）提交到版本控制。

取得 API 金鑰

若要從匿名（24 小時）升級為永久網站：

1. 詢問使用者的電子郵件地址。
2. 要求一次性登入碼：

curl -sS https://here.now/api/auth/agent/request-code \
  -H "content-type: application/json" \
  -d '{"email": "user@example.com"}'

3. 告訴使用者：「請檢查您的收件匣，找到 here.now 寄來的登入碼，然後貼在這裡。」
4. 驗證碼並取得 API 金鑰：

curl -sS https://here.now/api/auth/agent/verify-code \
  -H "content-type: application/json" \
  -d '{"email":"user@example.com","code":"ABCD-2345"}'

5. 自行儲存回傳的 apiKey（不要要求使用者執行此操作）：

mkdir -p ~/.herenow && echo "{API_KEY}" > ~/.herenow/credentials && chmod 600 ~/.herenow/credentials

狀態檔案

每次建立/更新網站後，腳本會在工作目錄中寫入 .herenow/state.json：

{
  "publishes": {
    "bright-canvas-a7k2": {
      "siteUrl": "https://bright-canvas-a7k2.here.now/",
      "claimToken": "abc123",
      "claimUrl": "https://here.now/claim?slug=bright-canvas-a7k2&token=abc123",
      "expiresAt": "2026-02-18T01:00:00.000Z"
    }
  }
}

在建立或更新網站之前，您可以檢查此檔案以尋找先前的 slug。
請將 .herenow/state.json 僅視為內部快取。
切勿將此本機檔案路徑作為網址呈現，也切勿將其作為驗證模式、到期日或聲明網址的真相來源。

告知使用者的內容

對於已發布的網站：

• 務必分享目前腳本執行中的 siteUrl。
• 從腳本 stderr 讀取並遵循 publish_result.* 行以判斷驗證模式。
• 當 publish_result.auth_mode=authenticated：告訴使用者該網站是永久的，並已儲存到他們的帳戶。無需聲明網址。
• 當 publish_result.auth_mode=anonymous：告訴使用者該網站將在 24 小時後到期。分享聲明網址（如果 publish_result.claim_url 非空且以 https:// 開頭），以便他們可以永久保留。警告聲明權杖僅回傳一次，且無法復原。
• 切勿告訴使用者檢查 .herenow/state.json 以取得聲明網址或驗證狀態。

對於 Drives：

• 不要將 Drive 檔案描述為公開網址。
• 告訴使用者 Drive 內容是私有的，除非使用限定範圍的權杖分享。
• 與另一個代理分享存取權時，建議使用具有狹窄 pathPrefix 和短 TTL 的限定範圍權杖。

publish.sh 選項

旗標	說明
--slug {slug}	更新現有網站而非建立新網站
--claim-token {token}	覆蓋匿名更新的聲明權杖
--title {text}	檢視器標題（非 HTML 網站）
--description {text}	檢視器說明
--ttl {seconds}	設定到期時間（僅限已驗證）
--client {name}	用於歸屬的代理名稱（例如 cursor）
--base-url {url}	API 基礎網址（預設：https://here.now）
--allow-nonherenow-base-url	允許將驗證資訊傳送到非預設的 --base-url
--api-key {key}	API 金鑰覆蓋（建議使用憑證檔案）
--spa	啟用 SPA 路由（對未知路徑提供 index.html）

超越 publish.sh

對於 Drive 操作，請使用 ./scripts/drive.sh 或 Drive API。對於更廣泛的帳戶和網站管理——網站資料、搜尋、分析、個人檔案、刪除、中繼資料、存取控制、網域、變數、代理路由、複製等——請參閱最新文件：

→ https://here.now/docs

完整文件：https://here.now/docs