改动日志

这个页面记录平台的每一步变化。发现数据过时、工具算错或信息有偏差，通过页面上的「这里有误？」或反馈表单告诉我们，处理完会更新到这里。

---

2026.05.09 — 员工合同模板 1 → 3 拆分 · 全职 / 兼职 / 外劳各自独立条目 [这里有误？]

• 资源库新增 2 条独立合同模板——原「员工合同模板」拆为 全职员工合同模板（本地全职 ≥31.5h/周 · EA1955 + 2022 修正 20 条款）+ 兼职员工合同模板（30-70% 全职工时 · Part-Time Regulations 2010 专属阶梯 6/8/11 年假 + 10/13/15 病假）+ 外劳员工合同模板（PLKS 持证 · EA1955 + Act 446 + Section III 加注 23 条款）
• 每类合同独立卡片——资源库人员管理分组从 3 卡（合同 + 手册 + 外劳合规）扩为 5 卡 · 卡标题层就明确合同类型 · 不再点入才知三类共一页
• 共享法律上下文 single source——三页共用「为什么是英文 / 2026 印花新规 / 通用填写规则 / 数据基准 / 官方来源」一份 partial · 改一处同步三页
• 历史链接不死——旧链接 /resources/employee-contract 走 301 自动跳 全职合同
• 跨页引用全对齐——劳动法章 / HR 章 / 员工手册框架 / 开业 90 天倒计时 / 起步路径 / 全栈目录 9 处引用按上下文重定向（默认指全职 · 外劳合规配套页指外劳）
• resources-employee-contract-split-3card

---

2026.05.08 — K11 图说大马 vol1 全删除 · reference 站 vs experience-oriented 任务定位错位根因 [这里有误？]

• K11 vol1 12 篇图说大马全删除——14 plan 真删 + 3 站点页删 + 17 图片资源删 + 1 组件删 + 1 rule 删 + 6 inline 链清 + 2 配置改 + 1 入口卡删 + 4 dead link 修 = 36 file deletion + 5 modification
• 删除根因——K11 立项 premise 错 · 「地图层故事性内容埋藏需视觉化破壳」想象需求不是实然 · /map/history-culture / festivals 等文字版直白展示由来 + 数据 + 制度 · 没埋藏 · reference 站读者 task-oriented · visual essay experience-oriented 任务定位错位
• 业界搜证——R301 ≥10 次：TasteAtlas（1.28M MAU · 8:27 session）= interactive map + database NOT visual essay · The Pudding = digital magazine NOT reference 站 · Wikipedia / Smithsonian Roots = infobox + 时间线 NOT visual essay · 业界 0 个 reference 站靠 visual essay 做长期内容资产先例
• R330 / R331 retired——K11 用例已全删 · R331 业态 vs 商号区分由 R106 L05 红线兜底
• 释放 55-66h 投入——task-oriented 项目主轴（handbook 章节扩 / 工具迭代 / 城市档案数据补 / 节庆 SOP / SEO 优化）

---

2026.05.08 — 全站无障碍基线升级 · WCAG 2.2 AA 合规 [这里有误？]

• 全站无障碍违规清零——VitePress 默认主题层 16 个无障碍违规（深色 / 浅色主题切换按钮缺无障碍标签 + 侧边栏折叠组双交互嵌套 + 内容容器 main 地标缺失）通过框架层 single source 修补全站清零 · 19 章经营手册 + 22 工具 + 站内全页面共享同一无障碍基线
• 辅助技术读屏更顺——VoiceOver / TalkBack 读「切换深色 / 浅色主题」按钮时朗读清晰中文 · 侧边栏键盘 Tab 单点交互不再嵌套 · 主内容区有正确 main 地标
• WCAG 2.2 AA 合规——对齐国际通用无障碍标准 · 三典型页（首页 / handbook / tools）× 三 viewport（375 / 768 / 1440）axe-core 扫 critical+serious=0 PASS
• vitepress-a11y-baseline-fix

---

2026.05.05 — 城市分类一致性升级 · 全站 8 大区命名口径统一 [这里有误？]

• 问诊台 Q3 城市选择更易懂——/quick-start OnboardingWizard 第 3 题原 8 类抽象分类内部代号改用 8 大地理区命名（巴生谷 · 柔佛 · 北马 · 霹雳 · 南部 · 东海岸 · 砂拉越 · 沙巴）· 一眼懂 + 移动端 nowrap 不溢出
• 执照清单 / 租金评估 / 基准数据全站对齐——执照清单 9 类城市分组合并为 8 大区 · 租金评估 7 类合并为 8 大区 · 业态基准数据 18 城分组「南马 Southern」漂归柔佛 + 中英混排统一中文 · 不再出现「Klang Valley / N. Sembilan / East Malaysia / East Coast」等英文 group 名
• 城市档案路由不变——34 城档案页、行政分级（联邦直辖区 / 州属 / 县市）、SEO URL 全部保持不变 · 仅前台分组命名口径统一
• region-canonical-single-source-batch

---

2026.05.05 — 图说大马 vol1 第 2 篇「24 小时 Mamak · 印度泰米尔劳工与拉茶物理学」上线 [这里有误？]

• 第 2 篇上线——/map/illustrated/02-mamak/（K11 vol1 2026-05-08 全删除） · 8 panel 翻页看 · 1965 KL Pudu 街角第一辆 mamak 推车 → 60 年后 24 小时不关灯的故事 · 拉茶物理学 + 印度泰米尔劳工与印裔穆斯林移民史 + 多元共桌
• 对位文字版——行业历史 §Mamak 起源 + 多元种族 §印裔饮食体系 + 饮品业态 §拉茶 章首均加 inline 翻页图说链
• 试这家——巴生（印度族群庞大） · 槟城小印度
• 故事虚构 · 文化背景真实——主角 Karim Mohammed 65 岁泰米尔印裔穆斯林虚构 · Mamak 商人传统 / 1880-1930s 泰米尔劳工殖民迁马 / 拉茶马来西亚本地发明 / 24 小时跨族群共桌文化背景真实

---

2026.05.05 — 马来西亚文化真实性 hard rule R331 立 · 全站 scope · K11-issue-02 实证驱动（4 维度 canonical · v70 升全站） [这里有误？]

