| name | amemo-find-memo |
| description | 当用户说「查看/查找/搜索 + 我的 + 笔记/备忘」时调用,按关键词模糊搜索并返回匹配的笔记列表。 |
amemo-find-memo — 查询备忘录
接口信息
| 属性 | 值 |
|---|
| 路由 | POST https://skill.amemo.cn/find-memo |
| Bean | MemoBean |
| Content-Type | application/json |
请求参数
⚠️ 服务端要求所有字段必须存在。userToken 和 memoTitle 必填且有值,其他字段可选但字段必须存在。
| 参数 | 类型 | 必填 | 说明 |
|---|
userToken | str | ✅ | 用户登录凭证 |
memoId | str | — | 按 ID 精确查询,不传则传 null |
memoTitle | str | ✅ | 按标题模糊查询(不能为空) |
memoContent | str | — | 按内容模糊查询,不传则传 null |
请求示例
curl -X POST https://skill.amemo.cn/find-memo \
-H "Content-Type: application/json" \
-d '{"userToken": "<token>", "memoId": null, "memoTitle": "量化", "memoContent": null}'
响应示例
{
"code": 200,
"desc": "success",
"data": {
"text": "## 相关笔记\n- 2025-11-08 05:14:24\n\n笔记内容...\n- 2012-01-29 09:26:03\n\n笔记内容..."
}
}
响应解析
| 字段 | 类型 | 说明 |
|---|
code | int | 状态码,200 表示成功 |
desc | str | 状态描述 |
data.text | str | Markdown 格式的笔记列表,包含时间和内容 |
数据格式说明
返回的 data.text 是 Markdown 格式,结构如下:
## 相关笔记
- 2025-11-08 05:14:24
笔记内容(支持多行)
- 2012-01-29 09:26:03
笔记内容...
每条笔记包含:
- 时间戳(列表项格式)
- 笔记内容(段落格式,支持多行)
注意事项
📌 最小参数:只需传入 userToken 和 memoTitle 即可查询
📋 排序规则:返回的笔记按时间倒序排列
✨ 格式说明:内容已格式化为 Markdown,可直接展示给用户
执行流程(由主模块调度)
关键词提取规则
- 去除通用词:查看、查找、搜索、我的、笔记、备忘、记录、相关的
- 保留核心主题词
| 用户输入 | 提取关键词 |
|---|
"查看我旅行攻略相关的笔记" | "旅行攻略" |
"查找关于健身计划的笔记" | "健身计划" |
"搜索我收藏的菜谱笔记" | "菜谱" |
"找一下读书笔记" | "读书" |
执行步骤
1. 识别触发词(查看/查找/搜索 + 关键词 + 笔记)
↓
2. 检查 userToken 是否存在
├── 无 token → 引导登录流程
↓
3. 提取关键词(去除通用词)
↓
4. 调用 POST /find-memo 接口
↓
5. 格式化输出 Markdown
Markdown 输出格式
单个结果时
**📝 {memoTitle}**
> 🕐 {createdAt}
{memoContent}
多个结果时
**📚 找到 {count} 条相关笔记**
---
**1. {memoTitle}**
> 🕐 {createdAt}
{memoContent}
---
**2. {memoTitle}**
> 🕐 {createdAt}
{memoContent}
无结果时
> 🔍 未找到「{关键词}」相关笔记
>
> 试试:
> • 更换关键词
> • 保存一条新笔记