Astro 網站怎麼放 poppy.json？Poppy 1.0 探索路徑與網域驗收

先宣告網站可供未登入瀏覽#

把以下範例存成 public/.well-known/poppy.json，並替換站名與主機名稱。這個例子只宣告網站入口。依規格，未提供 browser_session_endpoint 時，代理以一般未登入訪客的方式瀏覽。

1
{
2
  "protocol_version": "1.0",
3
  "organization": {
4
    "name": "Example Notes",
5
    "domain": "example.com"
6
  },
7
  "web": {}
8
}

在專案根目錄建置後，若沿用 Astro 預設輸出目錄，檢查 dist/.well-known/poppy.json 是否存在。部署平台若另有靜態資產目錄或通用 fallback 規則，還需要確認正式網址真的回傳該 JSON。路徑存在和 HTTP 200 都可能與首頁 fallback 同時出現，因此要解析回應本文。Astro 的 public 目錄

用對外入口驗收重新導向#

以下命令需要 curl 與 jq。把 entry 換成待驗證的 HTTPS 網域。若使用 www 和裸網域，兩個入口各測一次。

1
(
2
  set -eu
3
  entry=https://www.example.com
4
  body=$(mktemp)
5
  trap 'rm -f "$body"' EXIT
6
  final=$(curl -fsSL --max-redirs 5 --proto '=https' --proto-redir '=https' \
7
    -o "$body" -w '%{url_effective}' "$entry/.well-known/poppy.json")
8
  printf '%s\n' "$final"
9
  [[ "$final" =~ ^https://([a-zA-Z0-9.-]+)/[.]well-known/poppy[.]json$ ]]
10
  domain=${BASH_REMATCH[1]}
11
  jq -e --arg domain "$domain" '
12
    .protocol_version == "1.0"
13
    and .organization.domain == $domain
14
    and (.organization.name | type == "string" and length > 0)
15
    and (.web | type == "object")
16
  ' "$body"
17
)

這份檢查用於一般 HTTPS 網域與上述靜態範例。最終網址要使用規格指定的路徑且沒有 query。若 www.example.com 轉到 example.com，JSON 的 organization.domain 應為 example.com。若另有登入或操作需求，再依規格選擇 Company Agent 或 API，並為帳號存取設計 OAuth 與 scopes。Sierra 公告列出 Muse 已支援探索。這裡驗收的是網站回應，Muse 端的實際互動可另行驗證。Muse 的使用者端設定

參考資料：

Personal Agent Protocol：Draft 1.0

Sierra：Releasing Personal Agent Protocol 1.0

Astro：Project structure