本地商家網站建置工具(希臘)
源自一個真實網站(Αποφράξεις Τσαβάρης),該網站因為看不見的管線問題(伺服器設定、同意機制、SEO 檔案、不一致的事實)一再出錯,花費了數十個提示才完成。目標:一次就做對。以 Greek 與使用者溝通。
以下路徑皆相對於此技能的資料夾。執行腳本前請先解析為絕對路徑;腳本使用 deno run -A scripts/<name>.mjs(或 node)執行。若兩者皆不存在,請告知使用者(安裝方式:winget install DenoLand.Deno,先詢問)並使用手動檢查表。
可攜式執行
在執行輔助工具前,先檢查主機功能:終端機與檔案存取、Node 18+ 或 Deno、瀏覽器工具、選用的 FFmpeg 與網路權限。切勿假設安裝環境已提供這些工具。使用可用的同等圖片/瀏覽工具或手動參考檢查表;回報任何無法執行的自動化檢查。將所有支援路徑解析到此已安裝技能的目錄。切勿假設 Windows 使用者路徑或未經授權便安裝軟體。
永遠不能違反的規則(每條都耗費真實時間或金錢)
- 切勿虛構事實。 電話、電子郵件、地址、ΑΦΜ、ΓΕΜΗ、營業時間、價格、評價、評分、經營年數、執照、保證、到達時間皆來自業主。缺少則詢問,或不列入;
[ΧΡΕΙΑΖΕΤΑΙ: …]標記會阻擋上線。受監管職業(醫生、牙醫、律師、藥劑師):不得有評價,不得有成功宣稱(參考資料/01 §4)。 - 單一事實來源:
site-facts.json(位於部署資料夾之外)。衍生檔案(JSON-LD、sitemap、llms.txt、robots、manifest、vCard)由scaffold.mjs derive重新產生,絕不手動編輯。 - 設計由客戶決定,絕不從先前網站複製:撰寫
docs/DESIGN.md,讓使用者選擇一個方向,再進行編碼(參考資料/02)。 - 從第一行就保持 CSP 乾淨: 無內聯腳本/樣式/處理器;每個第三方在相同變更中新增至 CSP;僅有一個強制執行的 CSP。
- 同意或點擊前無第三方請求。 GA4 僅在使用者點擊「Αποδοχή」後載入;接受/拒絕同等對待;地圖需點擊後載入;字型自架且驗證包含希臘字形(許多熱門字型,如 Poppins/Montserrat,並無希臘字形)。
- 修復根本原因,而非針對每個寬度打補丁。 行動優先;使用
scripts/overflow_probe.js測試寬度矩陣。 - 切勿相信伺服器指令。 Hostinger/LiteSpeed 會忽略
<IfModule>,默默忽略不支援的指令並在邊緣強制 HTTPS:使用verify_live.mjs進行線上驗證。 - SEO 檔案為可交付成果: canonical、robots(
Allow: /+ Sitemap)、sitemap、JSON-LD(LocalBusiness 子類型)、OG 1200×630、圖示(含 maskable)。 - 每次 CSS/JS 變更後, 在所有頁面上增加
?v=(使用bump_version.mjs)並清除 Hostinger 快取。 - 驗證,而非假設。 僅在稽核顯示最終檔案無錯誤、瀏覽器 QA 完成,且誠實回報未驗證項目時,才能說「完成」。
注意事項(看似正確但已過時或錯誤的觀念)
- FAQPage/HowTo 標記無幫助:FAQ 豐富結果已於 2026 年 5 月 7 日退役。
llms.txt無證實效果(Google 表示不使用):可選。 - 絕對不要為商家本身新增
aggregateRating/reviewJSON-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 次快速請求後)並非網站故障:請等待,不要繞過。
工作流程(執行前先載入每個步驟中提到的參考資料)
- 分類: 新網站 · 重做 · 僅稽核(跳到 6) · 小修改(跳到 5)。檢查現有工具(deno/node、瀏覽器工具、ffmpeg、Edge/Chrome 用於
render_png)。 - 資料收集 → 閱讀
references/01-intake-and-facts.md。一次用希臘語問完所有問題(若無人能回答,僅使用已知事實,絕不虛構,撰寫QUESTIONS.md);從assets/site-facts.example.json建立site-facts.json;執行scaffold.mjs check --facts site-facts.json。 - 設計摘要 →
references/02-design-direction.md;填寫docs/DESIGN.md,提出 2-3 個方向,讓使用者選擇。 - 建立初始結構:
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 用於專案)。 - 建置 →
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/中(研究結構與文案語氣,切勿參考其外觀)。 - 任何事實變更後: 事實 →
scaffold.mjs derive→ 可見文字 →bump_version.mjs。 - 稽核:
audit_site.mjs public --facts site-facts.json→ 修正每個 ERROR,閱讀 WARN,提供業主 VERIFY 清單。不明確的發現 →references/mistake-registry.md。 - QA 與上線 →
references/08-qa-and-launch.md(寬度矩陣、同意測試、內容 QA);部署與伺服器細節在references/07-server-htaccess-deploy.md。 - 部署後:
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 政策會變更:使用前請重新驗證,並說明哪些部分未經驗證。