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:
thzxx
2026-04-20 20:52:55 +08:00
parent 3938cc8770
commit 6656f16d30
4 changed files with 25 additions and 11 deletions
+9 -7
View File
@@ -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 轮,可配置,无超时限制)
└───────────────────────────────────────────────────────────────────┘
流式响应 → 渲染到聊天区域(含工具调用卡片)→ 保存 → 自动提取记忆/技能