agent-publish-server 1.0.23 → 1.0.25

package/README.md

@@ -228,7 +228,9 @@ agent-publish-server --log false
 
 ### 版本历史
 
-- **v1.0.23**: 完善双语文档支持，优化package.json关键词，提升npm包曝光度
+- **v1.0.25**: 修复 staticProxy static 类型不支持 SPA History 路由刷新的问题，添加自动 fallback 到 index.html 支持
+- **v1.0.24**: 修复移动端兼容性问题，优化 HTTP 响应头设置，确保 iOS 和 Android 显示一致性
+- **v1.0.23**: 完善双语文档支持，优化 package.json 关键词，提升 npm 包曝光度
 - **v1.0.22**: 优化和完善 staticProxy 功能，提升稳定性
 - **v1.0.18**: 增强 staticProxy 功能，支持静态文件代理和 HTTP 服务代理两种模式
 - **v1.0.17**: 新增静态网页代理功能（staticProxy），支持与 API 代理同时使用

package/README_EN.md

@@ -229,6 +229,9 @@ startServer(app, config.port);
 
 ## Version History
 
+- **v1.0.25**: Fixed staticProxy static type not supporting SPA History route refresh, added automatic fallback to index.html
+- **v1.0.24**: Fixed mobile compatibility issues, optimized HTTP response headers for consistent iOS and Android display
+- **v1.0.23**: Enhanced bilingual documentation support, optimized package.json keywords for better npm exposure
 - **v1.0.22**: Optimized and improved staticProxy functionality, enhanced stability
 - **v1.0.18**: Enhanced staticProxy functionality, supporting both static file proxy and HTTP service proxy modes
 - **v1.0.17**: Added static web proxy functionality (staticProxy), supports simultaneous use with API proxy

package/dist/server.d.ts

@@ -1,3 +1,3 @@
-import { AgentConfig } from './types';
+import { AgentConfig } from "./types";
 export declare function createServer(config: AgentConfig): import("express-serve-static-core").Express;
 export declare function startServer(config: AgentConfig): Promise<void>;

package/dist/server.js

@@ -11,12 +11,12 @@ const path_1 = __importDefault(require("path"));
 const fs_1 = __importDefault(require("fs"));
 function createServer(config) {
     const app = (0, express_1.default)();
-    const staticDir = config.dir || './';
+    const staticDir = config.dir || "./";
     const enableLog = config.log !== false; // 默认为true
     // 检查项目路径是否存在
     const absoluteStaticDir = path_1.default.resolve(process.cwd(), staticDir);
     if (!fs_1.default.existsSync(absoluteStaticDir)) {
-        throw new Error('项目路径错误');
+        throw new Error("项目路径错误");
     }
     // 添加日志中间件
     if (enableLog) {
@@ -24,8 +24,8 @@ function createServer(config) {
             const timestamp = new Date().toISOString();
             const method = req.method;
             const url = req.url;
-            const userAgent = req.get('User-Agent') || '-';
-            const ip = req.ip || req.connection.remoteAddress || '-';
+            const userAgent = req.get("User-Agent") || "-";
+            const ip = req.ip || req.connection.remoteAddress || "-";
             console.log(`[${timestamp}] ${ip} "${method} ${url}" "${userAgent}"`);
             next();
         });
@@ -39,15 +39,59 @@ function createServer(config) {
     // 配置静态网页代理
     if (config.staticProxy) {
         Object.entries(config.staticProxy).forEach(([proxyPath, staticProxyConfig]) => {
-            const proxyType = staticProxyConfig.type || 'http'; // 默认为http类型
-            if (proxyType === 'static') {
+            const proxyType = staticProxyConfig.type || "http"; // 默认为http类型
+            if (proxyType === "static") {
                 // 静态文件代理
                 const staticPath = path_1.default.resolve(process.cwd(), staticProxyConfig.target);
                 if (!fs_1.default.existsSync(staticPath)) {
                     console.warn(`Warning: Static proxy path does not exist: ${staticPath}`);
                     return;
                 }
-                app.use(proxyPath, express_1.default.static(staticPath));
+                // 静态文件服务
+                app.use(proxyPath, express_1.default.static(staticPath, {
+                    setHeaders: (res, filePath, stat) => {
+                        // 设置通用响应头，提升移动端兼容性
+                        res.setHeader("X-Content-Type-Options", "nosniff");
+                        res.setHeader("X-Frame-Options", "SAMEORIGIN");
+                        res.setHeader("X-XSS-Protection", "1; mode=block");
+                        // 针对HTML文件设置移动端优化响应头
+                        if (filePath.endsWith(".html")) {
+                            res.setHeader("Cache-Control", "no-cache, no-store, must-revalidate");
+                            res.setHeader("Pragma", "no-cache");
+                            res.setHeader("Expires", "0");
+                            res.setHeader("Content-Type", "text/html; charset=utf-8");
+                        }
+                        // 针对CSS文件确保正确的Content-Type
+                        if (filePath.endsWith(".css")) {
+                            res.setHeader("Content-Type", "text/css; charset=utf-8");
+                        }
+                        // 针对JS文件确保正确的Content-Type
+                        if (filePath.endsWith(".js")) {
+                            res.setHeader("Content-Type", "application/javascript; charset=utf-8");
+                        }
+                        // 针对图片文件设置适当的缓存
+                        if (filePath.match(/\.(jpg|jpeg|png|gif|webp|svg)$/i)) {
+                            res.setHeader("Cache-Control", "public, max-age=31536000");
+                        }
+                    },
+                }));
+                // SPA fallback：静态文件不存在时回退到 index.html
+                app.use(proxyPath, (req, res, next) => {
+                    const reqPath = req.path === "/" ? "" : req.path;
+                    const filePath = path_1.default.join(staticPath, reqPath);
+                    const indexPath = path_1.default.join(staticPath, "index.html");
+                    // 如果请求的文件存在，跳过（已被 express.static 处理）
+                    if (fs_1.default.existsSync(filePath) && fs_1.default.statSync(filePath).isFile()) {
+                        return next();
+                    }
+                    // 如果 index.html 存在，返回它（SPA fallback）
+                    if (fs_1.default.existsSync(indexPath)) {
+                        res.setHeader("Cache-Control", "no-cache, no-store, must-revalidate");
+                        res.setHeader("Content-Type", "text/html; charset=utf-8");
+                        return res.sendFile(indexPath);
+                    }
+                    next();
+                });
             }
             else {
                 // HTTP服务代理
@@ -55,19 +99,57 @@ function createServer(config) {
                     target: staticProxyConfig.target,
                     changeOrigin: staticProxyConfig.changeOrigin !== false, // 默认为true
                     pathRewrite: {
-                        [`^${proxyPath}`]: '' // 移除代理路径前缀
-                    }
+                        [`^${proxyPath}`]: "", // 移除代理路径前缀
+                    },
                 }));
             }
         });
     }
