稍后读 · API

[Kenshin]

这是同步助手 1.5.4 推出的新功能，如低于此版本 请升级。

API

基于 Node.js 标准库实现的 SimpRead 稍后读查询接口，读取 simpread_config.json 中的 unrdist 字段，支持多维度筛选与响应裁剪。

如何开启

请访问 稍后读外部访问

快速开始

curl "http://localhost:7026/api/unrdist?date=last30&tags=科技史话/AI战争"

接口说明

GET /api/unrdist

所有参数均为可选，通过 URL query string 传递，参数之间为 AND 关系（同时满足）。

无参数时返回全部 unrdist 条目。

---

查询参数

date — 日期筛选

按 create 字段匹配，支持预设模式与精确日期两种写法。

值	含义
today	今天
yesterday	昨天
daily	昨天 + 今天（最近两天）
week	本周一 ~ 本周日
last7	包含今天在内的最近 7 天
last30	包含今天在内的最近 30 天
2026年05月27日	精确匹配该日（中文日期格式）
2026-05-27	精确匹配该日（ISO 日期格式）

# 今天的条目
curl "...?date=today"

# 精确日期
curl "...?date=2022年09月07日"
curl "...?date=2022-09-07"

tags — 标签筛选

按 tags 数组匹配，支持多个标签（逗号分隔），标签之间为 AND 关系，标签值为 子串包含 匹配。

值	含义
AI/LLM	标签中包含 AI/LLM
AI/LLM,AI/RAG	标签中同时包含 AI/LLM 和 AI/RAG
LLM	标签中包含 LLM（子串匹配，可命中 AI/LLM）

curl "...?tags=AI/LLM"
curl "...?tags=AI/LLM,AI/RAG"

url — URL 筛选

对 url 字段进行子串包含匹配。

curl "...?url=baidu.com"
curl "...?url=sspai.com/post"

title — 标题筛选

对 title 字段进行子串包含匹配。

curl "...?title=简悦"
curl "...?title=百度一下"

desc / note — 描述筛选

两个参数均指向 desc 字段，行为一致，子串包含匹配。

参数	实际查询字段
desc	desc
note	desc

curl "...?desc=搜索引擎"
curl "...?note=搜索引擎"    # 效果同上

idx — 索引精确匹配

对 idx 字段进行完全匹配，不支持模糊。

curl "...?idx=100"     # 命中 idx=100
curl "...?idx=10"      # 不会命中 idx=100 或 idx=102

annotations.text — 标注文本筛选

对 annotations 数组中每个元素的 text 字段进行子串包含匹配，任一命中即通过。

curl "...?annotations.text=向量数据库"

annotations.tags — 标注标签筛选

规则与 tags 一致，但作用于 annotations 数组中每个元素的 tags 字段。

curl "...?annotations.tags=AI/Agent"
curl "...?annotations.tags=搜索引擎,技术"

all — 查询本地快照

查询内容 title desc 以及本地快照中命中的关键词，返回格式包含了 snippets 数组结构，每个元素都是一段命中的 HTML。

curl "...?all=AI"

---

响应控制参数

include — 响应深度

控制返回数据的完整度，默认 full。

值	行为	返回的 annotations 结构
full	完整返回	完整的 annotations（含 annote、items 等所有字段）
unread	去除标注	不返回 annotations 字段
light	轻量标注	保留 annotations，但移除每个标注中的 annote 和 items 字段

# 仅返回条目基本信息，不含标注
curl "...?include=unread"

# 标注保留 text/tags/note 等，去掉 html/annote/items 等重字段
curl "...?include=light"

fields — 字段裁剪

仅返回指定字段，逗号分隔。设置 fields 时会覆盖 include 的效果。

# 仅返回 title、url、idx 三个字段
curl "...?fields=title,url,idx"

# 仅返回 title
curl "...?fields=title"

---

返回格式

{
  "total": 3,
  "query": {
    "date": "last30",
    "tags": "AI/LLM"
  },
  "data": [
    {
      "annotations": [...],
      "create": "2026年05月29日 10:00:00",
      "desc": "深入解析大语言模型...",
      "favicon": "https://example.com/favicon.ico",
      "idx": 100,
      "img": "https://example.com/llm.png",
      "note": "",
      "tags": ["AI/LLM", "深度学习"],
      "title": "大语言模型深度解析",
      "url": "https://example.com/articles/llm-deep-dive"，
      "snippets": [
        "<mark>OpenAI</mark> 和 Google 正在加速追赶",
        "促使 <mark>OpenAI</mark> 放弃机器人方向的重要因素之一。"
      ]
    },
    }
  ]
}

字段	说明
total	匹配结果数量
query	回显本次请求的查询参数
data	匹配的 unrdist 条目数组
snippets	当使用 all: 参数时会返回包含命中结果的 HTML，检索内容来自你的本地快照

---

组合查询示例

# 最近 30 天内，标签含 AI/LLM，轻量标注，只返回 title/url/create
curl "http://localhost:9235/api/unrdist?date=last30&tags=AI/LLM&include=light&fields=title,url,create"

# 标注中包含 "向量数据库" 的条目
curl "http://localhost:9235/api/unrdist?annotations.text=向量数据库"

# URL 含 baidu 且标题含 "百度"
curl "http://localhost:9235/api/unrdist?url=baidu&title=百度"

# 本周新增，标签含前端，去除标注
curl "http://localhost:9235/api/unrdist?date=week&tags=前端&include=unread"

# 精确索引查询
curl "http://localhost:9235/api/unrdist?idx=100&fields=title,url"

---

配置文件

默认读取与 server.js 同目录下的 simpread_config.json。

• 文件有 mtime 缓存，修改后自动重新加载
• unrdist 为空或不存在时返回空数组
• 不修改源文件

其他接口

接口	说明
GET /api/health	健康检查，返回配置文件路径

无依赖

仅使用 Node.js 内置模块：http、fs、path、url，无需 npm install。