MetonaTeam/metona-ai-desktop
2
1
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity

feat: v0.4.1 质量加固版 — 工程化基线 + 安全加固 + 测试补齐 + 体验升级
CI / 类型检查 + Lint + 单元测试 (push) Failing after 5m25s
Details
CI / 全量测试 (Electron ABI, experimental) (push) Failing after 5m19s
Details
CI / 产物编译验证 (push) Successful in 10m3s
Details

Browse Source 
工程化（从零到一）:
- 新增 Gitea Actions CI（debian-latest）：类型检查 + Lint + 单元测试 + 产物编译验证
- 新增 husky + lint-staged 预提交钩子（lint-staged + typecheck 门禁）
- 移除坏脚本 test:e2e（无 Playwright 配置必失败）；prebuild 改用内置 fs.rmSync
- 依赖清理：移除死依赖 sql.js(2MB)/@playwright/test，@types/shell-quote 移至 devDependencies

安全加固:
- PolicyEngine 频率限制按会话隔离（多会话并发不再互抢配额）
- ConfirmationHook 拒绝记忆加 10 分钟 TTL + 恢复询问入口（新增 2 个 IPC 通道）
- Windows run_command 白名单工具（git/node/npm/npx/pnpm/yarn/tsc）改走 cmd.exe /c + 参数数组执行，收窄 shell 注入面
- web_search 四引擎 HTML 解析迁移 node-html-parser（结构化主层 + 正则降级）

缺陷修复（测试驱动发现）:
- mapError 大小写缺陷：网络错误码永远落入 UNKNOWN 无法触发重试
- 搜狗解析器自我过滤：相对链接补全后又被 sogou.com 过滤导致结果全丢
- 百度复合类名重复收录：class="result c-container" 被双重匹配

测试补齐（113 → 194 用例）:
- 新增 5 个测试文件：sse-stream / base-adapter / confirmation-hook / ipc-agent 编排链路 / web-search 解析器
- 覆盖 sendMessage 全分支、SSE 流解析、错误映射、确认钩子竞态/超时/批量审批

