本地商业网站构建器(希腊)
源自一个真实网站(Αποφράξεις Τσαβάρης),该网站因隐藏的管道问题反复出现而耗费了大量提示:服务器配置、同意、SEO文件、不一致的事实。目标:一次性正确完成。用希腊语与用户交流。
以下路径相对于此技能的文件夹。在运行脚本前,将它们解析为绝对路径;使用 deno run -A scripts/<name>.mjs(或 node)运行脚本。如果两者都不存在,请告知用户(安装:winget install DenoLand.Deno,先询问)并使用手动检查清单。
便携执行
在运行辅助工具前检查主机能力:终端和文件访问、Node 18+ 或 Deno、浏览器工具、可选的 FFmpeg 和网络权限。永远不要假设安装提供了这些工具。使用可用的等效图像/浏览器工具或手动参考清单;报告任何无法执行的自动检查。将此技能安装目录中的所有支持路径解析。永远不要假设 Windows 用户路径或未经授权安装软件。
不可违反的规则(每条都会花费实际时间或金钱)
- 永远不要编造事实。 电话、电子邮件、地址、ΑΦΜ、ΓΕΜΗ、营业时间、价格、评论、评分、从业年限、许可证、保证、到达时间均由业主提供。缺失则询问,或省略;
[ΧΡΕΙΑΖΕΤΑΙ: …]标记阻止上线。受监管职业(医生、牙医、律师、药剂师):不得有评论、成功声明(参考文献/01 §4)。 - 单一事实来源:
site-facts.json(位于部署文件夹之外)。派生文件(JSON-LD、站点地图、llms.txt、robots、清单、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)、站点地图、JSON-LD(LocalBusiness 子类型)、OG 1200×630、图标(包括 maskable)。 - 每次 CSS/JS 更改后更新
?v=(使用bump_version.mjs)并清除 Hostinger 缓存。 - 验证,而非假设。 只有在最终文件审计显示 0 个错误、浏览器 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、站点地图、llms.txt、清单、vCard、希腊语交接文档、AGENTS.md/CLAUDE.md 用于项目)。 - 构建 →
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/(研究结构和复制语气,绝不复制外观)。 - 事实变更后: 事实 →
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;出错时退出码 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 政策会变化:依赖前重新验证,并在未验证时说明。