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文件、不一致的事实。目标:一次性正确完成。用希腊语与用户交流。

以下路径相对于此技能的文件夹。在运行脚本前,将它们解析为绝对路径;使用 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、站点地图、llms.txt、robots、清单、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)、站点地图、JSON-LD(LocalBusiness 子类型)、OG 1200×630、图标(包括 maskable)。
  9. 每次 CSS/JS 更改后更新 ?v=(使用 bump_version.mjs)并清除 Hostinger 缓存。
  10. 验证,而非假设。 只有在最终文件审计显示 0 个错误、浏览器 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、站点地图、llms.txt、清单、vCard、希腊语交接文档、AGENTS.md/CLAUDE.md 用于项目)。
  5. 构建 → references/03-build-and-code.md、04-conversion-and-content.md、05-seo-schema-geo.md:将 tokens + THEME 放入 style.css,部分放入 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;出错时退出码 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/模式/Google Business Profile/AI 搜索 · 06 隐私与希腊法律要点 · 07 Hostinger 服务器与部署 · 08 QA/发布 · 09 超越基础 · 错误登记。研究日期:2026-10-05;法律和 Google 政策会变化:依赖前重新验证,并在未验证时说明。

相关技能