feat: 环境感知配置(dev 经 vite proxy 指向本地 zTools2,prod 指向 f.zikai.wang)

修复 PDF 页签在开发环境返回 {"detail":"Not Found"}:
此前 baseUrl 始终指向线上 f.zikai.wang,开发环境跨域访问线上
既无法命中本地 /pdf 路由又会暴露生产。

- app.config.js: BASE_URL 按 import.meta.env.PROD 切换
  dev -> ''(同源,经 vite proxy 转发到本地 zTools2)
  prod -> https://f.zikai.wang(同源)
  VITE_API_BASE 可显式覆盖
- vite.config.js: dev server 新增 /api /pdf /health /static /upload
  /files /wb /ws 代理到 127.0.0.1:6867,使 iframe 与 fetch 同源命中本地服务

测试环境指向测试环境,生产环境指向生产环境。
This commit is contained in:
2026-07-27 13:59:50 +08:00
parent 66f93c67f5
commit 39f3056099
2 changed files with 58 additions and 2 deletions

View File

@@ -1,12 +1,25 @@
// ★ 集中配置 -- 外部服务 URL、默认参数等统一在此维护
// 模块按需 import { appConfig } 使用,改 URL 只改这里即可(需重新 build
// 每个服务项都带默认值,避免缺失字段导致渲染崩溃。
//
// 环境感知(测试环境指向测试环境,生产环境指向生产环境):
// - 开发服务器vite dev / MODE=developmentbaseUrl 为空串(同源),
// 经 vite.config.js 的 server.proxy 把 /api /pdf /health /static 等同源代理到
// 本地 zTools2127.0.0.1:6867使 iframe 与 fetch 都命中本地服务。
// - 生产构建vite build / MODE=productionbaseUrl 指向线上 f.zikai.wang同源
// - 可用 VITE_API_BASE 覆盖(如自定义测试环境域名,需含协议)。
// 生产构建用线上地址(同源);开发用空串(同源,经 vite proxy 转发到本地 zTools2
// 允许 VITE_API_BASE 显式覆盖(如指向独立测试环境域名)
const BASE_URL =
import.meta.env.VITE_API_BASE ||
(import.meta.env.PROD ? 'https://f.zikai.wang' : '')
export const appConfig = {
// 共享记事本(白板)服务
whiteboard: {
// 服务根地址(含协议与域名)
baseUrl: 'https://f.zikai.wang',
baseUrl: BASE_URL,
// 存活探针路径;周期探测,挂掉则隐藏页签并卸载组件
healthPath: '/health',
// 记事本页面路径生成器
@@ -19,7 +32,7 @@ export const appConfig = {
// PDF 转换服务zTools2 托管的 /pdf 页面iframe 同源嵌入)
pdf: {
// 服务根地址(含协议与域名)
baseUrl: 'https://f.zikai.wang',
baseUrl: BASE_URL,
// 存活探针路径;周期探测,挂掉则隐藏页签并卸载组件
healthPath: '/health',
// PDF 转换页面路径
@@ -39,3 +52,11 @@ export function healthUrl(service) {
if (!cfg) return ''
return `${cfg.baseUrl}${cfg.healthPath}`
}
/**
* 当前是否为开发/测试环境(便于组件按环境调整行为)。
* @returns {boolean}
*/
export function isDev() {
return !import.meta.env.PROD
}