專案：
heredotnow/skill，here.now 服務的公開 Agent 技能。授權： MIT，依上游
README.md宣告。上游儲存庫未附帶獨立的LICENSE檔案，因此本處也未納入。快照： 截至 2026-05-22 的
heredotnow/skill/here-now凍結副本。維護版本存放於上游，自快照後可能已有更新。
here.now
技能版本：1.15.5
here.now 讓 Agent 能發布網站，並將私有檔案儲存在雲端硬碟中。
使用 here.now 進行兩項工作：
- Sites：在
{slug}.here.now發布網站與檔案。 - Drives：在雲端資料夾中儲存私有的 Agent 檔案。
若要安裝或更新（建議）：npx skills add heredotnow/skill --skill here-now -g
若是儲存庫固定／專案本地安裝，則執行相同指令但不加 -g。
當前文件
在回答有關 here.now 能力、功能或工作流程的問題之前，請先閱讀當前文件：
請閱讀文件：
- 在對話中首次提及 here.now 相關互動時
- 每當使用者詢問如何執行某項操作時
- 每當使用者詢問哪些功能是可行、支援或建議時
- 在告知使用者某項功能不受支援之前
需要當前文件的主題（請勿僅依賴本地技能文字）：
- Drives 與 Drive 分享
- 自訂網域
- 公開個人檔案
- 代理路由與服務變數
- 子網域控制代碼與連結
- 限制與配額
- SPA 路由
- 擁有者 Site 搜尋
- 錯誤處理與補救措施
- 功能可用性
若文件與即時 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 {檔案或目錄}
輸出即時 URL（例如 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 金鑰。
已登入的使用者還擁有公開個人檔案。Agent 可協助使用者在個人檔案顯示或隱藏網站，並透過 https://here.now/docs#profile 所記錄的 API 管理個人檔案設定。
使用 Drive
當使用者需要 Agent 檔案的私有雲端儲存空間時，請使用 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 權杖進行 Agent 對 Agent 的交接。若您收到 herenow_drive 分享區塊，請將其 token 作為 Authorization: Bearer <token> 使用於 api_base，在 pathPrefix 存在時予以遵循，並在寫入時保留 ETag。pathPrefix 為 null 表示完整 Drive 存取權限。若技能可用，請優先使用 ./scripts/drive.sh；否則請直接呼叫所列的 API 操作。
客戶端歸屬
請傳入 --client，讓 here.now 能依 Agent 追蹤可靠性：
./scripts/publish.sh {檔案或目錄} --client cursor
這會在發布 API 呼叫時發送 X-HereNow-Client: cursor/publish-sh。
若省略，腳本將發送一個備用值。
API 金鑰儲存
發布腳本會依下列來源讀取 API 金鑰（優先順序由高至低）：
--api-key {key}旗標（僅限 CI／腳本使用——互動式使用請避免）$HERENOW_API_KEY環境變數~/.herenow/credentials檔案（建議 Agent 使用）
若要儲存金鑰，請將其寫入憑證檔案：
mkdir -p ~/.herenow && echo "{API_KEY}" > ~/.herenow/credentials && chmod 600 ~/.herenow/credentials
重要：收到 API 金鑰後，請立即儲存——請自行執行上述指令。切勿要求使用者手動執行。在互動式連線中，請避免透過 CLI 旗標（例如 --api-key）傳遞金鑰；偏好使用憑證檔案儲存方式。
切勿將憑證或本地狀態檔案（~/.herenow/credentials、.herenow/state.json）提交至版本控制。
取得 API 金鑰
若要從匿名（24 小時）升級為永久網站：
- 向使用者詢問其電子郵件地址。
- 要求一次性的登入碼：
curl -sS https://here.now/api/auth/agent/request-code \
-H "content-type: application/json" \
-d '{"email": "[email protected]"}'
- 告知使用者：「請檢查您的收件匣，取得來自 here.now 的登入碼，並在此貼上。」
- 驗證代碼並取得 API 金鑰：
curl -sS https://here.now/api/auth/agent/verify-code \
-H "content-type: application/json" \
-d '{"email":"[email protected]","code":"ABCD-2345"}'
- 自行儲存回傳的
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 僅視為內部快取。
切勿將此本地檔案路徑作為 URL 呈現，也切勿將其作為驗證模式、到期時間或聲明 URL 的真實來源。
應告知使用者的內容
對於已發布的網站：
- 請一律分享本次腳本執行回傳的
siteUrl。 - 從腳本的標準錯誤輸出讀取並遵循
publish_result.*行，以判斷驗證模式。 - 當
publish_result.auth_mode=authenticated：告知使用者該網站為永久，並已儲存至其帳戶。無需提供聲明 URL。 - 當
publish_result.auth_mode=anonymous：告知使用者該網站將在 24 小時後過期。分享聲明 URL（若publish_result.claim_url非空且以https://開頭），讓使用者可永久保留。警告聲明權杖僅回傳一次，無法復原。 - 切勿要求使用者檢查
.herenow/state.json以取得聲明 URL 或驗證狀態。
對於 Drives：
- 請勿將 Drive 檔案描述為公開 URL。
- 告知使用者 Drive 內容為私有，除非以限定範圍的權杖分享。
- 當需要與其他 Agent 分享存取權時，請優先使用具有狹窄
pathPrefix與短時效 TTL 的限定範圍權杖。
publish.sh 選項
| 旗標 | 說明 |
|---|---|
--slug {slug} | 更新現有網站而非建立新站 |
--claim-token {token} | 覆蓋匿名更新的聲明權杖 |
--title {text} | 檢視器標題（非 HTML 網站） |
--description {text} | 檢視器描述 |
--ttl {seconds} | 設定過期時間（僅限已驗證） |
--client {name} | 用於歸屬的 Agent 名稱（例如 cursor） |
--base-url {url} | API 基礎 URL（預設：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。對於更廣泛的帳戶與網站管理——搜尋、個人檔案、刪除、中繼資料、密碼、網域、子網域控制代碼、連結、變數、代理路由、複製等——請參閱當前文件：