thzxx
2230bcec3f
P0 安全修复: - API Key 加密存储（safeStorage 密钥链，版本化前缀，历史明文平滑兼容） - 间接提示注入防护（SecurityScanHook 工具结果深扫描，网络工具脱敏/本地工具警示分级） - error:report IPC 断链修复（渲染进程错误上报落 electron-log + 审计） - abort 信号贯通工具层（run_command/dev-tools 子进程随会话中断终止） - run_command 沙箱加固（cd 系统目录/敏感文件读取拦截 + chcp 前缀剥离防解析退化） - .env 真实生效（dotenv 回退加载，应用内配置优先） P1 工程基础: - ESLint 9 flat config + 全部 34 条存量 warnings 清零（零容忍基线） - 测试基线 118 用例 11 文件（token/文件防护/权限/沙箱/注入/命令/引擎/注册表/审计链/摘要分层） - test:electron 双模式（ELECTRON_RUN_AS_NODE 跑 Electron ABI，SQLite 套件全执行） - SessionRecorder 多会话隔离 + 9 种 TRACE 事件补全（含最终轮 iteration_end） - Provider 故障转移（重试耗尽/不可重试一次性切换 fallback + 前端通知） - MCP 真就绪（等待全部连接完成再广播 tools:ready） - SLO/HealthChecker 真实接入（60s 巡检 + 托盘状态） - CONFIG_DEFAULTS 单一来源（消除 SEED 双源漂移） P2 架构升级: - handlers.ts 1940 行拆分为 13 个 IPC 域模块（防重入注册 + 多窗口广播） - AgentEngineManager 每会话独立引擎（LRU 30 + adapter 工厂隔离 abort 信号） - TaskOrchestrator EngineProvider 改造 + abortByParent 联动中断 SubAgent - 会话摘要分层上下文（session_summaries 滚动摘要 + 截断游标清理防因果污染） - 消息编辑重发/重新生成（truncateAfter IPC + store 动作 + UI） - Markdown 导出 / WebSearch 并行抓取（并发 3）/ 记忆 TF 缓存 / 版本构建期注入 P3 能力扩展: - OpenAI Adapter（o 系列推理模型 reasoning_effort/max_completion_tokens） - Anthropic Adapter（原生 Messages API：tool_use 块/角色合并/thinking budget/图片 base64/SSE 事件机） - 设置页/Onboarding 六 Provider 全链路接入
71 lines
2.8 KiB
TypeScript
71 lines
2.8 KiB
TypeScript
/**
|
||
* Secure Config — 敏感配置项加密存储（P0-1）
|
||
*
|
||
* 使用 Electron safeStorage（操作系统级密钥链：Windows DPAPI / macOS Keychain / Linux libsecret）
|
||
* 对 API Key 等敏感配置值做静态加密，落盘前加密、读取时解密。
|
||
*
|
||
* 加密格式：`metona-enc:v1:<base64(safeStorage.encryptString(value))>`
|
||
*
|
||
* 兜底策略：
|
||
* - safeStorage 不可用（如部分 Linux 无 keyring）→ 明文存储并打 WARN（保持可用性）
|
||
* - 解密失败（跨机器拷贝配置/重装系统导致密钥失效）→ 返回空串，用户需重新录入
|
||
*/
|
||
|
||
import { safeStorage } from 'electron';
|
||
import log from 'electron-log';
|
||
|
||
/** 加密值前缀标记（版本化，便于未来算法升级） */
|
||
const ENCRYPTION_PREFIX = 'metona-enc:v1:';
|
||
|
||
/** 敏感配置 key 匹配模式（与 IPC 层审计脱敏规则保持一致） */
|
||
const SENSITIVE_KEY_PATTERNS = ['apikey', 'api_key', 'apitoken', 'token', 'secret', 'password', 'auth_key'];
|
||
|
||
/** 判断配置 key 是否为敏感项（需要加密存储） */
|
||
export function isSensitiveConfigKey(key: string): boolean {
|
||
return SENSITIVE_KEY_PATTERNS.some((p) => key.toLowerCase().includes(p));
|
||
}
|
||
|
||
/** 判断值是否已是加密格式 */
|
||
export function isEncryptedValue(value: unknown): value is string {
|
||
return typeof value === 'string' && value.startsWith(ENCRYPTION_PREFIX);
|
||
}
|
||
|
||
/**
|
||
* 加密配置值（写入持久层前调用）
|
||
*
|
||
* 仅对非空字符串生效；其他类型（number/boolean/null）原样返回。
|
||
* safeStorage 不可用时降级为明文（记录 WARN）。
|
||
*/
|
||
export function encryptConfigValue(value: unknown): unknown {
|
||
if (typeof value !== 'string' || value.length === 0) return value;
|
||
if (isEncryptedValue(value)) return value; // 已加密，幂等
|
||
try {
|
||
if (!safeStorage.isEncryptionAvailable()) {
|
||
log.warn('[SecureConfig] safeStorage 不可用，敏感配置将以明文存储');
|
||
return value;
|
||
}
|
||
const encrypted = safeStorage.encryptString(value);
|
||
return ENCRYPTION_PREFIX + encrypted.toString('base64');
|
||
} catch (err) {
|
||
log.error('[SecureConfig] 加密失败，回退明文存储:', err);
|
||
return value;
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 解密配置值（从持久层读取后调用）
|
||
*
|
||
* 非加密格式原样返回；解密失败返回空串（密钥链变更场景，
|
||
* 返回空串使 createAdapter 判定"未配置"，引导用户重新录入而非崩溃）。
|
||
*/
|
||
export function decryptConfigValue(value: unknown): unknown {
|
||
if (!isEncryptedValue(value)) return value;
|
||
try {
|
||
const buf = Buffer.from(value.slice(ENCRYPTION_PREFIX.length), 'base64');
|
||
return safeStorage.decryptString(buf);
|
||
} catch (err) {
|
||
log.error('[SecureConfig] 解密失败（可能因系统密钥链变更），请重新录入 API Key:', err);
|
||
return '';
|
||
}
|
||
}
|