• R331 立 + 全站升级——4 维度 audit checklist 起草前必走（A 招牌语言 / B 族裔头饰区分 / C 历史时间线 / D 业态 vs 商号区分）· registry.yaml meta v68→v69→v70 · total_rules 114→115 · 用户 2026-05-05 「全局呢？」驱动 v70 升全站 scope（map/** + handbook/** + appendix/** + start/** + tools/** + resources/** + 计划层）
• A 招牌语言——Mamak BM+EN+Tamil+Arabic Halal 零中文 · 华人 kopitiam 中文+EN · 马来 BM+EN+Halal · 守 DBKL by-laws BM 30% 大
• B 族裔头饰区分——印裔穆斯林 = kufi cap / taqiyah · 马来族 = songkok · 锡克教徒 = dastar turban · 印度教徒 = dhoti / 多无 · 阿拉伯 = keffiyeh · 防 GPT 误画 Sikh 错族裔
• C 历史时间线——1957-08-31 Merdeka 独立后 1965+ KL 街无英国殖民官员 · v1 issue-02 panel 6 设定有误已修
• D 业态 vs 商号区分——L05 红线 · 业态描述 OK / 具体商号禁 · 判断标准 = 法律实体 / 注册商标 / 体育俱乐部 / 物业所有者 = 商号；行业类目 / 业态描述 / 时代风格 = OK
• canonical 载体——R331 长期决策 propagate 5 载体（registry / canonical 模板 / 03 §6.34 / 01 / CLAUDE.md）· 后续 K11-issue-03~12 起草必走 4 维度 audit

---

2026.05.05 — 图说大马 vol1 第 1 篇 v2 视觉重生成 · panel 3 反虫壳 + panel 6 必含 jeep 双修复 [这里有误？]

• 8 panel v2 重出 · 修复 v1 两处视觉漂——(1) panel 3 罗布斯塔豆 close-up 在 v1 看起来像甲虫壳（深黑椭圆 + 反光 = 虫蛹错觉）→ v2 加 centerline groove + 偏圆豆型 + 木铲 1/3 入画 + 反例 6 项 list 锁；(2) panel 6 sepia 闪回 v1 GPT-2 跳过英军 jeep 元素 → v2 jeep 占画面 1/4 + Willys MB 型号 + 后侧 3/4 视角 + 2 军官 + MUST 画三连锁
• GPT-2 prompt 范式 v1 → v2 SOTA 重写——参 openai/openai-cookbook + freestylefly/awesome-gpt-image-2 + YouMind-OpenLab + fal.ai 2026 Guide 4 业界 SOTA grounding · 散文式 → OpenAI 官方 5 段结构（Scene / Subject / Important details / Use case / Constraints）+ 7 anchor block + 每 panel 反失败 mode list（5 类）
• canonical 模板单源 .claude/rules/illustrated-essay-prompt-template.md（K11 plan 落地后恢复内链）——12 篇图说共用 prompt 模板 · 改 prompt 范式 = 改本文件 · 12 篇全部跟车（防搜证返工 + 防风格漂）· 后续 K11-issue-02 ~ 12 起草必读
• canonical 载体——K11-issue-01-kopi-70-years plan v2 落地 · R330 fix_hint 加 GPT-2 prompt 范式段 + referenced_by 加 canonical 模板路径 · 03 §6.34 GPT Image 2 prompt 范式 canonical 子节落地 · Stage 升级触发：第 2 / 7 / 8 篇任意 1 篇套本模板 1-shot 出图 PASS 即升 Stage 2 portable 验证

---

2026.05.04 — 图说大马 vol1 第 1 篇上线 · 一杯 kopi 的 70 年 [这里有误？]

• 第 1 篇 一杯 kopi 的 70 年 · 海南咖啡师傅与南洋咖啡的诞生（K11 vol1 2026-05-08 全删除） 上线——8 panel 翻页阅读 · kishōtenketsu 起承转合 2-3-2-1 节奏（日本古典叙事范式）· 1948 年海南文昌移民开茶餐室 + 英式早餐本土化为今日 kopitiam + 黄糖黄油焦糖化烘焙独创 + 罗布斯塔 vs 阿拉比卡 + 4 种暗号（Kopi O / C / Susu / Ice）+ 现代精品咖啡对照 + 70 年三代传承故事
• 图说大马 12 篇目录已上线（K11 v3 范式革命 · /map/illustrated/）—— 12 篇主题对位 地图 文字版（5 族群移民史 / 4 节庆经济 / 6 城市精选 / 饮品工艺）· 余 11 篇制作中 · 第 2 篇 Mamak / 第 7 篇 Penang / 第 8 篇 Ipoh 优先排队
• 散文画 picture book 范式（不是漫画连载）——参考 Lee Xin Li 新加坡食景 + 谷口治郎《散步去》克制分镜 + Lat《Kampung Boy》大马本土质感 · 接受角色面相微变 · 风格统一为核心 · 暖琥珀主色 #b45309 + sepia 闪回 panel 6 专用
• 末 panel 三链 + 章首 inline 图说链跨层导航——末 panel：看完整 Kopi 工艺解析 + 试这家（怡保 / 槟城）+ 问老板（读者咨询）· 饮品业态 §南洋传统咖啡 + 行业历史 §殖民影响 + §华人南洋移民 三章首加 inline 翻页图说链
• canonical 载体——K11-issue-01-kopi-70-years plan · R330 长期决策 propagate 5 载体（registry.yaml R330 / 03 §6.33 / 01 / CLAUDE.md / 本条目）· IllustratedReader.vue 单组件（vanilla Vue 3 · swipe + ←→ + click + fullscreen + a11y · 12 篇复用 R325）· sharp q75 1200w ~95% 体积减少（PNG ~2.7MB → webp ~190KB）

---

2026.05.03 — handbook 章首图 + 流程图密度提升 Stage 1 pilot · 战略章 13 张图首批 [这里有误？]

• 战略章（ch01）13 张视觉资产首批落地——1 张章首 hero metaphor（资金 × 经验 × 城市 三轴决策罗盘） + 4 张 H2 节小 hero（业态自我定位 / 战略市场研判 / 商业模式架构 / 概念融资规划）+ 9 业态扁平卡通陈列 + 3 类创业者 persona + 资金 4 档 metaphor + 决策树视觉 + 章末成功画像 + 2 张 Mermaid 流程图（brand 主题色 #b45309）+ 1 张 SVG 资金 × 业态条形图（light/dark adaptive）
• 7 类工具栈分工 canonical ——A Mermaid 流程图 / B 静态 SVG 数据图 / C 真截图 + Excalidraw / D 业态场景 / E hero metaphor / F SVG sprite / G HTML overlay · 守 R329 4 类不加规则（today-action / 本章小结 / 自查清单 / 财务计算示例 节守纯文字结构）
• 后台规则补全——R717 入 registry.yaml（v54→v55 · 110→111 条）+ handbook-chapter.schema.json 加 chapter_hero_required 字段 + vitepress-plugin-mermaid 工具栈 enable + alt text WCAG 2.2 AA 全覆盖（4.24.2026 ADA Title II 强制）
• canonical 载体——handbook-visual-density-pilot-stage1 plan · R322 长期决策 propagate 5 载体（registry.yaml R717 / 01 / 03 §6.32 / CLAUDE.md / 本条目）· 18 章 Stage 2-19 后续候选已入建议池

---

2026.05.03 — handbook 章末 H2 措辞改名「下一步动作 · 3 件」· K09 维基化对齐 [这里有误？]

• 19 章 H2 字面值改名——原「今天就能做的 3 件事」全部改为「下一步动作 · 3 件」对齐 K09 维基化反转的 reference 站中性陈述语气（对仗 Wikipedia / NASA / Library of Congress 平台范式）
• 锚点 {#today-action} 保留——防 inbound link 死 · 数字硬约束保持固定 3（避 4 华人忌讳谐音「死」· 文化适配马来西亚华文读者画像）
• scanner regex 双分支兼容——旧「今天就能做的 N 件事」+ 新「下一步动作 · N 件」共存 · A 档 3 工具页 + map/ 城市层独立锚点遗留兼容
• canonical 载体——today-action-h2-rename-k09-align plan · R329 5 载体同步（registry / 01 / 03 §6.24 / CLAUDE.md / 本条目）

---

2026.05.03 — onboarding-wizard Q3 城市选项重排 · 减点击成本 [这里有误？]

• Q3 城市段重排为「巴生谷优先 + 9 大区」——原均匀 9 大区列改为巴生谷集合（KL / Selangor）顶部置 + 北马 / 南部 / 东海岸 / 东马 / 其他横排 · 对齐流量分布 78% 集中巴生谷
• localStorage 24h TTL 不变——读者第二次访问跳过 Q3 + paths cache · GDPR Articles 12/13/14 + PDPA 2024 透明度义务披露在 legal/privacy.md
• canonical——onboarding-wizard-q3-region-redesign plan · wizard-paths.js regions 单源 + Q3.vue 渲染层

---

2026.05.03 — 移动端布局综合审计 + 6 页修复 [这里有误？]

• 6 页移动 viewport 760px 内布局问题修复——CityStartPage 推荐路径表 overflow / OnboardingWizard 4 phase 进度条 ≥44px 触控区 / HandbookFilterIndex 段 tab 横滚出血修 / appendix consultations 卡片网格 1 列 grid / handbook ChapterCard 段 tab 计数胶囊 line-height
• 6 页 Playwright 5 device × 4 path = 20 cell 自动化断言全 PASS——iPhone SE / iPhone 14 Pro / iPad Mini / Pixel 7 / Galaxy S22 5 device baseline 锁
• canonical——mobile-layout-comprehensive-audit plan · R413 触控区 ≥44×44 + R414 max-width 680px 范畴

---

2026.05.03 — sweep-2026-W18-visual-functional-combined · ToolSupportCTA 抽组件 + 22 工具一等公民 [这里有误？]

• 22 工具 + 执照清单 + 城市起步页 ToolSupportCTA 内联 raw HTML 收敛单组件——ToolSupportCTA.vue from prop 默认 'tool' / 'city' / 'appendix' 业态分支 GA 漏斗追溯 · CommunityCTA 语义独立 class rename .community-cta-box 防 R325 单源撞
• R411 MarketingCalendarTool @media font-size 字面值删 + R412 SocialLinks dark mode hover 态 hex 硬编码 token 化——rgba(217,119,6,0.15) → color-mix(var(--brand-orange) 15%) · #fb923c → var(--vp-c-brand-2)
• scripts/check-tool-components.mjs scope 扩含 SocialLinks——R412 scope gap 反漂移保险 · R408 detection 既容 <ToolSupportCTA /> tag 又向后兼容旧 raw class
• canonical 载体——sweep-2026-W18-visual-functional-combined plan · R325 referenced_by + 03 §十二 新组件 Checklist 5 载体齐

---

2026.05.03 — page-intro-canon-layer2-batch1 · 7 文件 H3/H4 节首段 lead-in 补全 [这里有误？]

• 7 文件 ≥ 79 处 H3/H4 节首段补 ≥ 30 字 lead-in——handbook/09 / 10 / 12 / 13 + tools/cash-flow / delivery-comparison / salary-calculator · 5 类 anti-pattern 清（table / list / code-fence / 强调子标题伪装 / 纯数字开头）
• scanner baseline drift 601 → 510——scripts/check-section-leadin.mjs warn-only Stage 1 · 后续 batch2/batch3 入建议池 W19+1/+2 接力
• canonical——page-intro-canon-layer2-batch1 plan · 03 §6.0.B 双 scanner 反漂移层 R209 detection.items + R327 referenced_by

---

2026.05.03 — sweep-w18-seo · SEO dim 修 [这里有误？]

• W18 SEO dim FAIL 闭环——meta description 字数 + keywords 字段 + og:image:alt 字段全平台对齐扫 + lint:rules runOgImageMetaCheck warn-only Stage 1
• canonical——sweep-w18-seo plan · 03 §视觉资产 og-image canonical 子节锁 GPT Image 2 prompt SOP runbook 5 段结构 + 度判定 3 档

---

2026.05.02 — chip-canonical-unification · 单组件 + 3 variant + R325 一等公民 [这里有误？]

• 3 处 chip 视觉漂收敛——OnboardingWizard 浅橙底 + 深橙边 / HandbookFilterIndex 段 tab vs 业态混形 / StoriesWall 实底 → 单 Chip.vue + 3 variant pill / radio / filter + brand-tokens.css 9 chip token
• 选中态实底 #b45309 + 白字 + 999px pill——业界 Linear / GitHub Primer / Tailwind UI 3-of-5 范式收敛
• 段 tab 嵌套数字胶囊 props 化——:count="N" · runChipCanonicalCheck warn-only Stage 1 防回滚
• canonical 载体——chip-canonical-unification plan · R721 + 03 §6.31 长期决策 5 载体（registry / 01 / 03 §6.31 / CLAUDE.md / 本条目）

---

2026.05.02 — global-anchor-scroll-margin-canonical · 锚点跳转视觉位置全站统一 [这里有误？]

• 锚点跳转视觉位置 single source token 化——--scroll-margin-anchor: clamp(64px, 12vw, 96px) token 出处 brand-tokens.css · custom.css 加全局 [id] 兜底
• 散落字面值 80px / 120px 清零——custom.css × 2 + CityStartPage.vue + ResourceCatalog.vue · OnboardingWizard 三入口卡片 SPA 跨页 hash 跳转 nextTick + rAF × 2 兜底 scrollIntoView smooth + start
• npm run check:anchor-scroll lint 反漂移——warn-only Stage 1
• canonical——global-anchor-scroll-margin-canonical plan · R716 + 03 §15 R716 5 载体齐

---

2026.05.02 — handbook 入口顶部搜索框删除 · 与全站 nav MySearch 冗余 [这里有误？]

• /handbook/ HandbookFilterIndex 顶部 <input type=search> 删除——commit 5421269 · 关键词搜索由全站 nav MySearch + .vitepress/search-synonyms.js 同义词字典统一承载 · /handbook/ 三层结构（5 段 tab + 业态/阶段 chip + 19 章卡片网格）保留
• R322 propagation 补全——本批 text-canonical-ui-drift-batch-w18 plan 同步 handbook/index.md L12 文案 + 03 §6.28 三层结构 list 4 层→3 层 + 加删除 note · CLAUDE.md / registry / public/updates.md 5 载体齐
• canonical——handbook-index-search-removal commit 5421269 + text-canonical-ui-drift-batch-w18 plan

---

2026.05.02 — today-action-3-items-canonical · 3 件文化适配硬约束 [这里有误？]

• 数字硬约束固定 3——避 4 华人忌讳谐音「死」· 19 章「下一步动作」节统一 3 bullet · scanner 检 ≠ 3 触发 warn
• 每条「[动词]** [对象] — [时间预算] · 用 [工具/资源链接]」 ≤ 200 字格式约束**
• canonical——today-action-3-items-canonical plan · R329 + 03 §6.24 5 载体

---

2026.05.02 — reader-facing-jargon-eradication · R503 反漂 lint canonical [这里有误？]

• .claude/rules/dictionaries/reader-facing-jargon.txt 上线——A url-slug-leak / B framework-jargon / C dev-process-jargon 3 组 16 词 · npm run check:reader-facing-jargon warn-only Stage 1
• scope 7 reader-facing 目录——handbook / tools / resources / appendix / map / start / contents · 防 quick-start / wizard / archetype / canonical / commit 等技术词回灌读者 facing 文案
• 触发先例——handbook/01:22 link text 暴露「在 quick-start 跑 5 问 wizard」 → 立 R503 入 registry canonical
• canonical——reader-facing-jargon-eradication plan · R503 + 03 §读者 facing 文案 vs 技术 slug 边界 5 载体齐

---

2026.05.01 — og-image-vitepress-upgrade-and-alt · og-image 视觉升级 + alt 字段全平台对齐 [这里有误？]

• og-image 视觉资产升级——分享时门面对齐项目内容 · K10 brand token 就绪后 follow-up plan 接 per-page og-image 推延
• alt 字段全平台对齐——og:image:alt + twitter:image:alt 统一「大马餐饮全指南 · 中文餐饮行业参考站」
• npm run lint:rules 加 runOgImageMetaCheck——warn-only Stage 1 + meta 字段扫描
• canonical——og-image-vitepress-upgrade-and-alt plan · 03 §视觉资产 og-image canonical + 08 §11.6 类型 2 brand canonical

---

2026.05.01 — template-regulation-citation-typst-bibliography-fix · 模板法规引用 Typst bibliography 修 [这里有误？]

• 资源库模板 PDF 法规引用 Typst bibliography 字段修——Pandoc + Typst papersize=a4 渲染时 bibliography 字段在某些模板缺 · 11 模板补全
• canonical——template-regulation-citation-typst-bibliography-fix plan

---

2026.05.01 — magic-number-ban-derivable-counts · R328 字面 magic number ban [这里有误？]

• 6 类项目动态量 derive 自 single source——dim 数 / page-archetype 数 / handbook 章节数 / 工具数 / registry 规则总数 / R322 5 载体数
• helper scripts/_dynamic-counts.mjs exports 6 derive function——4 CLI scanner npm run count:{handbook,tools,archetypes,rules}（--json 模式）
• scripts/lint-rules.mjs runR328MagicNumberCheck() warn-only Stage 1
• canonical——magic-number-ban-derivable-counts plan · R328 + 03 §6.29 5 载体齐

---

2026.05.01 — page-intro-archetype-canon-layer1 · Layer 1 archetype intro + Layer 2 H3/H4 节首段 lead-in canonical [这里有误？]

• 9 archetype schema 加 intro_block_type enum + intro_block_required boolean 字段
• 双 scanner warn-only Stage 1——scripts/check-page-intro.mjs（archetype 头 30 行 · baseline drift 11/64）+ scripts/check-section-leadin.mjs（H3/H4 首段 5 类 anti-pattern · baseline drift 601/1057）
• canonical——page-intro-archetype-canon-layer1 plan · 03 §6.0.B + R209 detection.items + R327 referenced_by

---

2026.05.01 — onboarding-wizard-entry-pages · 三层入口职责 canonical [这里有误？]

• 三层入口职责落地——诊断（/quick-start <OnboardingWizard /> 3+2 progressive 问诊：业态 12 / 阶段 5 / 城市 34 → 3 卡 / 升级 5 卡 · localStorage 24h TTL）+ 查询（/handbook/ <HandbookFilterIndex /> 搜+5 段 tab+12 业态/5 阶段 chip+19 章卡片网格 · NN faceted filter 范式）+ 二次诊断（handbook/01 §entrepreneur-type 节首「→ 试试交互版」链回 wizard）
• 三入口共享 .vitepress/data/wizard-paths.js 单源数据——不引 IP geo · 巴生谷默认
• canonical 载体——onboarding-wizard-entry-pages plan · 03 §6.27 / §6.28 / §7 + privacy.md §浏览器本地存储 6 R322 载体齐（GDPR Articles 12/13/14 + PDPA 2024 透明度义务）

---

2026.05.01 — tools-resources-content-depth-audit · 工具页加「使用工具后下一步」节 [这里有误？]

• 工具 / 模板页加「使用工具后下一步」节——B/C 档 5 强制 + A 档 10 opt-in · 03 §6.0.A canonical · 与 R329 跨层对仗
• 工具页背景知识节末加 ## 使用工具后下一步 {#after-tool-use} 节——症状分支 → handbook #today-action + 配套工具锚点 + 本周 / 本月 3 步
• lint-rules.mjs runAfterToolUseCheck warn-only Stage 1——A 档豁免按 _管理/审计/tools-resources-depth-audit.md 分档
• canonical——tools-resources-content-depth-audit plan · 03 §6.0.A 5 载体齐

---

2026.05.01 — content-depth-cities-34 · 城市档案商圈级 actionable [这里有误？]

• 34 城每城 5 时段对照表——早 / 午 / 茶 / 晚 / 夜 5 时段 × 商圈 N 行 · 旺 / 平 / 冷 3 档
• 每商圈实战 3 步 bullet——动词起首 / 时间预算 / 工具锚点 · 对仗 R329 章末 actionable 哲学（handbook 层 → 城市层落地）
• canonical——content-depth-cities-34 plan · 03 §6.26 5 载体齐

---

2026.05.02 — sweep-2026-W18-data：@reg marker 覆盖率 6.5% → 97.8% · 144 处法规字面值跨 17 文件批量补全 [这里有误？]

• 全站法规字面值反漂体系上线——144 处法规 / 工资 / 税率字面值（EPF / SOCSO / EIS / 最低薪金 / SST / 外劳 levy / FOMEMA / Halal / 冷链温度 / SSM 注册费等）跨 17 文件批量补占位符 + HTML 注释 marker 双轨 · 反向扫描覆盖率 6.5% → 97.8%（≥ 90% 目标 PASS）· 漂时改 regulations.js 一处全站跟车
• format-reg.js + wizard-paths.js 补 DATA_META export——13/13 data/*.js 季度复审覆盖完整（updated / lastVerified / reviewer / nextReview / sources 5 字段 schema 1:1 对齐 regulations.js）
• ShopeeFood 25% 跨页对齐 platforms.js single source——tools/delivery-comparison.md disclaimer + 表格双对齐 · 真值源 shopee.rate=25 · range 22-28% 备注指向
• canonical 载体——sweep-2026-W18-data plan · R322 长期决策 propagate 5 载体（registry.yaml R210 + R322 / 01 命名对齐读者视角 / 03 §6.29 末段 / CLAUDE.md / 本条目）

---

2026.05.01 — iOS Pages 打开 PDF 黑屏修复 + 工具 PDF 改 A4 标准 [这里有误？]

• iOS 用户用 Pages 应用打开下载 PDF 显示黑屏的问题修复——5 个工具（薪资计算器 / 日清账 / 排班表 / 库存盘点 / 月度 P&L）生成 PDF 改为 A4 国际标准 page size（595×842pt portrait 或 842×595pt landscape · 横向布局自动检测）· 资源库 11 模板 PDF 同步改 A4（Pandoc + Typst papersize=a4）· 解决 Pages 应用对非标 page bbox 渲染失败问题
• iOS 用户提示——5 PDF 工具 + 资源库模板下载页加 iPhone / iPad 提示卡：建议用「档案」/ 预览 / 邮件附件打开 PDF · 避免用 Pages（兼容性差）
• 测试覆盖——Playwright 5 device × 4 path = 20 cell PDF page size + UI 提示可见性自动化断言全 PASS · 实机 protocol 待运营者跑（接收方 × 工具矩阵）

---

2026.05.01 — 读者咨询页扁平化 + 附录目录入口 [这里有误？]

• 读者咨询答复页路径扁平——/appendix/consultations/ 改为 /appendix/consultations（不带末尾斜杠 · 单一规范路径）· 旧路径走 301 永久跳转防外链断
• 首屏内容重排——主页改为 IntroWithCTA + 「目前已整理的答复」按 6 大类（A 成本利润 / B 营销获客 / C 运营效率 / D 人力团队 / E 合规注册 / F 扩张转型）分组占主屏 · 详细规则（答复对象 / 不受理 / 7 节结构 / 匿名化 / 排序 / 紧急联系）挪到 关于读者咨询答复 子页
• 新建附录目录入口页——/appendix/ 直访不再 404 · 9 大附录子页（术语 / 政府 / 软件 / 基准 / 案例 / 问答 / 经验 / 咨询 / 征集）卡片入口齐
• 后台 R322 propagation 同步——consultations-flatten-and-redesign 计划落地 · page-archetypes.yaml glob / consultation.schema.json description / 01 项目说明 / CLAUDE.md 项目摘要 / updates.md 5 载体一次同步扁平路径

---

2026.04.26 — 文案描述聚焦读者用语 + 视觉对齐 [这里有误？]

• 手册首页 / 工具箱 / 支持页 / AI 索引页 description 文案优化——读者看到的页面描述（meta description / 正文导语）改用更直接的读者语言：「按经营节奏五段编排」/「实用工具集合」/「经营起步 7 步」，原描述更聚焦读者 mental model
• 支持页 DuitNow 三步指引视觉对齐——「点这里看三步」展开后 1/2/3 序号被 VitePress 默认 ol 样式压贴左边的 bug 修了，序号现在正确缩进对齐说明文字
• 后台规则补全——新增 R106 入 .claude/rules/registry.yaml（v33→v34 · 104→105 条），自动扫描机制保障未来新写内容对齐

---

2026.04.24 — Tally 表 URL 口语化 [这里有误？]

• 5 张表 URL 从乱码改成口语词——原本乱码的 forms.myfnbguide.com/r/EkJ0lN 之类链接全部换成 /fix（纠错）、/feedback（反馈）、/story（分享经验）、/ask（问个问题）、/join（留邮箱等开群）· 对齐读者看到的中文 CTA 文案 · 去掉 /r/ 前缀让 URL 更短更干净
• 全站入口同步切换——14 个活跃文件（2 个 Vue 组件 + 12 处正文引用）链接全部更新到新 URL · build 验证 0 error · 读者点任何「这里有误？」「反馈与建议」「分享经验」「问个问题」「加入社群」按钮都落到新链
• Tally 表分析挂钩 GA4——5 表全接 Google Analytics 4（G-JBZ61SB3GE）· Tally FormPageView / FormSubmitted 事件流入 GA4 · 可观测读者从站点点进表到提交完成的漏斗（需在 GA4 Admin 建 2 个 custom dimensions + Mark as conversion · 首次提交后约 24 至 48 小时生效）
• 旧链返 404 的说明——Tally 改 slug 后旧乱码 URL 直接 404（2026-04-24 curl 实测 · 不保留 legacy redirect）· 若你之前把旧链存过书签或外部群发过 · 点击会看到「页面不存在」· 改用新链即可
• 后台档案同步——_管理/ canonical 档案里「Tally 表 ID」字段改为「Tally slug」· 配置快照与 Regression 自检全部对齐新 slug · 旧 ID 在档案里保留作历史追溯

tally-slug-rename · plan basename echo [这里有误？]

• plan basename echo（历史 backfill）——本 entry 对应 plan basename tally-slug-rename · commit 8bf40d8 · 历史 W17 期 plan basename echo 由 updates-md-historical-backfill-w17-w15 audit 补全（plan 文件无独立归档 · commit 永久链作 single source）

tally-slug-canonical · canonical 档案 9 处 drift 同步 [这里有误？]

• canonical 档案 9 处 drift 全面对齐——上一节 Tally slug 改名后 · _管理/ canonical 档案（01 项目说明 / 03 设计规范 / 05 任务系统 / 07 基础设施 / Regression 自检表 / 04 入口层 / 06 差距分析 / 02 会话日志 / 配置快照）共 9 处仍引旧 ID EkJ0lN / XxElML / yPx8dx 字面值 → 全数刷新为新 slug /fix / /feedback / /story / /ask / /join
• 02 会话日志 G1 + G3 HITL 闭环——G1（Tally slug 命名决策）+ G3（GA4 events Mark as conversion 24-48h 滞后确认）双 HITL 节点完整记录 · 含运营者人手在 GA4 Admin 建 2 custom dimensions + Tally Builder 添加 GA4 跟踪 ID 操作步骤
• commit + plan——commit 0e38785（plan 文件无独立归档 · commit 作 single source）· 由 updates-md-historical-backfill-w17-w15 audit 历史 W17 期 plan basename echo 补全

---

2026.04.23 — 读者咨询系统 K01 全量落地 [这里有误？]

• K01 13 步全量落地——读者咨询系统从 0 到 1 完整建成 · 13 步执行包含 Tally form 建表 + Vue 组件抽取（IntroWithCTA / consultations 列表页 / submitted 感谢页 + 站点路径注入）+ archetype 9 个 schema 加入 consultation + 全站 hero 第 8 入口接入 + R104 disclaimer 触达条款 + 三段式 plan→execute→falsify 闭环
• 24/24 acceptance PASS——R318 验收契约 24 条断言全部 PASS · 含字段层（23 字段 v3.1 schema + frontmatter required + enum 严格）+ 入口层（hero / IntroWithCTA / consultations index / submitted thank-you）+ 治理层（R322 propagation 5 载体齐 + audit log validate）
• commit + plan——三段闭环：plan ef84be3 feat 落地 · execute audit log cc3ad9c · falsify 归档 2d5530e · plan 文件 K01_读者咨询系统.md（已 archive · 跨 4 commit basename consult-k01-launch）
• plan basename echo（历史 backfill）——本 entry 由 updates-md-historical-backfill-w17-w15 audit 历史 W17 期补全 · 弥补原 04-23 落地后未独立 release note 直接 04-24 form-id 回填条目内嵌 K01 价值首发的漏列

---

2026.04.20 — 读者咨询入口上线 [这里有误？]

• 读者咨询入口上线——有具体经营问题可通过首页 Hero「问个问题」入口提交，编辑整理答复后发布至 /appendix/consultations/（目前为空 · 等待首批真实投稿）

---

2026.04.24 — AI 搜索引用能力升级（后台基建） [这里有误？]

• AI 搜索时代的结构化数据补全——给全站每页加了 schema.org 结构化数据（per-page JSON-LD · 工具页走 SoftwareApplication / 手册 + 城市档案 + 资源库 + 附录走 Article / 索引页走 CollectionPage / 首页保留 WebSite）。读者肉眼看不到变化，但 ChatGPT / Perplexity / Claude / Gemini / Copilot 在回答马来西亚餐饮相关问题时，更能识别本站内容是"算成本的工具 / 长文手册 / 城市档案 / 合规模板"中的哪一类，引用时更准确
• 新建 /llms.txt——按 llmstxt.org 规范给 AI 系统写一份项目介绍（含读者画像 / 三层内容 / 关键入口 / 数据方法论 / citation policy / non-goals），AI agent 不用解析整站 HTML 就能快速了解本站做什么
• robots.txt 复核——已正确区分 AI 训练爬虫（GPTBot / ClaudeBot / CCBot 等 Disallow）和 AI 搜索爬虫（OAI-SearchBot / Claude-SearchBot / PerplexityBot 等 Allow）· 本次审核无需改动
• 规则 R210 / R326 / R327 canonical 化——把上述做法写进 .claude/rules/registry.yaml（v25→v26 · 85→88 条）：R210 数字断言邻近来源 warn / R326 AI 引用基建三件套 canonical（robots + llms.txt + per-page JSON-LD）/ R327 AI citation 友好内容结构（self-contained answer 40-60 字 + 表格优于散文）· 未来新内容对齐
• 依据——Princeton GEO 2024 (KDD · Perplexity 跨平台实测)：结构化数据 AI 可见度 +30-40% / 引用来源 +40% / 统计数据 +37% / 专家引用 +30% / 关键词堆砌 -10%（反向损害）· 借鉴 coreyhaines31/marketingskills v1.8.0 (GitHub 24.2k star · MIT) ai-seo + seo-audit 源码方法论
• 读者侧零视觉变化——这是后台 SEO 基建 · 全站 120+ 页 frontmatter 的 title + description 回填 + handbook 章末「常见问答」H3 补充留待下一轮执行

---

2026.04.24 — 读者咨询表单上线 [这里有误？]

• 读者咨询 Tally 表建完——23 字段 v3.1（v3.1 新增字段 2b「具体城市 / 商圈」选填）· 3 步 multi-step + 进度条 · 8 条 conditional logic（7 条子问题按问题大类分支 + 1 条 email 在"只私复"时必填）· Respondent email 自动发确认邮件（Tally Pro + custom domain）· Google Sheets 同步到 myfnb-tally/读者咨询
• form-id 全站回填——hero 第 8 入口 / consultations 列表页 IntroWithCTA / submitted 感谢页跳转 / 各管理档案的占位符 <TODO-K01> → Gxo91j（7 文件同步替换）
• Sheet 「处理状态」列就位——Google Sheet 最右加一列 + 4 值下拉（待处理 / 处理中 / 已答复 / 已归档），future AI 处理咨询命令读这列判断状态
• 首屏 IA 重构——/appendix/consultations/ 列表页首屏从「CTA + 紧急 5 条 warning + 定位介绍」调整为「CTA(精简) + 答复列表(起始空状态) + 答复对象与时效」· 紧急 5 条下沉到页面底部 ::: warning · 对齐 2026-04-22 tools / stories / resources 同型整理
• Email 通道完整闭环——3 层 email 基建已全部到位：(1) Tally Respondent email 自动发提交确认（sender @forms.myfnbguide.com 子域 · DKIM 全绿）(2) Porkbun Email Forwarding 接收 notifications@myfnbguide.com 主域 → 项目 owner Gmail (3) Gmail Send-as alias 大马餐饮全指南 <notifications@myfnbguide.com> 供运营者手动答复发件 · 通过 Gmail SMTP 代发 + App Password 认证 · 2026-04-24 自发自收实测通过
• K01 全链路 Playwright 端到端验证通过——无痕浏览器填 23 字段 → 提交 → 跳 submitted 感谢页（无控制台错误）· Sheet 42 列全字段同步验证（字段 2b v3.1 城市 + 字段 9 选填 + 字段 12→13A 条件分支 + Checkboxes 多选展开 + 字段 19→20 必填条件全部对齐通过）· 测试行已删回起始空状态
• 进入起始空白状态——等待首批真实读者咨询 · 编辑整理后会发布至列表页

consult-k01-live · K01 form-id 全库回填 [这里有误？]

• form-id 全库回填——上节落地的 K01 form-id Gxo91j 在 7 个项目档案的占位符 <TODO-K01> 同步替换 · sheet-id myfnb-tally/读者咨询 在 5 个 canonical 档案对齐 · 防未来 grep 命中 placeholder 误以为 K01 未配
• commit + plan——commit be3a446（plan 文件无独立归档 · commit 作 single source）· 由 updates-md-historical-backfill-w17-w15 audit 历史 W17 期 plan basename echo 补全

consult-email-channel · K01 email 通道 3 层闭环 [这里有误？]

• 3 层 email 基建落档——(1) Tally Pro Respondent email 自动确认（sender @forms.myfnbguide.com 子域 · DKIM/SPF/DMARC 三件套全绿）+ (2) Porkbun Email Forwarding 接收 notifications@myfnbguide.com 主域 → 项目 owner Gmail + (3) Gmail Send-as alias 大马餐饮全指南 <notifications@myfnbguide.com> 供运营者手动答复发件（Gmail SMTP 代发 + App Password 认证）
• 2026-04-24 自发自收实测通过——3 层各跑 2 次往返测试 · 提交触发自动确认 + 主域转发收件 + 答复 alias 显示「大马餐饮全指南」发件人
• commit + plan——commit 4b9a6e5（plan 文件无独立归档 · commit 作 single source）· 由 updates-md-historical-backfill-w17-w15 audit 历史 W17 期 plan basename echo 补全

---

2026.04.22 — 入口层整理：工具页去搜索 / 资源库加筛选 / 分享 CTA 前置 [这里有误？]

• 工具页搜索栏删除——/tools/ 顶部的「搜索工具...」输入框不智能且与全站 MySearch 重复，去掉后只保留分类 tabs（全部 / 定价与盈利测算 / 日常经营工具 / 注册与速查 / 参考数据），切换即过滤
• 资源库加入分类筛选——/resources/ 10 份模板原本四段平铺（人员管理 / 供应链与食安 / 财务与运营 / 开业筹建），现在顶部加 tabs 和工具页一致，点「全部」看全部，点单类只看那一类
• 从业者页顶部加「分享经验」橙色按钮——/appendix/stories 页首灰色说明框内直接放橙色 CTA，点进页面立刻能投稿，不需要滚到底部才找到入口
• 全站右下角悬浮「分享经验」按钮移除——功能前置到页面顶部后，浮动按钮变得冗余且挡视线，保留右下返回顶部圆钮
• 新组件 IntroWithCTA——供页面顶部说明 + 橙色 CTA 组合复用，后续读者咨询页（/appendix/consultations/，K01 未上线）顶部将同 pattern 承载「问个问题」按钮
• 规则 R325 组件化优先 DRY canonical 上线——项目本已实然对齐"组件化一等公民"（22 工具组件 + 9 通用组件全抽取），但无 canonical 规则导致边界判断依赖直觉。本次把这条实然哲学 canonical 化到 .claude/rules/registry.yaml（v21→v22 · 85 条），明确：同一 HTML 结构 + CSS class 出现在 ≥ 2 文件必抽组件 + 全局注册。同日全项目 DRY 扫描 · 清 contents/index.md 手写 raw HTML 复制 SupportCTA template 一处 drift · 改用 <SupportCTA />（扩 SupportCTA.vue 的 ctaFrom 加 /contents/ 路径支持）。读者侧零视觉变化，但未来改 /support 链接 / 文案一处同步到所有引用页

---

2026.04.20 — 全站「开店」→「开业」覆盖极小型业态 [这里有误？]

原副标「城市开店指引 / 开店预算估算器 / 开店执照清单 / 7 步开店指引」等术语默认指向"开实体店面"，漏掉档口 / 家庭厨房 / 夜市摊 / 云厨房 / 流动餐车 / 食阁档位这些极小型业态读者——而项目 target 本来就涵盖他们。本次全站统一「开业」：

• 导航 / 侧栏 / 首页 / 快速入门 全部术语更新 → 城市开业指引 / 开业预算估算器 / 开业执照清单 / 7 步开业指引
• 68 城市档案 + 城市起步数据 SEO 描述与 CTA 统一 → "餐饮开业指引"
• 16 章手册 + 15 资源模板 + 5 工具页 + 8 appendix + 若干组件文案 语境化替换「开店」→「开业」
• URL 路径保持不动（/start/、/tools/startup-budget、/tools/license-checklist 等英文 slug 全部保留），旧链接 / 书签 / 外链完全不受影响
• 搜索同义词表 line 39 / 149 保留「开店 ↔ 开业」双向映射，搜「开店预算」老用法仍命中「开业预算估算器」；多处 SEO keywords 保留"开业 + 开店"双词兼容搜索引擎已索引历史
• 保留「开店」的语境：对比结构里特指"开实体店面"的场合不改，如麻坡 tagline「不是来开店的，是来做特产外输」、夜市验证 → 开店路径、家庭厨房 → 开店路径、外卖平台"在平台开店"行业术语、每日 SOP "开店前检查"日常运营语义、连锁展店"开店节奏"等

术语选择原因：马来西亚 SSM / LHDN 官方登记用的是「commencement of business」，对应中文是「开业」而非「开店」。「开业」= 开始营业，规模无关；「开店」= 开一家店铺，暗示实体店面 + 排除极小型。

---

2026.04.18 — 手册锚点 URL 命名统一 [这里有误？]

手册 / 附录 / 地图 / 资源模板页内所有段落小标题后的「#xxx」锚点 URL 做了一次命名统一（30 文件 / 666 个锚点）。大多数读者感受不到，但以下两种情况会注意到：

• 直接收藏或分享过站内段落链接 — 比如 /handbook/19-franchise-tax#s12-1-sst-collection 这类带 s + 数字开头的 fragment，现已改为纯主题词 #sst-collection。打开旧链接页面仍在，但不再自动滚到对应段落。用侧边栏目录或顶部搜索即可重新定位
• 外部博客 / 搜索引擎转载了旧 fragment 链接 — 同上，页面可访问，fragment 需重定位

改动原因：旧格式沿用了已弃用的 77 章编号（s7 / s12-1 / s17-5），但手册已按 01-19 章重编两年，锚点里的数字与文件名不匹配，新读者看到 /handbook/05...#s12-1-... 会疑惑「05 文件的 s12 是什么意思」。业界文档站（MDN / VitePress / Docusaurus）一致用纯主题 kebab-slug，本次对齐。

---

2026.04.18 — 故事点赞系统幕后升级 [这里有误？]

「从业者经验」故事卡的点赞按钮幕后做了 4 件事，对正常读者无感，但解决了真实场景下的几个老问题：

• 同咖啡店多人都能点赞 — 大马 4G/5G 网络下数百人共享同一公网 IP 是常态，旧逻辑用 IP 防重复投票导致「同一咖啡店第二位读者点赞被拦」。改用浏览器端匿名 ID（localStorage + cookie 双源记，清浏览器数据后还能恢复一次），从此不再误伤
• 手机 4G 切 WiFi 不会丢票 — 旧逻辑切网络等于换 IP，可能让同一人重复投票；新匿名 ID 跟设备走，跨网络稳定
• 并发点击不再多算或少算 — 服务端用 Redis Lua 原子脚本处理投票/取消，双开两 tab 同时点不会让计数 +2 或减负
• 防爬虫脚本刷票 — 加滑动窗口频率限制（每访客每分钟 10 次 API 调用上限），一人一票仍由后端 voted key 强制（不变）

---

2026.04.18 — 全站旧章节编号清理 [这里有误？]

• 战略规划综合定位速查表修复 — handbook/06 表格的「优先阅读章节」列原引用旧 77 章编号（第20章 / 第22章 / 第24章 等），部分章节在现 01-19 章制下根本不存在。全部改用手册实际章节名 + 内链（如 [传统与本土业态](/handbook/02-traditional-formats)）
• 「第 75 章 选址评分表」死引用清零 — 场景问答库 B 类槟城切入与 E 类扩张清单各引用一次「工具箱第75章选址评分表」；营销章节末尾引用「本手册第75章（经营者自我诊断体系）」。第 75 章均不存在，全部改指 /handbook/05-location-design 或去除无效指代
• 「第 12 章 税务合规」描述错位 — handbook/01 SSM/SST 误解段引用「第12章 税务合规」（第 12 章实为人力资源）。改为章节名「特许经营与税务合规」，链接不变
• 「手册第九章」描述改内链 — appendix/story-gaps 对新兴业态章的指代用编号，改为章节名「新兴与前沿业态」
• CogsTool 旧章节注释清理 — 组件内注释「与书中第44章数据一致」改为指向「行业基准数据库 /appendix/benchmarks」
• 完整目录地图节伪章节标题清除 — contents/index.md 地图节原在每个主题页内放「### 第 1 / 2 / 3 / 4 / 5 / 6 章 XXX」伪 h3 标题，但实际 map 页面内部结构不以"第 X 章"组织。去掉所有"第 X 章"前缀，锚点从 ch1-history 等改为 part-01-history-roots 等主题词 ID，要点列表去掉「1.1 / 2.1 / 3.1」伪小节编号

---

2026.04.18 — 导航清理 + 附录编号统一 [这里有误？]

• 顶部「从业者」菜单移除 — 原来跟「附录」并列放着的「从业者」菜单（场景问答库 + 从业者经验），两个条目全部被「附录」菜单收录过，属于 2026-04-01 拆分遗留冗余。现在删除，navbar 回归 8 项（入门 / 地图 / 手册 / 工具 / 资源 / 附录 / 关于 / 支持）
• 附录页 H1 编号统一去除 — 原来 8 个附录页的主标题混用「附录一 / 二 / 五 / 七」「第 74 章 / 第 77 章」「无编号」三套规则，且编号跳号（缺三 / 六）。现在全部去编号，用纯主题名，和 sidebar / URL 对齐
• 软件工具目录页 H1 错位修复 — 该页 URL 是「软件工具目录」但主标题写着「附录五：关键KPI快速参考表」，实际页内含 KPI + 数字工具两块。改为「软件工具与关键 KPI」覆盖全内容
• 死引用修复 — 场景问答库 E 类「检查薪资」原引用「工具箱第74章人工成本基准」（第74章不存在），改为直链「行业基准数据库（人工成本率 22-32%）」
• 完整目录附录节重写 — 原来只列附录 01-06，遗漏「行业基准数据库」「标杆案例库」两项；现在 8 项全列，和 sidebar 顺序对齐

---

2026.04.18 — 可访问性与分享图升级 + 首页 Hero 全面优化 [这里有误？]

• 链接与次要文字对比度加深至 WCAG AA 标准——手册正文链接从浅橙 #b45309 调至深橙 #9a4808（白底对比度 6.3:1）；工具提示、页脚说明等次要文字整体调深；保证弱视 / 老花 / 强光环境下读得清。不影响品牌橙主色，仅正文链接与 hint 级小字过 WCAG AA 4.5:1 要求
• OG 分享图换极简参考风——微信 / FB / WhatsApp / LinkedIn 转发链接时显示的卡片重做：象牙底 + 左橙竖条 + 淡灰指南针水印 + tagline「餐饮人自己的参考书」，去掉冗余数据徽章，突出"参考书"定位
• 首页首屏 Hero 全面重构——hero 背景图放大占满整个首屏（100svh）；导航 7 链接文案整体重写更紧凑（翻经营手册 / 用在线工具 / 查城市档案 / 听从业者经验 / 下载模板资源 / 支持这个项目 / 看改动日志），清掉重复词和硬编码数字；CTA 从"7 步指引"改"分步指引"不锁死步数；首页 navbar 简化为 logo-only（子页保留完整品牌文字），品牌展示让位给 hero 大标题，首屏更干净
• 「听从业者经验」副标同步 Tally 投稿分类 + mobile 字号下限微调——副标「一线经营心得」改成「开业、经营、成本、获客」（10 字纯四列举），对齐 Tally 投稿表单 A/B/C/D 四大 canonical 分类（开业经历 / 日常经营 / 财务与成本 / 营销与获客）+ 对齐兄弟 tools 副标「菜单定价、成本、排班计算」的无落点列举结构；stories 页面 startup 分类前台显示从「开店筹备」改「开业筹备」与表单用词统一；hero 链接 mobile 字号下限从 14.4px 提到 15.2px 更舒适。「开业」替「开店」贯穿是因为规模无关——档口、摊位、街铺、独立餐厅都叫开业

---

2026.04.17 — 手册 19 章加「本章小结」+ 术语首现括注 [这里有误？]

• 每章末尾新增「本章小结」section——19 章手册每章结尾统一加 3-5 条要点总结，便于快速回顾或决定是否深读
• 术语首现括注规范落地——全站 89 项技术术语首次出现时加括注英文 / 缩写（如 "SSM（马来西亚公司委员会）"、"JAKIM（伊斯兰宗教发展局）"），读者扫到陌生词不用跳出查
• 工具页手机端触控区统一 44×44px——按钮 / 操作元素在手机端满足 Apple 人机界面指南与 Google Material Design 的最低触控区标准，手指点击更稳
• 外卖平台利润对比工具换真实配图——原占位图替换为外卖袋实景图，工具卡更贴业态

---

2026.04.15 — 经验征集扩展至新兴业态 [这里有误？]

• 征集页扩展——/appendix/story-gaps 新增 5 类新兴业态征集：预制菜零售、Meal Kit 订阅、共享厨房、Dark Store、自动化与机器人餐饮
• Stories 页入口更新——征集提示扩展至新兴业态
• Ch09 交叉引用扩展——新兴业态章节末尾征集指引新增预制菜 / 共享厨房 / 机器人餐饮

---

2026.04.16 — 新手 7 步指引重写 + handbook 新手起步提顶 [这里有误？]

• quick-start 7 步指引重写——/quick-start 页面从原版散点列表改写为「业态自我定位 → 城市档案直入 → 资金估算 → 法规与执照速查 → 30 天日历 → 工具集 → 投稿分享经验」7 步顺序 · 每步含读者动作（"今天就能做"锚点）+ 推荐章节 + 推荐工具 · 30+ 入口链接收敛在单页内便于新读者按序走完
• handbook 新手起步章首提顶——/handbook/01 章首加「新手起步入口」节 · 顶部链回 /quick-start 形成「读手册 ← → 跑工具 ← → 看城市档案」三角入口
• commit + plan——commit 07d8194（plan 文件无独立归档 · commit 作 single source）· 由 updates-md-historical-backfill-w17-w15 audit 历史 W16 期 plan basename echo 补全
• W18 期跨载体覆盖——本 entry 重写已被 2026-05-01 onboarding-wizard-entry-pages plan 跨载体升级（<OnboardingWizard /> 3+2 progressive 决策树替代静态 7 步指引）· 历史 W16 期 plan basename echo 仅补 root entry 缺漏 · 不二次触发 K09 §16.3

---

2026.04.13 — 资源库 6 份法律/合规模板英文化（P27） [这里有误？]

• 背景：原中文模板打印出来无法直接用于签约/官方对接——马来西亚法律文件、JAKIM/MOH/Imigresen 等官方系统默认英文或 BM，中文翻译无法律效力
• 6 份模板英文主体重写，对齐官方术语：
  • employee-contract：EA1955 / EPF Act 1991 / SOCSO Act 1969 / EIS Act 2017 / Passports Act 1966，含全职/兼职/外劳三节
  • supplier-sla：Contracts Act 1950 + Sale of Goods Act 1957 框架，11 章商业协议标准条款
  • lease-negotiation-checklist：National Land Code 1965 + Stamp Act 1949（含 2026-01 印花税新规），30 项 + 签名区
  • food-safety-sop：HACCP 7 principles (Codex Alimentarius + MS 1480:2019) + MeSTI mapping + 每日/周/月检查清单 + 温度记录 + 纠正措施
  • halal-application-package：MYeHALAL + MS 1500:2019，28 项文件清单 + 8 类常见驳回原因 + 申请时间表
  • foreign-worker-compliance-pack：PLKS / FWCMS / FOMEMA / Act 446 全流程 42 项（Pre-recruitment / Arrival / In-employment / Termination）+ 6 条合规红线 + Year 1 成本估算
• 2026 数据：最低薪金 RM1,700 / 外劳 EPF 2%+2%（2025-10 起）/ F&B levy RM1,850-1,950 / 2026 Special Quota 窗口 01-19 至 03-31 / 印花税 RM2,400 豁免取消
• TemplateDownloader 加 lang='en' prop：header meta 标签切换 Downloaded/下载，品牌名保持双语
• 自适应 scale 优化：循环降级替代 floor 公式，canvas 允许到 15800px，员工合同英文版从 scale:2 提升到 scale:3（A4 169→254 DPI）
• resources/index.md 加 EN 英文 标签：6 份英文模板可一眼识别，保留 4 份中文模板（opening-90day / month-end / complaint / staff-handbook）
• 每份模板带官方来源链接（JTKSM / KWSP / PERKESO / FWCMS / FOMEMA / JAKIM / MOH / LHDN / NLC）
• 新建 P27 计划文档：记录英文化决策、方案评估、实施阶段

---

2026.04.13 — 资源库模板支持 PNG 下载 + 下载体系统一 [这里有误？]

• 新增 TemplateDownloader 组件——所有 10 份资源库模板页面顶部新增「下载图片」+「WhatsApp 分享 (PNG)」按钮，header 样式对齐实操工具（2px 暖黑下边线 / Noto Sans SC 字体 / 左右两列文档头）
• 10 份模板全部改造——员工合同 / 员工手册框架 / 外劳合规文件包 / 供应商 SLA / 食品安全 SOP / Halal 申请文件包 / 月末盘点清单 / 顾客投诉脚本 / 租约谈判清单 / 开业 90 天倒计时，均支持一键 PNG 下载与 WhatsApp 分享
• 自适应 scale 高清策略——PNG 优先 scale:4（A4 打印 ≈300 DPI 专业级），canvas 边长触顶 15000px 时自动降级（最低 scale:2），保证跨设备（Chrome / iOS Safari）可渲染；短模板实测 339 DPI，最长的员工手册自动降到 254 DPI 仍清晰
• 下载 util 统一——新建 .vitepress/theme/utils/downloadPNG.js 共享函数（renderDocumentCanvas / canvasToBlob / downloadBlob / shareOrDownload），SalaryTool / DailyCashTool / RosterTool / InventoryTool / PLTool / TemplateDownloader 6 个组件统一复用，消除重复实现
• 水印文案统一——全面精简为「myfnbguide.com · 仅供参考」（去除冗余品牌串，保留 L02 红线必需的"仅供参考"）
• 设计规范 6.10 全面更新——新增自适应 scale 策略、minWidth 阈值表、共享 util 规范，反映当前实际实现
• 资源库入口页说明更新——资源库首页顶部说明新增下载功能介绍
• P19 计划调整公示——原计划明确排除二进制下载，实际使用反馈后调整为 PNG 图片输出（用户自行打印手填或转发），不生成 Word/Excel

---

2026.04.13 — 空白业态经验征集专题 [这里有误？]

• 专题征集页上线——/appendix/story-gaps，列出 6 类完全空白业态（Food Truck / Pop-Up / Bar & Pub / Fine Dining / 中央厨房 / 加盟）与 2 类低覆盖业态（Bakery / 快餐），含投稿方式与保护机制说明
• Stories 页入口——从业者经验页顶部新增征集专题入口提示
• Ch07 连锁餐饮章节末尾交叉引用——Fine Dining / 加盟经验征集指引
• Ch08 传统业态章节末尾交叉引用——Bakery / 快餐经验征集指引
• Ch09 新兴业态章节末尾交叉引用——Food Truck / Pop-Up / 中央厨房经验征集指引
• 首页经验区入口——经验卡片展开后新增征集专题链接
• 04 入口层档案更新——经验分享表段落新增「空白业态专项征集」子节 + regression 自检清单更新（3→4 处源码位置）

---

2026.04.13 — 工具页纠错入口扩展 [这里有误？]

• 新增 ToolFeedback 组件——工具页专用纠错入口，文案「算错了？告诉我们」，复用纠错表后端，预填工具名与段落位置
• e-Invoice 合规测试——新增工具纠错入口（合规测试结果区）
• 开店执照清单——新增工具纠错入口（执照清单结果区）
• 餐饮经营问答——新增工具纠错入口（问答内容区）
• 开店预算估算器——新增工具纠错入口（预算计算结果区）
• 盈亏平衡点计算器——新增工具纠错入口（计算结果区）
• 食材成本率计算器——新增工具纠错入口（计算结果区）
• 菜单定价计算器——新增工具纠错入口（定价计算结果区）
• 租金承受力评估——新增工具纠错入口（租金计算结果区）
• 外卖利润计算器——新增工具纠错入口（外卖利润计算结果区）
• 员工成本规划器——新增工具纠错入口（人力成本计算结果区）
• 现金流预测器——新增工具纠错入口（现金流预测结果区）
• 每日现金对账——新增工具纠错入口（对账结果区）
• 每周排班表——新增工具纠错入口（排班结果区）
• 每周库存盘点——新增工具纠错入口（盘点结果区）
• 薪资计算器——新增工具纠错入口（薪资计算结果区）
• 月度盈亏报表——新增工具纠错入口（盈亏报表结果区）
• 04 入口层档案更新——ToolFeedback 扩展子节与 regression 自检清单追加

---

2026.04.13 — Ch17 现代渠道深化 + 危机公关专题 [这里有误？]

• TikTok Shop + Live 实操段（§54.6）——直播电商在F&B的五大场景、TikTok Shop费用结构、直播起步配置与合规红线
• 小红书营销段（§54.7）——平台定位与马来西亚300万华人用户画像、Visit Malaysia 2026中国游客商机、KOL/KOC合作费用参考
• WhatsApp Business + Meta Ads 私域漏斗（§54.5 扩写）——基础版 vs API对比、消息计费规则、Click-to-Chat广告完整漏斗、Template Message场景
• 社媒病毒式危机4小时黄金响应（§56.3-56.4）——2026高频场景、三级应对框架、食安舆情升级SOP、绝对禁忌清单
• Ch14 前厅投诉处理交叉引用——投诉上社媒时指引跳转至Ch17危机公关专题
• 术语词典新增8条——直播电商、种草、KOC、KOL、社区经理、点击聊天广告、模板消息等

---

2026.04.13 — Ch18 数字化深化 + AI应用章节 [这里有误？]

• AI库存预测与补货（§66.1）——基于销售历史+天气+节庆的食材需求预测，月费区间与适用门槛分析
• AI排班优化（§66.2）——自动生成合规排班表，马来西亚劳工法参数配置与月费参考
• AI客服与电话应答（§66.3）——自动接单与WhatsApp回复，三语挑战与投入产出评估
• AI菜单工程（§66.4）——销量×毛利率分析与动态定价，小店替代方案指引
• AI选址热力图（§66.5）——人流+竞品+订单密度可视化，本地替代方案与适用阶段
• AI视觉质检与浪费追踪（§66.6）——厨房摄像头识别丢弃食材，大型厨房投入回报分析
• POS四档选型指南（§61.1）——从手开票到含AI一体化系统，按月营业额匹配适合的POS档次
• 小店数据分析三招（§63.1）——Google Sheets仪表板、POS报表读法、外卖平台数据导出实操
• 数字化转型三档方案（§67）——Lite/Mid/Pro三档按月预算分级，含起步配置、3个月成果和12个月目标
• 术语词典新增6条——Agentic AI、Predictive Analytics、Vision POS、AI Menu Engineering、Dynamic Pricing、Prime Cost Monitoring
• 软件目录新增AI工具分类——AI库存预测、AI排班、AI客服、AI菜单工程、AI视觉浪费追踪五个类别

---

2026.04.13 — 新兴业态章节扩写 [这里有误？]

• 预制菜零售（§21.9）——从堂食延伸到超市货架的三种切入路径、渠道定价结构、合规要求与启动成本
• Meal Kit订阅（§21.10）——"做饭组合包"在马来西亚的商业逻辑、目标客群与冷链配送挑战
• 共享厨房（§21.11）——与云厨房的区别、Klang Valley租金结构参考、适合与不适合的使用场景
• Dark Store前置仓（§21.12）——平台自建与经营者自建两种模式对比、合规与商业风险分析
• 自动化与机器人餐饮（§21.13）——三档选择（全人工/部分自动化/近全自动化）、成本与回本周期分析
• 常见误解补3条——预制菜进超市、共享厨房零风险、机器人替代人工的认知纠偏
• 术语词典新增5条——Ready Meal、Meal Kit、Shared Kitchen、Dark Store、Robotic Restaurant
• 业态快速路径表新增3条——预制菜零售、共享厨房、机器人餐厅的章节组合推荐

---

2026.04.13 — 资源库上线 [这里有误？]

• 资源库板块上线——新增 /resources/ 资源区，提供 10 份餐饮经营常用模板与清单，可直接复制使用
• 员工合同模板——符合 EA1955（含 2022 修正案）的全职/兼职/外劳合同骨架
• 供应商 SLA 模板——交期、品质验收、价格调整、违约金、终止条款框架
• 租约谈判清单——签租约前的 30 项核查，涵盖租金、装修、退出机制
• 食品安全 SOP 框架——基于 HACCP 7 原则 + MeSTI 对接 + 每日/每周/每月检查清单
• Halal 申请文件包——MYeHALAL 数字化申请所需的 22 份附件清单与流程指引
• 开业 90 天倒计时——D-90 到 D-0 按周分解的 60 项开业筹备清单
• 月末财务盘点清单——库存、现金、应收应付、EPF/SOCSO/EIS 缴款逐项核对
• 员工手册框架——16 章骨架，从欢迎词到附录的完整结构
• 顾客投诉响应脚本——5 类场景的面对面脚本 + 线上回复模板 + 升级路径
• 外劳合规文件包——从招聘到离职的全流程文件清单与合规红线
• ResourceCard 组件——资源库展示卡片，CSS 渐变色块区分类别
• 首页/手册/工具箱入口——首页 Hero 新增资源库入口，手册和工具箱页面补链接

---

2026.04.13 — Budget 2026 与法规系统刷新 [这里有误？]

• e-Invoice Phase 4 日期对齐——三个附录页（FAQ / 软件目录 / 政府目录）原本写"2026 年 1 月 1 日实施"已对齐税务章，更正为"2027 年 1 月 1 日强制（原定 2026.1.1，已推迟一年），宽限期 12 个月"
• e-Invoice 单笔 RM10,000 独立开具规则补充——附录与税务章都补一句"任何单笔交易 ≥ RM10,000 须独立开具，不得纳入合并发票（2026 年 1 月 1 日已对所有 Phase 1-3 企业生效，不受 Phase 4 推迟影响）"
• 外劳 Levy RM1,850 现状刷新——劳动法规章补 2026 缴付强化要求（VDR 签发前必须缴付，须经 FWCMS/eServices 在线缴付）
• 2026 外劳特殊配额窗口注记——劳动法规章补 KDN 已于 2026 年 1 月 19 日起开放、原定 3 月 31 日截止已被移除、须经在线预约系统申请且不得通过中介
• JAKIM MYeHALAL 处理时限刷新——清真认证章补 2026 年官方目标 15-30 个工作日（完整资料后）、缴费 14 工作日时限、Malaysian Halal Commission 已运营
• SST 2026-01-01 全面执法节点补充——税务章补 2025-07 扩张后宽限期至 2025-12-31、2026-01-01 起严格执法、餐饮业维持 6% + RM1,500,000 门槛
• Budget 2026 融资渠道扩充——商业策略章新增 §15.6 三-A 板块，列入 9 项新渠道：数字化匹配资助 RM50M、Digital Acceleration Grant RM53M、MATRADE MDG RM60M、SJPP 担保池上调至 RM30B、清真业务贷款担保翻倍至 RM2B 等
• 2026 食材成本补贴变动链补充——后厨供应链章新增 §44.1.1 板块，覆盖 BUDI95 配额自 2026-04 起减为 200L/月、鸡肉天花板审视、食用油 2026-03 起禁外国人购买、化肥成本传导链对食材的潜在影响

---

2026.04.13 — 经验墙交互修复与移动端筛选优化 [这里有误？]

• 经验墙筛选按钮高亮态修复——之前点中后再悬停时按钮变成橙底橙字看不见，现已修复保留白字（从业者经验墙）
• 经验墙手机端筛选条改横向滑动——三组筛选（排序/区域/分类）原本在手机上换行成 5+ 行，现改为单行横滑、加左侧标签前缀消歧义（从业者经验墙）
• 城市起步页区域筛选手机端改横向滑动——9 个区域按钮原本在手机端换两行居中，现改为单行横滑（在哪座城市开店？）
• 餐饮经营问答分类筛选手机端改横向滑动——7 个分类原本换行，现改为单行横滑（餐饮经营问答工具）
• 工具箱分类筛选手机端改横向滑动——4 个分类原本换行，现改为单行横滑（工具箱首页）

2026.04.11 — 改动日志与首页入口 [这里有误？]

• 改动日志页上线——新增 /updates 页面，建立自进化公示机制
• 隐私政策泛化——不再写死具体表单数量，改为弹性描述
• 首页 hero 新增入口——「大家带来的更新」链接指向 /updates
• hero 入口文案调整——改为「大家带来的更新」，语气更贴合读者视角
• 关于页与目录页补入口——两个页面新增 /updates 链接
• 改动日志首屏精简——去掉内部架构术语，改为读者视角描述
• 首页 hero 按钮重排——Quick Start 升至第一位，手册入口文案改为用户导向措辞
• 感谢页与隐私政策脚注清理——去掉残留的内部术语
• 上线前建设记录补充——以读者语言描述平台建设历程
• 改动日志开头重写——整页开头改为读者视角

2026.04.10 — 安全加固、性能优化与纠错入口 [这里有误？]

安全与部署：

• 安全头补全——vercel.json 新增 X-Frame-Options / X-Content-Type-Options / Referrer-Policy 等浏览器级防护
• AI 爬虫屏蔽——robots.txt 新增 GPTBot / CCBot / ClaudeBot 等 AI 训练爬虫规则
• 点赞 API 域名限制——clap.js CORS 限制为自有域名，新增 ID 格式校验
• 主屏幕图标声明修复——site.webmanifest 补 maskable icon 声明

性能：

• 字体加载优化——CSS @import 迁移至 HTML <link> 标签，移除未使用的 wght@300 字重
• 首屏资源优化——hero 图片添加 preload 预加载，城市卡片图片改为 lazy loading
• 图片格式统一 WebP——全站 34 城市卡片图片统一转为 WebP 格式，hero 图片同步压缩
• 移除 jsPDF 依赖——不再使用的 PDF 库从构建中移除，减小体积

新功能：

• 删除 ClapButton 组件——功能已由 SectionFeedback 替代，清除冗余代码
• 自定义中文 404 页面——走到错误链接时看到中文引导页，不再是英文错误信息
• 段落级纠错入口上线——手册每个 h2/h3 标题旁新增「这里有误？」按钮，点击直接跳转反馈表单
• 纠错入口扩展至 h4——覆盖手册 49 个时效敏感子章节及地图 2 个文件 19 个 h4 标题

2026.04.09 — 大规模数据校准 [这里有误？]

禁止用词清除：

• 全站 38 文件清除绝对化措辞——移除「必须/唯一/首选」等绝对化、口号化、承诺性表述（第一轮）
• 补充清除残留——「必须/最优」等绝对化残留在 9 个文件中修正（第二轮）

根页面与法律页：

• 目录页对齐检查——内容完整性修复
• 手册入口页更新——章节列表和描述校准
• 法律三页同步 PDPA 2024 修案——免责声明/隐私政策/使用条款同步更新

手册逐章数据验证：

• Ch01 企业注册——SSM 费用等数据更新，修正禁止用词
• Ch02 食品安全——卫生法规数据验证更新，修正禁止用词
• Ch03 清真认证——系统名称统一 MyHALAL → MYeHALAL，URL 更新，费用表免责加强
• Ch04 劳动法规——工时/最低薪金/EPF 外劳/SOCSO/EIS 上限共 8 项过时数据修正
• Ch05 特许经营与税务——e-Invoice 时间表重写（5 阶段 + Phase4 推迟至 2027 + Phase5 取消），特许经营主管部门 KPDN → KUSKOP
• Ch05 补充——e-Invoice Phase4 延至 2027 年 1 月，SST 酒精 8% 补充说明
• Ch06 战略规划——最低薪金 RM1,500 → RM1,700，人口数据更新至 2025，融资渠道名称更新
• Ch07 连锁业态——特许经营 KPDN → KUSKOP，法令引用修正（2020 修案），McDonald's 门店数更新
• Ch08-19 批量验证——经营管理章节数据验证及基准更新
• Ch12 人力资源——最低薪金日期修正 2023 年 1 月 → 2025 年 2 月，EPF 示例核实
• Ch13/Ch16 SST 门槛——餐饮业 SST 注册门槛修正为 RM1,500,000
• Ch17 营销与外卖——社交媒体数据更新至 DataReportal 2026，ShopeeFood 升至区域第二
• Ch18 数字化——e-Invoice 时间表重写同步

e-Invoice 工具重写：

• e-Invoice 工具组件全面重写——5 阶段时间轴 + Phase4 推迟 2027 + Phase5 取消 + RM1M 门槛
• e-Invoice 工具页面同步重写——独立 .md 页面内容对齐组件
• e-Invoice 宽限期更新——Phase4 延长至 12 个月 + RM10K 规则不受宽限期影响
• 伤寒疫苗与 SSM 费用交叉验证——调研 Agent3 交叉验证修正

BizFaq 与工具数据对齐：

• BizFaqTool FAQ 数据修正——最低薪金/e-Invoice/FOMEMA 三项数据更新
• 执照清单与 StaffCost 复核——工具页数据与 handbook 对齐
• 工具组件数据对齐确认——禁止用词修正
• 工具内嵌法规数据更新——全部更新至 2026 年 4 月基准

城市与地图数据：

• KL 页数据更新——Greater KL 人口/收入/外卖数据更新，ECRL 进度更新至 91%
• 巴生谷 4 城对齐——city-start.js 数据及禁止用词修正
• 槟城北马 3 城 + 霹雳 5 城——数据对齐与禁止用词修正
• 柔佛 7 城 + 马六甲/芙蓉/东海岸 6 城——数据对齐与禁止用词修正
• 东马 8 城——数据对齐与禁止用词修正
• 市场数据更新——旅游/收入/GDP/通胀/最低工资更新至 2024–2026 基准
• 饮食地图禁止用词修正——行业规模口径统一至 RM750-800 亿
• 节庆日历更新——更新至 2026 年实际日期
• 饮品章与历史文化章——品牌门店数更新，禁止用词修正
• FAQ 页 e-Invoice 更新——Phase5 取消/RM100 万豁免等时间线同步
• 莎阿南描述修正——city-database 禁止用词修正
• 附录页审核——e-Invoice 政策更新 + 软件目录审核 + 禁止用词修正

语言与用词规范：

• 全站语言用词对齐——涉及 20+ 组件与 20+ 内容文件的术语、语气、禁止用词统一

SEO 元数据：

• 添加 titleTemplate——全站 title 后缀自动化，清理手动重复后缀
• 35 城市档案页补齐 SEO——每页补齐 title + description
• 4 页缺失 frontmatter 补齐——contents/map/cities/start 入口页
• keywords 格式归一——全站统一为 Format A
• 11 个超长 description 缩短——压缩至 160 字符内
• sitemap 排除 noindex 页面——搜索引擎只索引有用内容

结构与链接：

• 关闭 ignoreDeadLinks 并修复死链——开启严格检查后修复 1 个内部死链
• 目录页补齐缺失链接——每个目录项均可点击
• 修复 2 个超长锚点 ID——压缩至 50 字符以内
• 修复 2 个失效外链——政府机构和行业协会 URL 更新
• 修复 stories.js 中 3 个错误工具 slug——故事卡片链接指向正确工具页

组件与样式规范化：

• custom.css 全面规范化——消除重复规则、统一命名、清理注释
• 下载工具组 5 组件规范化——DailyCash/Inventory/PL/Roster/Salary 代码格式统一
• 计算工具组 8 组件规范化——BEP/Budget/CashFlow/COGS/DeliveryProfit/Pricing/Rent/StaffCost 统一
• 内容页面组件组 6 组件规范化——BizFaq/CityStartIndex/CityStartPage/EInvoice/LicenseChecklist/StoriesWall 统一
• 平台组件组规范化——ClapButton/FloatingActions/MySearch/SiteStats/ToolCatalog 统一
• PDF 渲染前 minWidth 拉宽——下载前自动拉宽容器，防止窄屏截断
• 跨组件一致性终检——15 工具的 CTA/按钮/间距/配色统一修复

工具一致性：

• BizFaqTool 支持入口统一——class 统一为 tool-support-cta
• LicenseChecklist 跨工具修复——与其他工具行为对齐

2026.04.08 — 用词审核与交互优化 [这里有误？]

• 白色文字透明度提升——暗色背景上的文字可读性改善
• 首页卡片墙三区域分离——手册/工具/城市三个区块可独立展开收起
• 暖底色收编为 CSS 变量——消除硬编码色值，全站视觉更一致
• 全站用词优化——消除绝对化/口号化/承诺性表述，涉及组件与 38 个内容文件
• 故事与案例匿名化——保护隐私，修正事实错误，基准数据更新至 2026 年
• 5 个工具打印水印统一——下载文档底部统一标注「myfnbguide.com · 仅供参考」
• 首页展开状态持久化——浏览器返回时已展开的区块不再自动收起
• 展开状态改用 sessionStorage——F5 刷新重置、返回保持，交互更符合预期

2026.04.07 — 工具功能扩展与全站统一化 [这里有误？]

工具数据修正：

• SalaryTool 修正 8 项法定数据——EPF/SOCSO/EIS 费率及阈值对齐 2025 年法规
• DailyCashTool 删除按钮 emoji——按钮文字改为纯中文
• RosterTool 新增 OT 三档倍率——普通日/休息日/公共假期分别计算，同步增加日期类型选择器并删除 emoji
• InventoryTool 删除按钮 emoji——按钮文字改为纯中文
• PLTool 删除按钮 emoji——按钮文字改为纯中文
• StaffCostTool 法定费率更新——对齐 SalaryTool 已修正数据
• BizFaqTool 最低时薪修正——RM8.17 → RM8.72

导出功能重构：

• 导出格式从 PDF 改为 PNG——去掉 PDF 中间层，直接生成高清 PNG 图片下载
• SalaryTool 移动端溢出修复——薪资单在小屏幕上不再水平溢出

城市图片替换：

• 9 个小城市图片替换——用当地风景图替代找不到实景的城市
• 金宝城市图片替换——更换为更有代表性的照片

工具功能扩展：

• StaffCostTool ≥60 岁差异化——支持法定供款年龄差异计算，全站费率同步更新
• 外卖平台补全——DeliveryProfitTool 新增 AirAsia Food，DailyCashTool 新增 Foodpanda
• CashFlowTool 一次性支出扩展——上限从 2 项增加到 5 项
• StaffCostTool 岗位补全——新增更多预设岗位 + 自定义岗位 + 行政后勤部门
• LicenseChecklist 条件分支——新增酒类/露天/夜间营业三个分支牌照提示
• 3 工具城市覆盖扩展——BudgetTool/LicenseChecklist/RentTool 统一扩展至 8 个城市区域
• 业态列表补全——RentTool/CogsTool/LicenseChecklist 新增更多业态选项
• InventoryTool 业态预设模板——按业态自动填入常见盘点品类

全站统一化：

• 创建 BIZ_LABELS 共享常量——全站业态名称统一来源
• stories.js 业态名统一——茶室 → 茶餐室
• 工具链接文字统一——约 30 处散落在手册中的工具链接文案对齐
• 财务术语统一——启动资金/食材成本/毛利/人工成本措辞对齐
• 侧边栏标签修正 + RM 格式统一 + sqft 格式统一——全站数字与单位格式对齐
• 「牌照」→「执照」全站统一——约 80 处用词修正
• 补漏对齐——业态名/工具名/RM 格式/城市数据等剩余不一致项修正
• CityStartPage 关键数据卡片断行——长文本自动换行，手机端不再溢出

全站英文锚点 ID：

• handbook 01-05 英文锚点——109 个中文标题 ID 改为英文
• handbook 06-10 英文锚点——98 个标题
• handbook 11-15 英文锚点——175 个标题
• handbook 16-19 + index 英文锚点——177 个标题
• map/cities 36 文件英文锚点——180 个标题
• map 根层 6 文件英文锚点——98 个标题
• tools 目录 18 文件英文锚点——19 个标题
• appendix/contents/legal/根目录英文锚点——103 个标题

视觉与搜索：

• 全站 logo 替换为新指南针设计——logo.svg + 三尺寸 PNG 图标同步更新
• logo SVG 微调——山丘平顶、圆环粗细、指针圆角修正
• OG 社交预览图字号加大——WhatsApp 缩略图文字更清晰
• 搜索系统全面优化——keywords 修正 + 共享分词器 + 拼音同义词 + 结果展示改进 + 容错
• 搜索 bigram 步进修复——改非重叠步进长，修复「注册执照」等跨词查询

支持系统：

• 支持系统优化（阶段一）——16 工具底部统一 SupportCTA 组件，支持页/感谢页文案精简
• 支持页重构——双卡片布局 + 文案精简 + 付后体验优化

2026.04.06 — 页面重写与 34 城全上线 [这里有误？]

• 关于/支持/参考来源整文重写——三个页面内容优化，清除承诺性措辞
• 34 城全上线——城市策展体系完成，psf → 月租，卡片增加评分条，交叉链接补全
• 新增 14 城独立页面——文冬/民都鲁/金宝/巴生/居銮/旁地安/诗里基/北海/实兆远/太平/斗湖/安顺/永平等上线（含照片与数据）
• 关于页/目录页/首页/法律页入口更新——同步新增城市的链接
• 搜索同义词库扩展——覆盖新增 14 城的搜索关键词

2026.04.05 — 域名升级与自定义搜索 [这里有误？]

• 域名迁移 myfbguide.com → myfnbguide.com——原域名中的 fb 与 Facebook 搜索结果混淆，加入 n 代表 F&B（Food & Beverage）
• 全站域名引用更新——工具组件/内容页/robots.txt/支持页等处同步迁移
• 感谢页文案通用化——兼容所有表单跳转，不再只针对单一表单
• 自定义搜索系统上线——替代 VitePress 默认搜索（默认搜索的中文分词不够准确）
• 评分条改版——改为格栅散布设计，清理 3 个旧组件（HomepageStories/ToolCard/CityCards）
• 内部路径更新——MYF&B_Book → myfnb-guide
• OG 社交预览图重设计——品牌琥珀渐变 + 简洁排版
• 主屏幕图标全设备覆盖——iOS apple-touch-icon + Android PWA icon-192/icon-512 + webmanifest

2026.04.04 — 首页体验细节 [这里有误？]

• 34 城策展计划扩展——从 20 城扩展至 34 城规划，清理 config 死代码
• 首页底部 CTA 区重构——深色背景首尾呼应 Hero，三级自适应布局
• 首页 Hero 重构——视觉层次拉开，CTA 文案改版，清理旧素材
• Hero 优化细节——去底部 4vh 间距，SiteStats 改 clamp()，透明度层级拉开
• Hero 图片与卡片缩略图分离——卡片改用 WebP 小图快速加载，hero 保持高清大图，img 标签利于 SEO
• 评分条改为连续填充——标签移至上方，手机端显示更紧凑

2026.04.03 — 首页大改版 [这里有误？]

首页重构：

• Hero 改版为 Nomadlist 风格——SiteStats 融入 hero 区域，视觉更整合
• HomepageGrid 卡片墙上线——工具/城市/故事统一卡片交互
• 工具卡片图片化——16 个工具配图上线，首页渐变叠字效果
• 工具箱页 ToolCatalog 改版——同步 Nomadlist 风格卡片
• 故事卡片改版——浅底左竖线条设计

搜索：

• 搜索 CJK 分词升级——字符级分词 + 中文 UI + 详情视图
• 搜索 keywords 注入——别名注入 + fuzzy 分级 + 21 城市关键词

响应式优化：

• 全站 font-size clamp() 迁移——47+ 硬编码值替换为自适应函数
• auto-fill 零断点网格——替代手写媒体查询
• PDF 打印自适应——下载文档适配不同纸张尺寸
• 响应式收尾——分隔线/评分条/悬浮按钮 clamp() 迁移，冗余断点清理
• 隐藏全站滚动条——页面视觉更干净
• 首页卡片网格间距收窄——手机端统一 12px 边距

城市与其他：

• 城市策展页系统上线——含 20 城及 slug 全名化修正
• 删除 changelog 页面——后续由 /updates 替代
• OG 分享图替换——改为天际线版本

2026.04.02 — 城市数据库诞生 [这里有误？]

• 20 城独立页面上线——每座城市含租金/竞争密度/消费力等开店参考指标，首页新增城市数据库区块
• 20 城完整饮食档案——真实城市照片 + 卡片交互改版
• 20 城注入 2025-2026 数据——基建/产业/政策全面更新
• 9 城数据补充——法律风险措辞修正
• 怡保卡片照片修正——原图被吉隆坡双峰塔替代，已更换为怡保实景
• 替换 20 城卡片照片——全部换为更有代表性的城市照片，修正英文名
• 槟城卡片照片替换——更换为更具辨识度的照片
• 美里卡片照片替换——更换为更具辨识度的照片
• 首页字数统计上线——展示平台总字数（当时已超 316,676 字）
• 宽屏布局优化——桌面版最大宽度 780px → 1200px，工具卡 3 列/故事 2 列
• og:image 社交分享上线——WhatsApp/Facebook 等分享时正确显示标题/描述/缩略图
• WhatsApp 分享文本修正——去掉个人计算数据，改为纯工具推荐
• URL 路径英文化——5 个文件夹 + 34 个文件重命名，656 处引用更新
• StaffCostTool 员工行折叠修复——显示问题修正
• DeliveryProfitTool 行内提示补全——缺失的输入提示补上
• iOS Safari 下载修复——window.open 移到 await 前，防止 Safari 静默拦截弹窗

2026.04.01 — 手册深化与众包入口 [这里有误？]

手册深化：

• Phase 6 合规与基础章节深化——手册 01/02/04/05 内容充实
• Phase 7 运营与增长章节深化——手册 07-14、19 内容充实
• Phase 8 地图与参考深化——地图 01-06、工具箱、附录内容充实
• Phase 9 横向链接与跨层桥梁——全书 19 章交叉导航补全
• Phase 10 死链修复——构建验证通过

首页与导航：

• 全书内容重构完成——19 章 4 阶段深化，约 4000+ 行内容增补
• 导航文字调整——「速览」改「入门」，首页副按钮改「开店指引」
• 首页副按钮再调整——改为「快速入门」
• 手册入口页更新——章节列表同步调整
• 首页新增区块——「从业者实报数据」数据展示区上线

众包 CTA：

• 租金/薪资工具众包 CTA——新增「贡献数据」按钮，邀请从业者提供真实数据
• 众包 CTA 按钮统一——大小与 WhatsApp 按钮对齐

2026.03.31 — 全站改版 [这里有误？]

16 工具 UX 统一：

• 16 工具全面中文化——按钮/标签/提示文字全部从英文改为中文
• 全站 emoji 清除——工具按钮/标签/状态文本中的 emoji 全部移除
• WhatsApp 分享按钮统一——文案和样式全站对齐
• Logo 颜色修复——修正 logo 在不同背景下的显示问题
• 按钮样式统一——hover/focus/CTA/圆角全站对齐
• Blockquote 样式修复——引用区块视觉修正
• 术语统一——全站工具中的专业术语措辞对齐
• 折叠区块统一——交互行为全站一致
• 输入提示统一——placeholder 文字全站格式对齐
• 标签规范统一——输入标签命名全站对齐
• 故事墙组件改版——横向滚动 + 卡片视觉重设计
• 支持页内容填充——支持页面正文更新
• 地名格式统一——州名英文化，涉及 19 个页面
• HomepageStories 上线——stories.js 作为单一数据源驱动首页故事区
• 法律三页中文化——免责声明/隐私政策/使用条款内容中文化
• 5 工具签名区统一——底部信息格式全站对齐

下载功能：

• PDF 下载功能上线——DailyCash/Inventory/PL/Roster/Salary 五个工具支持下载
• jsPDF 移除——被杀毒软件误报为恶意文件，改用 html2canvas 纯渲染
• 下载内容截断修复——移除 overflow:hidden 限制 + 增加文档宽度
• SalaryTool OT 三栏布局——加班费拆分为三栏展示
• 下载工具多轮修复——表单渲染与内容完整性持续修复

2026.03.30 — 12 个新工具上线 [这里有误？]

新工具：

• BizFaqTool 上线——常见问题速查工具
• BudgetTool 上线——开店预算计算器
• LicenseChecklist 上线——执照清单检查器
• PricingTool 上线——菜单定价计算器
• RentTool 上线——租金可负担性评估工具
• StaffCostTool 上线——人力成本计算器
• CashFlowTool 上线——现金流预测计算器
• DeliveryProfitTool 上线——外卖利润计算器
• DailyCashTool 上线——每日现金登记表
• InventoryTool 上线——盘点表
• PLTool 上线——月度损益表
• RosterTool 上线——员工排班表

UI 改进：

• 工具目录 ToolCatalog 更新——16 工具齐全上架
• 全站品牌色更新——切换为 #b45309 琥珀色
• SalaryTool 大幅更新——交互/布局/视觉全面改版
• 12 工具页面上线——每个新工具各有独立 .md 页面
• 工具分类数据更新——categories.js 同步新工具

2026.03.29 — 法律保护体系与社区投稿管道 [这里有误？]

法律保护：

• 免责声明页上线——legal/disclaimer.md 发布
• 隐私政策页上线——legal/privacy.md 发布
• 使用条款页上线——legal/terms.md 发布
• 全站 19 页底部免责声明部署——所有内容页面统一加入免责声明
• 品牌提及中性化——工具箱页面中涉及具体品牌的措辞改为中性表述
• 支持页修正——支付尚未接入，不再声称已处理支付
• OldTown 措辞中性化 + SSM 声明修正——补两处遗漏
• 卷三 OldTown 评价中性化——手册章节遗漏修正

UI/UX 重构：

• 首页 UX 重构——三路入口/工具区块布局/logo 更新
• 4 工具 UI 改进——BEP/COGS/e-Invoice/Salary 的 hover/focus/按钮统一
• CSS 与首页样式更新——全站视觉风格调整
• 投稿表单更新——FloatingContribButton 文案变更 + SalaryTool 字段微调
• 感谢页更新——提交后页面内容更新
• 站点配置更新——导航/SEO 相关配置调整
• vercel.json 重定向配置更新——URL 路由规则修正
• 关于页与支持页更新——内容调整和链接更新
• 工具页面信息更新——支持/支付信息同步
• BackToTop 按钮上线——页面底部返回顶部按钮
• FloatingActions 组件上线——BackToTop + FloatingContrib 合并为统一悬浮组件

社区功能：

• 故事墙 StoriesWall 上线——从业者经验展区
• 点赞功能 ClapButton 上线——读者可以点赞有帮助的内容，含 clap API 服务端
• 工具目录 ToolCatalog 改版——ToolCard 组件 + categories.js 分类数据上线

2026.03.27 — 计算器与导航改版 [这里有误？]

• COGS 食材成本率计算器上线——双模式 + 7 业态基准 + 三档行动建议 + WhatsApp 分享
• BEP 盈亏平衡点计算器上线——固定/可变成本拆分 + 外卖佣金折算 + 四档状态判断 + 安全边际
• BEP 示例数据按钮——一键填入参考数据降低填写门槛，字段参考范围 + COGS 引导链接
• 推荐工具页上线——recommended-tools 页面 + 首页工具区入口更新
• 导航改为下拉菜单——首页加数字工具参考入口
• 数字工具参考页重建——导航下拉重构 + 附录措辞修正
• 工具箱侧边栏排序修复——改用 frontmatter order 字段
• 推荐工具页内容更新——描述和分类调整
• 首页配置更新——config.js + index.md 导航调整

2026.03.26 — e-Invoice 与薪资计算器 [这里有误？]

• e-Invoice 查询工具上线——EInvoiceTool 组件 + 独立工具页面 + 首页入口
• 薪资计算器上线——SalaryTool 组件 + 独立页面 + 首页入口
• 工具 emoji 清除——e-Invoice 与薪资计算器按钮文字改为纯中文
• Tally 经验表单改造——新增亲身经验字段和章节字段，FloatingContribButton 组件上线
• FloatingContribButton 样式修复——按钮视觉微调
• config.js 配置修正——站点配置更新

2026.03.25 — Logo 上线与基础设施 [这里有误？]

• 指南针 Logo 上线——网站品牌标识和浏览器图标（favicon）设置完成
• Logo 品牌资产发布——logo_full_badge.png 版本
• Logo 造型修复——SVG 透明背景 + 造型微调
• 深色模式 Logo 适配——浅色和深色主题下 Logo 均正常显示
• GA4 流量分析接入——Google Analytics 开始采集访问数据
• 首页三路入口上线——三个维度的内容入口 + 快问快答区块
• Logo 透明背景修复——合规焦虑链接同步修正
• 首页三路入口重设计——logo 背景修正 + 合规链接修正
• 首页标题居中对齐——视觉居中
• 首页所有标题统一居中——全页标题对齐
• sitemap.xml 自动生成——搜索引擎可发现性提升
• 全书数据更新至 2026 基准——e-Invoice 第三阶段推迟至 2026 年 7 月 1 日、SST 注册门槛更新至 RM1.5M 及 8% 税率、补充 2023 年外劳 EPF 强制新规、最低薪金确认 RM1,700

2026.03.23 — 平台上线 [这里有误？]

• 全站初版上线——19 章经营手册 + 完整目录 + 地图与城市数据库 + 工具箱首页 + 附录场景问答库
• Vercel 构建部署——站点正式上线运行
• 配置修复——忽略死链检查以通过构建
• 侧边栏标签与标题优化——导航标签清晰化
• 预发布内容清理——目录/城市数据库/手册卷二/附录措辞修正
• WhatsApp 分享按钮上线——全书 + 首页 + 目录页一键分享，Tally 表单 + 邮箱反馈通道同步开通
• WhatsApp 分享文本修正——首页和目录页分享文案调整
• WhatsApp 分享错别字修正——文案修正
• 534 处加粗格式修复——全站 Markdown 加粗语法统一修正

2026.03.20–03.22 — 开工前准备 [这里有误？]

• 全书初稿完成——7 大卷 19 章经营手册 + 完整目录 + 地图层 + 工具箱层 + 附录 6 篇
• 三层架构确立——地图（宏观市场）→ 手册（操作指南）→ 工具箱（计算器与模板）
• 城市数据库准备——20 城初始数据
• 场景问答库准备——20 条 FAQ 初始数据
• VitePress 站点搭建——框架搭建 + 主题定制 + 自定义 CSS