From 419938c667a1adb97ee5a32eeb3480c3025cfb55 Mon Sep 17 00:00:00 2001 From: thzxx Date: Sun, 19 Apr 2026 20:50:44 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20README=20=E6=96=B0=E5=A2=9E=E6=8E=A8?= =?UTF-8?q?=E8=8D=90=E8=A7=84=E5=88=99=E8=AE=B0=E5=BF=86=E5=8C=BA=E5=9F=9F?= =?UTF-8?q?=EF=BC=8812=20=E6=9D=A1=20Agent=20=E8=A1=8C=E4=B8=BA=E7=BA=A6?= =?UTF-8?q?=E6=9D=9F=E8=A7=84=E5=88=99=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 30 ++++++++++++++++++++++++++++++ 1 file changed, 30 insertions(+) diff --git a/README.md b/README.md index 7e2be3e..8b2bec6 100644 --- a/README.md +++ b/README.md @@ -131,6 +131,36 @@ AI 自动从对话中学习并记住关键信息，跨会话持续积累： --- +### 📏 推荐规则记忆 + +通过 `memory_add` 工具添加以下规则，可显著约束 Agent 行为、减少无效操作： + +> 规则类型（`rule`）在注入时标记为「必须无条件执行」，始终生效，不依赖关键词匹配。 + +#### 行为约束 + +| # | 规则 | 解决的问题 | +|---|------|-----------| +| 1 | **禁止重复调用** — 同一工具+参数连续失败 2 次后必须换策略，禁止第 3 次尝试 | 工具失败后死循环重试 | +| 2 | **搜索结果即答案** — `web_search` 返回的 snippet 已含关键摘要，能回答就直接回答，不要无意义追加 `web_fetch` | 过度抓取浪费 token | +| 3 | **禁止编造 URL** — 所有 URL 必须从搜索结果或文件中获取，禁止猜测、拼接、编造任何 URL 路径 | Agent 幻觉出不存在的链接 | +| 4 | **禁止抓取 SPA 页面** — GitHub releases、npm 等 SPA 网站内容无法被简单 fetch，从搜索 snippet 提取信息 | 反复抓取空壳页面 | +| 5 | **搜索查询必须进化** — 第一次结果不理想时，第二次必须换关键词/角度/表述，禁止重复相同查询 | 搜索死循环 | +| 6 | **工具调用前先想清楚** — 确认：(a) 工具能完成目标？(b) 参数正确？(c) 有更高效的方式？ | 盲目试错 | +| 7 | **命令结果要解读** — `run_command` 完成后必须分析输出并向用户解释，不要只贴原始输出 | 无意义的结果回显 | +| 8 | **文件操作先读后写** — 修改文件前必须先 `read_file` 确认当前内容，禁止凭记忆写入 | 覆盖用户已修改的文件 | +| 9 | **错误信息是线索** — 工具返回错误时仔细阅读并据此调整策略，忽略错误重复相同操作是最差行为 | 忽视错误继续撞墙 | +| 10 | **适时停止** — 任务已完成时立即停止，不要为了展示能力追加不必要的操作 | 过度操作 | + +#### 信息获取 + +| # | 规则 | 解决的问题 | +|---|------|-----------| +| 11 | **始终使用中文回复** — 所有回复使用中文（技术术语可保留英文原名），除非用户明确使用其他语言 | 中英混杂体验差 | +| 12 | **优先官方来源** — 技术信息优先从官方文档 / GitHub 仓库 / 官方 API 获取，其次 Stack Overflow / MDN，避免引用未交叉验证的个人博客 | 信息准确性不足 | + +--- + ### 🖥️ 工作空间 右侧常驻面板（480px），集成**终端**和**文件浏览器**：