Almanac Seed
Almanac Seed 是一個單檔案 SEED.md 配方，它允許 AI 編碼代理建置並自我驗證一個完整的 Next.js 14、Figma 風格的 HTML 設計審查應用程式，具有圖釘錨定評論、討論串、回應、解決、即時在線狀態以及用於 AI 審閱者的標頭門控 API。
https://seeds.plow.co/seed/plow-pbc/almanac-seed?ref=producthunt&utm_source=aipure
產品資訊
更新時間：2026年06月08日
什麼是 Almanac Seed
Almanac Seed 是 Almanac 的獨立「產品種子」，Almanac 是一個可在本地託管的設計審查工具，用於直接在渲染的 HTML 構件上進行評論——類似於 Figma 基於圖釘的評論，但適用於網頁原型和單檔案 HTML 探索。該儲存庫不提供應用程式碼，而是提供一個權威的規範檔案 SEED.md，指導 AI 編碼代理如何從頭開始生成整個應用程式，包括路由、資料模型、UI 行為、安全規則和驗收測試。生成的應用程式是一個 Next.js 14 (App Router) 專案，具有基於 NextAuth 的身份驗證和 KV 支持的持久層，旨在完全在開發人員的機器上運行和驗證，無需外部服務或生產憑證。
Almanac Seed 的主要功能
Almanac Seed 是一個單一檔案的「SEED.md」配方，它指導 AI 編碼代理程式從頭開始建置完整的 Almanac 網路應用程式：這是一個 Next.js 14 設計審查工具，讓協作者可以直接在渲染的 HTML 構件上使用釘選錨定的討論串（Figma 樣式）、回應、解決狀態和即時狀態進行評論。該種子包括固定的資料模型、KV 綱要、路由/API 合約（包括標頭門控代理程式 API）、UI/品牌要求，以及一個自動驗證套件（27 個驗收旅程），該套件可以在本地執行，無需外部服務或生產實例，使用僅限開發的測試登入路徑和可選的記憶體內 KV 備用。
單一檔案產品規格，可水合為完整應用程式: 不提供應用程式程式碼——只有 SEED.md——因此 AI 代理程式可以僅從規格生成整個 Almanac 實作（Next.js 14 + TypeScript）。
在真實 HTML 構件上進行 Figma 樣式圖釘評論: 審閱者打開在 iframe 中渲染的構件，並放置帶有編號、可拖曳的圖釘，其中包含討論串、連結化文字、回應以及解決/未解決行為。
內建驗收驗證（27 個旅程）: 包括一個端到端 Playwright 套件，該套件透過針對規格的絕對設計代幣的計算樣式/DOM 斷言來驗證功能流程和視覺保真度。
兩種存取路徑：人類會話 + 代理程式 API: 透過 NextAuth 會話支援人類審查，並為 AI 審閱者提供單獨的雙標頭門控 API 通道，以讀取構件並將評論寫入同一儲存區。
用於本地 + 生產的可攜式安全和驗證: 使用中介軟體和 Next.js 標頭（而非僅限部署的配置）來設定框架/安全規則；提供僅限開發的測試登入路由，無需 Google 即可進行驗證，以及生產密碼登入選項。
KV 支援的協作與彈性開發備用: 將評論/狀態/回應持久化到 Vercel KV (Upstash Redis) 中，並帶有釘選的 Redis 鍵/類型綱要，以及當本地執行時缺少 KV 環境變數時的記憶體內 Map 備用。
Almanac Seed 的使用案例
HTML 原型產品設計審查: 審查靜態 HTML 模擬（登陸頁面、UI 探索、行銷頁面）的團隊可以直接在構件上使用圖釘和討論串回饋進行註釋。
內部設計 QA 和利害關係人簽核: PM、工程師和利害關係人可以解決討論串、回應並追蹤活動/狀態，以協調批准，而無需將回饋移至單獨的文件中。
AI 輔助的 UX 評論和自動化審查: AI 代理程式可以擷取構件和候選錨點，透過代理程式 API 發布結構化評論，並與人類一起參與相同的審查介面。
用於受管制環境的私有、本地託管審查工具: 需要本地優先工具的組織可以在 localhost 上執行應用程式，無需外部依賴（開發驗證 + 記憶體 KV），然後透過受控存取進行部署。
設計系統和視覺回歸強制執行: 團隊可以使用規範驅動的視覺斷言來強制執行跨迭代的一致排版、大小寫、佈局密度和互動行為。
優點
獨立、可重現的建置：單一的種子檔案加上自動驗證，可以從頭開始實現一致的水合。
強大的協作原語：錨定圖釘、討論串、回應、解決狀態和狀態反映了熟悉的設計審查工作流程。
設計上對代理程式友好：專用的標頭門控端點允許 AI 審閱者以程式設計方式讀取和寫入回饋。
缺點
複雜的規格表面積：嚴格的 KV 綱要、驗證規則和 UI 保真度要求增加了實作和維護的複雜性。
生產設定仍需要平台步驟：公開部署需要 Vercel 專案設定和 Upstash/Vercel KV 連接（以及秘密管理）。
特定領域的預設值：該種子是為特定工作流程（HTML 構件、Next.js、Vercel KV、NextAuth）量身定制的，可能不適合所有堆疊，除非進行調整。
如何使用 Almanac Seed
1) 安裝 Almanac Seed (Plow Seeds CLI 配方): 運行：
curl -fsSL https://raw.githubusercontent.com/plow-pbc/seed/main/install.sh | bash -s -- https://github.com/plow-pbc/almanac-seed/blob/main/SEED.md
這將安裝 Plow Seeds 工具並獲取 Almanac SEED.md 配方。
2) 打開 SEED.md 並將其交給編碼代理: 在您的編輯器或瀏覽器中打開原始 SEED.md，並將其貼到您的 AI 編碼代理（例如 Claude Code）中，並附帶指令，例如：「滋潤此種子：建置它指定的應用程式，然後運行其 ## 步驟和 ## 驗證，直到所有 27 個 §16 旅程都通過。」
注意：SEED.md 是一個完整的產品規格；它設計上不包含任何實作程式碼。
3) 決定您是要進行本地驗證還是真正的公開部署: 本地建置/驗證：您可以跳過步驟 0 的部署訪談，直接進入建置步驟（種子稱之為「直接跳到 §13.5」）。
公開部署：您必須先完成步驟 0（Vercel 登入 + Upstash 儲存建立/連接），然後才能建置。
4) (僅限公開部署) 完成步驟 0 訪談先決條件: 在終端機中，確保 Node 可用 (>= 18.17) 且 Vercel CLI 已安裝。如果 Vercel CLI 缺失，請使用用戶可寫入的前綴安裝它：
mkdir -p ~/.npm-global && npm config set prefix ~/.npm-global
export PATH="$HOME/.npm-global/bin:$PATH"
npm i -g vercel
然後進行身份驗證：
vercel login
現在建立/連結 Vercel 專案（團隊與個人範圍不同）：
- 團隊：vercel link --yes --project <您的-almanac> --scope <您的-團隊>
- 個人：vercel link --yes --project <您的-almanac>
在 Vercel 儀表板中，建立 + 將 Upstash for Redis 資料庫連接到此專案（儲存 → 建立資料庫 → Upstash for Redis → 連接專案 → 所有環境）。
5) (僅限公開部署) 設定生產機密 (代理生成的密碼): 生成並設定機密（種子指定代理應生成密碼；用戶不選擇它）：
PASSPHRASE="$(openssl rand -base64 18)"
printf '%s' "$(openssl rand -base64 32)" | vercel env add NEXTAUTH_SECRET production
printf '%s' "$PASSPHRASE" | vercel env add ALMANAC_ACCESS_PASSWORD production
請勿在生產環境中設定 ALMANAC_TEST_LOGIN。
6) 在本地運行種子的建置步驟（種子的 §13.5「步驟」）: 按照 SEED.md §13.5 步驟來滋潤/建置應用程式。總之，種子指示代理：
- 確保 Node >= 18.17
- 安裝 npm 依賴項 (npm install)
- 確保存在 cookoff-seeds/ 語料庫（如果缺失，種子會建立一個範例）
- 安裝 Playwright Chromium + OS 依賴項：
npx playwright install --with-deps chromium
- 為本地開發建立 .env.local（包括 NEXTAUTH_SECRET、NEXTAUTH_URL=http://localhost:3210、ALMANAC_TEST_LOGIN=1 和開發代理金鑰）
- 在埠 3210 上建置並運行 (npm run build; npm start -p 3210 或等效命令)
7) 在埠 3210 上啟動應用程式並確認其響應: 運行伺服器並確認 /login 加載：
npm run build
npm start
然後檢查：
curl -sI http://localhost:3210/login
預期 HTTP 200。
8) 在本地使用僅限開發的測試登入路由登入，無需 Google: 在 .env.local 中設定 ALMANAC_TEST_LOGIN=1，打開：
http://localhost:3210/api/[email protected]&next=/
這會產生一個 NextAuth 會話 cookie 並將您重定向到應用程式（本地驗證無需 Google OAuth）。
9) 運行種子的驗證套件（種子的 §15「驗證」/ §16 旅程）: 運行 Playwright E2E 套件：
npm run e2e
種子的驗收標準是 §16 中的 27 個旅程（功能 + 視覺計算樣式斷言）。所有這些都必須針對 localhost:3210 通過。
10) (可選) 使用提供的 Docker stranger-test 腳本: 如果您想要完全隔離的「空白容器」驗證，請運行儲存庫的驗證腳本（需要 Docker 和已配置的 claude CLI）：
verify/hydrate-and-verify.sh
它會自動在 node:20-slim 容器中執行陌生人流程，並列印 FINAL_VERIFY 結果。
11) (僅限公開部署) 部署到 Vercel (種子的 §13.6「部署」): 在步驟 0 完成且您的應用程式在本地建置成功後，部署：
vercel deploy --prod
然後透過 API 或儀表板禁用 Vercel 部署保護 (ssoProtection)（必需，以便 /login 可訪問）。將 NEXTAUTH_URL 設定為部署的 URL 並重新部署一次：
printf '%s' "https://<專案>.vercel.app" | vercel env add NEXTAUTH_URL production
vercel deploy --prod
12) (僅限公開部署) 使用生成的密碼共享訪問權限: 您部署的 Almanac 使用密碼登入（憑證提供者）。審閱者使用任何顯示名稱 + 生成的 ALMANAC_ACCESS_PASSWORD 密碼登入。確認評論在重新載入後仍然存在（證明 Upstash KV 已連接）。
Almanac Seed 常見問題
Almanac Seed 是一個單一檔案的「SEED.md」產品規格，它指導 AI 程式碼代理如何從頭開始建構完整的 Almanac 應用程式。該儲存庫不包含應用程式程式碼，只有建構說明。
与 Almanac Seed 类似的最新 AI 工具
Foundry
Foundry 是一個多功能平台，以多種形式存在——作為智能合約開發工具鏈、虛擬桌面遊戲軟件和傳統金屬鑄造設施——每個版本都為其特定領域提供專業化功能。
PythonConvert.com
PythonConvert.com 是一個免費的基於網頁的工具，提供 AI 驅動的 Python 和其他編程語言之間的代碼翻譯以及 Python 類型轉換功能。
Softgen
Softgen.ai 是一個 AI 驅動的全棧項目生成平台，使用戶能夠在沒有編碼要求的情況下將其想法轉化為功能完整的網頁應用程序。
Micro SaaS Ideas
Micro SaaS 想法是小規模、細分市場專注的軟件解決方案，針對特定問題或市場，為創業者提供了一種以最少的資源和複雜性建立盈利業務的方式。
类似 Almanac Seed 的热门 AI 工具
GitHub Copilot Chat
GitHub Copilot Chat 是一個 AI 驅動的編碼助手，提供自然語言交互、實時代碼建議和上下文支持，直接在支持的 IDE 和 GitHub.com 中提供。
CopilotForXcode
CopilotForXcode 是一個 Xcode 源代碼編輯器擴展，將 GitHub Copilot、Codeium 和 ChatGPT 集成在一起，在 Xcode 中提供 AI 驅動的代碼建議、聊天協助和 prompt-to-code 功能。
OpenAI Codex CLI
OpenAI Codex CLI 是一個輕量級、開源的程式碼編寫代理，可在您的終端中執行，使開發人員能夠將自然語言轉換為程式碼執行，同時提供 ChatGPT 等級的推理能力，並具有執行程式碼、操作檔案以及在版本控制下迭代的能力。
GoCodeo SaaS Builder
GoCodeo SaaS Builder 是一個 AI 原生框架，它使用自主 AI 代理自動生成可立即投入生產的全棧 SaaS 應用程序，包括身份驗證、實時功能和 TypeScript 集成。