docs: 根据实际代码更新 README.md 和 docs 文件
README.md: - Agent Loop: 最大15轮→默认85轮(可配置),移除10分钟超时 - 架构图: tool-handlers 25→21 工具 - 工作空间: 新增工具Tab说明,3个页签 - 记忆系统: 新增容量上限500条 - Heartbeat: 补充默认1小时间隔 docs/BUILD.md: - 新增v5.1.6构建日志(含构建产物和踩坑记录) docs/CHANGELOG.md: - v5.1.6新增构建产物信息 docs/DEVELOPMENT.md: - Agent Loop: 最大15轮→85轮,移除所有超时限制
This commit is contained in:
@@ -33,7 +33,7 @@
|
||||
|
||||
### 🔧 Tool Calling — 38 个内置工具
|
||||
|
||||
AI 在对话中**主动调用**本地工具完成任务,所有操作在用户可视化监督下执行。采用 **ReAct Agent Loop**(Thought → Action → Observation → Reflection),最大 15 轮,10 分钟超时。
|
||||
AI 在对话中**主动调用**本地工具完成任务,所有操作在用户可视化监督下执行。采用 **ReAct Agent Loop**(Thought → Action → Observation → Reflection),默认最大 85 轮(可在设置中调整),无超时限制。
|
||||
|
||||
> ⚠️ 需要模型支持 Tool Calling(推荐 Qwen3、Llama 3.1+、Mistral)
|
||||
|
||||
@@ -126,6 +126,7 @@ AI 自动从对话中学习并记住关键信息,跨会话持续积累:
|
||||
- FTS5 全文搜索 + 向量语义搜索
|
||||
- AI 可通过 `memory_replace` 更新、`memory_remove` 删除已有记忆(子串匹配 + 唯一匹配约束)
|
||||
- 记忆写入前自动安全扫描(prompt injection / 敏感信息 / 不可见字符检测)
|
||||
- **容量上限 500 条**,超限时自动清理低价值条目(规则类型受保护)
|
||||
- 对话 ≥6 条消息后自动触发提取
|
||||
- SQLite 持久化,可视化管理面板
|
||||
|
||||
@@ -164,10 +165,11 @@ AI 自动从对话中学习并记住关键信息,跨会话持续积累:
|
||||
|
||||
### 🖥️ 工作空间
|
||||
|
||||
右侧常驻面板(480px),集成**终端**和**文件浏览器**:
|
||||
右侧常驻面板(480px),集成**终端**、**工具**和**文件浏览器**三个页签:
|
||||
|
||||
- **终端**:实时流式输出,支持 ANSI 颜色,无超时限制
|
||||
- **文件浏览器**:目录树展示,点击文件预览内容(带行号)
|
||||
- **💻 终端 Tab**:实时流式输出,支持 ANSI 颜色,无超时限制
|
||||
- **🔧 工具 Tab**:展示工具调用卡片及状态统计,AI 执行时自动切换
|
||||
- **📁 文件 Tab**:目录树展示,点击文件预览内容(带行号)
|
||||
- AI 工具命令自动在工作空间终端执行,用户可随时停止
|
||||
|
||||
---
|
||||
@@ -179,7 +181,7 @@ AI 自动从对话中学习并记住关键信息,跨会话持续积累:
|
||||
| 🧠 技能自动生成 | 从成功工具调用链提取可复用技能,渐进式加载(skill_list / skill_view),自动匹配复用 |
|
||||
| 👤 用户画像 | 自动检测技术栈(14 种),注入 system prompt |
|
||||
| 🎭 人格模式 | 多种预设模板,独立 system prompt + 温度设置 |
|
||||
| 💓 Heartbeat | 后台主动检查 Ollama 连接状态、磁盘空间等 |
|
||||
| 💓 Heartbeat | 后台主动检查 Ollama 连接状态、磁盘空间等(默认 1 小时间隔) |
|
||||
| ⏰ Cron 定时任务 | 一次性 / 周期性任务调度 |
|
||||
| 📦 数据导出 | Markdown / HTML / TXT / JSON 全量备份与恢复 |
|
||||
|
||||
@@ -202,7 +204,7 @@ AI 自动从对话中学习并记住关键信息,跨会话持续积累:
|
||||
│ ┌─────────────────────────────┴────────────────────────────────┐│
|
||||
│ │ 主进程 (Main) ││
|
||||
│ │ main.ts · ipc.ts · preload.ts · menu.ts · tray.ts ││
|
||||
│ │ tool-handlers.ts (25 工具) · tool-security.ts ││
|
||||
│ │ tool-handlers.ts (21 工具) · tool-security.ts ││
|
||||
│ │ workspace.ts · browser.ts (8 工具) · mcp-manager.ts ││
|
||||
│ │ db/sqlite.ts (sql.js WASM · WAL · FTS5) ││
|
||||
│ └──────────────────────────────────────────────────────────────┘│
|
||||
@@ -215,7 +217,7 @@ AI 自动从对话中学习并记住关键信息,跨会话持续积累:
|
||||
用户消息 → 注入记忆/技能上下文
|
||||
↓
|
||||
┌─ Thought → Action(tool_calls) → Observation(result) → Reflection ─┐
|
||||
│ 循环(最大 15 轮,10 分钟超时) │
|
||||
│ 循环(默认最大 85 轮,可配置,无超时限制) │
|
||||
└───────────────────────────────────────────────────────────────────┘
|
||||
↓
|
||||
流式响应 → 渲染到聊天区域(含工具调用卡片)→ 保存 → 自动提取记忆/技能
|
||||
|
||||
@@ -181,6 +181,14 @@ electron-builder 会自动处理所有依赖下载(Electron、NSIS、winCodeSi
|
||||
- 🔧 移除所有工具执行超时:tool-registry.ts 移除 25s/60s IPC 硬超时,browser.ts 移除 executeJsWithTimeout
|
||||
- 🔧 browser 工具状态检查:所有 browser 函数入口检查 isBrowserOpen(),关闭后返回明确错误
|
||||
- 📝 版本号更新至 5.1.6
|
||||
- ✅ `Metona Ollama Setup 5.1.6.exe`(81MB)
|
||||
- ✅ Gitee Release v5.1.6-desktop
|
||||
- ⚠️ 构建问题及处理:
|
||||
1. apt 源 `mirrors.cloud.aliyuncs.com` 不可达 → 切换 `archive.ubuntu.com`
|
||||
2. `restore-build-cache.sh` npmmirror NoSuchKey → 跳过,electron-builder 自动下载
|
||||
3. winCodeSign 从 GitHub 下载 EOF → 使用 ghfast.top 代理手动下载缓存
|
||||
4. NSIS 从 GitHub 下载 EOF → 使用 ghfast.top 代理手动下载缓存
|
||||
5. 无编译错误,手动缓存后构建一次通过
|
||||
|
||||
### v5.1.5(2026-04-20) — metona-ollama-desktop 仓库
|
||||
|
||||
|
||||
@@ -21,6 +21,10 @@
|
||||
- 浏览器关闭后返回明确错误 `"浏览器未打开,请先使用 browser_open 加载页面"`,不再自动重建空窗口
|
||||
- 避免 browser_close 后 AI 继续调用 evaluate 浪费循环
|
||||
- 📝 **版本号更新至 5.1.6**(7 个文件同步更新)
|
||||
- 📦 **构建产物**
|
||||
- `Metona Ollama Setup 5.1.6.exe`(81MB)
|
||||
- Gitee Release v5.1.6-desktop
|
||||
- apt 源切 archive.ubuntu.com,winCodeSign/NSIS 用 ghfast.top 代理手动缓存,无编译错误
|
||||
|
||||
### Desktop v5.1.5 — 第三方库替换 & 代码精简 & 联网日期修复
|
||||
|
||||
|
||||
+4
-4
@@ -170,10 +170,10 @@ import {
|
||||
用户消息 → Thought → Action(tool_calls) → Observation(result) → Reflection → 循环 → Final Answer
|
||||
```
|
||||
|
||||
- 最大循环次数:15
|
||||
- 全局超时:10 分钟
|
||||
- 工具执行超时:30 秒(run_command 除外,走 workspace 无超时)
|
||||
- 流式调用超时:2 分钟
|
||||
- 最大循环次数:85(默认,可在设置中调整)
|
||||
- 全局超时:无(用户控制生命周期)
|
||||
- 工具执行超时:无(所有工具直接 await,无超时限制)
|
||||
- 流式调用超时:无
|
||||
- 自动重试:最多 2 次
|
||||
- **去重机制**:工具调用缓存 + 同轮内重复检测 + 跨轮次重复检测
|
||||
|
||||
|
||||
Reference in New Issue
Block a user