cursor2api / src /config.ts
github-actions[bot]
sync: upstream b70f787 Merge pull request #84 from huangzt/feature/vue-logs-ui
c6dedd5
import { readFileSync, existsSync, watch, type FSWatcher } from 'fs';
import { parse as parseYaml } from 'yaml';
import type { AppConfig } from './types.js';
let config: AppConfig;
let watcher: FSWatcher | null = null;
let debounceTimer: ReturnType<typeof setTimeout> | null = null;
// 配置变更回调
type ConfigReloadCallback = (newConfig: AppConfig, changes: string[]) => void;
const reloadCallbacks: ConfigReloadCallback[] = [];
/**
* 注册配置热重载回调
*/
export function onConfigReload(cb: ConfigReloadCallback): void {
reloadCallbacks.push(cb);
}
/**
* 从 config.yaml 解析配置(纯解析,不含环境变量覆盖)
*/
function parseYamlConfig(defaults: AppConfig): { config: AppConfig; raw: Record<string, unknown> | null } {
const result = { ...defaults, fingerprint: { ...defaults.fingerprint } };
let raw: Record<string, unknown> | null = null;
if (!existsSync('config.yaml')) return { config: result, raw };
try {
const content = readFileSync('config.yaml', 'utf-8');
const yaml = parseYaml(content);
raw = yaml;
if (yaml.port) result.port = yaml.port;
if (yaml.timeout) result.timeout = yaml.timeout;
if (yaml.proxy) result.proxy = yaml.proxy;
if (yaml.cursor_model) result.cursorModel = yaml.cursor_model;
if (typeof yaml.max_auto_continue === 'number') result.maxAutoContinue = yaml.max_auto_continue;
if (typeof yaml.max_history_messages === 'number') result.maxHistoryMessages = yaml.max_history_messages;
if (yaml.fingerprint) {
if (yaml.fingerprint.user_agent) result.fingerprint.userAgent = yaml.fingerprint.user_agent;
}
if (yaml.vision) {
result.vision = {
enabled: yaml.vision.enabled !== false,
mode: yaml.vision.mode || 'ocr',
baseUrl: yaml.vision.base_url || 'https://api.openai.com/v1/chat/completions',
apiKey: yaml.vision.api_key || '',
model: yaml.vision.model || 'gpt-4o-mini',
proxy: yaml.vision.proxy || undefined,
};
}
// ★ API 鉴权 token
if (yaml.auth_tokens) {
result.authTokens = Array.isArray(yaml.auth_tokens)
? yaml.auth_tokens.map(String)
: String(yaml.auth_tokens).split(',').map((s: string) => s.trim()).filter(Boolean);
}
// ★ 历史压缩配置
if (yaml.compression !== undefined) {
const c = yaml.compression;
result.compression = {
enabled: c.enabled !== false, // 默认启用
level: [1, 2, 3].includes(c.level) ? c.level : 1,
keepRecent: typeof c.keep_recent === 'number' ? c.keep_recent : 10,
earlyMsgMaxChars: typeof c.early_msg_max_chars === 'number' ? c.early_msg_max_chars : 4000,
};
}
// ★ Thinking 开关(最高优先级)
if (yaml.thinking !== undefined) {
result.thinking = {
enabled: yaml.thinking.enabled !== false, // 默认启用
};
}
// ★ 日志文件持久化
if (yaml.logging !== undefined) {
const persistModes = ['compact', 'full', 'summary'];
result.logging = {
file_enabled: yaml.logging.file_enabled === true, // 默认关闭
dir: yaml.logging.dir || './logs',
max_days: typeof yaml.logging.max_days === 'number' ? yaml.logging.max_days : 7,
persist_mode: persistModes.includes(yaml.logging.persist_mode) ? yaml.logging.persist_mode : 'summary',
};
}
// ★ 工具处理配置
if (yaml.tools !== undefined) {
const t = yaml.tools;
const validModes = ['compact', 'full', 'names_only'];
result.tools = {
schemaMode: validModes.includes(t.schema_mode) ? t.schema_mode : 'full',
descriptionMaxLength: typeof t.description_max_length === 'number' ? t.description_max_length : 0,
includeOnly: Array.isArray(t.include_only) ? t.include_only.map(String) : undefined,
exclude: Array.isArray(t.exclude) ? t.exclude.map(String) : undefined,
passthrough: t.passthrough === true,
disabled: t.disabled === true,
};
}
// ★ 响应内容清洗开关(默认关闭)
if (yaml.sanitize_response !== undefined) {
result.sanitizeEnabled = yaml.sanitize_response === true;
}
// ★ 自定义拒绝检测规则
if (Array.isArray(yaml.refusal_patterns)) {
result.refusalPatterns = yaml.refusal_patterns.map(String).filter(Boolean);
}
} catch (e) {
console.warn('[Config] 读取 config.yaml 失败:', e);
}
return { config: result, raw };
}
/**
* 应用环境变量覆盖(环境变量优先级最高,不受热重载影响)
*/
function applyEnvOverrides(cfg: AppConfig): void {
if (process.env.PORT) cfg.port = parseInt(process.env.PORT);
if (process.env.TIMEOUT) cfg.timeout = parseInt(process.env.TIMEOUT);
if (process.env.PROXY) cfg.proxy = process.env.PROXY;
if (process.env.CURSOR_MODEL) cfg.cursorModel = process.env.CURSOR_MODEL;
if (process.env.MAX_AUTO_CONTINUE !== undefined) cfg.maxAutoContinue = parseInt(process.env.MAX_AUTO_CONTINUE);
if (process.env.MAX_HISTORY_MESSAGES !== undefined) cfg.maxHistoryMessages = parseInt(process.env.MAX_HISTORY_MESSAGES);
if (process.env.AUTH_TOKEN) {
cfg.authTokens = process.env.AUTH_TOKEN.split(',').map(s => s.trim()).filter(Boolean);
}
// 压缩环境变量覆盖
if (process.env.COMPRESSION_ENABLED !== undefined) {
if (!cfg.compression) cfg.compression = { enabled: false, level: 1, keepRecent: 10, earlyMsgMaxChars: 4000 };
cfg.compression.enabled = process.env.COMPRESSION_ENABLED !== 'false' && process.env.COMPRESSION_ENABLED !== '0';
}
if (process.env.COMPRESSION_LEVEL) {
if (!cfg.compression) cfg.compression = { enabled: false, level: 1, keepRecent: 10, earlyMsgMaxChars: 4000 };
const lvl = parseInt(process.env.COMPRESSION_LEVEL);
if (lvl >= 1 && lvl <= 3) cfg.compression.level = lvl as 1 | 2 | 3;
}
// Thinking 环境变量覆盖(最高优先级)
if (process.env.THINKING_ENABLED !== undefined) {
cfg.thinking = {
enabled: process.env.THINKING_ENABLED !== 'false' && process.env.THINKING_ENABLED !== '0',
};
}
// Logging 环境变量覆盖
if (process.env.LOG_FILE_ENABLED !== undefined) {
if (!cfg.logging) cfg.logging = { file_enabled: false, dir: './logs', max_days: 7, persist_mode: 'summary' };
cfg.logging.file_enabled = process.env.LOG_FILE_ENABLED === 'true' || process.env.LOG_FILE_ENABLED === '1';
}
if (process.env.LOG_DIR) {
if (!cfg.logging) cfg.logging = { file_enabled: false, dir: './logs', max_days: 7, persist_mode: 'summary' };
cfg.logging.dir = process.env.LOG_DIR;
}
if (process.env.LOG_PERSIST_MODE) {
if (!cfg.logging) cfg.logging = { file_enabled: false, dir: './logs', max_days: 7, persist_mode: 'summary' };
cfg.logging.persist_mode = process.env.LOG_PERSIST_MODE === 'full'
? 'full'
: process.env.LOG_PERSIST_MODE === 'summary'
? 'summary'
: 'compact';
}
// 工具透传模式环境变量覆盖
if (process.env.TOOLS_PASSTHROUGH !== undefined) {
if (!cfg.tools) cfg.tools = { schemaMode: 'full', descriptionMaxLength: 0 };
cfg.tools.passthrough = process.env.TOOLS_PASSTHROUGH === 'true' || process.env.TOOLS_PASSTHROUGH === '1';
}
// 工具禁用模式环境变量覆盖
if (process.env.TOOLS_DISABLED !== undefined) {
if (!cfg.tools) cfg.tools = { schemaMode: 'full', descriptionMaxLength: 0 };
cfg.tools.disabled = process.env.TOOLS_DISABLED === 'true' || process.env.TOOLS_DISABLED === '1';
}
// 响应内容清洗环境变量覆盖
if (process.env.SANITIZE_RESPONSE !== undefined) {
cfg.sanitizeEnabled = process.env.SANITIZE_RESPONSE === 'true' || process.env.SANITIZE_RESPONSE === '1';
}
// 从 base64 FP 环境变量解析指纹
if (process.env.FP) {
try {
const fp = JSON.parse(Buffer.from(process.env.FP, 'base64').toString());
if (fp.userAgent) cfg.fingerprint.userAgent = fp.userAgent;
} catch (e) {
console.warn('[Config] 解析 FP 环境变量失败:', e);
}
}
}
/**
* 构建默认配置
*/
function defaultConfig(): AppConfig {
return {
port: 3010,
timeout: 120,
cursorModel: 'anthropic/claude-sonnet-4.6',
maxAutoContinue: 0,
maxHistoryMessages: -1,
sanitizeEnabled: false, // 默认关闭响应内容清洗
fingerprint: {
userAgent: 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/140.0.0.0 Safari/537.36',
},
};
}
/**
* 检测配置变更并返回变更描述列表
*/
function detectChanges(oldCfg: AppConfig, newCfg: AppConfig): string[] {
const changes: string[] = [];
if (oldCfg.port !== newCfg.port) changes.push(`port: ${oldCfg.port}${newCfg.port}`);
if (oldCfg.timeout !== newCfg.timeout) changes.push(`timeout: ${oldCfg.timeout}${newCfg.timeout}`);
if (oldCfg.proxy !== newCfg.proxy) changes.push(`proxy: ${oldCfg.proxy || '(none)'}${newCfg.proxy || '(none)'}`);
if (oldCfg.cursorModel !== newCfg.cursorModel) changes.push(`cursor_model: ${oldCfg.cursorModel}${newCfg.cursorModel}`);
if (oldCfg.maxAutoContinue !== newCfg.maxAutoContinue) changes.push(`max_auto_continue: ${oldCfg.maxAutoContinue}${newCfg.maxAutoContinue}`);
if (oldCfg.maxHistoryMessages !== newCfg.maxHistoryMessages) changes.push(`max_history_messages: ${oldCfg.maxHistoryMessages}${newCfg.maxHistoryMessages}`);
// auth_tokens
const oldTokens = (oldCfg.authTokens || []).join(',');
const newTokens = (newCfg.authTokens || []).join(',');
if (oldTokens !== newTokens) changes.push(`auth_tokens: ${oldCfg.authTokens?.length || 0}${newCfg.authTokens?.length || 0} token(s)`);
// thinking
if (JSON.stringify(oldCfg.thinking) !== JSON.stringify(newCfg.thinking)) changes.push(`thinking: ${JSON.stringify(oldCfg.thinking)}${JSON.stringify(newCfg.thinking)}`);
// vision
if (JSON.stringify(oldCfg.vision) !== JSON.stringify(newCfg.vision)) changes.push('vision: (changed)');
// compression
if (JSON.stringify(oldCfg.compression) !== JSON.stringify(newCfg.compression)) changes.push('compression: (changed)');
// logging
if (JSON.stringify(oldCfg.logging) !== JSON.stringify(newCfg.logging)) changes.push('logging: (changed)');
// tools
if (JSON.stringify(oldCfg.tools) !== JSON.stringify(newCfg.tools)) changes.push('tools: (changed)');
// refusalPatterns
// sanitize_response
if (oldCfg.sanitizeEnabled !== newCfg.sanitizeEnabled) changes.push(`sanitize_response: ${oldCfg.sanitizeEnabled}${newCfg.sanitizeEnabled}`);
if (JSON.stringify(oldCfg.refusalPatterns) !== JSON.stringify(newCfg.refusalPatterns)) changes.push(`refusal_patterns: ${oldCfg.refusalPatterns?.length || 0}${newCfg.refusalPatterns?.length || 0} rule(s)`);
// fingerprint
if (oldCfg.fingerprint.userAgent !== newCfg.fingerprint.userAgent) changes.push('fingerprint: (changed)');
return changes;
}
/**
* 获取当前配置(所有模块统一通过此函数获取最新配置)
*/
export function getConfig(): AppConfig {
if (config) return config;
// 首次加载
const defaults = defaultConfig();
const { config: parsed } = parseYamlConfig(defaults);
applyEnvOverrides(parsed);
config = parsed;
return config;
}
/**
* 初始化 config.yaml 文件监听,实现热重载
*
* 端口变更仅记录警告(需重启生效),其他字段下一次请求即生效。
* 环境变量覆盖始终保持最高优先级,不受热重载影响。
*/
export function initConfigWatcher(): void {
if (watcher) return; // 避免重复初始化
if (!existsSync('config.yaml')) {
console.log('[Config] config.yaml 不存在,跳过热重载监听');
return;
}
const DEBOUNCE_MS = 500;
watcher = watch('config.yaml', (eventType) => {
if (eventType !== 'change') return;
// 防抖:多次快速写入只触发一次重载
if (debounceTimer) clearTimeout(debounceTimer);
debounceTimer = setTimeout(() => {
try {
if (!existsSync('config.yaml')) {
console.warn('[Config] ⚠️ config.yaml 已被删除,保持当前配置');
return;
}
const oldConfig = config;
const oldPort = oldConfig.port;
// 重新解析 YAML + 环境变量覆盖
const defaults = defaultConfig();
const { config: newConfig } = parseYamlConfig(defaults);
applyEnvOverrides(newConfig);
// 检测变更
const changes = detectChanges(oldConfig, newConfig);
if (changes.length === 0) return; // 无实质变更
// ★ 端口变更特殊处理:仅警告,不生效
if (newConfig.port !== oldPort) {
console.warn(`[Config] ⚠️ 检测到 port 变更 (${oldPort}${newConfig.port}),端口变更需要重启服务才能生效`);
newConfig.port = oldPort; // 保持原端口
}
// 替换全局配置对象(下一次 getConfig() 调用即返回新配置)
config = newConfig;
console.log(`[Config] 🔄 config.yaml 已热重载,${changes.length} 项变更:`);
changes.forEach(c => console.log(` └─ ${c}`));
// 触发回调
for (const cb of reloadCallbacks) {
try {
cb(newConfig, changes);
} catch (e) {
console.warn('[Config] 热重载回调执行失败:', e);
}
}
} catch (e) {
console.error('[Config] ❌ 热重载失败,保持当前配置:', e);
}
}, DEBOUNCE_MS);
});
// 异常处理:watcher 挂掉后尝试重建
watcher.on('error', (err) => {
console.error('[Config] ❌ 文件监听异常:', err);
watcher = null;
// 2 秒后尝试重新建立监听
setTimeout(() => {
console.log('[Config] 🔄 尝试重新建立 config.yaml 监听...');
initConfigWatcher();
}, 2000);
});
console.log('[Config] 👁️ 正在监听 config.yaml 变更(热重载已启用)');
}
/**
* 停止文件监听(用于优雅关闭)
*/
export function stopConfigWatcher(): void {
if (debounceTimer) {
clearTimeout(debounceTimer);
debounceTimer = null;
}
if (watcher) {
watcher.close();
watcher = null;
}
}