在子域名上發佈登陸頁面並附帶編輯面板
將一個已批准的登陸頁面轉換為已部署的網站並附帶面板。您無需撰寫文案或重新設計:輸入的是已批准的 HTML;輸出的是可正常運作、可進行衡量且合法的 URL。
黃金法則
未經用戶明確批准模型之前,不得部署任何內容。 如果登陸頁面尚未獲得批准,請停止並將控制權交還給相應的登陸頁面技能。
執行方式:自動駕駛
管理層不想回答問題。由您決定並繼續進行。 以下所有內容都已解決,無需詢問:
- 使用哪個主機 → 由
dig +short NS(第 0.5 階段)決定。 - 專案名稱 → 客戶名稱的 kebab-case 格式 + 角度 (
Cliente14-metodo)。 - 什麼是可編輯的 → 標題、副標題、項目符號、按鈕文字、消除疑慮內容、步驟、評論、常見問題、數字、圖片、追蹤 ID、Cookie 聲明文字以及感謝頁面的所有內容。
- 建立感謝頁面和資料庫 → 預設包含,不是需要詢問的附加項目。
- 創建儲存庫、部署、建立 DNS 記錄、啟用 SSL、移除主機的水印 → 直接執行,無需諮詢。
- 在客戶的 DNS 中添加 CNAME 或 TXT 記錄 → 是附加操作,直接執行(請參見第 0.5 階段)。
唯一三個合理的停止點:
- 已批准的 HTML 不清楚或存在多個候選項。 詢問哪一個是正確的,並且不要猜測:磁碟上最顯眼的檔案可能是舊版本。如有疑問,請要求用戶貼上內容。
- 缺少一個您無法憑空捏造的資料:GTM 或追蹤像素的 ID、影片嵌入代碼、電話號碼。需要詢問;永遠不要使用佔位符填寫。
- 機密或付款。
client_secret、密碼和購買物品您永遠不要碰(請參見第 8 階段)。
其他所有事情:繼續進行,最後報告完成了什麼。
帳戶、會話和瀏覽器(已於 2026 年 9 月 11 日驗證)
知道哪個帳戶和哪個 Chrome 負責什麼可以節省一半的會話時間。任何密碼都不會經過您的手:如果某個訪問要求輸入密碼或驗證碼,您就停止並將其傳遞給管理層。
帳戶
| 服務 | 帳戶 | 用途 |
|---|---|---|
| GitHub | <github-username>(SSH 已配置) | 登陸頁面的儲存庫。使用 ssh -T [email protected] 進行驗證 |
| Cloudflare | <work-email> | Pages:所有登陸頁面都在這裡。已連接 <github-username> 的 GitHub 應用程式 |
| Netlify | ⚠️ 兩個帳戶,不要混淆 | 僅用於遷移舊網站 離開 Netlify。不部署任何新內容 |
↳ 團隊 <work-account> | <work-email> | 無信用額度("運營信用額度"):部署會被暫停 |
↳ 團隊 Fb | <direccion-email> | 擁有 tiseraconstrucciones.com,免費方案,待遷移 |
| Clarity | 每個登陸頁面一個專案 | 在 clarity.microsoft.com 上創建;ID 會放入面板 |
兩個 Chrome 瀏覽器
通常會有兩個已登入的瀏覽器。每個瀏覽器中的會話如下:
| Chrome | 會話 |
|---|---|
<work-account> | Cloudflare、GitHub、Netlify 團隊 <work-account> |
<direccion-email> | Sered 客戶入口(屬於客戶)、Typeform、Netlify 團隊 Fb |
- 不要讓管理層在 deviceId 之間做選擇:這對他們沒有任何意義。使用
switch_browser並用一句話通知:"您會看到一個 Connect 按鈕,點擊打開了 X 的那個"。 - 如果某個網站要求登入,但該 Chrome 中沒有保存的帳戶,請先嘗試另一個瀏覽器,然後再詢問。
- 如果 Google 顯示帳戶選擇器,選擇帳戶不是輸入密碼:這是允許的。如果之後要求輸入密碼或驗證碼,則停止。
🚨 Sered 是客戶的帳戶
Chrome <direccion-email> 中的 Sered 客戶入口是以客戶身份登入的(例如,客戶 14 中顯示 "歡迎,Alejandro")。在該入口內,您只能操作登陸頁面的記錄(CNAME 及其驗證 TXT 記錄)。不要觸碰您沒有創建的任何區域。
路徑:客戶入口 → 進入 cPanel → Zone Editor → 管理 域名。
🚨 刪除 Netlify 站點需要擁有它的帳戶
如果 Chrome 登入了另一個團隊,即使專案存在,也會顯示 Page not found。您需要登出 (app.netlify.com/logout) 並使用 Google 重新登入,選擇正確的帳戶。這會在該 Chrome 中登出另一個帳戶:請通知管理層您進行了此操作。
🚨 React 表單欄位:使用 form_input,不要直接輸入
在使用 React 構建的面板中(Keystatic 助手、Pages 表單),使用 computer type 進行輸入會導致屏幕變白。form_input 會直接設定值並且可以正常運作。對於 form_input 無法更改的下拉菜單,請點擊打開它們並選擇選項。
步驟 0 — 您需要的資料
- 已批准的 HTML。 如果您是從另一個技能鏈接過來的,那就是已組裝好的
index.html。如果您在磁碟上搜尋它,請確認它是最新的:使用grep -rl --include="*.html" -i "<客戶名稱>" ~/Desktop ~/Downloads進行搜尋,如果出現多個結果,或者現有的檔案看起來像是課堂素材或來自非客戶文件夾,請進行詢問。發佈舊版本會迫使您重新進行整個轉換。 - 專案名稱,使用 kebab-case 格式 (
Cliente14-metodo)。這將作為儲存庫和主機上的專案名稱。 - 子域名 (
metodo.cliente.com)。不要問 DNS 在哪裡:您自己會查明。 - 登陸頁面使用哪個表單:Tally 還是 Typeform。 不要問,直接在 HTML 中查看(
grep -oE "data-tf-live|data-tally-src")。這會影響嵌入代碼、隱藏欄位和 Webhook(第 9 階段)。 - Google 代碼管理器 (GTM) 和/或 Meta 像素的 ID(如果有的話)(第 3 階段)。
- 客戶的 Favicon 和標誌(如果您有的話)(第 4 階段)。
在轉換之前,檢查 HTML 中是否有未填寫的佔位符:
# 文件是必需的:沒有它,grep 會一直等待標準輸入並阻塞會話。
grep -nE '\{\{[A-Z0-9_]+\}\}|VIDEO_ID|SUBDOMINIO|TODO:|XXXX|LOREM|placeholder|Lorem ipsum' <fichero.html>
⛔ [A-Z0-9_],包含數字。 此處的正則表達式先前是 [A-Z_]+,但我們自家的佔位符包含數字:經測試,{{H1_LINEA_1}}、{{FUD_1}}、{{VP_1_TITULO}}、{{URL_LOGO_PRENSA_1}} 和 {{SUBDOMINIO}} 中只有最後一個被匹配到。換句話說,這個旨在確保「沒有任何佔位符會被發佈」的檢查,在發佈前恰好漏掉了五分之四的佔位符。
任何發現都會阻止該部分並進行詢問。任何佔位符都不能被發佈。
⛔ 第 0.5 階段 — 主機:只有一條路徑(2026 年 9 月 11 日)
登陸頁面是靜態的。沒有 SSR,沒有適配器,沒有需要做的決定。
以前有一個決策樹,取決於客戶的 DNS 在哪裡。現在沒有了:這是因為 Cloudflare Workers 的自定義域名需要 DNS 區域在 Cloudflare 內,而這只有在需要伺服器時才重要。登陸頁面不需要伺服器。
| 元件 | 運行位置 |
|---|---|
| 登陸頁面 | 靜態 HTML |
| 表單 | Tally/Typeform 的 iframe,在瀏覽器中 |
| 追蹤(GTM/像素) | 瀏覽器 |
| Cookie 聲明 | localStorage |
| 潛在客戶 | 從表單到 CRM,不經過我們 |
| Keystatic 面板 | 本地,npm run dev。不會被部署 |
主機:Cloudflare Pages。永遠是,無論客戶的主機是什麼。 Pages 接受來自任何 DNS 的 CNAME — Sered、IONOS、Hostinger、GoDaddy、本地主機的 cPanel,任何都可以 — 並且由於沒有 SSR,因此不需要不再支援它的適配器。
免費方案:每月 500 次構建,100 個專案,每個專案 100 個域名,頻寬無限制。
⚠️ 為什麼不使用 Netlify(已於 2026 年 9 月 11 日驗證,請勿重複)
Netlify 已轉為信用額度:免費方案每月 300 點,並且一次生產部署花費 15 點。這意味著該帳戶下所有網站總共只能進行 20 次部署 — 而每當有人在面板中保存時,就會觸發一次提交和一次部署。
但嚴重的問題不是上限:信用額度用完後,Netlify 會暫停您所有的網站,訪客會看到 Site not available。在免費方案中,這是一個硬性上限,無法購買更多。一個正在運行活躍廣告活動的客戶登陸頁面會因此癱瘓。這對於客戶工作來說是無法接受的,而不僅僅是麻煩。
⚠️ 為什麼不使用 Vercel(已驗證,請勿重複)
Vercel 的免費方案 (Hobby) 僅限於非商業用途。 其自己的文檔說明:"Hobby 方案限制用戶僅用於非商業的個人用途"。客戶的登陸頁面屬於商業用途:需要 Pro 方案(每位用戶每月 20 美元)。
唯一需要查明的事情:DNS 在哪裡
主機和 DNS 不是一回事。名稱伺服器 (Nameservers) 是決定性的:客戶可能將網站放在 Sered,而 NS 在 Cloudflare,那麼 Sered 的面板就毫無用處了。
dig +short NS <客戶域名>
這會告訴您在請求之前需要向哪個面板請求訪問權限,並且無需憑據即可查詢。很多時候甚至不需要訪問權限:您可以直接提供已編寫好的記錄,客戶或其 IT 人員可以在兩分鐘內創建它。
🚨 cPanel 和 Plesk 會創建一個會破壞 CNAME 的 A 記錄
創建子域名時,cPanel 和 Plesk 會自動創建一個 A 記錄指向它們的伺服器。CNAME 不能與同名的 A 記錄共存 — 這是 DNS 的工作方式,而不是面板的任性行為。
必須刪除該 A 記錄,否則 CNAME 永遠無法解析。這是浪費最多時間的錯誤,因為面板上所有內容都顯示為 "正常"。
關於客戶 DNS 的規則
- 永遠不要建議移動名稱伺服器作為首選方案。 他們的郵件 (MX)、網站和驗證 (TXT) 都依賴於此:錯誤地複制一個記錄會導致客戶無法收發電子郵件。這是最後的手段,並且需要客戶的明確同意。
- 添加新的 CNAME 或 TXT 記錄不是移動 DNS。 這是附加操作:它不會觸動現有的 MX 或網站記錄。可以毫不猶豫地執行此操作。
- 購買新域名不是選項。永遠不是。 不要提出這個建議,即使是作為備用計劃。登陸頁面始終是客戶現有域名下的一個子域名。
- 如何在有疑問時解釋:
"這是為一個當前不存在的子域名創建的新記錄。它不會修改或刪除任何內容:郵件 (MX)、網站和驗證保持不變。如果出現任何問題,只需刪除此記錄,一切都會恢復原狀。"
- 如果確實無法訪問客戶的面板,登陸頁面將保留在
<project>.pages.dev,並且廣告活動可以從那裡開始。這是臨時的且已告知用戶,但永遠不要為了解決問題而購買域名。 - 客戶憑據:您不處理這些。 您確切地告訴他們要創建什麼記錄,然後驗證它是否解析。訪問權限由管理層或客戶使用。
🚨 不要在創建子域名之前查詢它
dig +short metodo.cliente.com # ⛔ 在創建記錄之前不要這樣做
許多供應商的 SOA 將負快取 TTL 設定為 86400 秒(24 小時)。如果您在子域名存在之前查詢它,解析器會將 "不存在" 的結果快取一整天 — 您的解析器,有時甚至是證書頒發機構的解析器。結果:證書頒發會延遲或失敗,看起來像配置錯誤,但事實並非如此。
檢查 SOA 以了解您面臨的情況,而無需查詢子域名本身:
dig +short SOA <dominio> # 最後一個數字是負快取 TTL
第 1 階段 — 建立專案
最小化技術棧。不使用 Tailwind 和 Fontsource:登陸頁面技能會生成帶有 !important 的純 CSS,並在其主區塊中引入自己的字體。引入 Tailwind 只會增加錯誤。
也沒有適配器。 不要安裝 @astrojs/netlify 或 @astrojs/cloudflare:輸出是靜態的。
npm create astro@latest <project> -- --template minimal --install --no-git --skip-houston --yes
cd <project>
npm install @keystatic/core @keystatic/astro @astrojs/react react react-dom @astrojs/sitemap zod
npm install -D @astrojs/check typescript
已驗證的版本(執行於 2026 年 9 月 11 日):astro 7.3.2 · @keystatic/core 0.6.9 · @keystatic/astro 6.0.0 · @astrojs/react 6.0.5 · react 19.3.0。
astro.config.mjs — 唯一版本
// @ts-check
import { defineConfig } from 'astro/config';
import react from '@astrojs/react';
import keystatic from '@keystatic/astro';
import sitemap from '@astrojs/sitemap';
// Keystatic 僅在開發模式下運行。在構建時輸出純 HTML:沒有 /api 路由、沒有
// React 運行時、沒有適配器。面板在本地使用並提交代碼。
const isDev = process.argv.includes('dev');
export default defineConfig({
// 在子域名存在之前,指向主機的實際 URL。
// 一個無法解析的 site: 會發出 canonical 和 sitemap
…
[為翻譯而截斷]