-    // 配置静态文件服务
-    app.use(express_1.default.static(staticDir));
+    // 配置静态文件服务，添加移动端兼容性响应头
+    app.use(express_1.default.static(staticDir, {
+        setHeaders: (res, filePath, stat) => {
+            // 设置通用响应头，提升移动端兼容性
+            res.setHeader("X-Content-Type-Options", "nosniff");
+            res.setHeader("X-Frame-Options", "SAMEORIGIN");
+            res.setHeader("X-XSS-Protection", "1; mode=block");
+            // 针对HTML文件设置移动端优化响应头
+            if (filePath.endsWith(".html")) {
+                res.setHeader("Cache-Control", "no-cache, no-store, must-revalidate");
+                res.setHeader("Pragma", "no-cache");
+                res.setHeader("Expires", "0");
+                // 确保正确的Content-Type
+                res.setHeader("Content-Type", "text/html; charset=utf-8");
+            }
+            // 针对CSS文件确保正确的Content-Type
+            if (filePath.endsWith(".css")) {
+                res.setHeader("Content-Type", "text/css; charset=utf-8");
+            }
+            // 针对JS文件确保正确的Content-Type
+            if (filePath.endsWith(".js")) {
+                res.setHeader("Content-Type", "application/javascript; charset=utf-8");
+            }
+            // 针对图片文件设置适当的缓存
+            if (filePath.match(/\.(jpg|jpeg|png|gif|webp|svg)$/i)) {
+                res.setHeader("Cache-Control", "public, max-age=31536000");
+            }
+        },
+    }));
+    // 添加移动端兼容性中间件
+    app.use((req, res, next) => {
+        // 检测移动端User-Agent并设置相应响应头
+        const userAgent = req.get("User-Agent") || "";
+        const isMobile = /Mobile|Android|iPhone|iPad|iPod|BlackBerry|IEMobile|Opera Mini/i.test(userAgent);
+        if (isMobile) {
+            // 为移动端设置额外的响应头
+            res.setHeader("Vary", "User-Agent");
+        }
+        next();
+    });
     // 添加SPA应用的回退路由处理
     // 只有当实际文件不存在时才回退到index.html
     app.use((req, res, next) => {
         // 排除API和已处理的代理请求
-        if (req.path.startsWith('/api/')) {
+        if (req.path.startsWith("/api/")) {
             return next();
         }
         // 排除静态代理路径
@@ -82,7 +164,7 @@ function createServer(config) {
         // 检查是否为目录
         if (fs_1.default.existsSync(filePath) && fs_1.default.statSync(filePath).isDirectory()) {
             // 检查目录中是否有index.html
-            const indexPath = path_1.default.join(filePath, 'index.html');
+            const indexPath = path_1.default.join(filePath, "index.html");
             if (fs_1.default.existsSync(indexPath)) {
                 return res.sendFile(indexPath);
             }
@@ -92,7 +174,7 @@ function createServer(config) {
             return res.sendFile(filePath);
         }
         // 如果路径不存在，回退到index.html
-        res.sendFile(path_1.default.join(process.cwd(), staticDir, 'index.html'));
+        res.sendFile(path_1.default.join(process.cwd(), staticDir, "index.html"));
     });
     return app;
 }
@@ -108,7 +190,7 @@ function startServer(config) {
                 });
             }
             catch (error) {
-                console.error('Failed to start server:', error);
+                console.error("Failed to start server:", error);
                 reject(error);
             }
         });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-publish-server",
-  "version": "1.0.23",
+  "version": "1.0.25",
   "description": "A powerful frontend development server with API proxy, static file serving, and dual-mode static proxy support. Built with Node.js + Express + http-proxy-middleware. 基于 Node.js + Express + http-proxy-middleware 的强大前端开发服务器，支持API代理、静态文件服务和双模式静态代理。",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",