From 6656f16d302675d68572ce330ff8c9f6b942c68f Mon Sep 17 00:00:00 2001 From: thzxx Date: Mon, 20 Apr 2026 20:52:55 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=A0=B9=E6=8D=AE=E5=AE=9E=E9=99=85?= =?UTF-8?q?=E4=BB=A3=E7=A0=81=E6=9B=B4=E6=96=B0=20README.md=20=E5=92=8C=20?= =?UTF-8?q?docs=20=E6=96=87=E4=BB=B6?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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轮，移除所有超时限制 --- README.md | 16 +++++++++------- docs/BUILD.md | 8 ++++++++ docs/CHANGELOG.md | 4 ++++ docs/DEVELOPMENT.md | 8 ++++---- 4 files changed, 25 insertions(+), 11 deletions(-) diff --git a/README.md b/README.md index 3717d5a..9b0494e 100644 --- a/README.md +++ b/README.md @@ -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 轮，可配置，无超时限制） │ └───────────────────────────────────────────────────────────────────┘ ↓ 流式响应 → 渲染到聊天区域（含工具调用卡片）→ 保存 → 自动提取记忆/技能 diff --git a/docs/BUILD.md b/docs/BUILD.md index f925872..54f19d2 100644 --- a/docs/BUILD.md +++ b/docs/BUILD.md @@ -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 仓库 diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md index de670d0..55e1be9 100644 --- a/docs/CHANGELOG.md +++ b/docs/CHANGELOG.md @@ -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 — 第三方库替换 & 代码精简 & 联网日期修复 diff --git a/docs/DEVELOPMENT.md b/docs/DEVELOPMENT.md index 168543e..e70ff99 100644 --- a/docs/DEVELOPMENT.md +++ b/docs/DEVELOPMENT.md @@ -170,10 +170,10 @@ import { 用户消息 → Thought → Action(tool_calls) → Observation(result) → Reflection → 循环 → Final Answer ``` -- 最大循环次数：15 -- 全局超时：10 分钟 -- 工具执行超时：30 秒（run_command 除外，走 workspace 无超时） -- 流式调用超时：2 分钟 +- 最大循环次数：85（默认，可在设置中调整） +- 全局超时：无（用户控制生命周期） +- 工具执行超时：无（所有工具直接 await，无超时限制） +- 流式调用超时：无 - 自动重试：最多 2 次 - **去重机制**：工具调用缓存 + 同轮内重复检测 + 跨轮次重复检测