Communitygithub.com

在地商家架站:讓電話響起來的靜態網站

為在地商家建置、稽核並上線正式等級的靜態網站(HTML、CSS、原生 JS):以來電轉換為核心,事實驅動的鷹架,在地 SEO 與 JSON-LD,先取得同意才載入 GA4,CSP 安全,加上零相依稽核腳本。

在地商家架站:讓電話響起來的靜態網站 是什麼?

在地商家架站配方第 2 步(建置、稽核、上線),來自 PongoDogo/local-business-site-builder(2026-10-06 發布,MIT 授權,資料查核日期 2026-10-05)。它針對架在 Hostinger 的希臘水電師傅、診所、餐廳和小店,用希臘語和店主溝通,但方法可以照搬:絕不捏造事實(電話、營業時間、價格、評價只能來自店主,沒有就不寫);只維護一個 site-facts.json,用 scaffold.mjs derive 重新產生 JSON-LD、sitemap、robots、manifest 和 vCard;先寫 docs/DESIGN.md 並選定一個方向再寫程式;全程符合 CSP;取得同意前不載入任何第三方;只有 audit_site.mjs 零錯誤、verify_live.mjs 在正式網域通過才算完成。附完整範例站、多寬度溢位探針、OG 圖渲染與圖示產生腳本。不適用於電商或 WordPress。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/PongoDogo/local-business-site-builder/tree/HEAD/skills/local-business-site-builder

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

本地商家網站建置工具(希臘)

源自一個真實網站(Αποφράξεις Τσαβάρης),該網站因為看不見的管線問題(伺服器設定、同意機制、SEO 檔案、不一致的事實)一再出錯,花費了數十個提示才完成。目標:一次就做對。以 Greek 與使用者溝通。

以下路徑皆相對於此技能的資料夾。執行腳本前請先解析為絕對路徑;腳本使用 deno run -A scripts/<name>.mjs(或 node)執行。若兩者皆不存在,請告知使用者(安裝方式:winget install DenoLand.Deno,先詢問)並使用手動檢查表。

可攜式執行

在執行輔助工具前,先檢查主機功能:終端機與檔案存取、Node 18+ 或 Deno、瀏覽器工具、選用的 FFmpeg 與網路權限。切勿假設安裝環境已提供這些工具。使用可用的同等圖片/瀏覽工具或手動參考檢查表;回報任何無法執行的自動化檢查。將所有支援路徑解析到此已安裝技能的目錄。切勿假設 Windows 使用者路徑或未經授權便安裝軟體。

永遠不能違反的規則(每條都耗費真實時間或金錢)

  1. 切勿虛構事實。 電話、電子郵件、地址、ΑΦΜ、ΓΕΜΗ、營業時間、價格、評價、評分、經營年數、執照、保證、到達時間皆來自業主。缺少則詢問,或不列入;[ΧΡΕΙΑΖΕΤΑΙ: …] 標記會阻擋上線。受監管職業(醫生、牙醫、律師、藥劑師):不得有評價,不得有成功宣稱(參考資料/01 §4)。
  2. 單一事實來源: site-facts.json(位於部署資料夾之外)。衍生檔案(JSON-LD、sitemap、llms.txt、robots、manifest、vCard)由 scaffold.mjs derive 重新產生,絕不手動編輯。
  3. 設計由客戶決定,絕不從先前網站複製:撰寫 docs/DESIGN.md,讓使用者選擇一個方向,再進行編碼(參考資料/02)。
  4. 從第一行就保持 CSP 乾淨: 無內聯腳本/樣式/處理器;每個第三方在相同變更中新增至 CSP;僅有一個強制執行的 CSP。
  5. 同意或點擊前無第三方請求。 GA4 僅在使用者點擊「Αποδοχή」後載入;接受/拒絕同等對待;地圖需點擊後載入;字型自架且驗證包含希臘字形(許多熱門字型,如 Poppins/Montserrat,並無希臘字形)。
  6. 修復根本原因,而非針對每個寬度打補丁。 行動優先;使用 scripts/overflow_probe.js 測試寬度矩陣。
  7. 切勿相信伺服器指令。 Hostinger/LiteSpeed 會忽略 <IfModule>,默默忽略不支援的指令並在邊緣強制 HTTPS:使用 verify_live.mjs 進行線上驗證。
  8. SEO 檔案為可交付成果: canonical、robots(Allow: / + Sitemap)、sitemap、JSON-LD(LocalBusiness 子類型)、OG 1200×630、圖示(含 maskable)。
  9. 每次 CSS/JS 變更後, 在所有頁面上增加 ?v=(使用 bump_version.mjs)並清除 Hostinger 快取。
  10. 驗證,而非假設。 僅在稽核顯示最終檔案無錯誤、瀏覽器 QA 完成,且誠實回報未驗證項目時,才能說「完成」。

