#skillpress —— 把一堆 skill 印成一个站点

#三个根（先认清再动手）

#三条命令（在程序根跑）

npm run press          # 内容源 → 实例的内容包（**P6 起走新引擎**：tools/press.mjs → cmd/skillpress gen-file）
npm run press:check    # 门：实例里那份生成物与**新引擎现跑**一致吗
npm run check          # 门：skill 自己（G1–G8）—— 走新 CLI（tools/run-js.mjs check → cmd/skillpress）
npm run verify         # 站点判据：真 Chrome 无头，自起服务 —— `cmd/skillpress-native verify`（见下）
npm run audit          # 上色的回归闸门（召回率 / 未上色比例）—— `tools/run-js.mjs audit`
npm run check:selftest # 门自己的证伪：22 条 wbtest（`moon test engine/gates`），造诱饵必须全被点名

⚠️ 四条 npm run 入口都已经换成新引擎（press P6、check/audit 2026-10-07、verify P8.3 收口）。 lib/ 与 bin/ 已整体退役（PLAN 的 D43，2026-10-07）：迁移期那五条"拿冻结旧实现现场跑基准"的 对账脚本（file-parity / blocks-parity / highlight-parity / site-parity / site-corpus-parity） 同批删掉了，参照物的职责改由入库 golden（tools/fixtures/expected/）接管。 ⇒ 仓库里再见到 lib/xxx.mjs / bin/skillpress.mjs，读作历史坐标（迁移记录里的出处），不是活文件。 ⚠️ verify 那条路只能 native：站点判据要 async 的 http server / websocket / process， 而它们在 moonbitlang/async 的 js 目标上没有实现 ⇒ 要一次 C 工具链；js 那份 CLI 遇到 verify 会明说"只有 native 有"并退 2。 在内容仓根（moobile/）跑同一份程序就多一层：node ../skillpress/tools/run-js.mjs check。 内容仓不在兄弟位置时用 --repo <仓库根> 或 SKILLPRESS_REPO 指定 —— 它不猜 （猜错的表现是"站点没更新"，最难查的一类症状）。 脚手架那条 attach 已落地（见下节）；pack 还没做（命令存在，但会明说"还没做"并以非零退出）。 ⚠️ facts（查 docs 有没有撒谎）按 D18 已搬去内容仓自己：moobile/tools/skillpress-gates.mjs --gate facts （连同 G5 / G6 两道"只对 moobile 有意义"的门与台账 done-claims.txt）。 npm run package-check = 发布包内容复核（见下节 ⑧）。

cd ../moobile/skills/skillpress/scripts/.skillpress
npm install && npm run press && npm run build && npm run serve   # → http://127.0.0.1:8123/

#脚手架：给一份 skills/ 直接生成一个站点

node tools/run-js.mjs attach --repo . --skills skills     # 本仓自己就是一份语料（自举）
node tools/run-js.mjs attach --skills <别人的内容根> --ignore "某份=它的理由"

#目录

#对账与验收（判据都写在明处）

export SKILLPRESS_CORPUS=../moobile/skills     # 下面的命令都按这个内容根跑
# ① ② ③（迁移期的三条对账判据：整份生成物 / 上色 / 文档块）**已随 `lib/` 退役**（D43）——
#    它们的职责现在由 ⑫ 承担（参照物从「现场跑的旧实现」换成了入库 golden）。
bash tools/blocks-fixtures.sh     # ④ 夹具：残缺的围栏 / 缺分隔行的表格 / 原始 HTML / 空内容根 —— 与入库 golden 逐字节比
                                  #    （`--capture` 重采；整行图片**已支持** ⇒ 夹具三里它是"不许再被点名"的反向控制）
bash tools/line-budget.sh         # ⑤ R9：每个源文件 ≤400 行（默认全覆盖 + 显式豁免；--selftest 造 401 行的诱饵证明它会红）
bash tools/diagnostics-ledger.sh  # ⑥ 诊断口径账本：旧实现 76 条诊断逐条"有对应物"或"记了账"（--selftest 改坏锚点即红）
bash tools/fresh-clone-check.sh   # ⑦ 干净克隆自查：把 HEAD 克隆到临时目录（只有 tracked 文件）、现装现编，再跑上面几条 + R9 + 账本
bash tools/package-check.sh       # ⑧ 发布包内容复核：该含的缺一个也红、不该含的多一个也红（--selftest 三向诱饵）
bash tools/mbt-traps.sh           # ⑨ MoonBit 坑位（第一条：`Array::sort()` 排字符串**不是字典序**；--selftest 两向诱饵）
bash tools/site-source.sh         # ⑩ 首页源（R2：WEBSITE.md 优先 / 回退 SKILL.md / --home）+ 忽略清单（R4：站点与门都跳过）
bash tools/shell-traps.sh         # ⑪ shell 坑位（双引号里的反引号 = **会真的执行**；--selftest 四向诱饵）
bash tools/published-check.sh     # ⑫ 发布后（§7 第 7 条）：从 registry 装下来、在别的工程里编过（没发布时会明说）
bash tools/attach-check.sh        # ⑬ 脚手架：产物齐全 / 幂等 / 不覆盖手写 / 坏输入不落盘 / 首页改写（+ 诱饵）
bash tools/queries-check.sh       # ⑭ 内嵌 query（native 用）与 grammars/*.scm 逐字节同源（+ 诱饵）
                                  #    加 `--build` 再加一档：生成出来的实例**真的能编**（要拷依赖，慢）
