القائمة
Use when the user asks to search, read, export, manage, move, or auto-classify Ai好记 / AI好记 notes and notebooks, including 笔记本, 文件夹, 划线, 批注, 我的记录, 新建笔记本, 移动笔记, 移动笔记本, AI 自动归类整理。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | aihaoji |
| description | Use when the user asks to search, read, export, manage, move, or auto-classify Ai好记 / AI好记 notes and notebooks, including 笔记本, 文件夹, 划线, 批注, 我的记录, 新建笔记本, 移动笔记, 移动笔记本, AI 自动归类整理。 |
| metadata | {"openclaw":{"requires":{},"optionalEnv":["AIHAOJI_API_KEY"],"baseUrl":"https://openapi.aihaoji.com","homepage":"https://www.aihaoji.com"}} |
通过 Ai好记 Agent Open Platform 查询、读取、导出和整理用户笔记。实际接口、字段和场景细节见 references/agent-open-platform.md；处理写入、记录读取、导出、自动归类或接口参数不确定时必须读取该参考。
优先从 ~/.aihaoji/config.json 读取：
{
"apiKey": "sk-sxxxxxxxx",
"baseUrl": "https://openapi.aihaoji.com"
}
缺失时再读 $AIHAOJI_API_KEY 和 $AIHAOJI_BASE_URL。请求头固定为：
Authorization: $AIHAOJI_API_KEY
没有 API Key 时，引导用户去 https://openapi.aihaoji.com 创建 sk-s... 开发者密钥；拿到 key 后先调 GET /agent-open/api/v1/auth/verify 校验，再写入 ~/.aihaoji/config.json。自动配置失败时再提示 npx aihaoji-openclaw setup。
folder_id、target_folder_id、note_id、move_item_list[].item_id 都必须先查询确认。note_id 和 folder_id；只有用户要求调试或原始字段时再展示。401/403/429/5xx 时，明确说明当前无法通过 Ai好记开放平台获取数据，不要退回本地搜索。| 参数 | 来源 |
|---|---|
folder_id | GET /agent-open/api/v1/folders 返回的真实笔记本 ID |
parent_id | 新建子笔记本时来自真实父级 folder_id；顶层笔记本传 parent_id=0，不要传 null |
target_folder_id | 单篇/批量移动笔记的目标笔记本 ID，也用于批量移动笔记本；必须来自真实笔记本 ID；移动笔记本到根目录可传 -1 |
note_id | GET /agent-open/api/v1/notes 或详情接口返回的真实笔记 ID |
move_item_list | 与 PC 端移动接口同形：笔记 move_type=1，笔记本 move_type=2，item_id 为真实 ID |
name | 用户明确输入，或 AI 自动归类计划生成并经用户确认 |
include_records | 用户要看划线/高亮/批注/我的记录，或归类需要标注依据时传 true |
include_export_markdown | 用户选择导出 Markdown 到本地时传 true |
| 意图 | 接口 |
|---|---|
| 校验 Key | GET /agent-open/api/v1/auth/verify |
| 笔记本树 | GET /agent-open/api/v1/folders |
| 笔记列表 / 搜索 / 最近笔记 | GET /agent-open/api/v1/notes |
| 笔记详情 / 语义视图 / 导出 / 划线、批注、我的记录 | GET /agent-open/api/v1/notes/{note_id} |
| 新建笔记本 | POST /agent-open/api/v1/folders |
| 重命名笔记本 | PUT /agent-open/api/v1/folders/{folder_id} |
| 删除笔记本 | DELETE /agent-open/api/v1/folders/{folder_id} |
| 移动单篇笔记 | PATCH /agent-open/api/v1/notes/{note_id}/folder，请求体使用 target_folder_id |
| 批量移动笔记 | POST /agent-open/api/v1/notes/batch-move |
| 批量移动笔记本 | POST /agent-open/api/v1/folders/batch-move |
写入权限通常需要 folder:write 或 note:move；记录读取需要 note:read。
GET /agent-open/api/v1/folders，按接口的 folder_tree_text 或 children 真实层级展示。/folders 定位真实 folder_id，再调 /notes?folder_id=...；不要把笔记本名复用成 keyword。folder_id，再调 /notes?folder_id=...&keyword=...；结果数量以 API 返回为准，不做人为二次删减。/notes?page_no=1&page_size=N&sort_mode=create_time&sort_order=desc；未给 N 默认 10。sort_order=asc；未给 N 默认 10。keyword 搜索，优先匹配返回里的真实 URL。semantic_view=summary|outline|highlights。A：导出为 Markdown 文件到本地 / B：直接在聊天里查看；用户选 A 时用 include_export_markdown=true，选 B 时按 semantic_chunk_no 分块查看。include_records=true；重点读取 data.records_detail.records、data.records_detail.my_record、data.records_detail.ai_highlights 和 data.records_detail.ai_highlights_status。写入固定顺序：
folders 和 notes，确认真实 ID。新建顶层笔记本时请求体必须使用 "parent_id": 0。后端会把 0 归一为根级 parent_id=None；不要传 JSON null，线上接口可能返回“创建笔记本失败”。
自动归类整理要求：
批量移动请求优先使用 PC 端同形参数：
{
"target_folder_id": 123,
"move_item_list": [
{"move_type": 1, "item_id": "task_xxx", "pre_id": null}
]
}
移动笔记本时 move_type=2，target_folder_id=-1 表示移动到根目录。
401/403：提示 API Key 可能无效、过期、停用、删除、无权限、非会员或应用绑定失效。note:list、note:read、folder:write 或 note:move。404：说明笔记或笔记本不存在，重新查询候选让用户确认。429：说明触发频率限制，建议稍后再试或减少批量范围。references/agent-open-platform.md