NOTES · GUIDE

便利贴使用文档

一个只属于你的记事本。你自己随手记，也可以让各个 Agent 帮你记、把它们的记忆存在这里，每条都标明是谁写的。

01

快速开始

  1. 打开 notes.wangming.cv，输入密码进入。同一台设备登录一次能保持一年。
  2. 点右下角黑色 ＋ 新建。写标题和内容，点「完成」或点空白处就自动保存。
  3. 点任意一条便利贴可以修改。底部能换颜色、置顶、删除。
  4. 手机上可以用浏览器「添加到主屏幕」，用起来像个 App。

标题尽量写成以后会搜的词，比如「家里 WiFi 密码」「身份证号」「车险到期」，找起来最快。

03

接入 Agent

每个 Agent 用自己的密钥，它写的东西会自动归到它名下。Agent 多了也不会乱。

  1. 登录后点右上角 Agent。
  2. 输入名字（比如 Hark、Claude、手机助手），备注可选，点「创建并生成密钥」。
  3. 点 「复制给 Agent 的整段说明」，粘贴给那个 Agent。说明里已经带好了密钥和用法。
  4. 以后这个 Agent 记的东西，在「来源」里点它的名字就能单独看。
管理
  • 密钥只显示一次。丢了就点「换密钥」，旧的立即失效。
  • 不用某个 Agent 了就「删除」，它的密钥马上失效，已经写的便利贴会保留，归到「已删除的 Agent」。
  • 列表里能看到每个 Agent 写了多少条、最近一次使用时间，方便发现异常。

密钥相当于这个本子的钥匙：别发到群里，也别写进便利贴内容里。

04

Agent 记忆

除了便利贴，每个 Agent 还可以把自己的「长期记忆」存上来：它对你的了解、你的偏好、正在做的项目进展。点顶部的 记忆 标签就能看到，按 Agent 分组。

  • 每条记忆有一个键（比如 user.profile），同一个 Agent 用同一个键再上传会直接覆盖，不会越存越多。
  • 换了新 Agent、或者旧 Agent 换了会话，让它读 /api/memories.md 就能把记忆全部接上。
  • 你也可以自己点 ＋ 改错的记忆，或者删掉不想让它记住的。
POST /api/memories
{"key":"user.profile","title":"用户资料","body":"王兵，说中文…"}

GET /api/memories.md?mine=1   # 导出自己的全部记忆

05

API 参考

给 Agent 看的纯文本版在 /api（也叫 /llms.txt），可以直接把链接丢给 Agent。

鉴权

每个请求带 Authorization: Bearer 密钥，或 X-API-Key: 密钥。Base URL：https://notes.wangming.cv

接口说明
GET/api/me查看当前密钥属于哪个 Agent
GET/api/notes列出便利贴。参数：q 搜索（空格分多词）、mine=1 只看自己写的、agent=ag_xxx 或 me、color、pinned=1、limit
GET/api/notes/{id}取一条
POST/api/notes新建：title、body、color、pinned；自动标记为当前 Agent
PATCH/api/notes/{id}修改，只传要改的字段
DELETE/api/notes/{id}删除
GET/api/memories列出记忆，参数同上；/api/memories.md 导出 Markdown
POST/api/memories新建记忆：key、title、body；同一 Agent 同一 key 自动覆盖
*/api/memories/{id}GET / PATCH / DELETE，同便利贴

便利贴对象

{
  "id": "8f146da1-b98",
  "title": "家里 WiFi 密码",
  "body": "名称 xxx，密码 xxx",
  "color": "paper",        // paper lemon sage sky blush lilac
  "pinned": 0,
  "agent": "ag_3f9a1c20",  // 空字符串 = 你本人写的
  "agent_name": "Hark",
  "created": 1793915069148,  // 毫秒时间戳
  "updated": 1793915069148
}

例子

curl -H "Authorization: Bearer $KEY" \
  "https://notes.wangming.cv/api/notes?q=wifi"

curl -X POST -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"买菜","body":"鸡蛋、牛奶"}' \
  https://notes.wangming.cv/api/notes

出错时返回 {"error":"原因"}：401 密钥无效，404 不存在，400 参数不对。

06

常见问题

忘了密码怎么办？

告诉 Hark，可以帮你重设。

Agent 能看到我自己写的便利贴吗？

能。所有 Agent 都能搜到全部内容，这样问它「我之前记的 XX」它才找得到。真正不想让 Agent 看到的东西别记在这里。

数据存在哪？

存在你自己 Cloudflare 账户的 D1 数据库里，不经过别人的服务器。

打开便利贴