fix: 统一 clean URL 并完善高流量计算器 (#229)

* fix: align clean URLs and improve top calculators

* fix: address clean URL review feedback

* test: tolerate partial location mocks

* fix: harden calculator keyboard accessibility

Author: chicogong

assets/js/main.js

@@ -218,9 +218,28 @@ function renderCategories() {
 // ==================== 渲染工具卡片 ====================
 let renderedCount = 0;
 
+const CLEAN_URL_HOSTS = new Set(['tools.realtime-ai.chat', 'localhost', '127.0.0.1']);
+const CLEAN_URL_HOST_SUFFIXES = ['.vercel.app', '.netlify.app', '.pages.dev'];
+
+function hostSupportsCleanUrls() {
+  const hostname = (window.location.hostname || '').toLowerCase();
+  return (
+    CLEAN_URL_HOSTS.has(hostname) ||
+    CLEAN_URL_HOST_SUFFIXES.some((suffix) => hostname.endsWith(suffix))
+  );
+}
+
+function publicToolUrl(filePath) {
+  if (!hostSupportsCleanUrls()) return filePath;
+  if (filePath === 'index.html') return './';
+  if (filePath.endsWith('/index.html')) return filePath.slice(0, -'index.html'.length);
+  if (filePath.endsWith('.html')) return filePath.slice(0, -'.html'.length);
+  return filePath;
+}
+
 function createToolCard(tool, index) {
   const card = document.createElement('a');
-  card.href = tool.url;
+  card.href = publicToolUrl(tool.url);
   card.className = 'tool-card';
   card.dataset.category = tool.category;
   card.dataset.keywords = tool.keywords;

assets/js/tool-chrome.js

@@ -15,7 +15,7 @@
  *   <script src="../../assets/js/tool-chrome.js"></script>
  *
  * 覆盖主页地址（可选）：
- *   <meta name="home-url" content="/index.html">
+ *   <meta name="home-url" content="/">
  *
  * ========================================================== */
 
@@ -146,7 +146,7 @@
    *    优先级：
    *    a. <meta name="home-url" content="...">  （显式覆盖，最高优先）
    *    b. 根据 <script src="..."> 路径逆推        （自动计算）
-   *    c. 兜底 '/index.html'
+   *    c. 兜底 '/'
    * ------------------------------------------------------ */
   function resolveHomeUrl() {
     // a. meta 显式指定（最高优先）
@@ -161,27 +161,78 @@
         var assetIdx = parts.lastIndexOf('assets');
         if (assetIdx > 0) {
           var rootPath = parts.slice(0, assetIdx).join('/') || '';
-          return rootPath + '/index.html';
+          return rootPath + (scriptUrl.protocol === 'file:' ? '/index.html' : '/');
         }
       } catch (e) {}
     }
 
     // c. 兜底：从 window.location.pathname 的目录层级计算相对路径
     //    正确算法：找到 'tools' 目录，计算从当前文件到 tools 父目录的 .. 层数
-    //    tools/dev/base64.html      -> ../../index.html      (afterTools=['dev'], depth=2)
-    //    tools/ai/wiki/page.html    -> ../../../index.html   (afterTools=['ai','wiki'], depth=3)
+    //    tools/dev/base64.html      -> ../../      (afterTools=['dev'], depth=2)
+    //    tools/ai/wiki/page.html    -> ../../../   (afterTools=['ai','wiki'], depth=3)
     try {
       var segs = window.location.pathname.split('/').filter(Boolean);
       var toolsIdx = segs.indexOf('tools');
       if (toolsIdx >= 0) {
         // afterTools：tools 后面的路径段，去掉最后一段（文件名）
         var afterTools = segs.slice(toolsIdx + 1, -1);
         var depth = afterTools.length + 1; // +1 for 'tools' itself
-        return Array(depth).fill('..').join('/') + '/index.html';
+        return (
+          Array(depth).fill('..').join('/') +
+          (window.location.protocol === 'file:' ? '/index.html' : '/')
+        );
       }
     } catch (e) {}
 
-    return '/index.html';
+    return window.location.protocol === 'file:' ? '/index.html' : '/';
+  }
+
+  /** 分类页保留物理文件回退，确保直接双击 HTML 时仍可离线导航。 */
+  function restoreFileLinks() {
+    if (window.location.protocol !== 'file:') return;
+    doc.querySelectorAll('[data-file-href]').forEach(function (link) {
+      link.setAttribute('href', link.getAttribute('data-file-href'));
+    });
+  }
+
+  /**
+   * 仅在已知提供 HTML rewrite 的主机上启用 clean URL。
+   * 静态主机（例如 github.io）必须保留物理 .html 路径，否则站内链接会 404。
+   */
+  function hostSupportsCleanUrls() {
+    var hostname = (window.location.hostname || '').toLowerCase();
+    return (
+      hostname === 'tools.realtime-ai.chat' ||
+      hostname === 'localhost' ||
+      hostname === '127.0.0.1' ||
+      hostname.endsWith('.vercel.app') ||
+      hostname.endsWith('.netlify.app') ||
+      hostname.endsWith('.pages.dev')
+    );
+  }
+
+  /** 在支持 rewrite 的主机上规范化同源 HTML 链接，避免站内跳转触发 308。 */
+  function normalizeHttpLinks() {
+    if (!hostSupportsCleanUrls()) return;
+
+    doc.querySelectorAll('a[href]').forEach(function (link) {
+      try {
+        var url = new URL(link.getAttribute('href'), window.location.href);
+        if (url.origin !== window.location.origin) return;
+
+        if (url.pathname === '/index.html') {
+          url.pathname = '/';
+        } else if (url.pathname.endsWith('/index.html')) {
+          url.pathname = url.pathname.slice(0, -'index.html'.length);
+        } else if (url.pathname.endsWith('.html')) {
+          url.pathname = url.pathname.slice(0, -'.html'.length);
+        } else {
+          return;
+        }
+
+        link.href = url.pathname + url.search + url.hash;
+      } catch (e) {}
+    });
   }
 
   /* --------------------------------------------------------
@@ -373,6 +424,8 @@
    * ------------------------------------------------------ */
   function start() {
     recordRecentTool();
+    restoreFileLinks();
+    normalizeHttpLinks();
     injectFallbackCSS();
     injectChrome();
     loadHomepageRecentController();