注意事項(看似正確但已過時或錯誤的觀念)

  • FAQPage/HowTo 標記無幫助:FAQ 豐富結果已於 2026 年 5 月 7 日退役。llms.txt 無證實效果(Google 表示不使用):可選。
  • 絕對不要為商家本身新增 aggregateRating/review JSON-LD;sameAs 僅用於真實且有內容的個人檔案(絕不為空的第二網域)。
  • 在正式環境留下暫存 Disallow: / 或 noindex 會導致網站被除名(稽核 SEO-001/023)。
  • Hostinger 預覽網域 *.hostingersite.com 會造成網站重複:需 301 重新導向並移除。
  • 無句點的 htaccess 會被忽略;有句點則必須明確上傳(隱藏檔案)。Docs/facts/.md不得放在public_html` 中。
  • Google Fonts CDN 連結會破壞隱私與 CSP;提到 Poppins/DM Sans/Playfair 等的前端設計建議在希臘語中會失敗。
  • 僅大小寫不同的連結在 Windows 上可運作,但在伺服器上會 404。
  • 在 JS 中建立的錨點(cookie 橫幅 → /privacy.html#cookies)也必須實際存在。
  • 邊緣機器人驗證(約 60 次快速請求後)並非網站故障:請等待,不要繞過。

工作流程(執行前先載入每個步驟中提到的參考資料)

  1. 分類: 新網站 · 重做 · 僅稽核(跳到 6) · 小修改(跳到 5)。檢查現有工具(deno/node、瀏覽器工具、ffmpeg、Edge/Chrome 用於 render_png)。
  2. 資料收集 → 閱讀 references/01-intake-and-facts.md。一次用希臘語問完所有問題(若無人能回答,僅使用已知事實,絕不虛構,撰寫 QUESTIONS.md);從 assets/site-facts.example.json 建立 site-facts.json;執行 scaffold.mjs check --facts site-facts.json。
  3. 設計摘要 → references/02-design-direction.md;填寫 docs/DESIGN.md,提出 2-3 個方向,讓使用者選擇。
  4. 建立初始結構: scaffold.mjs init --facts site-facts.json --out public --docs docs [--logo logo.svg](建立頁面、基本 CSS、JS、附帶 CSP 的 .htaccess、robots、sitemap、llms.txt、manifest、vCard、希臘文交接文件、AGENTS.md/CLAUDE.md 用於專案)。
  5. 建置 → references/03-build-and-code.md、04-conversion-and-content.md、05-seo-schema-geo.md:在 style.css 中設定 tokens + THEME,在 index.html(取代 [ΧΡΕΙΑΖΕΤΑΙ…] 標記)中設定區塊,透過 make_icons.mjs、render_png.mjs(從 HTML 頁面產生 OG 圖片)、images.mjs、font_greek_check.mjs --download 設定資產。對於同意機制、隱私文字、頁尾識別、價格或評價,也請閱讀 06-privacy-consent-legal.md。品質標竿的完整虛構範例在 assets/example-site/ 中(研究結構與文案語氣,切勿參考其外觀)。
  6. 任何事實變更後: 事實 → scaffold.mjs derive → 可見文字 → bump_version.mjs。
  7. 稽核: audit_site.mjs public --facts site-facts.json → 修正每個 ERROR,閱讀 WARN,提供業主 VERIFY 清單。不明確的發現 → references/mistake-registry.md。
  8. QA 與上線 → references/08-qa-and-launch.md(寬度矩陣、同意測試、內容 QA);部署與伺服器細節在 references/07-server-htaccess-deploy.md。
  9. 部署後: verify_live.mjs https://DOMAIN --local public --preview-domain X.hostingersite.com;將 docs/ 交給業主。 表單、預約、更多頁面、CMS、電子商店、其他語言、廣告像素 → references/09-beyond-the-basics.md 並先協商範圍。

腳本(scripts/)

audit_site.mjs 上線前稽核(ERROR/WARN/VERIFY/INFO;--json、--strict;錯誤時 exit 1) · verify_live.mjs 線上檢查(重新導向、標頭、404、暴露檔案、位元組一致性;節流) · scaffold.mjs init/derive/check · bump_version.mjs · render_png.mjs · make_icons.mjs · images.mjs(ffmpeg) · contrast.mjs · font_greek_check.mjs · overflow_probe.js(在頁面內執行)。無參數呼叫時,每個腳本都會顯示 --help 型式的使用方式。它們只會在您傳入的資料夾內寫入。

參考索引

01 資料收集/事實/受監管職業 · 02 設計方向、希臘字型 · 03 建置、效能、可及性、寬度 · 04 轉換與文案 · 05 SEO/結構化資料/GBP/AI 搜尋 · 06 隱私與希臘法律要點 · 07 Hostinger 伺服器與部署 · 08 QA/上線 · 09 進階功能 · 錯誤登錄。研究日期:2026-10-05;法律與 Google 政策會變更:使用前請重新驗證,並說明哪些部分未經驗證。

相關技能