Files

T

thzxx 20cbfbd169 v0.11.11: 彻底移除技能系统，工具 44→42，SQLite 7→6 张表

- 删除 src/renderer/services/skill-manager.ts (480行)
- sqlite.ts: 删除 skills 表/索引/迁移/SkillRow接口/CRUD
- ipc.ts: 删除 6 个 skills IPC handler
- preload.ts/types.d.ts: 删除 skills bridge 方法/类型
- agent-engine.ts: 删除技能匹配上下文注入/自动提取
- tool-registry.ts: 删除 skill_list/skill_view 工具定义/执行
- log-service.ts/sub-agent.ts/workspace-panel.ts: 清理引用
- index.html: 帮助面板/工具卡片更新，44→42
- README/release-notes/DEVELOPMENT/AGENT: 文档全量同步

2026-06-22 18:13:01 +08:00

18 KiB

Raw Blame History

Metona Ollama Desktop

🤖 本地 AI 桌面客户端 · Local AI Desktop Client

所有 AI 推理在本地完成，数据不离开本机。
All AI inference runs locally — data never leaves your machine.

🇨🇳 中文

✨ 特性

	功能	说明
🤖	ReAct Agent Loop	始终开启的唯一对话模式。Thought → Action → Observation → Reflection 完整循环，最大 85 轮（可配置），自动重试 2 次，工具去重，并行/链式执行
🔧	42 个内置工具	文件系统（16个） · 命令执行 · 联网搜索 · 浏览器控制（9个） · Git · 记忆 · 会话 · 子代理 · 系统工具
🧠	智能记忆系统	三类记忆（fact / preference / rule），FTS5 全文搜索 + 向量语义搜索，写入前安全扫描，容量 500 条，90 天衰减
📋	自定义文件	SOUL.md（人格，不可压缩）+ AGENT.md（行为准则）+ USER.md（用户画像），工作空间优先，内置默认 fallback
🌐	MCP 协议扩展	JSON-RPC 2.0 over stdio，动态工具发现，Shadowing 防护
🔍	联网搜索（双模式）	SearXNG 元搜索引擎 JSON API（70+引擎聚合）/ 四引擎 HTML 解析（Bing+百度+搜狗+360），双模式可切换；web_fetch 支持反爬+UA切换+浏览器回退
🌏	浏览器控制	打开网页 · 截图 · 执行 JS · 提取内容 · 点击 · 输入 · 滚动 · 关闭
🖥️	工作空间面板	终端（实时流式输出）+ 文件浏览器，命令安全检查
🔢	上下文长度自动检测	切换模型时自动从 model_info 获取实际支持的上下文长度，无需手动配置
🗜️	智能上下文管理	滑动窗口 + Token 自动校准 + 消息重要性评分 + LLM 结构化 JSON 压缩
👥	子代理委派	spawn_task 工具，独立上下文 + 超时保护
📈	Token 仪表盘	全局 + 会话统计，消耗趋势柱状图，2 秒刷新，输入/输出分色
📋	系统提示词卡片	每条 AI 回复顶部折叠卡片，点击查看实际发送给模型的完整上下文
🎨	暖色调 UI	奶白 `#FAF7F2` + 珊瑚橙 `#E8734A`，长时间使用不疲劳
🔔	系统托盘	原生托盘集成
🔐	AES-256-GCM	数据加密支持

🔧 工具清单

📁 文件系统（16 个）

工具	功能
`read_file`	读取文件（文本/binary，2000行默认）
`write_file`	写入/追加文件（支持base64二进制）
`list_directory`	列出目录内容
`search_files`	搜索文件（正则/通配符）
`create_directory`	创建目录
`delete_file`	删除文件/目录（返回大小）
`move_file`	移动/重命名文件
`copy_file`	复制文件
`edit_file`	编辑文件（支持正则替换）
`get_file_info`	获取文件元信息
`tree`	目录树结构（默认5层深度）
`download_file`	下载文件
`diff_files`	文件差异对比
`replace_in_files`	批量替换
`read_multiple_files`	批量读取（50文件/10KB）
`compress`	压缩文件/目录

⚡ 命令执行（1 个）

工具	功能
`run_command`	执行 shell 命令，实时流式输出，支持自动/需确认/禁用三种模式

