fuyao-agent-recalllisted
Install: claude install-skill ZLHAOOO/fuyao-agent-recall
# Fuyao Agent Recall Engine
零成本本地联想引擎,让 AI 在对话中自动"灵光一现"记起相关记忆。
## 核心理念
**不是"用户让我搜",而是"我自动知道"。**
这个工具的价值不在于精准搜索,而在于**在对的时刻给模型一个浅层提醒**:"你的记忆库里可能有相关的信息"。就像人聊天时听到某个关键词后脑中自然浮现相关记忆——这个"浮现"是自动的,不需要主动发起。
## 安装
```bash
bash install.sh
```
- **pi 环境**:自动安装为 extension,重启后每轮无条件运行
- **OpenClaw**:检测 `~/.openclaw/workspace/` 目录结构
- **Hermes / Claude Code / Cursor**:检测当前工作目录的 `AGENTS.md` + `memory/`
- **其他 agent**:以 skill 模式运行,遵循下方触发规则
## 触发规则
### 每轮都运行(除了以下例外)
**例外情况(不需要运行):**
- 简单打招呼:你好 / hello / hi / 嗨
- 短回应:好 / 嗯 / ok / okk / 收到 / 继续 / 谢谢 / 不客气
- 纯闲聊 / 情绪表达:今天好累 / 随便聊聊 / 无聊 / 好玩
- 少于 4 个字符的任何输入
**其他所有对话都需要运行:**
- 提问("怎么写 X""为什么 X""X 是什么")
- 讨论 / 分析("帮我分析一下""对比一下")
- 创作("写一篇""帮我写")
- 决策("要不要""该不该""选哪个")
- 调研 / 搜索("查一下""搜一下")
- 执行任务("帮我做""执行""运行")
- 技术问题(代码、配置、架构)
- 项目相关(进度、计划、问题)
### 运行方式
```bash
recall q "用户的完整问题"
```
如果命中,模型会看到"标题 + 一句话摘要 + 标签"。基于摘要判断:
- **摘要已足够** → 直接回答,不需要读文件
- **需要细节** → `grep -n "关键词" 文件路径` 定向搜索
- **不相关** → 忽略,正常回答
## 约束
1. 禁止直接 `read` 整篇文件,先用 `grep -n` 定向搜索
2. 命中 ≥2 个关键词才读取,只读命中行附近 ±5 行
3. 摘要已包含关键信息时,不要再读文件
4. 不相关直接忽略,不要强行关联
5. 命中 0 条时完全沉默,不输出任何提示
## 数据位置
- 索引文件:`memory/.recall-index.json`(在检测到的 Agent 目录下)
- 自动检测:pi / OpenClaw / Hermes / Claude Code / Cursor 的目录结构
- 索引自愈:检测到新文件自动重建
- 手动重建:`recall build`
## 技术
- **算法**:BM25(k1=1.5, b=0.75)
- **延迟**:<100ms
- **成本**:零 API 调用
- **字段权重**:title×3 / tag×2 / body×1
- **注入上限**:5 条 / 300 字符
## 文件结构
```
fuyao-agent-recall/
├── SKILL.md # 本文件
├── bin/recall # BM25 匹配引擎
├── extensio