feat: v0.4.0 四阶段迭代 — 安全加固 + 工程基线 + 架构重构 + 双 Provider 扩展

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 全链路接入
This commit is contained in:
2026-08-20 23:17:02 +08:00
parent b9f7ec5118
commit 2230bcec3f
90 changed files with 6581 additions and 2771 deletions
+70
View File
@@ -0,0 +1,70 @@
/**
* 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 '';
}
}