bash tools/native-parity.sh       # ⑮ 两个 target：同一份语料上 native 与 js 的产物**逐字节一致**
                                  #    （gen-file 921 行 / dump-blocks 224 行 / batch 读数）；前提守卫：两份
                                  #    runtime 必须同版本、PROVENANCE 记的 sha256 必须对得上盘上文件
bash tools/engine-fixtures.sh     # ⑱ 引擎在**冻结夹具语料**上的读数 == 入库 golden（迁移期那三条的永久替代品：
                                  #    语料与期望都冻结 ⇒ 不会像 D29 那次那样"基线自己腐掉"）
bash tools/acceptance.sh          # ⑪ 验收：按 PLAN §6 的 A1/A2/A3 逐条查（红在哪 = 还差什么）

bash tools/normalize-gen.sh --selftest                       # 归一化只抹形状：值 / 顺序 / 缩进 / 正文空行改一处都必须红
node tools/dom-dump.mjs --app <实例> --out a.html --repeat 2  # 真 Chrome 抓 DOM：先自证仪器（两次逐字节相同），再比搬前/搬后
node tools/press.mjs --check                                 # 实例里的生成物与**新引擎现跑**逐字节一致（= 旧 `press --check` 的位置）
node _scratch/image-check.mjs                                # 「图片」那条通道（对标表 #10）：现搭一份夹具站点，
                                                             #   真 Chrome 量"真 <img> / 解码尺寸 / alt / 占版面 / 按 URL 取字节"
                                                             #   （`--drop-asset` 是它的证伪开关 ⇒ 必须红 3 条）

• ⑦ 干净克隆：本机绿不算数 —— 本机有 _build/、node_modules/、各种缓存，克隆里都没有。 实测两笔：① 四条对账判据要"编出来的 js"，而 _build/ 不进版本库 ⇒ 克隆里全红、本机一直绿； ② 更狠：已提交的引擎里根本没有「图片 / 原始 HTML / 表格缺分隔行 / 围栏没闭合」这四条点名规矩 （parse_blocks 的签名里没有 problems 参数，移植时按注释把它摘了）⇒ 认不出的构造被咽下去、 照吐一份坏产物、退出码还是 0。本机之所以没看出来，是因为本机编的是工作区，不是 HEAD。
• ⑥ 诊断账本：四种对账判据盯的都是产物，而"诊断"是另一条线 —— 一句话没了、退出码反了、 该走 stderr 的走了 stdout，产物照样逐字节一致、判据全绿。76 条里实测逮到：未知子命令新实现 rc=0（旧 rc=2 且点名）、「（N/M 个代码块没配语法或为空）」今天就在触发却已静默丢、 首页两条问题丢了定位前缀。账本是自销账的：欠账补上了那一行就红，逼着改成"钉住新句子"。

#程序自己的 skill（skills/）

node tools/run-js.mjs check --skills skills
node tools/run-js.mjs check --skills skills --update-lock   # 复核体量后落锁

#门与判据（现状，2026-10-06 复核；这些会漂 —— 要准数就跑一遍）

node tools/run-js.mjs check            # 门：skill 自己（G1–G8）
moon test engine/gates                 # 门自己的证伪：22 条 wbtest（诱饵全被点名）
node tools/run-js.mjs audit            # 上色的回归闸门（召回率 / 未上色比例）
bash tools/verify.sh                   # 站点判据：**23 条**（真 Chrome 无头；**要一次 native 编译**）
moobile/tools/skillpress-gates.mjs --gate facts   # 事实来源对账（按 D18 住在**内容仓**）

⚠️ 上面那几行是入口，不是读数；要准数就跑一遍（判据会自己打读数）。

#诚实清单

