code-review

name	code-review
description	Review pull requests in this repository. Use when reviewing changes to Markdown rendering, the marked configuration, renderers, knowledge/** content, or the CI and git-hook gates. Encodes the failure modes that have actually shipped here — most importantly the ones where the test suite was green while the reader-facing page was still broken.

Code review

這個 repo 的 review 目標不是抓風格，是抓兩件事：

1. 讀者看得到的壞掉（字面 ** 印在頁面上、<h2> 裡有星號、終端機有裸標記）
2. 假的綠燈（測試通過但頁面照壞）

第 2 項是這裡最貴的錯誤，所以放在方法的第一步。

---

方法

步驟 1：先確定你在審的東西是哪支引擎渲的

在對任何渲染改動下判斷之前先跑這個。

# 文章頁是哪支 renderer 渲的？
git grep -n "from 'marked'" -- src cli
git grep -rn 'remarkPlugins' -- astro.config.mjs

knowledge/**.md 的文章頁不走 Astro 的 markdown pipeline： src/pages/[category]/[slug].astro 用 fs 讀檔 + gray-matter，交給 src/utils/article-render.ts 的 marked 渲染。

所以動 astro.config.mjs 的 markdown.remarkPlugins 對文章頁沒有作用。 2026-08-14 有人這樣改，並且寫了一個自己 new 一個 Astro processor 的測試 → 測試全綠、build 成功、頁面照壞，只有掃 dist/ 的 HTML 才抓到。

Review 動作：聲稱修好渲染的 PR，要求證據是 build 出來的 HTML。

# 唯一算數的證據形狀
npm run build   # 或 bash scripts/core/sync.sh && ./node_modules/.bin/astro build
grep -c '\*\*' dist/<那一頁>/index.html