🔍 联网搜索（2 个）

工具	功能
`web_search`	SearXNG JSON API / 四引擎并行，默认 30 条结果
`web_fetch`	网页内容抓取，自动重试（指数退避），移动端UA切换，SPA页面自动升级到浏览器渲染

🌐 浏览器控制（9 个）

工具	功能
`browser_open`	打开网页
`browser_screenshot`	页面截图
`browser_evaluate`	执行 JavaScript
`browser_extract`	提取页面内容
`browser_click`	点击元素
`browser_type`	输入文本
`browser_scroll`	页面滚动
`browser_wait`	等待元素/延时
`browser_close`	关闭浏览器

📦 Git（1 个，17 个子命令）

子命令	功能
`init` `clone` `add` `commit` `push` `pull`	基础操作
`diff` `log` `status` `branch` `checkout`	查看与切换
`merge` `stash` `reset` `tag` `remote`	高级操作

🧠 记忆管理（4 个）

工具	功能
`memory_search`	搜索记忆（FTS5 + 向量语义）
`memory_add`	添加记忆（自动安全扫描）
`memory_replace`	修改记忆
`memory_remove`	删除记忆

📊 会话 / 子代理（3 个）

工具	功能
`session_list`	列出历史会话
`session_read`	读取会话内容
`spawn_task`	委派子代理（独立上下文 + 超时保护）

🕐 系统工具（6 个）

工具	功能
`datetime`	获取系统精确时间（ISO/Unix/日期/时间/完整）
`calculator`	安全数学计算（+ - * / ** % ()，递归下降解析器）
`random`	随机生成（整数/浮点/抽取/随机字符串）
`uuid`	生成 UUID v4 唯一标识符
`json_format`	JSON 格式化 + 语法验证 + 键排序
`hash`	哈希计算（MD5/SHA1/SHA256/SHA384/SHA512）

🏗️ 架构

用户消息 → 扫描工作空间 SOUL.md（不可压缩层）→ AGENT.md → USER.md
              ↓
         Agent Engine (ReAct Loop, ≤85轮)
              ↓
         记忆检索 (FTS5 + 向量语义搜索) → 上下文注入
              ↓
         Ollama API (流式响应，num_ctx 自动检测)
              ↓
         Tool Registry (42 内置 + MCP 动态)
              ↓
         观察结果 → 反思 → 循环 / 最终回答

🧩 UI 组件（原生 DOM）

main.ts (入口)
  ├── header.ts              # 顶部导航栏
  ├── model-bar.ts           # 模型选择栏
  ├── chat-area.ts           # 聊天消息区域
  ├── input-area.ts          # 输入框 + 文件上传
  ├── workspace-panel.ts     # 终端 + 文件浏览器
  ├── settings-modal.ts      # 设置面板
  ├── history-modal.ts       # 会话历史
  ├── memory-modal.ts        # 记忆管理
  ├── tools-modal.ts         # 工具列表
  ├── token-dashboard.ts     # Token 消耗仪表盘
  ├── tool-confirm-modal.ts  # 工具执行确认
  ├── prompt-modal.ts        # 系统提示词查看
  ├── toast.ts               # Toast 通知
  └── lightbox.ts            # 图片灯箱

🗄️ 数据库

SQLite (sql.js WASM)，6 张表，WAL 模式 + FTS5 全文搜索：

表	用途
`sessions`	会话（parent_id 父子关系）
`messages`	消息（外键级联删除）
`tool_calls`	工具调用记录
`memories`	Agent 记忆（FTS5 + 向量嵌入）
`settings`	设置（JSON 序列化）
`traces`	ReAct 执行轨迹

🔒 安全机制

层级	措施
📁 文件系统	`checkPathAllowed()` — 路径黑名单
⚡ 命令执行	`checkCommandAllowed()` — 命令黑名单 + 三种模式
🖥️ 前端渲染	HTML 净化器（白名单标签 + URI 协议检查）
🔒 Electron	`contextIsolation: true` + IPC 白名单
🔐 数据加密	AES-256-GCM
🧠 记忆安全	写入前 Prompt Injection / 敏感信息检测
🌐 MCP 安全	Shadowing 防护

