UHD_Media_Tool/apps/server/src/config.ts

import { join, resolve } from "node:path";
import { z } from "zod";

/** compose 里 `${X:-}` 展开成空串:按未设置处理 */
const emptyToUndef = (v: unknown) => (v === "" ? undefined : v);

/** 可选正整数环境变量(空串 = 未设置) */
const optionalInt = (max: number) => z.preprocess(emptyToUndef, z.coerce.number().int().min(1).max(max).optional());

const LogLevel = z.enum(["fatal", "error", "warn", "info", "debug", "trace", "silent"]);

export const ConfigSchema = z.object({
  NODE_ENV: z.enum(["development", "test", "production"]).default("development"),
  PORT: z.coerce.number().int().min(1).max(65535).default(4380),
  /** 监听地址 */
  HOST: z.string().min(1).default("0.0.0.0"),
  DATABASE_URL: z.string().regex(/^postgres(ql)?:\/\//, "必须是 postgres:// 连接串"),
  SECRET_MASTER_KEY: z.string().min(16, "SECRET_MASTER_KEY 至少 16 个字符"),
  /** 主密钥轮换(--role rotate-master-key)的新密钥;只在轮换命令里读取,完成后换成 SECRET_MASTER_KEY 并删掉 */
  SECRET_MASTER_KEY_NEW: z.string().min(16, "SECRET_MASTER_KEY_NEW 至少 16 个字符").optional(),
  /**
   * Passkey 的 RP ID(浏览器地址栏里的主机名,例如 media.example.com;不含协议与端口)。
   * 不设时取请求的 Host(反代后面取 X-Forwarded-Host);换域名后已登记的 Passkey 全部失效。
   */
  WEBAUTHN_RP_ID: z.string().min(1).optional(),
  /** Passkey 允许的来源,逗号分隔(例如 https://media.example.com);不设时接受主机名等于 / 属于 RP ID 的来源 */
  WEBAUTHN_ORIGINS: z.string().min(1).optional(),
  /** Passkey 注册时显示的站点名 */
  WEBAUTHN_RP_NAME: z.string().min(1).default("UHD Media Tool"),
  LOG_LEVEL: LogLevel.default("info"),
  /** 仅开发模式生效的管理员 Key */
  DEV_ADMIN_KEY: z.string().min(8).optional(),
  /** worker 心跳间隔 */
  WORKER_HEARTBEAT_MS: z.coerce.number().int().min(1000).default(30_000),
  /**
   * 旧变量(WK-1 前的 io 组总并发):现在映射到网络道(WORKER_NETWORK_CONCURRENCY 未设时);
   * 不设 = 用设置页的值。空串视为未设置(compose 里 `${WORKER_CONCURRENCY:-}`)。
   */
  WORKER_CONCURRENCY: optionalInt(64),
  /** io worker 三条道的并发(WK-1);设置了就覆盖 设置 → 自动化 → 高级 里的值 */
  WORKER_FILE_CONCURRENCY: optionalInt(64),
  WORKER_NETWORK_CONCURRENCY: optionalInt(64),
  WORKER_MAINTENANCE_CONCURRENCY: optionalInt(64),
  /** agent 组 worker(runAgent/resolveDecision:整段会话占一槽数分钟)并发槽数 */
  WORKER_AGENT_CONCURRENCY: z.coerce.number().int().min(1).max(16).default(2),
  /** 手动整理 dryRun / 按路径整理时递归遍历的文件数上限(超出截断并标记 truncated) */
  ORGANIZE_WALK_MAX_FILES: z.coerce.number().int().min(1).max(1_000_000).default(5000),
  /** web 静态产物目录(单容器模式):设置后同端口托管 SPA,非 /api 路径回退 index.html */
  WEB_ROOT: z.string().min(1).optional(),
  /**
   * 应用数据目录(容器内 /data,由卷挂载):agent-sessions/、backups/、exports/、tmp/。
   * 编译后的二进制与 /app 保持只读,所有运行期写入都落在这里。相对路径按进程 cwd 解析。
   */
  DATA_DIR: z.string().min(1).default("./data"),
  /** Agent JSONL 会话目录;缺省 DATA_DIR/agent-sessions(api 与 worker 必须共享同一目录) */
  AGENT_SESSION_DIR: z.string().min(1).optional(),
  // ── 文件操作挂死隔离(adapters fsproxy,对标 MP fsproxy)──
  /** auto:能起 deno 子进程就把单个文件操作放进执行子进程(可 SIGKILL 回收),否则进程内看门狗;inprocess 强制进程内 */
  FS_PROXY_MODE: z.enum(["auto", "subprocess", "inprocess"]).default("auto"),
  /** 复制/哈希:进度停滞多久判挂死(ms),超时 SIGTERM→SIGKILL 并以 TIMEOUT 失败 */
  FS_HANG_TIMEOUT_MS: z.coerce.number().int().min(1000).default(120_000),
  /** stat/根检查/同卷 move 等快操作的总超时(ms) */
  FS_QUICK_TIMEOUT_MS: z.coerce.number().int().min(500).default(30_000),
  /** 执行子进程上报进度心跳的间隔(ms) */
  FS_PROGRESS_INTERVAL_MS: z.coerce.number().int().min(10).default(1000),
  /** SIGTERM 到 SIGKILL 的宽限(ms) */
  FS_KILL_GRACE_MS: z.coerce.number().int().min(100).default(2000),
  /** 写入前清理目标目录残留 partial 的年龄阈值(ms);0 = 不清 */
  FS_PARTIAL_MAX_AGE_MS: z.coerce
    .number()
    .int()
    .min(0)
    .default(24 * 3600_000),
  /** 单个文件的 TIMEOUT/IO 类失败最多尝试几次(含首次);超限转待处理,不删记录不重下 */
  FS_TRANSFER_MAX_ATTEMPTS: z.coerce.number().int().min(1).max(10).default(3),
  /** 替换入库(replace_with_verify)时旧文件去向:trash = 移到库根 .umt-trash;delete = 删除 */
  FS_REPLACE_OLD: z.enum(["trash", "delete"]).default("trash"),
  /** 入库目标已存在时的缺省策略:conflict = 转待处理;skip = 跳过;replace_with_verify = 授权后写临时→校验→原子替换 */
  ORGANIZE_ON_EXISTING: z.enum(["conflict", "skip", "replace_with_verify"]).default("conflict"),
  /** 随行字幕中此语言加 .default 标记(对照 MP DEFAULT_SUB);不设 = 不加 */
  ORGANIZE_DEFAULT_SUBTITLE_LANG: z.enum(["zh-cn", "zh-tw", "en", "ja", "ko"]).optional(),
  // ── 浏览器服务(camofox-browser,docs/runbook/browser.md)──
  /**
   * 部署自带的浏览器服务地址(compose 缺省 http://camofox:9377;接自有实例时改成它的地址)。
   * 设置后启动时登记/更新名为 camofox-env 的浏览器服务;不设则只用设置页登记的。
   */
  BROWSER_PROVIDER_URL: z.preprocess(emptyToUndef, z.string().url().optional()),
  /** 该服务的访问凭据(camofox CAMOFOX_ACCESS_KEY);只在进程内使用,不入库 */
  BROWSER_ACCESS_KEY: z.preprocess(emptyToUndef, z.string().min(1).optional()),
  /**
   * 浏览器会话保活间隔(毫秒,AG-4):桌面接管 / 人工接管 / 智能体正在用的会话每隔这么久做一次只读调用,
   * 避免 camofox 空闲 5 分钟回收标签页;0 = 关闭。要比 camofox 的 TAB_INACTIVITY_MS 短。
   */
  BROWSER_KEEPALIVE_MS: z.preprocess(emptyToUndef, z.coerce.number().int().min(0).default(120_000)),
  /** false = 停用 camofox-env(容器可照常运行,界面标"浏览器不可用") */
  BROWSER_ENABLED: z.preprocess(
    emptyToUndef,
    z
      .enum(["true", "false", "1", "0"])
      .default("true")
      .transform((v) => v === "true" || v === "1"),
  ),
});
export type Config = z.infer<typeof ConfigSchema>;

/** 从环境变量加载并校验配置;失败时抛出可读错误(不含变量值) */
export function loadConfig(env: Record<string, string | undefined> = Deno.env.toObject()): Config {
  const parsed = ConfigSchema.safeParse(env);
  if (!parsed.success) {
    const lines = parsed.error.issues.map((i) => `  ${i.path.join(".")}: ${i.message}`);
    throw new Error(`配置无效：\n${lines.join("\n")}`);
  }
  return parsed.data;
}

/** DATA_DIR 下的固定子目录 */
export const DATA_SUBDIRS = ["agent-sessions", "backups", "exports", "tmp"] as const;

/** 解析数据目录与会话目录为绝对路径 */
export function dataPaths(c: Pick<Config, "DATA_DIR" | "AGENT_SESSION_DIR">, cwd: string = Deno.cwd()) {
  const dataDir = resolve(cwd, c.DATA_DIR);
  return {
    dataDir,
    sessionDir: resolve(cwd, c.AGENT_SESSION_DIR ?? join(dataDir, "agent-sessions")),
    backupsDir: join(dataDir, "backups"),
    exportsDir: join(dataDir, "exports"),
    tmpDir: join(dataDir, "tmp"),
  };
}

export const isDev = (c: Pick<Config, "NODE_ENV">) => c.NODE_ENV !== "production";