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

v0.16.18: 网络超时 30s→900s + 流式超时动态计算修复 + 预存编译错误修复

Browse Source
This commit is contained in:
thzxx
2026-08-01 14:13:04 +08:00
parent 794f94ab89
commit e140e735de
10 changed files with 126 additions and 126 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+108 -108
View File
@@ -5,7 +5,7 @@
<h1 align="center">Metona Ollama Desktop</h1>
<p align="center">
<strong>🤖 本地 AI 桌面客户端 · Local AI Desktop Client</strong>
<strong>🤖 本地 AI 桌�客户�· Local AI Desktop Client</strong>
</p>
<p align="center">
@@ -14,7 +14,7 @@
</p>
<p align="center">
<img src="https://img.shields.io/badge/version-v0.16.17-E8734A?style=flat-square" alt="version">
<img src="https://img.shields.io/badge/version-v0.16.18-E8734A?style=flat-square" alt="version">
<img src="https://img.shields.io/badge/electron-33+-47848F?style=flat-square&logo=electron" alt="electron">
<img src="https://img.shields.io/badge/typescript-5.7+-3178C6?style=flat-square&logo=typescript" alt="typescript">
<img src="https://img.shields.io/badge/license-MIT-green?style=flat-square" alt="license">
@@ -22,65 +22,65 @@
</p>
<p align="center">
<em>所有 AI 推理在本地完成，数据不离开本机。</em><br>
<em>All AI inference runs locally — data never leaves your machine.</em>
<em>所�AI 推�在本地完�，数��离开本机�/em><br>
<em>All AI inference runs locally �data never leaves your machine.</em>
</p>
---
# 🇨🇳 中文
## ✨ 特性
## �特�
| | 功能 | 说明 |
|:---:|:---|:---|
| 🤖 | **ReAct Agent Loop** | 始终开启的唯一对话模式。8 状态机（INIT→THINKING→PARSING→EXECUTING→OBSERVING→REFLECTING→COMPRESSING→TERMINATED），最大 85 轮（可配置），智能重试（永久错误立即返回、瞬态错误指数退避），工具去重，智能路径依赖串行化，看门狗超时保护 |
| 🛡️ | **提示词加固** | 参考数据标记（<<<REFERENCE_DATA_START>>>）+ 工具结果仅为数据非指令的安全规则注入 |
| 📋 | **Plan Mode** | 开关切换，AI 首先生成执行计划（Markdown 渲染确认弹窗），批准后按步骤追踪执行，plan_track 工具标记完成状态，**支持断点续传**（中止后可恢复未完成计划） |
| 🔧 | **32 个内置工具** | 文件系统（13个） · 命令执行 · 联网搜索 · 浏览器控制（9个） · Git · 记忆 · 会话 · 子代理 · 系统工具 · Plan Mode 追踪 |
| 🧠 | **智能记忆系统** | 三类记忆（fact / preference / rule），存储于工作空间 MEMORY.md 文件，受路径保护仅 memory 工具可访问，写入前安全扫描，容量 500 条，对话结束自动提取，严格格式校验 |
| 📋 | **自定义文件** | SOUL.md（人格，不可压缩）+ AGENT.md（行为准则，内置 fallback）+ USER.md（用户画像，仅工作空间读取，不存在则不注入） |
| 🤖 | **ReAct Agent Loop** | 始终开�的唯一对�模�� 状�机（INIT→THINKING→PARSING→EXECUTING→OBSERVING→REFLECTING→COMPRESSING→TERMINATED），最�85 轮（��置），智能�试（永久错误立�返回�瞬�错误指数退�），工具去�，智能路径�赖串行化，看门狗超时��|
| 🛡�| **�示�加�* | �考数�标记（<<<REFERENCE_DATA_START>>>� 工具结果仅为数��指令的安全规则注入 |
| 📋 | **Plan Mode** | 开关切�，AI 首先生�执行计划（Markdown 渲染确认弹窗），批准�按步骤追踪执行，plan_track 工具标记完�状�，**支�断点续传**（中止����未完�计划�|
| 🔧 | **32 个内置工�* | 文件系统�3个） · 命令执行 · �网�索 · �览器控制（9个） · Git · 记忆 · 会� · �代�· 系统工具 · Plan Mode 追踪 |
| 🧠 | **智能记忆系统** | 三类记忆（fact / preference / rule），存储于工作空�MEMORY.md 文件，�路径�护�memory 工具�访问，写入�安全扫�，容� 500 �，对�结�自动��，严格格�校�|
| 📋 | **自定义文�* | SOUL.md（人格，��压缩� AGENT.md（行为准则，内置 fallback� USER.md（用户画�，仅工作空间读�，�存在则�注入） |
| � | **MCP �议扩展** | JSON-RPC 2.0 over stdio，动�工具�现，Shadowing 防护 |
| 🔍 | **联网搜索（双模式）** | SearXNG 元搜索引擎 JSON API（70+引擎聚合）/ 四引擎 HTML 解析（Bing+百度+搜狗+360），双模式可切换；web_fetch 支持反爬+UA切换+浏览器回退 |
| 🌏 | **浏览器控制** | 打开网页 · 截图 · 执行 JS · 提取内容 · 点击 · 输入 · 滚动 · 关闭 |
| 🖥️ | **工作空间面板** | 终端（增量流式输出）+ 文件浏览器，命令安全检查 |
| 🔢 | **上下文长度手动控制** | 设置面板下拉选择（128K / 256K / 512K / 1M），默认 128K，模型栏显示当前配置值，下拉框中显示每个模型自身的上下文长度 |
| 🗜️ | **智能上下文管理** | 滑动窗口 + Token 自动校准 + 消息重要性评分 + LLM 结构化 JSON 压缩，智能触发（120 条增量压缩 + 300 条硬上限） |
| ⏱️ | **智能超时保护** | Agent Loop 看门狗（可配，默认 30min）+ 流式总超时（可配，默认 300s）+ 工具 HTTP/MCP 超时可配 |
| 🪝 | **Hook 系统** | 4 阶段生命周期钩子（pre_tool / post_tool / post_iteration / pre_completion），内置安全检查、文件去重、自动计划追踪、变更审计、结果校验 |
| 👥 | **子代理委派** | spawn_task 工具，独立上下文 + 超时保护 |
| 📈 | **Token 仪表盘** | 全局 + 会话统计，消耗趋势柱状图，2 秒刷新，输入/输出分色 |
| 📋 | **系统提示词卡片** | 每条 AI 回复顶部折叠卡片，点击查看实际发送给模型的完整上下文 |
| 🎨 | **暖色调 UI** | 奶白 `#FAF7F2` + 珊瑚橙 `#E8734A`，长时间使用不疲劳，流式渲染优化 |
| � | **�网�索（�模��* | SearXNG 元�索引�JSON API�0+引擎��� 四引�HTML 解�（Bing+百度+�狗+360），�模��切�；web_fetch 支��爬+UA切�+�览器回退 |
| � | **�览器控�* | 打开网页 · 截图 · 执行 JS · ��内容 · 点击 · 输入 · 滚动 · 关闭 |
| 🖥�| **工作空间��** | 终端（增���输出）+ 文件�览器，命令安全检�|
| 🔢 | **上下文长度手动控�* | 设置��下拉选择�28K / 256K / 512K / 1M），默认 128K，模型�显示当��置值，下拉框中显示�个模型自身的上下文长度 |
| 🗜�| **智能上下文管�* | 滑动窗� + Token 自动校准 + 消���性评�+ LLM 结构�JSON 压缩，智能触�（120 �增�压�+ 300 �硬上��|
| �� | **智能超时�护** | Agent Loop 看门狗（��，默�30min� ��总超时（��，默�300s� 工具 HTTP/MCP 超时�� |
| � | **Hook 系统** | 4 阶段生命周期钩�（pre_tool / post_tool / post_iteration / pre_completion），内置安全检查�文件去��自动计划追踪��更审计�结果校�|
| 👥 | **�代�委�* | spawn_task 工具，独立上下文 + 超时�护 |
| 📈 | **Token 仪表�* | 全局 + 会�统计，消耗趋势柱状图� 秒刷新，输入/输出分色 |
| 📋 | **系统�示���* | �� AI 回�顶部折��片，点击查看实际��给模型的完整上下文 |
| 🎨 | **暖色�UI** | 奶白 `#FAF7F2` + �瑚�`#E8734A`，长时间使用�疲劳，��渲染优化 |
| 🔔 | **系统托盘** | 原生托盘集� |
| � | **AES-256-GCM** | 数�加密支� |
| 🧪 | **可观测性** | 执行轨迹缓冲批量写入 SQLite + Agent Metrics JSON/Prometheus 双格式导出 |
| 🧪 | **�观测�* | 执行轨迹缓冲批�写入 SQLite + Agent Metrics JSON/Prometheus �格�导�|
## 🔧 工具清�
<details>
<summary><strong>📁 文件系统（13 个）</strong></summary>
<summary><strong>� 文件系统�3 个）</strong></summary>
| 工具 | 功能 |
|------|------|
| `read_file` | 读取文件（文本/binary，2000行默认） |
| `read_file` | 读�文件（文�binary�000行默认） |
| `write_file` | 写入/追加文件（支�base64二进制） |
| `list_directory` | 列出目录内容 |
| `search_files` | 搜索文件（正则/通配符） |
| `search_files` | �索文件（正�通�符） |
| `create_directory` | 创建目录 |
| `delete_file` | 删除文件/目录（返回大�） |
| `move_file` | 移动/重命名文件 |
| `move_file` | 移动/�命�文�|
| `copy_file` | �制文件 |
| `edit_file` | 编辑文件（支�正则替�） |
| `tree` | 目录树结构（默认5层深度） |
| `download_file` | 下载文件 |
| `read_multiple_files` | 批量读取（50文件/10KB） |
| `read_multiple_files` | 批�读��0文件/10KB�|
| `compress` | 压缩文件/目录 |
</details>
<details>
<summary><strong>⚡ 命令执行（1 个）</strong></summary>
<summary><strong>�命令执行� 个）</strong></summary>
| 工具 | 功能 |
|------|------|
@@ -89,11 +89,11 @@
</details>
<details>
<summary><strong>🔍 联网搜索（2 个）</strong></summary>
<summary><strong>� �网�索� 个）</strong></summary>
| 工具 | 功能 |
|------|------|
| `web_search` | SearXNG JSON API / 四引擎并行，默认 30 条结果 |
| `web_search` | SearXNG JSON API / 四引擎并行，默认 30 �结�|
| `web_fetch` | 网页内容抓�，自动�试（指数退�），移动端UA切�，SPA页�自动�级到�览器渲染 |
</details>
@@ -111,27 +111,27 @@
| `browser_type` | 输入文本 |
| `browser_scroll` | 页�滚动 |
| `browser_wait` | 等待元素/延时 |
| `browser_close` | 关闭浏览器 |
| `browser_close` | 关闭�览�|
</details>
<details>
<summary><strong>📦 Git（1 个，17 个子命令）</strong></summary>
<summary><strong>📦 Git� 个，17 个�命令�/strong></summary>
| 子命令 | 功能 |
| �命�| 功能 |
|--------|------|
| `init` `clone` `add` `commit` `push` `pull` | 基础�作 |
| `diff` `log` `status` `branch` `checkout` | 查看与切换 |
| `diff` `log` `status` `branch` `checkout` | 查看与切�|
| `merge` `stash` `reset` `tag` `remote` | 高级�作 |
</details>
<details>
<summary><strong>🧠 记忆管理（1 个）</strong></summary>
<summary><strong>🧠 记忆管�� 个）</strong></summary>
| 工具 | 功能 |
|------|------|
| `memory` | 统一记忆管理（5 个 action：search 搜索 / add 添加 / replace 替换 / remove 删除 / read_all 读取全部）。工作空间 MEMORY.md 受路径保护，仅此工具可访问 |
| `memory` | 统一记忆管�� �action：search �索 / add 添加 / replace 替� / remove 删除 / read_all 读�全部）。工作空�MEMORY.md �路径�护，仅此工具�访�|
</details>
@@ -142,21 +142,21 @@
|------|------|
| `session_list` | 列出历�会� |
| `session_read` | 读�会�内容 |
| `spawn_task` | 委派子代理（独立上下文 + 超时保护） |
| `spawn_task` | 委派�代�（独立上下�+ 超时�护�|
</details>
<details>
<summary><strong>🕐 系统工具（1 个）</strong></summary>
<summary><strong>� 系统工具� 个）</strong></summary>
| 工具 | 功能 |
|------|------|
| `calculator` | 安全数学计算（+ - * / ** % ()，递归下降解析器） |
| `calculator` | 安全数学计算� - * / ** % ()，递归下�解�器） |
</details>
<details>
<summary><strong>📋 Plan Mode（1 个，仅 Plan 模式激活）</strong></summary>
<summary><strong>📋 Plan Mode� 个，�Plan 模�激活）</strong></summary>
| 工具 | 功能 |
|------|------|
@@ -164,51 +164,51 @@
</details>
## 🏗️ 架构
## ��架构
```
用户消息 → 扫描工作空间 SOUL.md（不可压缩层）→ AGENT.md → USER.md（工作空间，不存在则跳过）
↓
记忆检索 (MEMORY.md 关键词搜索) → 上下文注入
↓
Agent Engine (8 状态机 ReAct Loop, ≤85 轮, 智能重试, 路径依赖串行化, 看门狗+分级超时)
↓
提示词加固（参考数据标记 + 工具结果安全规则）
↓
用户消� �扫�工作空间 SOUL.md（��压缩层）→ AGENT.md �USER.md（工作空间，�存在则跳过�
�
记忆检�(MEMORY.md 关键��� �上下文注�
�
Agent Engine (8 状�机 ReAct Loop, �5 � 智能�试, 路径�赖串行� 看门�分级超时)
�
�示�加固（�考数�标�+ 工具结果安全规则�
�
Ollama API (���应，num_ctx 用户�� 128K/256K/512K/1M)
↓
Tool Registry (32 内置 + MCP 动态 + Plan Mode plan_track)
↓
Hook 系统 (pre/post tool/iteration/completion) → 观察结果 → 反思 → 循环 / 最终回答
�
Tool Registry (32 内置 + MCP 动�+ Plan Mode plan_track)
�
Hook 系统 (pre/post tool/iteration/completion) �观察结果 ����循环 / 最终回�
```
### 🧩 UI 组件（原生 DOM）
### 🧩 UI 组件（原�DOM�
```
main.ts (入�)
├── header.ts # 顶部导航栏
├── model-bar.ts # 模型选择栏
├── header.ts # 顶部导航�
├── model-bar.ts # 模型选择�
├── chat-area.ts # �天消�区域
├── input-area.ts # 输入框 + 文件上传 + Plan Mode 开关
├── workspace-panel.ts # 终端 + 文件浏览器 + 工具卡片
├── input-area.ts # 输入�+ 文件上传 + Plan Mode 开�
├── 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 # 系统提示词查看 + Plan 确认弹窗
├── prompt-modal.ts # 系统�示�查�+ Plan 确认弹窗
├── toast.ts # Toast 通知
└── lightbox.ts # 图片�箱
```
### 🗄️ 数据库
### 🗄�数��
SQLite (sql.js WASM)，5 张表，WAL 模式：
SQLite (sql.js WASM)� 张表，WAL 模��
| 表 | 用途 |
| �| 用�|
|---|---|
| `sessions` | 会话（parent_id 父子关系） |
| `sessions` | 会�（parent_id 父�关系�|
| `messages` | 消�（外键级�删除） |
| `tool_calls` | 工具调用记录 |
| `settings` | 设置（JSON �列化） |
@@ -218,17 +218,17 @@ SQLite (sql.js WASM)，5 张表，WAL 模式：
| 层级 | 措施 |
|------|------|
| 📁 文件系统 | `checkPathAllowed()` — 路径黑名单（33 个系统/敏感目录，含 Linux + Windows） |
| ⚡ 命令执行 | `checkCommandAllowed()` — 命令黑名单（30 条危险命令，含 POSIX + Windows）+ 三种模式 |
| 🖥️ 前端渲染 | HTML 净化器（白名单标签 + URI 协议检查） |
| 🔒 Electron | `contextIsolation: true` + IPC 白名单 + IPC fs 路径验证 |
| � 文件系统 | `checkPathAllowed()` �路径黑��（33 个系��感目录，� Linux + Windows�|
| �命令执行 | `checkCommandAllowed()` �命令黑��（30 ��险命令，�POSIX + Windows� 三�模� |
| 🖥��端渲染 | HTML 净化器（白��标签 + URI �议检查） |
| 🔒 Electron | `contextIsolation: true` + IPC 白��+ IPC fs 路径验� |
| � 数�加密 | AES-256-GCM |
| 🧠 记忆安全 | 写入前 Prompt Injection / 敏感信息检测，多层级去重过滤 |
| 🌐 MCP 安全 | Shadowing 防护 + 双下划线分隔防歧义 |
| 🌐 网络安全 | `web_fetch` 流式体积限制（10MB）+ 无 content-length 时防 OOM |
| ⚡ 进程安全 | Windows `taskkill` 强制终止 + 工作空间路径大小写不敏感校验 |
| 🧠 记忆安全 | 写入�Prompt Injection / �感信�检测，多层级去�过�|
| � MCP 安全 | Shadowing 防护 + �下划线分隔防歧�|
| � 网络安全 | `web_fetch` ��体积�制�0MB� �content-length 时防 OOM |
| �进程安全 | Windows `taskkill` 强制终止 + 工作空间路径大�写��感校验 |
## 🚀 快速开始
## 🚀 快速开�
```bash
git clone https://gitee.com/thzxx/metona-ollama-desktop.git
@@ -238,32 +238,32 @@ npm install
npm start
```
## 📦 构建 Windows 安装包
## 📦 构建 Windows 安装�
```bash
# 环境：Ubuntu 24.04 + Node.js v22 + Wine 9.0+
ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/ npm run dist
```
产出：`release/Metona Ollama Setup v0.16.17.exe`
产出：`release/Metona Ollama Setup v0.16.18.exe`
## 🛠️ 常用命令
## 🛠�常用命令
```bash
npm start # 构建并运行
npm start # 构建并��
npm run dev:renderer # Vite watch（渲染进程）
npm run dev:main # tsc watch（主进程）
npm run dev:main # tsc watch（主进程�
npm run build # 完整构建
npm run dist # 构建 Windows 安装包
npm run dist # 构建 Windows 安装�
```
## 💻 系统�求
- 🖥️ Windows 10/11（64 位）
- 🤖 Ollama 本地运行中（默认 `http://localhost:11434`）
- 🖥�Windows 10/11�4 �）
- 🤖 Ollama 本地�行中（默认 `http://localhost:11434`�
- 💾 建议 8GB+ 内存
## 📄 许可证
## 📄 许��
[MIT](LICENSE)
@@ -271,27 +271,27 @@ npm run dist # 构建 Windows 安装包
# 🇬🇧 English
## ✨ Features
## �Features
| | Feature | Description |
|:---:|:---|:---|
| 🤖 | **ReAct Agent Loop** | Always-on, only chat mode. 8-state machine, up to 85 iterations (configurable), smart retry (permanent errors return immediately, transient errors use exponential backoff), tool dedup, path-aware dependency serialization, watchdog + tiered timeout protection |
| 🛡️ | **Prompt Hardening** | Reference data markers (<<<REFERENCE_DATA_START>>>) + tool results are data-not-instructions safety rules |
| 🛡�| **Prompt Hardening** | Reference data markers (<<<REFERENCE_DATA_START>>>) + tool results are data-not-instructions safety rules |
| 📋 | **Plan Mode** | Toggle switch. AI first generates an execution plan (Markdown-rendered confirmation dialog), then tracks step-by-step execution, **supports resume** (interrupted plans restore on next session) |
| 🔧 | **32 Built-in Tools** | File system · Command · Web search · Browser · Git · Memory · Sessions · Sub-agent · System · Plan Mode tracking |
| 🧠 | **Smart Memory System** | Three types (fact / preference / rule), stored in workspace MEMORY.md file, path-protected — only the memory tool can access it, pre-write security scan, 500 capacity, auto-extract on conversation end, strict format validation |
| 🧠 | **Smart Memory System** | Three types (fact / preference / rule), stored in workspace MEMORY.md file, path-protected �only the memory tool can access it, pre-write security scan, 500 capacity, auto-extract on conversation end, strict format validation |
| 📋 | **Custom Files** | SOUL.md (persona, never compressed) + AGENT.md (behavior rules, built-in fallback) + USER.md (user profile, workspace only, skipped if absent) |
| � | **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 (incremental streaming) + file browser, command security checks |
| 🖥�| **Workspace Panel** | Terminal (incremental streaming) + file browser, command security checks |
| 🔢 | **Manual Context Length** | Settings dropdown (128K / 256K / 512K / 1M), default 128K. Model bar shows configured value, dropdown shows per-model context length |
| 🗜️ | **Smart Context Manager** | Sliding window + Token auto-calibration + message importance scoring + LLM structured JSON compression, smart triggers (120 msg incremental + 300 msg hard limit) |
| 🗜�| **Smart Context Manager** | Sliding window + Token auto-calibration + message importance scoring + LLM structured JSON compression, smart triggers (120 msg incremental + 300 msg hard limit) |
| �� | **Smart Timeout Protection** | Agent Loop watchdog (configurable, default 30min) + stream total timeout (configurable, default 300s) + configurable HTTP/MCP timeouts |
| � | **Hook System** | 4-phase lifecycle hooks (pre_tool / post_tool / post_iteration / pre_completion), built-in security check, file dedup, auto plan tracking, change audit, result validation |
| 👥 | **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 |
| 📋 | **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, streaming render optimized |
| 🔔 | **System Tray** | Native tray integration |
| � | **AES-256-GCM** | Data encryption support |
@@ -321,7 +321,7 @@ npm run dist # 构建 Windows 安装包
</details>
<details>
<summary><strong>⚡ Command Execution (1)</strong></summary>
<summary><strong>âš?Command Execution (1)</strong></summary>
| Tool | Function |
|------|------|
@@ -404,22 +404,22 @@ npm run dist # 构建 Windows 安装包
</details>
## 🏗️ Architecture
## ��Architecture
```
User message → workspace SOUL.md (never compressed) → AGENT.md → USER.md (workspace, skipped if absent)
↓
Memory Retrieval (MEMORY.md keyword search) → Context Injection
↓
Agent Engine (8-state ReAct Loop, ≤85 iter, smart retry, path-aware serialization, watchdog+tiered timeout)
↓
User message �workspace SOUL.md (never compressed) �AGENT.md �USER.md (workspace, skipped if absent)
�
Memory Retrieval (MEMORY.md keyword search) �Context Injection
�
Agent Engine (8-state ReAct Loop, �5 iter, smart retry, path-aware serialization, watchdog+tiered timeout)
�
Prompt Hardening (reference data markers + tool result safety rules)
↓
�
Ollama API (Streaming Response, num_ctx user-configurable 128K/256K/512K/1M)
↓
�
Tool Registry (32 Built-in + MCP Dynamic + Plan Mode plan_track)
↓
Hook System (pre/post tool/iteration/completion) → Observation → Reflection → Loop / Final Answer
�
Hook System (pre/post tool/iteration/completion) �Observation �Reflection �Loop / Final Answer
```
### 🧩 UI Components (Native DOM)
@@ -442,7 +442,7 @@ main.ts (Entry)
└── lightbox.ts # Image lightbox
```
### 🗄️ Database
### 🗄�Database
SQLite (sql.js WASM), 5 tables, WAL mode:
@@ -458,15 +458,15 @@ SQLite (sql.js WASM), 5 tables, WAL mode:
| Layer | Measure |
|------|------|
| 📁 File System | `checkPathAllowed()` — path blacklist (33 system/sensitive dirs, Linux + Windows) |
| ⚡ Command Execution | `checkCommandAllowed()` — command blacklist (30 dangerous commands, POSIX + Windows) + three modes |
| 🖥️ Frontend Rendering | HTML sanitizer (whitelist tags + URI protocol check) |
| � File System | `checkPathAllowed()` �path blacklist (33 system/sensitive dirs, Linux + Windows) |
| �Command Execution | `checkCommandAllowed()` �command blacklist (30 dangerous commands, POSIX + Windows) + three modes |
| 🖥�Frontend Rendering | HTML sanitizer (whitelist tags + URI protocol check) |
| 🔒 Electron | `contextIsolation: true` + IPC whitelist + IPC fs path validation |
| � Data Encryption | AES-256-GCM |
| 🧠 Memory Security | Pre-write prompt injection / sensitive info detection, multi-layer dedup filtering |
| � MCP Security | Shadowing protection + double-underscore delimiter disambiguation |
| � Network Security | `web_fetch` streaming size limit (10MB) + OOM prevention without content-length |
| ⚡ Process Security | Windows `taskkill` forced termination + case-insensitive workspace path validation |
| âš?Process Security | Windows `taskkill` forced termination + case-insensitive workspace path validation |
## 🚀 Quick Start
@@ -485,9 +485,9 @@ npm start
ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/ npm run dist
```
Output: `release/Metona Ollama Setup v0.16.17.exe`
Output: `release/Metona Ollama Setup v0.16.18.exe`
## 🛠️ Common Commands
## 🛠�Common Commands
```bash
npm start # Build and run
@@ -499,7 +499,7 @@ npm run dist # Build Windows installer
## 💻 System Requirements
- 🖥️ Windows 10/11 (64-bit)
- 🖥�Windows 10/11 (64-bit)
- 🤖 Ollama running locally (default `http://localhost:11434`)
- 💾 8GB+ RAM recommended
package-lock.json
Generated
+2 -2
View File
@@ -1,12 +1,12 @@
{
"name": "metona-ollama-desktop",
"version": "0.16.17",
"version": "0.16.18",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "metona-ollama-desktop",
"version": "0.16.17",
"version": "0.16.18",
"license": "MIT",
"dependencies": {
"ffmpeg-static": "^5.2.0",
package.json
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "metona-ollama-desktop",
"version": "0.16.17",
"version": "0.16.18",
"description": "Metona Ollama - TypeScript + Electron 桌面 AI 聊天客户端",
"main": "dist/main/main.js",
"author": "thzxx",
src/main/menu.ts
+1 -1
View File
@@ -101,7 +101,7 @@ export function createMenu(): void {
dialog.showMessageBox(mainWindow!, {
type: 'info',
title: '关于 Metona Ollama',
message: 'Metona Ollama Desktop v0.16.17',
message: 'Metona Ollama Desktop v0.16.18',
detail: 'TypeScript + Electron Ollama AI 聊天客户端\n\nhttps://gitee.com/thzxx/metona-ollama',
icon: getIconPath()
});
src/main/tool-handlers-system.ts
+3 -3
View File
@@ -124,8 +124,8 @@ export function killToolProcess(): boolean {
/** HTTP 请求超时（毫秒），默认 30s，可通过 IPC 设置 */
let HTTP_TIMEOUT = 30_000;
/** HTTP 请求超时（毫秒），默认 900s，可通过 IPC 设置 */
let HTTP_TIMEOUT = 900_000;
/** 设置 HTTP 请求超时（毫秒），0=禁用超时 */
export function setHTTPTimeout(ms: number): void {
@@ -576,7 +576,7 @@ export async function handleWebFetch(params: { url: string; max_chars?: number;
} catch (err) {
const errMsg = (err as Error).message;
if (errMsg.includes('abort') && attempt < maxAttempts - 1) {
lastError = `请求超时 (${HTTP_TIMEOUT > 0 ? HTTP_TIMEOUT / 1000 : '∞'}s)（将重试）`;
lastError = `请求超时 (${HTTP_TIMEOUT > 0 ? HTTP_TIMEOUT / 1000 : '∞'}s)（将重试）`; // 900s 默认，大页面/慢服务器需要更长时间
continue;
}
if (errMsg.includes('abort')) {
src/renderer/components/metrics-dashboard.ts
+1 -1
View File
@@ -129,7 +129,7 @@ function renderMetricsDashboard(): void {
suggestionsEl.innerHTML = suggestions.map(s => `
<div class="md-suggestion">
<span class="md-suggestion-severity md-severity-${s.severity}">${s.severity}</span>
<span class="md-suggestion-msg">${s.message}</span>
<span class="md-suggestion-msg">${s.suggestion}</span>
</div>
`).join('');
}
src/renderer/components/settings-modal.ts
+4 -4
View File
@@ -106,22 +106,22 @@ export function initSettingsModal(): void {
const saveHttpTimeout = debounce(async () => {
const db = state.get<ChatDB | null>(KEYS.DB);
const sec = parseSec(inputHttpTimeout.value.trim());
const ms = sec >= 0 ? sec * 1000 : 30_000;
const ms = sec >= 0 ? sec * 1000 : 900_000;
if (db) await db.saveSetting('httpTimeout', sec);
const bridge = window.metonaDesktop;
if (bridge?.tool?.setTimeouts) {
await bridge.tool.setTimeouts({ http: ms });
}
logSetting('HTTP 超时', sec >= 0 ? (sec === 0 ? '已禁用' : `${sec}s`) : '默认(30s)');
logSetting('HTTP 超时', sec >= 0 ? (sec === 0 ? '已禁用' : `${sec}s`) : '默认(900s)');
}, 500);
const saveStreamTimeout = debounce(async () => {
const db = state.get<ChatDB | null>(KEYS.DB);
const sec = parseSec(inputStreamTimeout.value.trim());
const ms = sec >= 0 ? sec * 1000 : 300_000;
const ms = sec >= 0 ? sec * 1000 : -1;
state.set('streamTimeout', ms);
if (db) await db.saveSetting('streamTimeout', sec);
logSetting('流式超时', sec >= 0 ? (sec === 0 ? '已禁用' : `${sec}s`) : '默认(300s)');
logSetting('流式超时', sec >= 0 ? (sec === 0 ? '已禁用' : `${sec}s`) : '默认(动态)');
}, 500);
const saveMCPTimeout = debounce(async () => {
src/renderer/index.html
+2 -2
View File
@@ -28,7 +28,7 @@
<div class="header-left">
<img class="logo" src="./assets/icons/llama.png" alt="logo" />
<span class="app-title">Metona Ollama</span>
<span class="app-version">v0.16.17</span>
<span class="app-version">v0.16.18</span>
<button class="icon-btn help-btn" id="btnHelp" title="使用帮助">
<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
<circle cx="12" cy="12" r="10"/><path d="M9.09 9a3 3 0 0 1 5.83 1c0 2-3 3-3 3"/>
@@ -344,7 +344,7 @@
<div style="display:grid;grid-template-columns:1fr 1fr;gap:10px;">
<div>
<label style="font-size:12px;color:var(--text-secondary);" for="inputHttpTimeout">🌐 HTTP 请求超时（秒）</label>
<input class="setting-input" id="inputHttpTimeout" type="number" min="0" step="5" placeholder="30" style="margin-bottom:0;">
<input class="setting-input" id="inputHttpTimeout" type="number" min="0" step="5" placeholder="900" style="margin-bottom:0;">
<p class="text-muted" style="font-size:10px;">web_search / web_fetch 等 HTTP 请求的超时</p>
</div>
<div>
src/renderer/main.ts
+3 -3
View File
@@ -459,13 +459,13 @@ async function init(): Promise<void> {
}
// 应用流式超时到 state（agent-engine 读取，0=禁用）
state.set('streamTimeout', streamTimeout >= 0 ? streamTimeout * 1000 : 300_000);
state.set('streamTimeout', streamTimeout >= 0 ? streamTimeout * 1000 : -1);
// 应用 HTTP 和 MCP 超时到主进程
const bridge = window.metonaDesktop;
if (bridge?.tool?.setTimeouts) {
await bridge.tool.setTimeouts({
http: httpTimeout >= 0 ? httpTimeout * 1000 : 30_000,
http: httpTimeout >= 0 ? httpTimeout * 1000 : 900_000,
mcp: mcpTimeout >= 0 ? mcpTimeout * 1000 : 60_000,
});
}
@@ -474,7 +474,7 @@ async function init(): Promise<void> {
(document.querySelector('#inputHttpTimeout') as HTMLInputElement).value = httpTimeout >= 0 ? String(httpTimeout) : '';
(document.querySelector('#inputStreamTimeout') as HTMLInputElement).value = streamTimeout >= 0 ? String(streamTimeout) : '';
(document.querySelector('#inputMCPTimeout') as HTMLInputElement).value = mcpTimeout >= 0 ? String(mcpTimeout) : '';
logInit(`超时设置: HTTP=${httpTimeout>=0?httpTimeout:30}s 流式=${streamTimeout>=0?streamTimeout:300}s MCP=${mcpTimeout>=0?mcpTimeout:60}s`);
logInit(`超时设置: HTTP=${httpTimeout>=0?httpTimeout:900}s 流式=${streamTimeout>=0?streamTimeout:'动态'}s MCP=${mcpTimeout>=0?mcpTimeout:60}s`);
// ── 子代理参数 ──
let subAgentMaxLoops = await db.getSetting<number>('subAgentMaxLoops', 10);
src/renderer/services/sub-agent.ts
+1 -1
View File
@@ -215,7 +215,7 @@ export async function executeSubAgent(
if (chunk.message?.content) content += chunk.message.content;
if (chunk.message?.tool_calls?.length) {
for (const tc of chunk.message.tool_calls) {
if (tc.function?.name && SUB_AGENT_TOOL_WHITELIST.has(tc.function.name)) {
if (tc.function?.name && toolWhitelist.has(tc.function.name)) {
toolCalls.push({ name: tc.function.name, arguments: tc.function.arguments || {} });
}
}