
Almanac Seed
Almanac Seed là một công thức SEED.md một tệp cho phép một tác nhân mã hóa AI xây dựng và tự xác minh một ứng dụng đánh giá thiết kế HTML kiểu Figma, Next.js 14 đầy đủ với các bình luận được neo bằng ghim, thảo luận theo luồng, phản ứng, giải quyết, hiện diện trực tiếp và một API được bảo vệ bằng tiêu đề cho các người đánh giá AI.
https://seeds.plow.co/seed/plow-pbc/almanac-seed?ref=producthunt&utm_source=aipure

Thông tin Sản phẩm
Đã cập nhật:Jun 8, 2026
Almanac Seed là gì
Almanac Seed là một "hạt giống sản phẩm" độc lập cho Almanac, một công cụ đánh giá thiết kế có thể lưu trữ cục bộ được xây dựng để bình luận trực tiếp trên các tạo phẩm HTML đã được hiển thị—tương tự như tính năng bình luận dựa trên ghim của Figma, nhưng dành cho các nguyên mẫu web và các khám phá HTML một tệp. Thay vì gửi mã ứng dụng, kho lưu trữ cung cấp một tệp đặc tả có thẩm quyền, SEED.md, hướng dẫn một tác nhân mã hóa AI cách tạo toàn bộ ứng dụng từ đầu, bao gồm các tuyến, mô hình dữ liệu, hành vi giao diện người dùng, quy tắc bảo mật và kiểm thử chấp nhận. Ứng dụng kết quả là một dự án Next.js 14 (App Router) với xác thực dựa trên NextAuth và một lớp lưu trữ bền vững dựa trên KV, được thiết kế để chạy và xác minh hoàn toàn trên máy của nhà phát triển mà không yêu cầu các dịch vụ bên ngoài hoặc thông tin xác thực sản xuất.
Các Tính năng Chính của Almanac Seed
Almanac Seed là một "SEED.md" công thức một tệp duy nhất hướng dẫn một tác nhân mã hóa AI xây dựng ứng dụng web Almanac hoàn chỉnh từ đầu: một công cụ đánh giá thiết kế Next.js 14 cho phép cộng tác viên nhận xét trực tiếp trên các tạo phẩm HTML được hiển thị bằng các luồng được neo bằng ghim (kiểu Figma), phản ứng, trạng thái giải quyết và hiện diện trực tiếp. Seed bao gồm một mô hình dữ liệu cố định, lược đồ KV, hợp đồng tuyến đường/API (bao gồm API tác nhân được bảo vệ bằng tiêu đề), yêu cầu UI/thương hiệu và một bộ xác minh tự động (27 hành trình chấp nhận) có thể chạy cục bộ mà không cần dịch vụ bên ngoài hoặc phiên bản sản xuất, sử dụng đường dẫn đăng nhập thử nghiệm chỉ dành cho nhà phát triển và dự phòng KV trong bộ nhớ tùy chọn.
Đặc tả sản phẩm một tệp duy nhất biến thành một ứng dụng hoàn chỉnh: Không xuất bản mã ứng dụng nào—chỉ SEED.md—để một tác nhân AI có thể tạo toàn bộ triển khai Almanac (Next.js 14 + TypeScript) chỉ từ đặc tả.
Bình luận ghim kiểu Figma trên các tạo phẩm HTML thực: Người đánh giá mở một tạo phẩm được hiển thị trong iframe và thả các ghim được đánh số, có thể kéo với các cuộc thảo luận theo luồng, văn bản được liên kết, phản ứng và hành vi giải quyết/chưa giải quyết.
Xác minh chấp nhận tích hợp sẵn (27 hành trình): Bao gồm một bộ Playwright end-to-end xác thực các luồng chức năng và độ trung thực hình ảnh thông qua các xác nhận kiểu được tính toán/DOM so với các mã thông báo thiết kế tuyệt đối của đặc tả.
Hai đường dẫn truy cập: phiên người dùng + API tác nhân: Hỗ trợ đánh giá của con người thông qua các phiên NextAuth và một làn API riêng biệt được bảo vệ bằng hai tiêu đề cho các nhà đánh giá AI để đọc các tạo phẩm và ghi nhận xét vào cùng một kho lưu trữ.
Bảo mật và xác thực di động cho cục bộ + sản xuất: Sử dụng middleware và tiêu đề Next.js (không phải cấu hình chỉ triển khai) cho các quy tắc khung/bảo mật; cung cấp một tuyến đăng nhập thử nghiệm chỉ dành cho nhà phát triển để xác minh mà không cần Google và tùy chọn đăng nhập bằng mật khẩu sản xuất.
Cộng tác được hỗ trợ bởi KV với dự phòng phát triển linh hoạt: Lưu trữ các nhận xét/sự hiện diện/phản ứng trong Vercel KV (Upstash Redis) với lược đồ khóa/kiểu Redis được ghim, cộng với dự phòng Map trong bộ nhớ khi các biến môi trường KV không có cho các lần chạy cục bộ.
Các Trường hợp Sử dụng của Almanac Seed
Đánh giá thiết kế sản phẩm cho các nguyên mẫu HTML: Các nhóm xem xét các bản nháp HTML tĩnh (trang đích, khám phá UI, trang tiếp thị) có thể chú thích trực tiếp trên tạo phẩm bằng ghim và phản hồi theo luồng.
Kiểm tra chất lượng thiết kế nội bộ và phê duyệt của các bên liên quan: Các PM, kỹ sư và các bên liên quan có thể giải quyết các luồng, phản ứng và theo dõi hoạt động/sự hiện diện để phối hợp phê duyệt mà không cần chuyển phản hồi vào các tài liệu riêng biệt.
Phê bình UX có hỗ trợ AI và đánh giá tự động: Một tác nhân AI có thể tìm nạp các tạo phẩm và các neo ứng cử viên, đăng các nhận xét có cấu trúc thông qua API tác nhân và tham gia cùng với con người trong cùng một bề mặt đánh giá.
Công cụ đánh giá riêng tư, được lưu trữ cục bộ cho các môi trường được quản lý: Các tổ chức cần các công cụ ưu tiên cục bộ có thể chạy ứng dụng trên localhost mà không có phụ thuộc bên ngoài (xác thực nhà phát triển + KV bộ nhớ) và sau đó triển khai với quyền truy cập được kiểm soát.
Hệ thống thiết kế và thực thi hồi quy hình ảnh: Các nhóm có thể sử dụng các xác nhận hình ảnh dựa trên đặc tả để thực thi tính nhất quán về kiểu chữ, chữ hoa/thường, mật độ bố cục và hành vi tương tác qua các lần lặp.
Ưu điểm
Tự chứa, xây dựng có thể tái tạo: một tệp seed duy nhất cộng với xác minh tự động cho phép hydrat hóa nhất quán từ đầu.
Các nguyên tắc cộng tác mạnh mẽ: ghim neo, luồng, phản ứng, trạng thái giải quyết và sự hiện diện phản ánh các quy trình làm việc đánh giá thiết kế quen thuộc.
Thân thiện với tác nhân theo thiết kế: các điểm cuối được bảo vệ bằng tiêu đề chuyên dụng cho phép các nhà đánh giá AI đọc và ghi phản hồi theo chương trình.
Nhược điểm
Bề mặt đặc tả phức tạp: lược đồ KV nghiêm ngặt, quy tắc xác thực và yêu cầu độ trung thực UI làm tăng độ phức tạp trong triển khai và bảo trì.
Thiết lập sản xuất vẫn yêu cầu các bước nền tảng: triển khai công khai cần thiết lập dự án Vercel và kết nối Upstash/Vercel KV (cộng với quản lý bí mật).
Mặc định dành riêng cho miền: seed được điều chỉnh cho một quy trình làm việc cụ thể (tạo phẩm HTML, Next.js, Vercel KV, NextAuth), có thể không phù hợp với tất cả các ngăn xếp mà không cần điều chỉnh.
Cách Sử dụng Almanac Seed
1) Cài đặt Almanac Seed (công thức Plow Seeds CLI): Chạy:
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
Điều này cài đặt các công cụ Plow Seeds và tìm nạp công thức Almanac SEED.md.
2) Mở SEED.md và đưa nó cho một tác nhân mã hóa: Mở SEED.md thô trong trình chỉnh sửa hoặc trình duyệt của bạn và dán nó vào tác nhân mã hóa AI của bạn (ví dụ: Claude Code) với một hướng dẫn như: "Hydrate hạt giống này: xây dựng ứng dụng mà nó chỉ định, sau đó chạy ## Steps và ## Verify cho đến khi tất cả 27 §16 hành trình đều vượt qua."
Lưu ý: SEED.md là một đặc tả sản phẩm đầy đủ; nó không chứa mã triển khai theo thiết kế.
3) Quyết định xem bạn đang thực hiện xác minh cục bộ hay triển khai công khai thực sự: Xây dựng/xác minh cục bộ: bạn có thể bỏ qua cuộc phỏng vấn triển khai Bước 0 và đi thẳng đến các bước xây dựng (hạt giống gọi đây là "bỏ qua thẳng đến §13.5").
Triển khai công khai: bạn phải hoàn thành Bước 0 trước (đăng nhập Vercel + tạo/kết nối cửa hàng Upstash) trước khi xây dựng.
4) (Chỉ triển khai công khai) Hoàn thành các điều kiện tiên quyết phỏng vấn Bước 0: Trong một thiết bị đầu cuối, đảm bảo Node có sẵn (>= 18.17) và Vercel CLI đã được cài đặt. Nếu Vercel CLI bị thiếu, hãy cài đặt nó với tiền tố có thể ghi của người dùng:
mkdir -p ~/.npm-global && npm config set prefix ~/.npm-global
export PATH="$HOME/.npm-global/bin:$PATH"
npm i -g vercel
Sau đó xác thực:
vercel login
Tạo/liên kết dự án Vercel ngay bây giờ (phạm vi khác nhau đối với Nhóm so với Cá nhân):
- Nhóm: vercel link --yes --project <your-almanac> --scope <your-team>
- Cá nhân: vercel link --yes --project <your-almanac>
Trong bảng điều khiển Vercel, tạo + kết nối cơ sở dữ liệu Upstash cho Redis với dự án này (Storage → Create Database → Upstash for Redis → Connect Project → All Environments).
5) (Chỉ triển khai công khai) Đặt các bí mật sản xuất (mật khẩu do tác nhân tạo): Tạo và đặt các bí mật (hạt giống chỉ định tác nhân nên tạo mật khẩu; người dùng không chọn nó):
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
KHÔNG đặt ALMANAC_TEST_LOGIN trong sản xuất.
6) Chạy các bước xây dựng của hạt giống cục bộ (các "Bước" §13.5 của hạt giống): Làm theo các bước §13.5 của SEED.md để hydrate/xây dựng ứng dụng. Tóm lại, hạt giống hướng dẫn tác nhân:
- Đảm bảo Node >= 18.17
- Cài đặt các phụ thuộc npm (npm install)
- Đảm bảo một corpus cookoff-seeds/ tồn tại (hạt giống tạo một ví dụ nếu thiếu)
- Cài đặt Playwright Chromium + các phụ thuộc OS:
npx playwright install --with-deps chromium
- Tạo .env.local cho phát triển cục bộ (bao gồm NEXTAUTH_SECRET, NEXTAUTH_URL=http://localhost:3210, ALMANAC_TEST_LOGIN=1 và các khóa tác nhân dev)
- Xây dựng và chạy trên cổng 3210 (npm run build; npm start -p 3210 hoặc tương đương)
7) Khởi động ứng dụng trên cổng 3210 và xác nhận nó phản hồi: Chạy máy chủ và xác nhận /login tải:
npm run build
npm start
Sau đó kiểm tra:
curl -sI http://localhost:3210/login
Mong đợi HTTP 200.
8) Đăng nhập cục bộ không dùng Google bằng tuyến đăng nhập thử nghiệm chỉ dành cho dev: Với ALMANAC_TEST_LOGIN=1 trong .env.local, mở:
http://localhost:3210/api/[email protected]&next=/
Điều này tạo một cookie phiên NextAuth và chuyển hướng bạn đến ứng dụng (không yêu cầu Google OAuth để xác minh cục bộ).
9) Chạy bộ xác minh của hạt giống (các hành trình §15 "Verify" / §16 của hạt giống): Chạy bộ E2E của Playwright:
npm run e2e
Các tiêu chí chấp nhận của hạt giống là 27 hành trình trong §16 (các khẳng định chức năng + kiểu tính toán trực quan). Tất cả phải vượt qua so với localhost:3210.
10) (Tùy chọn) Sử dụng tập lệnh Docker stranger-test được cung cấp: Nếu bạn muốn xác minh "container trống" hoàn toàn cô lập, hãy chạy tập lệnh xác minh của kho lưu trữ (yêu cầu Docker và một CLI claude đã cấu hình):
verify/hydrate-and-verify.sh
Nó tự động hóa luồng stranger trong một container node:20-slim và in kết quả FINAL_VERIFY.
11) (Chỉ triển khai công khai) Triển khai lên Vercel (các "Triển khai" §13.6 của hạt giống): Sau khi Bước 0 hoàn tất và ứng dụng của bạn xây dựng cục bộ, hãy triển khai:
vercel deploy --prod
Sau đó tắt Bảo vệ triển khai Vercel (ssoProtection) qua API hoặc bảng điều khiển (bắt buộc để /login có thể truy cập được). Đặt NEXTAUTH_URL thành URL đã triển khai và triển khai lại một lần:
printf '%s' "https://<project>.vercel.app" | vercel env add NEXTAUTH_URL production
vercel deploy --prod
12) (Chỉ triển khai công khai) Chia sẻ quyền truy cập bằng mật khẩu đã tạo: Almanac đã triển khai của bạn sử dụng đăng nhập bằng mật khẩu (nhà cung cấp thông tin xác thực). Người đánh giá đăng nhập bằng bất kỳ tên hiển thị nào + mật khẩu ALMANAC_ACCESS_PASSWORD đã tạo. Xác nhận các bình luận vẫn tồn tại sau khi tải lại (chứng minh Upstash KV đã được kết nối).
Câu hỏi Thường gặp về Almanac Seed
Almanac Seed là một tệp đặc tả sản phẩm “SEED.md” duy nhất hướng dẫn một tác nhân mã hóa AI cách xây dựng ứng dụng Almanac hoàn chỉnh từ đầu. Kho lưu trữ không chứa mã ứng dụng—chỉ công thức.
Video Almanac Seed
Bài viết phổ biến

Atoms: Nền tảng AI đa tác nhân biến ý tưởng thành sản phẩm sẵn sàng ra mắt
May 22, 2026

Nano Banana SBTI: Nó là gì, Cách thức hoạt động và Cách sử dụng nó vào năm 2026
Apr 15, 2026

Đánh giá Atoms — Trình tạo sản phẩm AI định nghĩa lại việc tạo nội dung số vào năm 2026
Apr 10, 2026

Kilo Claw: Cách Triển Khai và Sử Dụng AI Agent "Làm-Thay-Bạn" Thực Sự (Cập Nhật 2026)
Apr 3, 2026







