docs: 根据 v3.3.4 实际代码更新 README 和开发规范

- README.md: Agent Loop 说明补充去重机制
- README.md: 记忆类型表增加检索方式列(规则/偏好始终注入)
- README.md: 记忆工作流程更新(规则/偏好始终注入 + 事实关键词检索)
- README.md: web_fetch 补充默认返回完整内容说明
- docs/DEVELOPMENT.md: Tool Calling 流程补充去重机制
- docs/DEVELOPMENT.md: 联网搜索联动补充 web_fetch 不截断说明
This commit is contained in:
thzxx
2026-04-17 10:44:56 +08:00
parent 1771b1e326
commit 5fb36a93e6
2 changed files with 10 additions and 8 deletions
+8 -8
View File
@@ -36,7 +36,7 @@ AI 可以在对话中主动调用本地工具来完成任务,所有操作在
| 💻 `run_command` | 执行 Shell 命令(无超时,通过工作空间终端执行) | 自动/需确认/禁用 |
| 📦 `move_file` | 移动/重命名文件或目录 | 自动 |
| 📋 `copy_file` | 复制文件或目录 | 自动 |
| 🌐 `web_fetch` | 抓取网页内容(HTTP/HTTPS,自动提取文本) | 自动 |
| 🌐 `web_fetch` | 抓取网页内容(HTTP/HTTPS,自动提取文本,默认返回完整内容 | 自动 |
| 🔍 `web_search` | 联网搜索(DuckDuckGo/Bing,返回标题+链接+摘要) | 自动 |
| `append_file` | 追加内容到文件末尾 | 自动 |
| ✂️ `edit_file` | 查找替换文件中的文本(比重写整个文件高效) | 自动 |
@@ -49,7 +49,7 @@ AI 可以在对话中主动调用本地工具来完成任务,所有操作在
| 🔖 `git` | Git 操作(status/log/diff/add/commit/push/pull/branch/checkout/merge/stash 等 16 个子操作) | 自动 |
| 🗜️ `compress` | 创建/解压归档(zip/tar.gz | 自动 |
**Agent Loop**:用户请求 → 模型返回 tool_calls → 客户端执行 → 回传结果 → 循环直到无工具调用,支持流式 + 并行调用 + 最大 10 轮保护。
**Agent Loop**:用户请求 → 模型返回 tool_calls → 客户端执行 → 回传结果 → 循环直到无工具调用,支持流式 + 并行调用 + 最大 10 轮保护。自动检测并跳过重复工具调用(相同工具+参数),连续两轮完全相同则终止循环。
> ⚠️ 需要模型支持 Tool Calling(推荐 Qwen3、Llama 3.1+、Mistral
@@ -86,17 +86,17 @@ AI 可以在对话中主动调用本地工具来完成任务,所有操作在
AI 会自动从对话中学习并记住关键信息,跨会话持续积累,无需手动配置:
**记忆类型**
| 类型 | 说明 | 示例 |
|------|------|------|
| 📌 事实 | 关于用户的事实 | "用户正在开发一个 Electron 应用" |
| ⚙️ 偏好 | 用户的偏好习惯 | "喜欢用中文回答,代码风格简洁" |
| 📏 规则 | 应遵守的规则 | "项目中使用 TypeScript 严格模式" |
| 类型 | 说明 | 检索方式 | 示例 |
|------|------|----------|------|
| 📌 事实 | 关于用户的事实 | 关键词匹配 | "用户正在开发一个 Electron 应用" |
| ⚙️ 偏好 | 用户的偏好习惯 | 始终注入 | "喜欢用中文回答,代码风格简洁" |
| 📏 规则 | 应遵守的规则 | 始终注入 | "项目中使用 TypeScript 严格模式" |
**工作流程**
```
会话结束 → LLM 自动提取关键信息 → 去重检测 → 存入 IndexedDB
新消息发送 → 关键词+标签+重要性检索 → 注入 system prompt
新消息发送 → 规则/偏好始终注入 + 事实关键词检索 → 注入 system prompt
AI 基于记忆提供个性化回答
```
+2
View File
@@ -172,12 +172,14 @@ import {
- run_command 支持三模式:自动执行 / 需确认 / 禁用(通过工具面板下拉框切换)
- run_command:无超时(通过 workspace IPC 执行)
- 其他工具:30 秒超时
- **去重机制**:工具调用缓存(`toolResultCache`)+ 同轮内重复检测 + 跨轮次重复检测(连续两轮相同则终止)
### 5.3 联网搜索与网页抓取联动
- web_search 返回搜索结果(标题、URL、摘要),默认 15 条
- TOOL_USAGE_GUIDE 要求模型在 web_search 后必须选择相关 URL 调用 web_fetch 抓取详情
- 模型被引导主动使用工具:不确定答案、信息过时、需实时数据时应调用工具而非猜测
- web_fetch 默认返回完整内容(`max_chars=0`),不截断;仅用户显式指定 `max_chars` 时才截断
### 5.4 工作空间与 AI 集成