1. 还没发布：现在靠源码路径调用（node tools/run-js.mjs … / bash tools/verify.sh）。 ⚠️ 发布形态已改（PLAN.md 的 D15）：不单独发 npm 引擎包 —— 引擎从这 3404 行 .mjs 迁到 MoonBit（P8.0–P8.2 已落地：engine/content / engine/gates / engine/highlight + cmd/skillpress）， 最后由一个月亮包装下引擎 + 站点界面 + skills，CLI 用 moon install 装。 ✅ 站点判据也搬完了（P8.3，2026-10-07）：本体在 engine/site/ + cmd/skillpress-native verify， 22 条与旧实现在同一份站点产物上各跑一遍、逐行 diff 一致（D38 的读数）。 ⚠️ 出这条读数的 tools/site-parity.sh 已随 D43 退役（同一批里 site-corpus-parity.sh 也一样） ⇒ 今天仓里没有能复跑它的判据，这句请当历史读数读；现役那条路是自己跑 bash tools/verify.sh。
2. native CLI 能 moon install 装上、产物与 js 逐字节一致（P10，2026-10-07 实测）： moon install ./cmd/skillpress-native --bin <目录> 装出来的是本机可执行件（使用者零 Node）， 跑 gen-file 的产物与 js 逐字节一致（921 行；判据 tools/native-parity.sh，含 --selftest 六条诱饵）。 ⚠️ 三条写在明处的账：① 吃到 check / attach 时程序根必须显式给 （--program 或 SKILLPRESS_PROGRAM）—— moon install 把可执行件放进 ~/.moon/bin/， 那里没有 claims.txt / skills.lock.json / template/，而 native 不猜（不给会先打一句 「程序根没给（native 不猜）」，然后门照常红）；② 日常那条路仍是 Node（tools/run-js.mjs）—— moon install 走 release 构建，慢一档（站点判据已经搬完了，它自己就是 native 那条路）； ③ 两条已知口径差：js 的 md_kids 用 localeCompare（分语言环境）而 native 用 UTF-16 码元序 （同一层里既有大写又有小写开头的名字会排得不同）；native 没有 process.exitCode，退出码记在 Ref 里由可执行件收摊时用。
3. ✅ 界面已抽成包（P6 起）：站点壳住在 shell/（tokens / theme / layout / sidebar / toc / blocks / article / pages / topbar / mobile / route…），实例 app.mbt 只剩几行接线。形状、验收读数与 "哪些还没做"在 DESIGN-site.md §11–§12，施工单在 PLAN-ui.md。
4. pack 还没做（attach 已落地，见「脚手架」一节）：pack 命令存在，但会明说"还没做"并以非零退出 （不做"看着像跑了"的假动作）。
5. 还没做的（卡点与归属写在 DESIGN-site.md §12.2 / PLAN-ui.md 的卡点表）： ✅ 搜索 ⌘K 已落地（2026-10-07）：顶栏入口 + ⌘K/Ctrl+K、输入即筛、命中分整页 / 小节 两种粒度、点一下切页并跳到那一节；索引渲染期现算（只在浮层打开时算），浮层复用"根不滚 + 绝对定位"（不必 portal）。读数：_scratch/search-check.mjs（真鼠标 + 真按键）。 ✅ 目录可点 + 跟读高亮也已落地（_scratch/toc-click.mjs）。 ✅ 正文链接也可点了（#9，_scratch/link-check.mjs）：Span::Link + 引擎把目标折成页面键， 站内路由跳页（不刷新）、站外走 @sub.open_url；代码块工具条（#5）与 prod 产物档（#14）也已落地。 ✅ #10 图片也落地了（2026-10-07）：整行一条的  ⇒ 引擎折 URL + press 拷资产到实例 img/ + build-web 拷进 dist/ + 站点排成真正的 <img>；读数 _scratch/image-check.mjs （真 Chrome 量"真 <img> / 解码尺寸 / alt / 占版面 / 按 URL 取回字节"，含 --drop-asset 证伪）。 ⚠️ 两条留在明处的缺口：原生 RN 的 img 仍需调用方给尺寸；行内图片没有去处（今天退化成一条链接）。 ⬜ 还差的：页面内 #section 深链（目录能跳，但"地址栏里带某一节"还没有）。 ✅ 已经还掉的两笔旧账：窄屏入口（三个贴边按钮 + 两级交互 + 遮罩互斥，shell/mobile.mbt）； URL 路由（hash ⇄ 状态双向 + 后退 + 深链 + 404 有到达路径，shell/route.mbt）。
6. ✅ 产物默认就是 prod 档（2026-10-07 起）：npm run build 走 NODE_ENV=production + minify ⇒ 829 KB（同一份源码的 dev 档 2939 KB，差 3.5 倍；要 dev 档用 npm run build:dev）。 ⚠️ 档位是构建期的（NODE_ENV 在打包时被替换成字面量）—— 运行时再设环境变量改不动已打好的产物； dist/artifact.json 里的 mode 记着这一份是哪个档。