lockfeel 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}
无结果时
> 🔍 未找到「{关键词}」相关笔记
>
> 试试：
> • 更换关键词
> • 保存一条新笔记