mirror of
https://gitcode.com/JianFeeeee/HomeAgent.git
synced 2026-09-21 17:38:10 +00:00
74 lines
2.2 KiB
Markdown
74 lines
2.2 KiB
Markdown
# memo 插件讲解
|
||
|
||
备忘插件，支持创建、完成、列出备忘，自动提醒未完成事项。
|
||
|
||
## 工具清单
|
||
|
||
| 工具 | 功能 | 源码 |
|
||
|------|------|------|
|
||
| `memo_create` | 创建一条备忘 | `handleCreate` |
|
||
| `memo_complete` | 标记备忘为已完成 | `handleComplete` |
|
||
| `memo_list` | 列出所有未完成备忘 | `handleList` |
|
||
|
||
## 核心设计
|
||
|
||
### 数据持久化
|
||
|
||
备忘存储在 JSON 文件中，路径由核心配置 `core.daemon.data_dir` 决定：
|
||
|
||
```go
|
||
// plugin.go:Start
|
||
dataDirVal, _ := s.Settings().GetCore("core.daemon.data_dir")
|
||
p.filePath = filepath.Join(fmt.Sprint(dataDirVal), "memos.json")
|
||
p.load()
|
||
```
|
||
|
||
`load()` 和 `save()` 实现 JSON 文件的读写，格式为 `{memos: [...], next_id: N}`。每次写操作后自动 `save()`，Stop 时也执行一次。
|
||
|
||
### PreAction 注入提醒
|
||
|
||
注册 `pre_action` 阶段钩子，在每次 LLM 调用前注入未完成备忘数量：
|
||
|
||
```go
|
||
// plugin.go:stagePreAction
|
||
n := p.pendingCount()
|
||
if n == 0 { return nil }
|
||
ctx.ContextMsgs = append(ctx.ContextMsgs, map[string]interface{}{
|
||
"role": "system",
|
||
"content": fmt.Sprintf("目前有%d条备忘未完成，调用%slist工具读取具体内容", n, p.tp),
|
||
})
|
||
```
|
||
|
||
这样每次 LLM 处理消息时都感知到未完成备忘，无需主动查询。
|
||
|
||
### 定时打断提醒
|
||
|
||
每 5 分钟检查未完成备忘，如果有则通过中断通道提醒：
|
||
|
||
```go
|
||
// plugin.go:periodicCheck
|
||
ticker := time.NewTicker(5 * time.Minute)
|
||
for {
|
||
select {
|
||
case <-p.stopCh: return
|
||
case <-ticker.C:
|
||
n := p.pendingCount()
|
||
if n == 0 { continue }
|
||
p.sdk.InjectInterruptText(p.name, p.name,
|
||
fmt.Sprintf("注意，你还有%d条备忘未标记完成，请检查", n))
|
||
}
|
||
}
|
||
```
|
||
|
||
中断消息会打断当前 LLM 处理，在下一轮工具循环前插入 `[打断消息]`，确保 agent 不会长期忽略未完成备忘。
|
||
|
||
### 工具返回值
|
||
|
||
所有工具返回 `{content: string}` 或 `{isError: true, content: string}` 格式，LLM 通过 content 字段获取结果文本。
|
||
|
||
## 注意事项
|
||
|
||
- `memo_create` 的 content 参数应包含事项的完整描述，方便后续回顾
|
||
- `memo_complete` 只标记为 done，不删除数据，保留历史
|
||
- 更早的暂停时自动 save，防丢数据
|