🚀 快速开始

git clone https://gitee.com/thzxx/metona-ollama-desktop.git
cd metona-ollama-desktop
npm config set registry https://registry.npmmirror.com
npm install
npm start

📦 构建 Windows 安装包

# 环境：Ubuntu 24.04 + Node.js v22 + Wine 9.0+
ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/ npm run dist

产出：release/Metona Ollama Setup v0.11.11.exe

🛠️ 常用命令

npm start              # 构建并运行
npm run dev:renderer   # Vite watch（渲染进程）
npm run dev:main       # tsc watch（主进程）
npm run build          # 完整构建
npm run dist           # 构建 Windows 安装包

💻 系统要求

🖥️ Windows 10/11（64 位）
🤖 Ollama 本地运行中（默认 http://localhost:11434）
💾 建议 8GB+ 内存

📄 许可证

MIT

🇬🇧 English

✨ Features

	Feature	Description
🤖	ReAct Agent Loop	Always-on, only chat mode. Full Thought → Action → Observation → Reflection cycle, up to 85 iterations (configurable), auto-retry 2 times, tool dedup, parallel/chain execution
🔧	42 Built-in Tools	File system · Command · Web search · Browser · Git · Memory · Sessions · Sub-agent · System
🧠	Smart Memory System	Three types (fact / preference / rule), FTS5 + vector semantic search, pre-write security scan, 500 capacity, 90-day decay
📋	Custom Files	SOUL.md (persona, never compressed) + AGENT.md (behavior rules) + USER.md (user profile), workspace-first with built-in defaults
🌐	MCP Protocol Extension	JSON-RPC 2.0 over stdio, dynamic tool discovery, Shadowing protection
🔍	Web Search (dual-mode)	SearXNG meta-search JSON API (70+ engines) / quad-engine HTML parsing (Bing+Baidu+Sogou+360), switchable; web_fetch with auto-retry+mobile UA+SPA browser fallback
🌏	Browser Control	Open pages · Screenshot · JS execution · Content extraction · Click · Type · Scroll · Close
🖥️	Workspace Panel	Terminal (real-time streaming) + file browser, command security checks
🔢	Auto Context Length Detection	Reads actual context_length from model metadata on model switch — no manual config needed
🗜️	Smart Context Manager	Sliding window + Token auto-calibration + message importance scoring + LLM structured JSON compression
👥	Sub-agent Delegation	spawn_task tool, isolated context + timeout protection
📈	Token Dashboard	Global + session stats, consumption trend bar chart, 2s refresh, input/output color-coded
📋	System Prompt Card	Collapsible card atop each AI reply — click to inspect the full context sent to the model
🎨	Warm-tone UI	Cream `#FAF7F2` + coral `#E8734A`, fatigue-free for extended use
🔔	System Tray	Native tray integration
🔐	AES-256-GCM	Data encryption support

🔧 Tool List

📁 File System (16)

Tool	Function
`read_file`	Read file (text/binary, 2000 lines default)
`write_file`	Write/append file (base64 binary support)
`list_directory`	List directory contents
`search_files`	Search files (regex/wildcard)
`create_directory`	Create directory
`delete_file`	Delete file/dir (returns size)
`move_file`	Move/rename file
`copy_file`	Copy file
`edit_file`	Edit file (regex support)
`get_file_info`	Get file metadata
`tree`	Directory tree (default 5 levels)
`download_file`	Download file
`diff_files`	File diff comparison
`replace_in_files`	Batch replace
`read_multiple_files`	Batch read (50 files/10KB)
`compress`	Compress file/directory

⚡ Command Execution (1)

Tool	Function
`run_command`	Execute shell command, real-time streaming, auto/confirm/disabled modes

🔍 Web Search (2)

Tool	Function
`web_search`	SearXNG JSON API / quad-engine parallel, 30 results default
`web_fetch`	Fetch web page content, auto-retry with backoff, mobile UA toggle, SPA auto-upgrade to browser rendering

🌐 Browser Control (9)

Tool	Function
`browser_open`	Open web page
`browser_screenshot`	Page screenshot
`browser_evaluate`	Execute JavaScript
`browser_extract`	Extract page content
`browser_click`	Click element
`browser_type`	Type text
`browser_scroll`	Scroll page
`browser_close`	Close browser

