Memos 自托管时间线笔记

问题：笔记工具好用，Agent 却进不去

Memos（usememos）是一款自托管的、基于时间线的笔记工具，遵循「先记录、后整理」的思路。但当 Agent 需要替你存一条想法、改一条旧笔记，或批量整理标签时，让它自己去拼 HTTP 请求并不现实。curl 的响应里可能带着完整 token；散落在对话里的调试片段稍不注意就会把凭据抄进日志；每次调用各写一套鉴权头和错误处理，会让 Agent 的行为难以预测。

这个技能做了什么

它把 Memos 的常用操作收敛到 scripts/api.cjs 这一个入口。Agent 不需要自己拼请求，而是把意图映射到 list、create、update、delete、pin、tags 等 action，技能再按对应文档执行。这个入口统一负责三件事：

• 认证头注入，Agent 不用关心 token 怎么拼
• 错误处理，避免每个 action 各自实现一套重试逻辑
• 凭据脱敏，所有响应在进入对话前经过 scripts/sanitize.cjs 过滤

技能还覆盖了笔记之外的周边操作：comments、reactions、relations、share、attachments 等分别有独立的参考文档，Agent 可以按需加载对应章节，而不是把全部细节塞进上下文。

执行时的关键约定

首次调用必须先读 references/setup.md，拿到配置项、鉴权头格式和运行时环境判断。后续每一步，Agent 都应先看 action 对照表，再读对应的 references/*.md 详细步骤；遇到无法识别的 action，就返回帮助表，而不是空跑。

适用边界与注意点

• 所有 API 调用必须经过 scripts/api.cjs，不要用 curl / wget 直连，否则 token 可能随响应泄露。
• .env 和凭据变量只被脚本读取，不会出现在对话输出里，这是刻意的设计，不要试图绕过。
• scripts/sanitize.cjs 默认开启脱敏，任何「取消屏蔽」式的修改都会让敏感字段重新进入聊天日志，动手前要清楚后果。
• 技能是围绕 Memos API 的封装，不负责部署 Memos 服务本身；服务器没起、token 没配、权限没对，它也救不了。