whistle.figma-cache 1.0.0

package/lib/uiServer.js

@@ -0,0 +1,88 @@
+'use strict';
+
+/**
+ * UI 服务模块
+ *
+ * 提供插件 Option 页面：查看缓存统计 / 命中率 / 已缓存条目，并支持一键清空。
+ * whistle 会把请求路径标准化为 /whistle.figma-cache/...，所以这里统一用后缀匹配。
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const store = require('./store');
+const config = require('./config');
+
+function sendJson(res, data, status) {
+  const body = Buffer.from(JSON.stringify(data, null, 2), 'utf8');
+  res.writeHead(status || 200, {
+    'Content-Type': 'application/json; charset=utf-8',
+    'Content-Length': String(body.length),
+    'Cache-Control': 'no-store'
+  });
+  res.end(body);
+}
+
+function sendHtml(res, html) {
+  const body = Buffer.from(html, 'utf8');
+  res.writeHead(200, {
+    'Content-Type': 'text/html; charset=utf-8',
+    'Content-Length': String(body.length),
+    'Cache-Control': 'no-store'
+  });
+  res.end(body);
+}
+
+module.exports = (server) => {
+  server.on('request', (req, res) => {
+    let pathname = '/';
+    try {
+      pathname = new URL(req.url, 'http://' + (req.headers.host || 'localhost')).pathname;
+    } catch (e) {
+      pathname = req.url || '/';
+    }
+
+    try {
+      store.use(config.resolveConfig(''));
+
+      // ── 首页 ──────────────────────────────────────────────────────────
+      if (/\/$/.test(pathname) || /index\.html$/.test(pathname)) {
+        const htmlPath = path.join(__dirname, '..', 'public', 'index.html');
+        if (fs.existsSync(htmlPath)) {
+          sendHtml(res, fs.readFileSync(htmlPath, 'utf8'));
+        } else {
+          sendHtml(res, '<h1>whistle.figma-cache</h1><p>public/index.html 缺失</p>');
+        }
+        return;
+      }
+
+      // ── 统计 ──────────────────────────────────────────────────────────
+      if (/\/cgi-bin\/stats$/.test(pathname)) {
+        const stats = store.getStats();
+        const c = stats.counters;
+        const total = c.hit + c.miss;
+        stats.hitRate = total > 0 ? ((c.hit / total) * 100).toFixed(1) + '%' : '-';
+        stats.savedMB = Math.round((c.bytesServed / 1048576) * 10) / 10;
+        sendJson(res, stats);
+        return;
+      }
+
+      // ── 条目列表 ──────────────────────────────────────────────────────
+      if (/\/cgi-bin\/entries$/.test(pathname)) {
+        sendJson(res, store.list(200));
+        return;
+      }
+
+      // ── 清空缓存 ──────────────────────────────────────────────────────
+      if (/\/cgi-bin\/clear$/.test(pathname)) {
+        store.clear();
+        sendJson(res, { ok: true, message: '缓存已清空' });
+        return;
+      }
+
+      sendJson(res, { ok: false, message: 'not found: ' + pathname }, 404);
+    } catch (e) {
+      sendJson(res, { ok: false, message: String((e && e.message) || e) }, 500);
+    }
+  });
+};

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "whistle.figma-cache",
+  "version": "1.0.0",
+  "description": "Figma 客户端静态资源磁盘缓存：只缓存 content-hash 命名的不可变资源，命中即由本地磁盘回放，绝不触碰画布数据 / API / WebSocket",
+  "main": "index.js",
+  "files": [
+    "index.js",
+    "lib/",
+    "rules.txt",
+    "public/",
+    "README.md",
+    "AGENTS.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "test": "node test/policy.test.js && node test/store.test.js && node test/hooks.test.js && node test/revalidate.test.js",
+    "test:policy": "node test/policy.test.js",
+    "test:store": "node test/store.test.js",
+    "test:hooks": "node test/hooks.test.js",
+    "test:swr": "node test/revalidate.test.js",
+    "prepublishOnly": "npm test",
+    "link": "npm link",
+    "unlink": "npm unlink -g whistle.figma-cache"
+  },
+  "keywords": [
+    "whistle",
+    "whistle-plugin",
+    "figma",
+    "cache",
+    "proxy",
+    "cdn"
+  ],
+  "author": "ducaoya",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ducaoya/whistle-figma-cache.git"
+  },
+  "homepage": "https://github.com/ducaoya/whistle-figma-cache#readme",
+  "bugs": {
+    "url": "https://github.com/ducaoya/whistle-figma-cache/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "engines": {
+    "node": ">=14"
+  },
+  "whistleConfig": {
+    "priority": 0,
+    "hintList": [
+      "figma-cache://",
+      "figma-cache://revalidate=7d",
+      "figma-cache://revalidate=0",
+      "figma-cache://revalidate=-1",
+      "figma-cache://maxSize=8192,revalidate=24h",
+      "figma-cache://log=1"
+    ]
+  }
+}

package/public/index.html

@@ -0,0 +1,341 @@
+<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+<meta charset="utf-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1" />
+<title>whistle.figma-cache</title>
+<style>
+  :root {
+    --bg: #16181d;
+    --panel: #1e2128;
+    --panel2: #22252c;
+    --line: #2c3039;
+    --fg: #e6e8ec;
+    --dim: #9aa1ad;
+    --accent: #4c8dff;
+    --ok: #35c46b;
+    --warn: #f0a23c;
+    --bad: #f06060;
+  }
+  * { box-sizing: border-box; }
+  html, body { height: 100%; }
+  body {
+    margin: 0;
+    background: var(--bg);
+    color: var(--fg);
+    font: 13px/1.65 -apple-system, "Segoe UI", "Microsoft YaHei", sans-serif;
+    display: flex;
+    flex-direction: column;
+    overflow: hidden;
+  }
+
+  /* ── 顶部：标题 + 页签 ───────────────────────────────── */
+  header { flex: none; padding: 14px 20px 0; border-bottom: 1px solid var(--line); }
+  .title { font-size: 16px; font-weight: 600; }
+  .subtitle { color: var(--dim); font-size: 12px; margin: 2px 0 10px; }
+  .tabs { display: flex; gap: 4px; }
+  .tab {
+    padding: 7px 16px; cursor: pointer; font-size: 13px;
+    color: var(--dim); border: 1px solid transparent; border-bottom: none;
+    border-radius: 7px 7px 0 0; user-select: none; position: relative; top: 1px;
+  }
+  .tab:hover { color: var(--fg); }
+  .tab.on {
+    color: var(--fg); background: var(--panel);
+    border-color: var(--line); border-bottom-color: var(--panel);
+    font-weight: 500;
+  }
+
+  /* ── 页面容器 ─────────────────────────────────────────── */
+  .page { display: none; flex: 1; min-height: 0; }
+  .page.on { display: flex; flex-direction: column; }
+
+  /* ── 第一页：使用方式（整页滚动）─────────────────────── */
+  #page-guide { overflow-y: auto; padding: 18px 20px 40px; display: none; }
+  #page-guide.on { display: block; }
+  .guide { max-width: 860px; }
+  h2 { font-size: 13px; color: var(--dim); font-weight: 500; margin: 22px 0 8px; }
+  h2:first-child { margin-top: 0; }
+  .step {
+    background: var(--panel); border: 1px solid var(--line); border-radius: 8px;
+    padding: 12px 16px; margin-bottom: 10px;
+  }
+  .step .h { font-weight: 600; margin-bottom: 6px; }
+  .step .h .n {
+    display: inline-block; width: 18px; height: 18px; line-height: 18px; text-align: center;
+    background: var(--accent); color: #fff; border-radius: 50%; font-size: 11px; margin-right: 7px;
+  }
+  pre {
+    background: #111318; border: 1px solid var(--line); border-radius: 6px;
+    padding: 9px 12px; margin: 7px 0 0; overflow-x: auto;
+    font: 12px/1.55 ui-monospace, Consolas, monospace; color: #cfe3ff;
+  }
+  code { font-family: ui-monospace, Consolas, monospace; }
+  p { margin: 6px 0; }
+  .dim { color: var(--dim); }
+  .tip { color: var(--warn); }
+  table.kv { width: 100%; border-collapse: collapse; margin-top: 6px; }
+  table.kv th, table.kv td { text-align: left; padding: 6px 10px; border-bottom: 1px solid var(--line); font-size: 12.5px; }
+  table.kv th { color: var(--dim); font-weight: 500; }
+  table.kv tr:last-child td { border-bottom: 0; }
+  table.kv code { color: #cfe3ff; }
+
+  /* ── 第二页：数据 ─────────────────────────────────────── */
+  #page-data { padding: 16px 20px 0; }
+  .cards { flex: none; display: flex; flex-wrap: wrap; gap: 10px; }
+  .card {
+    background: var(--panel); border: 1px solid var(--line); border-radius: 8px;
+    padding: 9px 14px; min-width: 118px;
+  }
+  .card .k { color: var(--dim); font-size: 11px; letter-spacing: .3px; white-space: nowrap; }
+  .card .v { font-size: 19px; font-weight: 600; margin-top: 1px; font-variant-numeric: tabular-nums; }
+  .v.ok { color: var(--ok); }
+  .v.warn { color: var(--warn); }
+  .v.bad { color: var(--bad); }
+
+  .bar { flex: none; display: flex; align-items: center; gap: 10px; margin: 14px 0 10px; flex-wrap: wrap; }
+  button {
+    background: var(--accent); color: #fff; border: 0; border-radius: 6px;
+    padding: 6px 14px; font-size: 13px; cursor: pointer;
+  }
+  button:hover { filter: brightness(1.1); }
+  button.ghost { background: transparent; border: 1px solid var(--line); color: var(--fg); }
+  .path { color: var(--dim); font-size: 12px; word-break: break-all; }
+
+  /* 列表：占据剩余高度并滚动 */
+  .table-wrap {
+    flex: 1; min-height: 0; overflow: auto;
+    border: 1px solid var(--line); border-radius: 8px 8px 0 0; background: var(--panel);
+    margin-bottom: 0;
+  }
+  table.list { width: 100%; border-collapse: collapse; }
+  table.list th {
+    position: sticky; top: 0; z-index: 1;
+    background: var(--panel2); color: var(--dim); font-weight: 500; font-size: 11px;
+    letter-spacing: .3px; text-align: left; padding: 8px 10px;
+    border-bottom: 1px solid var(--line);
+  }
+  table.list td { padding: 6px 10px; border-bottom: 1px solid var(--line); font-size: 12px; }
+  table.list tr:last-child td { border-bottom: 0; }
+  table.list tr:hover td { background: #1a1d23; }
+  td.num { text-align: right; font-variant-numeric: tabular-nums; white-space: nowrap; }
+  td.url { font-family: ui-monospace, Consolas, monospace; font-size: 11.5px; max-width: 0; width: 100%;
+           overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+  td.type { color: var(--dim); white-space: nowrap; font-size: 11px; }
+  .empty { color: var(--dim); text-align: center; padding: 30px 0; }
+
+  footer { flex: none; padding: 8px 20px 12px; color: var(--dim); font-size: 11.5px; }
+</style>
+</head>
+<body>
+
+<header>
+  <div class="title">whistle.figma-cache</div>
+  <div class="subtitle">Figma 静态资源磁盘缓存 · 命中即本地回放，不再重复走跨境带宽</div>
+  <div class="tabs">
+    <div class="tab on" data-tab="guide">使用方式</div>
+    <div class="tab" data-tab="data">数据</div>
+  </div>
+</header>
+
+<!-- ═══════════════ 第一页：使用方式 ═══════════════ -->
+<div class="page on" id="page-guide">
+  <div class="guide">
+
+    <h2>一、启用插件（本机只需一次）</h2>
+    <div class="step">
+      <div class="h"><span class="n">1</span>确认 whistle 在运行</div>
+      <pre>w2 status</pre>
+      <p class="dim">插件安装在 whistle 的 <code>custom_plugins</code> 目录，whistle 启动时会自动加载。
+      本页能打开就说明插件已经加载成功了。</p>
+    </div>
+    <div class="step">
+      <div class="h"><span class="n">2</span>确认插件处于启用状态</div>
+      <p>whistle 界面 → <b>Plugins</b> 面板 → 找到 <code>figma-cache</code>，确保未被禁用。</p>
+      <p class="dim">插件自带的 <code>rules.txt</code> 会随插件一起启用 / 停用 —— 禁用插件后所有缓存能力立即失效，不留任何痕迹。</p>
+    </div>
+
+    <h2>二、让 Figma 走 whistle</h2>
+    <div class="step">
+      <div class="h"><span class="n">3</span>写注册表（需要管理员权限）</div>
+      <p>Figma 只读 <code>HKLM\Software\Figma</code>，用管理员身份打开 PowerShell 执行：</p>
+      <pre>New-Item -Path 'HKLM:\SOFTWARE\Figma' -Force | Out-Null
+Set-ItemProperty -Path 'HKLM:\SOFTWARE\Figma' -Name 'ProxyUrl' `
+  -Value 'http://127.0.0.1:8899' -Type String</pre>
+      <p class="tip">⚠ 端口要换成 <code>w2 status</code> 显示的实际端口。这里是进程级代理，<b>不影响系统代理</b>。</p>
+    </div>
+    <div class="step">
+      <div class="h"><span class="n">4</span>完全退出 Figma 再重新打开</div>
+      <p>Figma 只在<b>启动那一瞬间</b>读一次这个配置。必须让所有 <code>Figma.exe</code> 进程都结束
+      （关窗口不够，看托盘图标退出，或任务管理器结束）。</p>
+    </div>
+    <div class="step">
+      <div class="h"><span class="n">5</span>打开一个设计文件</div>
+      <p>第一次加载仍然慢 —— 它要把资源回源并写入缓存。之后再刷新就是走本地磁盘了。</p>
+      <p class="dim">只停在「最近文件」列表页不会触发缓存，因为白名单只覆盖编辑器资源。</p>
+    </div>
+
+    <h2>三、验证是否生效</h2>
+    <div class="step">
+      <div class="h">看「数据」页这几个数</div>
+      <table class="kv">
+        <tr><th>指标</th><th>生效的表现</th></tr>
+        <tr><td><code>命中</code></td><td>第二次刷新后大幅增长</td></tr>
+        <tr><td><code>回源</code></td><td>只在第一次加载时增长</td></tr>
+        <tr><td><code>命中率</code></td><td>第二次刷新后应 &gt; 90%</td></tr>
+        <tr><td><code>已省流量</code></td><td>持续增长 —— 这就是没走网络的量</td></tr>
+        <tr><td><code>后台校验流量</code></td><td>应远小于「已省流量」（理想接近 0）</td></tr>
+      </table>
+      <p class="dim" style="margin-top:8px">另外可以在 whistle 的 <b>Network</b> 面板看到
+      <code>www.figma.com/webpack-artifacts/</code> 与 <code>static.figma.com/uploads/</code> 的请求记录。</p>
+    </div>
+
+    <h2>四、可选参数</h2>
+    <div class="step">
+      <p>默认零配置即可。需要调整时，在 whistle 的 <b>Rules</b> 面板追加一条更高优先级的规则：</p>
+      <pre>static.figma.com/uploads/  figma-cache://revalidate=7d,maxSize=8192,log=1</pre>
+      <table class="kv">
+        <tr><th>参数</th><th>默认</th><th>说明</th></tr>
+        <tr><td><code>maxSize</code></td><td>4096 MB</td><td>缓存总量上限，超出按 LRU 淘汰</td></tr>
+        <tr><td><code>maxFileSize</code></td><td>64 MB</td><td>单文件上限</td></tr>
+        <tr><td><code>revalidate</code></td><td>24h</td><td>后台静默校验冷却期；<code>0</code>=每次命中都校验；<code>-1</code>=关闭</td></tr>
+        <tr><td><code>ttl</code></td><td>0（永久）</td><td>缓存有效期</td></tr>
+        <tr><td><code>dir</code></td><td>插件目录/data/cache</td><td>缓存目录（<b>路径不能带空格</b>）</td></tr>
+        <tr><td><code>bodySettle</code></td><td>500 ms</td><td>判定「body 写完」的静默阈值</td></tr>
+        <tr><td><code>log</code></td><td>0</td><td>设 <code>1</code> 在插件控制台打印 HIT / MISS 日志</td></tr>
+      </table>
+    </div>
+
+    <h2>五、关闭 / 撤销</h2>
+    <div class="step">
+      <table class="kv">
+        <tr><th>操作</th><th>效果</th></tr>
+        <tr><td>Plugins 面板禁用插件</td><td>缓存能力立即失效，请求原样透传</td></tr>
+        <tr><td>删掉注册表的 <code>ProxyUrl</code></td><td>Figma 恢复直连 / 走系统代理</td></tr>
+        <tr><td>数据页「清空缓存」</td><td>清掉全部本地缓存</td></tr>
+      </table>
+      <pre>Remove-ItemProperty -Path 'HKLM:\SOFTWARE\Figma' -Name 'ProxyUrl'</pre>
+    </div>
+
+    <h2>六、常见问题</h2>
+    <div class="step">
+      <p><b>Q：数据页一直是 0，计数器不动？</b><br>
+      A：① 确认写的是 <code>HKLM</code> 而不是 <code>HKCU</code>（Figma 只读 HKLM）；② 确认 Figma 是<b>完全退出后</b>重启的；③ 确认打开的是设计文件而不是只停在文件列表页。</p>
+      <p><b>Q：Figma 打不开了 / 白屏？</b><br>
+      A：说明代理进去了但 whistle 没响应。检查 whistle 是否在运行（<code>w2 status</code>）。急着用的话删掉注册表的 <code>ProxyUrl</code> 立刻恢复。</p>
+      <p><b>Q：第一次加载还是慢？</b><br>
+      A：正常。第一次必须回源填缓存，从第二次开始才走本地。</p>
+      <p><b>Q：第二次刷新还是不够快？</b><br>
+      A：网络成本已经消除（数据页「已省流量」很大、「后台校验流量」很小即可确认）。剩下的时间是 Figma 自己解析编译 JS/WASM、渲染文档的客户端开销，缓存帮不上忙 —— 需要从文件复杂度（拆分大文件、删除隐藏图层、压缩大图）方向优化。</p>
+      <p><b>Q：后台校验会不会偷跑我的流量？</b><br>
+      A：不会。它带 <code>If-None-Match</code> 条件请求，绝大多数返回 304（body 0 字节）；而且同一资源 24 小时内最多校验一次。数据页的「后台校验流量」可以直接确认。</p>
+    </div>
+
+  </div>
+</div>
+
+<!-- ═══════════════ 第二页：数据 ═══════════════ -->
+<div class="page" id="page-data">
+  <div class="cards" id="cards"></div>
+  <div class="bar">
+    <button onclick="refresh()">刷新</button>
+    <button class="ghost" onclick="clearCache()">清空缓存</button>
+    <span class="path" id="dir"></span>
+  </div>
+  <div class="table-wrap">
+    <table class="list">
+      <thead>
+        <tr><th>体积</th><th>URL</th><th>类型</th><th>最后命中</th><th>最后校验</th></tr>
+      </thead>
+      <tbody id="rows"><tr><td colspan="5" class="empty">加载中…</td></tr></tbody>
+    </table>
+  </div>
+</div>
+
+<footer id="foot">「命中」为从本地磁盘回放的次数；「放行」为白名单外、原样透传的请求。</footer>
+
+<script>
+function fmtMB(b) { return (b / 1048576).toFixed(1) + ' MB'; }
+function fmtBytes(b) {
+  b = b || 0;
+  if (b < 1024) return b + ' B';
+  if (b < 1048576) return (b / 1024).toFixed(1) + ' KB';
+  return (b / 1048576).toFixed(2) + ' MB';
+}
+function fmtTime(ts) {
+  if (!ts) return '-';
+  var d = new Date(ts);
+  function p(n) { return n < 10 ? '0' + n : n; }
+  return p(d.getMonth() + 1) + '-' + p(d.getDate()) + ' ' + p(d.getHours()) + ':' + p(d.getMinutes());
+}
+function card(k, v, cls) {
+  return '<div class="card"><div class="k">' + k + '</div><div class="v ' + (cls || '') + '">' + v + '</div></div>';
+}
+function esc(s) {
+  return String(s == null ? '' : s).replace(/[&<>"]/g, function (c) {
+    return { '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;' }[c];
+  });
+}
+
+/* ── 页签切换 ── */
+document.querySelectorAll('.tab').forEach(function (el) {
+  el.onclick = function () {
+    document.querySelectorAll('.tab').forEach(function (t) { t.classList.remove('on'); });
+    document.querySelectorAll('.page').forEach(function (p) { p.classList.remove('on'); });
+    el.classList.add('on');
+    document.getElementById('page-' + el.dataset.tab).classList.add('on');
+    if (el.dataset.tab === 'data') refresh();
+  };
+});
+
+async function refresh() {
+  try {
+    const s = await (await fetch('cgi-bin/stats')).json();
+    const c = s.counters || {};
+    const rate = parseFloat(s.hitRate);
+    document.getElementById('cards').innerHTML = [
+      card('缓存占用', s.totalMB + ' MB'),
+      card('文件数', s.files),
+      card('命中', c.hit, 'ok'),
+      card('回源', c.miss),
+      card('命中率', s.hitRate, isNaN(rate) ? '' : (rate > 50 ? 'ok' : 'warn')),
+      card('已省流量', s.savedMB + ' MB', 'ok'),
+      card('后台校验 304', c.revalidated304 || 0, 'ok'),
+      card('后台校验 200', c.revalidated200 || 0, (c.revalidated200 || 0) > 0 ? 'warn' : ''),
+      card('后台校验流量', fmtBytes(c.revalidateBytes)),
+      card('放行(不缓存)', c.bypass),
+      card('淘汰', c.evicted, (c.evicted || 0) > 0 ? 'warn' : '')
+    ].join('');
+    document.getElementById('dir').textContent = s.dir || '';
+    document.getElementById('foot').textContent =
+      '后台校验 304 = 内容未变（body 0 字节）；后台校验 200 = 内容变了已替换；「放行」为白名单外原样透传。';
+
+    const list = await (await fetch('cgi-bin/entries')).json();
+    const rows = document.getElementById('rows');
+    if (!Array.isArray(list) || !list.length) {
+      rows.innerHTML = '<tr><td colspan="5" class="empty">暂无缓存</td></tr>';
+      return;
+    }
+    rows.innerHTML = list.map(function (e) {
+      return '<tr>' +
+        '<td class="num">' + fmtMB(e.size) + '</td>' +
+        '<td class="url" title="' + esc(e.url) + '">' + esc(e.url) + '</td>' +
+        '<td class="type">' + esc((e.contentType || '').split(';')[0]) + '</td>' +
+        '<td class="num">' + fmtTime(e.lastHitAt) + '</td>' +
+        '<td class="num">' + fmtTime(e.validatedAt) + '</td>' +
+        '</tr>';
+    }).join('');
+  } catch (e) {
+    document.getElementById('rows').innerHTML =
+      '<tr><td colspan="5" class="empty" style="color:var(--warn)">读取失败：' + esc(e.message) + '</td></tr>';
+  }
+}
+
+async function clearCache() {
+  if (!confirm('确定清空全部 Figma 静态资源缓存？\n\n清空后首次刷新 Figma 会重新下载全部资源。')) return;
+  await fetch('cgi-bin/clear', { method: 'POST' });
+  refresh();
+}
+</script>
+</body>
+</html>

package/rules.txt

@@ -0,0 +1,34 @@
+# ═══════════════════════════════════════════════════════════════════════════
+#  whistle.figma-cache —— 内置规则
+# ═══════════════════════════════════════════════════════════════════════════
+#  本文件由插件自动加载：
+#    · 插件「启用」时自动生效，无需在 Rules 面板做任何配置
+#    · 插件「禁用」时不再加载，所有能力立即失效
+#
+#  匹配范围刻意收得极窄 —— 只有下面两类 URL 会进入本插件。
+#  画布数据、文件内容、GraphQL / REST API、WebSocket、图片素材
+#  全都不在匹配范围内，完全不受影响（原样透传，零改动）。
+#
+#  第二道闸门在 lib/policy.js：即使规则意外命中，只要 URL 不是
+#  「内容哈希命名」的不可变资源，也会被拒绝并原样透传。
+# ═══════════════════════════════════════════════════════════════════════════
+
+# ① Figma 编辑器 JS/CSS bundle（webpack [contenthash] 命名，内容不可变）
+#    例：https://www.figma.com/webpack-artifacts/assets/vendor-1d532d39d96c5d27.min.js.br
+www.figma.com/webpack-artifacts/  whistle.figma-cache://
+
+# ② Figma 自有静态 CDN 的 content-addressed 资源（字体 / 图标等）
+#    例：https://static.figma.com/uploads/<40 位内容哈希>
+static.figma.com/uploads/         whistle.figma-cache://
+
+# ═══════════════════════════════════════════════════════════════════════════
+#  ✖ 以下域名/路径【严禁】加入本插件，否则会导致 Figma 白屏或拿不到最新数据：
+#
+#    www.figma.com/api/...            GraphQL / REST 接口（文件内容、样式、版本）
+#    www.figma.com/file|design/...    画布与文件数据
+#    s3-alpha.figma.com              用户内容（画布图片、素材）
+#    s3-alpha-sig.figma.com          带签名的临时地址（会过期）
+#    wss://...                        multiplayer 实时协作长连接
+#
+# 'lib/policy.js' 里已对上述目标做了硬性拒绝，作为双保险。
+# ═══════════════════════════════════════════════════════════════════════════