📦 Git (1 tool, 17 subcommands)

Subcommands	Function
`init` `clone` `add` `commit` `push` `pull`	Basic operations
`diff` `log` `status` `branch` `checkout`	View & switch
`merge` `stash` `reset` `tag` `remote`	Advanced operations

🧠 Memory Management (4)

Tool	Function
`memory_search`	Search memories (FTS5 + vector semantic)
`memory_add`	Add memory (auto security scan)
`memory_replace`	Modify memory
`memory_remove`	Delete memory

📊 Sessions / Sub-agent (3)

Tool	Function
`session_list`	List session history
`session_read`	Read session content
`spawn_task`	Delegate sub-agent (isolated context + timeout)

🕐 System Tools (6)

Tool	Function
`datetime`	Get precise system time (ISO/Unix/date/time/full)
`calculator`	Safe math evaluation (+ - * / ** % (), recursive descent parser)
`random`	Random generation (int/float/pick/string)
`uuid`	Generate UUID v4 unique identifier
`json_format`	JSON format + validate + sort keys
`hash`	Cryptographic hash (MD5/SHA1/SHA256/SHA384/SHA512)

🏗️ Architecture

User message → workspace SOUL.md (never compressed) → AGENT.md → USER.md
              ↓
         Memory Retrieval (FTS5 + Vector Semantic Search) → Context Injection
              ↓
         Ollama API (Streaming Response)
              ↓
         Tool Registry (42 Built-in + MCP Dynamic)
              ↓
         Observation → Reflection → Loop / Final Answer

🧩 UI Components (Native DOM)

main.ts (Entry)
  ├── header.ts              # Top navigation bar
  ├── model-bar.ts           # Model selector
  ├── chat-area.ts           # Chat message area
  ├── input-area.ts          # Input box + file upload
  ├── workspace-panel.ts     # Terminal + file browser
  ├── settings-modal.ts      # Settings panel
  ├── history-modal.ts       # Session history
  ├── memory-modal.ts        # Memory management
  ├── tools-modal.ts         # Tool list
  ├── token-dashboard.ts     # Token consumption dashboard
  ├── tool-confirm-modal.ts  # Tool execution confirmation
  ├── prompt-modal.ts        # System prompt viewer
  ├── toast.ts               # Toast notifications
  └── lightbox.ts            # Image lightbox

🗄️ Database

SQLite (sql.js WASM), 6 tables, WAL mode + FTS5 full-text search:

Table	Purpose
`sessions`	Sessions (parent_id hierarchy)
`messages`	Messages (cascade delete)
`tool_calls`	Tool call records
`memories`	Agent memories (FTS5 + vector embedding)
`settings`	Settings (JSON serialization)
`traces`	ReAct execution traces

🔒 Security

Layer	Measure
📁 File System	`checkPathAllowed()` — path blacklist
⚡ Command Execution	`checkCommandAllowed()` — command blacklist + three modes
🖥️ Frontend Rendering	HTML sanitizer (whitelist tags + URI protocol check)
🔒 Electron	`contextIsolation: true` + IPC whitelist
🔐 Data Encryption	AES-256-GCM
🧠 Memory Security	Pre-write prompt injection / sensitive info detection
🌐 MCP Security	Shadowing protection

🚀 Quick Start

git clone https://gitee.com/thzxx/metona-ollama-desktop.git
cd metona-ollama-desktop
npm config set registry https://registry.npmmirror.com
npm install
npm start

📦 Build Windows Installer

# Environment: Ubuntu 24.04 + Node.js v22 + Wine 9.0+
ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/ npm run dist

Output: release/Metona Ollama Setup v0.11.11.exe

🛠️ Common Commands

npm start              # Build and run
npm run dev:renderer   # Vite watch (renderer)
npm run dev:main       # tsc watch (main process)
npm run build          # Full build
npm run dist           # Build Windows installer

💻 System Requirements

🖥️ Windows 10/11 (64-bit)
🤖 Ollama running locally (default http://localhost:11434)
💾 8GB+ RAM recommended

📄 License

MIT

_{Made with ❤️ by thzxx}

18 KiB Raw Blame History Unescape Escape