体验升级:
- OutputValidator 验证结果可见化（VALIDATION 流事件 → 聊天流提示卡）
- SettingsModal 巨型组件拆分（1503 行 → 10 个文件，可独立维护）
- MessageList 接入 react-virtuoso 真虚拟滚动（千条消息恒定开销）
- MCP 新增 streamable HTTP 传输支持（SDK 内置传输 + DB 迁移 6 + UI 双模式）
This commit is contained in:
thzxx
2026-08-21 13:58:48 +08:00
parent 2230bcec3f
commit 49c9b25538
41 changed files with 6254 additions and 2608 deletions
Download Patch File Download Diff File Expand all files Collapse all files
src/types/global.d.ts
Vendored
+90 -40
View File
@@ -59,15 +59,19 @@ interface MetonaAgentAPI {
/** 发送 MetonaMessage（IR 类型）+ sessionId 到主进程 */
sendMessage: (message: MetonaMessageInput, sessionId: string) => Promise<{ success: boolean }>;
onStreamEvent: (callback: (event: MetonaStreamEventData) => void) => () => void;
onStateChange: (callback: (state: {
sessionId: string | null;
iteration: number;
state: string;
previous: string;
current: string;
}) => void) => () => void;
onStateChange: (
callback: (state: {
sessionId: string | null;
iteration: number;
state: string;
previous: string;
current: string;
}) => void,
) => () => void;
abortSession: (sessionId: string) => Promise<{ success: boolean }>;
onProviderSwitched: (callback: (data: { from?: string; to?: string; reason?: string }) => void) => () => void;
onProviderSwitched: (
callback: (data: { from?: string; to?: string; reason?: string }) => void,
) => () => void;
}
// ===== Sessions API =====
@@ -87,25 +91,40 @@ interface MetonaSessionsAPI {
create: (title?: string) => Promise<MetonaSessionInfo>;
rename: (sessionId: string, title: string) => Promise<{ success: boolean; error?: string }>;
delete: (sessionId: string) => Promise<{ success: boolean; error?: string }>;
getMessages: (sessionId: string) => Promise<Array<{
id: string;
role: string;
content: string;
reasoningContent?: string;
toolCalls?: unknown[];
toolResult?: unknown;
attachments?: Array<{ id: string; name: string; type: string; size: number; preview?: string; textContent?: string }>;
iteration?: number;
timestamp: number;
}>>;
getMessages: (sessionId: string) => Promise<
Array<{
id: string;
role: string;
content: string;
reasoningContent?: string;
toolCalls?: unknown[];
toolResult?: unknown;
attachments?: Array<{
id: string;
name: string;
type: string;
size: number;
preview?: string;
textContent?: string;
}>;
iteration?: number;
timestamp: number;
}>
>;
pin: (sessionId: string, pinned: boolean) => Promise<{ success: boolean; error?: string }>;
archive: (sessionId: string, archived: boolean) => Promise<{ success: boolean; error?: string }>;
deleteMessage: (messageId: string) => Promise<{ success: boolean }>;
clearMessages: (sessionId: string) => Promise<{ success: boolean }>;
/** P2-11: 截断消息（编辑重发/重新生成） */
truncateAfter: (sessionId: string, messageId: string, inclusive?: boolean) =>
Promise<{ success: boolean; truncated?: number; error?: string }>;
saveTrace: (sessionId: string, data: { traceSteps: unknown[]; tokenUsage: unknown }) => Promise<{ success: boolean }>;
truncateAfter: (
sessionId: string,
messageId: string,
inclusive?: boolean,
) => Promise<{ success: boolean; truncated?: number; error?: string }>;
saveTrace: (
sessionId: string,
data: { traceSteps: unknown[]; tokenUsage: unknown },
) => Promise<{ success: boolean }>;
getTrace: (sessionId: string) => Promise<{ traceSteps: unknown[]; tokenUsage: unknown } | null>;
}
@@ -113,7 +132,8 @@ interface MetonaSessionsAPI {
interface MetonaMCPServerConfig {
name: string;
transport: 'stdio' | 'sse';
/** v0.4.1: 新增 'streamable-http'（MCP 当前主流远程传输） */
transport: 'stdio' | 'sse' | 'streamable-http';
command?: string;
args?: string[];
url?: string;
@@ -147,11 +167,14 @@ interface MetonaMemorySearchResult {
}
interface MetonaMemoryAPI {
search: (query: string, options?: {
topK?: number;
type?: 'episodic' | 'semantic' | 'working';
minImportance?: number;
}) => Promise<MetonaMemorySearchResult[]>;
search: (
query: string,
options?: {
topK?: number;
type?: 'episodic' | 'semantic' | 'working';
minImportance?: number;
},
) => Promise<MetonaMemorySearchResult[]>;
listAll: (options?: { type?: string; limit?: number }) => Promise<{
success: boolean;
data?: { episodic?: unknown[]; semantic?: unknown[]; working?: unknown[] };
@@ -166,7 +189,9 @@ interface MetonaConfigAPI {
get: (key: string) => Promise<unknown>;
set: (key: string, value: unknown) => Promise<{ success: boolean; error?: string }>;
// v0.3.9: 批量保存配置，避免串行保存中间态触发 reloadAdapter 失败
setBatch: (entries: Array<{ key: string; value: unknown }>) => Promise<{ success: boolean; error?: string }>;
setBatch: (
entries: Array<{ key: string; value: unknown }>,
) => Promise<{ success: boolean; error?: string }>;
// v0.3.17: 监听配置变更广播（后端 config:set/setBatch 后触发，用于前端 store 实时更新）
onChanged: (callback: (data: { key: string; value: unknown }) => void) => () => void;
}
@@ -227,8 +252,11 @@ interface MetonaWorkspaceInfo {
interface MetonaWorkspaceAPI {
check: (targetPath: string) => Promise<MetonaWorkspaceCheckResult>;
inheritFiles: (params: { targetPath: string; sourcePath: string; files: string[] }) =>
Promise<MetonaWorkspaceInheritResult>;
inheritFiles: (params: {
targetPath: string;
sourcePath: string;
files: string[];
}) => Promise<MetonaWorkspaceInheritResult>;
getInfo: () => Promise<MetonaWorkspaceInfo>;
// #51 修复: 校验源数据库完整性（PRAGMA integrity_check）
checkDatabaseIntegrity: (sourcePath: string) => Promise<{
@@ -242,11 +270,13 @@ interface MetonaWorkspaceAPI {
// ===== Toast API =====
interface MetonaToastAPI {
onShow: (callback: (data: {
type: 'success' | 'error' | 'warning' | 'info';
message: string;
options?: Record<string, unknown>;
}) => void) => () => void;
onShow: (
callback: (data: {
type: 'success' | 'error' | 'warning' | 'info';
message: string;
options?: Record<string, unknown>;
}) => void,
) => () => void;
}
// ===== Tools API =====
@@ -280,7 +310,11 @@ interface MetonaSearXNGTestResult {
interface MetonaSearXNGAPI {
/** 测试 SearXNG 实例连接可达性与认证有效性 */
testConnection: (url: string, authKey: string, authType: string) => Promise<MetonaSearXNGTestResult>;
testConnection: (
url: string,
authKey: string,
authType: string,
) => Promise<MetonaSearXNGTestResult>;
}
// ===== Data API =====
@@ -347,8 +381,11 @@ interface MetonaAuditVerifyResult {
interface MetonaAuditAPI {
verifyChain: () => Promise<MetonaAuditVerifyResult>;
query: (filters?: { sessionId?: string; eventType?: string; limit?: number }) =>
Promise<{ success: boolean; data?: unknown[]; error?: string }>;
query: (filters?: {
sessionId?: string;
eventType?: string;
limit?: number;
}) => Promise<{ success: boolean; data?: unknown[]; error?: string }>;
}
// ===== v0.2.0: Tool Confirmation API =====
@@ -386,8 +423,21 @@ interface MetonaToolAPI {
success: boolean;
data: MetonaConfirmationRequest[];
}>;
/**
* v0.4.1: 获取本会话内记住"拒绝"的工具列表（拒绝记忆 10 分钟 TTL，到期自动恢复询问）
* 供确认弹框展示"重新询问"入口
*/
getRememberedDenials: () => Promise<{
success: boolean;
data: Array<{ toolName: string; expiresInSeconds: number }>;
}>;
/** v0.4.1: 重置指定工具的会话内拒绝记忆（立即恢复询问） */
resetRememberedDenial: (toolName: string) => Promise<{ success: boolean; error?: string }>;
/** 设置/取消工具的持久化自动执行（跨会话不再询问） */
setAutoExecute: (toolName: string, enabled: boolean) => Promise<{ success: boolean; error?: string }>;
setAutoExecute: (
toolName: string,
enabled: boolean,
) => Promise<{ success: boolean; error?: string }>;
/** 获取已设置为自动执行的工具列表 */
getAutoExecuteList: () => Promise<{ success: boolean; data: string[] }>;
}