thzxx 025f00171b feat: 升级至 v0.3.0 — 安全增强、死循环检测、六轮全面审计修复
大版本迭代,新增安全增强、Agent Loop 增强、UI/UX 增强,经六轮全面审计修复所有问题。

新增功能:
- OutputValidator 事实一致性检查 + 幻觉检测
- PromptInjectionDefender 语义级检测(指令性动词密度、角色边界、分隔符嵌套)
- DeadLoopError 死循环检测(连续3轮相同工具调用自动终止)
- PolicyEngine maxFrequency 滑动窗口频率限制
- MemoryManager TF-IDF 语义检索 + IDF 缓存原子替换
- 斜杠命令(/tool /memory /clear /export)+ 快捷键(Ctrl+B/J/Shift+F/N/[/])
- 专注模式(Ctrl+Shift+F)带面板状态快照保存/恢复

六轮审计修复(共修复 3 CRITICAL + 8 HIGH + 13 MEDIUM + 11 LOW):

CRITICAL:
- main.ts 传入 createAdapter 而非 reloadAdapter,导致 Provider 切换完全失效
- Ctrl+N/Ctrl+[/Ctrl+] 不同步 agent-store,导致消息发到错误会话
- engine.ts emit('error') 无监听器导致 DONE 事件丢失、前端卡死

HIGH:
- 死循环检测在工具执行之后(移入 PARSING 后 EXECUTING 前)
- deadLoop 事件前端未处理
- ConfirmationHook.clearPending 从未调用导致定时器泄漏
- engine.ts retry abort listener 未移除导致监听器堆积
- MCPManager JSON.parse 无 try-catch 导致初始化崩溃
- sendMessage 自动创建会话不同步 session-store
- setCurrentSession 竞态导致旧请求覆盖新会话数据

MEDIUM:
- toggleFocusMode 覆盖用户原有面板状态
- 正则检测可被常见词绕过
- 频率限制内存泄漏 + customPolicies 覆盖
- LIKE 回退转义未包含反斜杠
- OutputValidator 新功能未传入 toolResults/context
- MemoryConsolidator LLM 调用无超时保护
- AuditService 每次 log 都查询数据库
- browser-window-manager 超时后未停止页面加载
- output-validator URL 比较大小写敏感
- FileReader 无 onerror 导致 Promise 永久挂起
- /clear /export 不关闭斜杠菜单
- 专注模式下 toggleSidebar/toggleDetail 未恢复另一面板快照

LOW:
- abortPromise 事件监听器堆积
- RateLimitHook Map 内存泄漏
- memory.ts await 同步方法
- PolicyEngine 死代码清理
- Orchestrator sessionDepth 会话结束不清理
- workspace.service.ts 元数据插入边界问题
2026-07-12 19:46:47 +08:00
2026-06-27 21:33:27 +08:00
2026-06-27 21:33:27 +08:00
2026-06-27 21:33:27 +08:00

MetonaAI Desktop

生产级通用 AI Agent 智能体桌面应用。

技术栈

  • 运行时: Electron 35 + React 19 + TypeScript 5.8
  • 状态管理: Zustand 5
  • 数据库: better-sqlite3
  • LLM: DeepSeek / Agnes AI / Ollama
  • 协议: MCP (Model Context Protocol)
  • 构建: electron-vite + Vite 6

快速开始

# 安装依赖
npm install

# 开发模式
npm run dev

# 构建
npm run build

配置

复制 .env.example.env,填入 API Key

cp .env.example .env

或在应用设置界面中配置 LLM Provider。

项目结构

MetonaAI-Desktop/
├── electron/              # Electron 主进程
│   ├── main.ts            # 应用入口
│   ├── preload.ts         # 安全桥接脚本
│   ├── ipc/               # IPC 通道处理
│   ├── services/          # 业务服务(数据库、会话、记忆等)
│   └── harness/           # Agent 核心引擎
│       ├── agent-loop/    # ReAct 状态机
│       ├── adapters/      # LLM Provider 适配器
│       ├── tools/         # 工具注册与内置工具
│       ├── memory/        # 记忆系统
│       ├── prompts/       # System Prompt 构建
│       └── types/         # Metona IR 类型定义
├── src/                   # React 渲染进程
│   ├── components/        # UI 组件
│   ├── hooks/             # React Hooks
│   ├── stores/            # Zustand 状态管理
│   ├── styles/            # 全局样式
│   └── types/             # 类型声明
├── docs/                  # 设计文档
├── standard/              # 开发规范
└── apis/                  # API 文档

功能

  • 三栏布局(Sidebar + Chat + DetailPanel
  • 流式对话(DeepSeek / Agnes / Ollama
  • 9 个内置工具(文件系统、网络、记忆、命令行)
  • MCP 协议支持
  • 会话持久化(SQLite
  • 三层记忆系统(情节/语义/工作)
  • 全链路追踪(Trace Viewer
  • 审计日志(防篡改)
  • 系统托盘 + 全局快捷键
  • 暗色/亮色主题
  • 14 个键盘快捷键

许可证

MIT

S
Description
MetonaAI Desktop — 生产级通用 AI Agent 智能体桌面应用
Readme MIT
4.1 MiB
Languages
TypeScript 78.4%
HTML 21%
CSS 0.6%