Ai好记

当笔记数据集中在 Ai好记 Agent Open Platform 时，一个很常见的工程问题是：模型如果只是翻本地目录、日志或缓存去猜笔记内容，很容易拿到过期结构、写错 folder_id / note_id，或把笔记本名当成搜索关键词，导致移动、归类结果不可控。这个技能的价值在于把笔记操作固定为「接口优先、真实 ID、写入前确认」的链路。

核心能力与工作流程

• 配置与鉴权：优先读取 ~/.aihaoji/config.json；缺失时再回退到 $AIHAOJI_API_KEY 与 $AIHAOJI_BASE_URL。请求头固定，不会把密钥散落在别处。
• Key 校验：拿到开发者密钥后先调 GET /agent-open/api/v1/auth/verify，确认可用后再写入配置；自动配置失败时才提示 npx aihaoji-openclaw setup。
• 意图路由：列笔记本先调 GET /agent-open/api/v1/folders；看笔记本内笔记先定位真实 folder_id，再调 GET /agent-open/api/v1/notes?folder_id=...；在笔记本内搜关键词时继续沿用该 folder_id 与 keyword，结果数量以 API 返回为准。
• 读取细节：查最近/最新 N 篇使用 sort_mode=create_time 与 sort_order=desc；查最早/最老则用 asc，未指定 N 时默认 10。看总结、大纲、精华速览时传 semantic_view=summary|outline|highlights；看划线、批注、我的记录时传 include_records=true，并读取 data.records_detail.records、data.records_detail.my_record、data.records_detail.ai_highlights 等字段。

写入与整理的约束

写入不是直接落库，而是固定六步：

1. 读取 folders 和 notes，确认真实 ID；
2. 读取详情与必要记录；
3. 输出变更计划，包括将创建的笔记本、将移动的笔记/笔记本、目标位置和归类依据；
4. 等待用户明确确认；
5. 创建缺失笔记本，再执行移动；
6. 重新查询目标列表验证结果。

自动归类时必须先读笔记内容和记录依据，不能只凭标题批量移动，除非用户明确要求粗略整理。已存在同名笔记本时复用，不重复创建；目标不确定的笔记列入「待确认」；同一轮自动整理不删除笔记本。批量移动优先使用 PC 端同形参数：笔记 move_type=1，笔记本 move_type=2，移动笔记本到根目录时 target_folder_id=-1。

适用边界与注意点

这个技能只面向在线开放平台，不扫描本地目录、日志、缓存或源码来猜测笔记内容。所有内部 ID 必须来自接口返回，不能手写。普通展示默认隐藏 note_id 和 folder_id，调试或需要原始字段时再展开。接口报错、超时或返回 401/403/429/5xx 时，应明确说明当前无法通过 Ai好记开放平台获取数据，而不是退回本地搜索。写入前必须展示计划并等待确认；删除笔记本必须单独确认，不能混入自动整理默认计划。权限方面，写入通常需要 folder:write 或 note:move，记录读取需要 note:read，列表和读取还需要 note:list 等相应权限。