thzxx 3c5aea8fb7 feat: 升级至 v0.2.1 — 流式渲染修复、安全增强、工具自动执行
流式渲染修复:
- runId 机制防止 abort 后旧流事件污染新 run
- run lock 防止并发 run 污染引擎状态
- abort race 提前退出工具执行等待
- TERMINATED 状态通过 stateChange 发射
- tool_call_delta 流式参数拼接 + pending 占位替换
- 首轮卡片创建路径统一,traceStep 按 ID 精确匹配
- compressed 事件转发为 toast 通知

安全增强:
- ConfirmationHook 支持持久化自动执行(跨会话)
- 设置面板新增自动执行工具管理 UI
- SandboxManager 双重安全校验 fail-closed
- 审计日志链式哈希防篡改
- PromptInjectionDefender 中文注入标记清理
- scanCode 28 模式 + base64/$() 检测
- validatePath realpathSync 防符号链接逃逸
- code-search 使用 execFile 防命令注入

新增工具:
- file_editor、code_search、task_manager、diff_viewer

其他:
- Agent Loop 加 PARSING/REFLECTING 状态 + 指数退避重试
- MemoryManager TF-IDF 语义检索
- run_command Windows 中文编码修复(chcp 65001)
- 版本号 0.2.0 → 0.2.1
2026-07-12 12:54:52 +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%