feat: add privacy-friendly visitor counter

zhangkaihua88 · zhangkaihua88 · commit a3f07ced74fb · 2026-08-05T19:27:22.000+08:00
diff --git a/catalog/api-catalog.json b/catalog/api-catalog.json
@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "catalogVersion": "1.15.2",
+  "catalogVersion": "1.15.3",
   "title": "WQ API 非官方接口目录",
   "description": "以 WorldQuant BRAIN 前端 bundle 静态分析为基线，并通过人工复核的去敏真实响应逐项升级。此目录不是官方 API 承诺；unknown/inferred 字段必须在取得去敏真实响应后再升级。",
   "generatedFrom": {
diff --git a/site/assets/app.js b/site/assets/app.js
@@ -19,6 +19,7 @@ const DOMAIN_LABELS = {
 
 const DOMAIN_ORDER = Object.keys(DOMAIN_LABELS);
 const BASE_URL = "https://api.worldquantbrain.com";
+const GOATCOUNTER_TOTAL_URL = "https://huahua.goatcounter.com/counter/TOTAL.json";
 
 const SENSITIVITY_DESCRIPTIONS = {
   none: "未发现额外的敏感信息或高风险副作用。",
@@ -58,6 +59,8 @@ const elements = typeof document === "undefined" ? {} : {
   catalogStatus: document.querySelector("#catalog-status"),
   statusDot: document.querySelector(".status-dot"),
   downloadMarkdown: document.querySelector("#download-markdown"),
+  visitorStat: document.querySelector("#visitor-stat"),
+  visitorCount: document.querySelector("#visitor-count"),
   docPane: document.querySelector("#doc-pane"),
   parameterForm: document.querySelector("#parameter-form"),
   parameterSummary: document.querySelector("#parameter-summary"),
@@ -1341,6 +1344,23 @@ function downloadVisibleCatalogMarkdown() {
   showToast(`${visibleOperations().length} 个接口的 Markdown 已生成`);
 }
 
+async function loadVisitorCount() {
+  try {
+    const response = await fetch(GOATCOUNTER_TOTAL_URL, {
+      cache: "no-store",
+      credentials: "omit"
+    });
+    if (!response.ok) throw new Error(`HTTP ${response.status}`);
+    const payload = await response.json();
+    const count = String(payload.count ?? "").trim();
+    if (!/^\d[\d,.\s]*$/.test(count)) throw new Error("invalid visitor count");
+    elements.visitorCount.textContent = count;
+    elements.visitorStat.hidden = false;
+  } catch {
+    elements.visitorStat.hidden = true;
+  }
+}
+
 function bindEvents() {
   elements.domainNav.addEventListener("click", (event) => {
     const button = event.target.closest("[data-domain]");
@@ -1415,6 +1435,7 @@ function bindEvents() {
 
 async function initialize() {
   bindEvents();
+  void loadVisitorCount();
   try {
     const response = await fetch("./data/api-catalog.json", { cache: "no-cache" });
     if (!response.ok) throw new Error(`HTTP ${response.status}`);
diff --git a/site/assets/styles.css b/site/assets/styles.css
@@ -18,6 +18,7 @@
   --sans: Inter, ui-sans-serif, -apple-system, BlinkMacSystemFont, "Segoe UI", "PingFang SC", "Microsoft YaHei", sans-serif;
   --shadow: 0 12px 34px rgba(30, 39, 55, 0.08);
   --topbar-height: 72px;
+  --footer-height: 30px;
 }
 
 * {
@@ -260,7 +261,29 @@ kbd {
 .workspace {
   display: grid;
   grid-template-columns: 288px minmax(420px, 1fr) minmax(410px, 32vw);
-  height: calc(100vh - var(--topbar-height));
+  height: calc(100vh - var(--topbar-height) - var(--footer-height));
+}
+
+.site-footer {
+  display: flex;
+  height: var(--footer-height);
+  align-items: center;
+  justify-content: center;
+  border-top: 1px solid var(--line);
+  background: var(--paper-raised);
+  color: var(--ink-muted);
+  font-family: var(--mono);
+  font-size: 10px;
+  letter-spacing: 0.025em;
+}
+
+.visitor-stat[hidden] {
+  display: none;
+}
+
+.visitor-stat strong {
+  color: var(--accent);
+  font-weight: 750;
 }
 
 .nav-pane,
@@ -1286,13 +1309,13 @@ noscript {
   .workspace {
     grid-template-columns: 235px minmax(0, 1fr);
     height: auto;
-    min-height: calc(100vh - var(--topbar-height));
+    min-height: calc(100vh - var(--topbar-height) - var(--footer-height));
   }
 
   .nav-pane {
     position: sticky;
     top: 0;
-    height: calc(100vh - var(--topbar-height));
+    height: calc(100vh - var(--topbar-height) - var(--footer-height));
   }
 
   .doc-pane,
@@ -1336,6 +1359,10 @@ noscript {
     display: block;
   }
 
+  .site-footer {
+    position: relative;
+  }
+
   .nav-pane {
     position: static;
     height: auto;
diff --git a/site/index.html b/site/index.html
@@ -10,7 +10,7 @@
     <title>WQ API Workbench</title>
     <link rel="icon" type="image/png" sizes="32x32" href="./assets/favicon-32.png?v=ac9ae6d6875f" />
     <link rel="apple-touch-icon" href="./assets/quantapi-logo.png?v=19fd43f07782" />
-    <link rel="stylesheet" href="./assets/styles.css?v=ad6ae40216fa" />
+    <link rel="stylesheet" href="./assets/styles.css?v=0ea64f985da7" />
   </head>
   <body>
     <header class="topbar">
@@ -111,8 +111,15 @@ <h2 id="code-language-title">Python requests</h2>
       </aside>
     </div>
 
+    <footer class="site-footer" aria-label="网站访问统计">
+      <span class="visitor-stat" id="visitor-stat" hidden>
+        累计访问 <strong id="visitor-count" aria-live="polite">—</strong> 次
+      </span>
+    </footer>
+
     <div id="toast" class="toast" role="status" aria-live="polite"></div>
     <noscript>此页面需要 JavaScript 才能读取接口目录并生成请求代码。</noscript>
-    <script type="module" src="./assets/app.js?v=b9a62316b7f3"></script>
+    <script data-goatcounter="https://huahua.goatcounter.com/count" async src="https://gc.zgo.at/count.js"></script>
+    <script type="module" src="./assets/app.js?v=d6737bb99c1c"></script>
   </body>
 </html>
diff --git a/tools/verify-site.mjs b/tools/verify-site.mjs
@@ -109,6 +109,22 @@ check(
     && app.includes('elements.downloadMarkdown.disabled = false')
     && css.includes(".catalog-download")
 );
+check(
+  "页脚使用 GoatCounter 统计并安全显示累计访问量",
+  html.includes('<footer class="site-footer" aria-label="网站访问统计">')
+    && html.includes('id="visitor-stat" hidden')
+    && html.includes('id="visitor-count" aria-live="polite"')
+    && html.includes('data-goatcounter="https://huahua.goatcounter.com/count"')
+    && html.includes('async src="https://gc.zgo.at/count.js"')
+    && app.includes('const GOATCOUNTER_TOTAL_URL = "https://huahua.goatcounter.com/counter/TOTAL.json"')
+    && app.includes('credentials: "omit"')
+    && app.includes("elements.visitorStat.hidden = false")
+    && app.includes("elements.visitorStat.hidden = true")
+    && css.includes("--footer-height: 30px")
+    && css.includes("calc(100vh - var(--topbar-height) - var(--footer-height))")
+    && !html.includes("goatcounter.com/api/")
+    && !app.includes("Authorization: Bearer")
+);
 check("页面已移除 QUICK TEST 与本地测试器", !html.includes("QUICK TEST") && !html.includes("LOCAL ONLY") && !app.includes("LocalTester"));
 check(
   "右侧代码面板使用统一浅色主题",
@@ -761,8 +777,8 @@ const superSelectionOperation = catalog.operations.find((operation) => operation
 const createProtoUserOperation = catalog.operations.find((operation) => operation.operationId === "createProtoUser");
 const searchPlatformOperation = catalog.operations.find((operation) => operation.operationId === "searchPlatform");
 check(
-  "catalog 1.15.2 固化本轮实测覆盖率与剩余接口",
-  catalog.catalogVersion === "1.15.2"
+  "catalog 1.15.3 固化本轮实测覆盖率与剩余接口",
+  catalog.catalogVersion === "1.15.3"
     && visibleOperations.length === 93
     && liveConfirmedVisibleOperations.length === 92
     && JSON.stringify(remainingVisibleOperationIds) === JSON.stringify(["searchPlatform"])
@@ -779,7 +795,7 @@ const hiddenMarkdownSections = hiddenOperations.filter((operation) =>
 );
 check(
   "Markdown 下载内容完整且排除隐藏接口",
-  visibleCatalogMarkdown.startsWith("# WQ API Catalog 1.15.2")
+  visibleCatalogMarkdown.startsWith("# WQ API Catalog 1.15.3")
     && visibleCatalogMarkdown.includes("共 93 个前端可见接口")
     && visibleMarkdownSections.length === visibleOperations.length
     && hiddenMarkdownSections.length === 0

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"$schema": "https://json-schema.org/draft/2020-12/schema",`
`3`		`- "catalogVersion": "1.15.2",`
	`3`	`+ "catalogVersion": "1.15.3",`
`4`	`4`	`"title": "WQ API 非官方接口目录",`
`5`	`5`	`"description": "以 WorldQuant BRAIN 前端 bundle 静态分析为基线，并通过人工复核的去敏真实响应逐项升级。此目录不是官方 API 承诺；unknown/inferred 字段必须在取得去敏真实响应后再升级。",`
`6`	`6`	`"generatedFrom": {`