xhs-minitool-creator 1.2.0 → 1.2.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xhs-minitool-creator",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "小红书小工具脚手架：创建项目 / Vite 构建预设 / 打包 / 静态校验，内置官方打包规范 Skill",
   "type": "module",
   "bin": {

package/src/pack.mjs

@@ -46,6 +46,47 @@ function pruneEmptyDirs(dir) {
   }
 }
 
+const COMMENT_RE = /<!--[\s\S]*?-->/g;
+// 哨兵用 NUL 包裹：不会出现在 UTF-8 的 index.html 正文里，且不含引号/斜杠，
+// 不会干扰下面的 href|src、crossorigin、manifest、script 四条正则。
+const NUL = String.fromCharCode(0);
+const COMMENT_SENTINEL = (i) => `${NUL}XMC_COMMENT_${i}${NUL}`;
+const COMMENT_SENTINEL_RE = new RegExp(`${NUL}XMC_COMMENT_(\\d+)${NUL}`, 'g');
+
+/** 把 HTML 注释摘成占位符，避免后续正则命中的是注释里的字面量 */
+function maskComments(html) {
+  const store = [];
+  const masked = html.replace(COMMENT_RE, (m) => {
+    const i = store.push(m) - 1;
+    return COMMENT_SENTINEL(i);
+  });
+  return { masked, store };
+}
+
+function unmaskComments(html, store) {
+  return html.replace(COMMENT_SENTINEL_RE, (_m, i) => store[Number(i)]);
+}
+
+/**
+ * 注入后自检：确认刚写入的脚本没有被 HTML 注释包裹。
+ * 只检查本次注入的标签，因此不会把开发者主动注释掉的旧脚本误判为问题。
+ */
+function auditInjectedScripts(html, scripts) {
+  for (const s of scripts) {
+    const idx = html.indexOf(s);
+    if (idx === -1) {
+      throw new Error(`index.html 结构异常：注入的脚本未出现在文件中：${s}`);
+    }
+    const before = html.slice(0, idx);
+    if (before.lastIndexOf('<!--') > before.lastIndexOf('-->')) {
+      throw new Error(
+        `index.html 结构异常：脚本 ${s} 被写进了 HTML 注释内部，真机上不会执行（白屏）。` +
+          '常见原因是注释里含有 body 结束标签字面量，导致注入锚点命中了注释。'
+      );
+    }
+  }
+}
+
 /**
  * 修正 index.html 使其符合容器要求。
  * 这是整个流程里最容易出错也最有价值的一步。
@@ -58,6 +99,12 @@ export function patchIndexHtml(outDir) {
 
   let html = readFileSync(htmlPath, 'utf8');
 
+  // 先把 HTML 注释摘成占位符。否则下面几条正则会命中注释里的
+  // 结束标签 / <script src="..."> 字面量：前者会把脚本注入到注释内部（真机白屏），
+  // 后者会把开发者注释掉的旧脚本"复活"到文档末尾。手术后原样还原。
+  const { masked, store: comments } = maskComments(html);
+  html = masked;
+
   // 绝对路径资源 -> 相对路径（离线 zip 根为 /）
   html = html.replace(/(href|src)="\/([^"]+)"/g, '$1="./$2"');
   // 去掉 crossorigin（离线同源无需，且部分内核处理异常）
@@ -85,6 +132,9 @@ export function patchIndexHtml(outDir) {
     }
   }
 
+  html = unmaskComments(html, comments);
+  auditInjectedScripts(html, scripts);
+
   writeFileSync(htmlPath, html);
   return scripts.length;
 }