IMA Skills 完整使用指南

最后更新: 2026-04-20

API版本: 1.1.2

📋 配置信息

| 配置项 | 值 | |--------|-----| | Client ID | 87e4c9978e1b50b3918e20313b7084ed | | API Key | gep8bpF4dsT/7rN32p61y6r2KN0RPZADIWm+HBx7ce2UT7f6lUUuBd3hJCmojQ1aHPjZMOL6vA== | | Base URL | https://ima.qq.com | | 状态 | ✅ 已验证有效 |

🚀 快速开始

1. 笔记模块操作

from ima_skills_demo import IMAClient

client = IMAClient(
    client_id='87e4c9978e1b50b3918e20313b7084ed',
    api_key='gep8bpF4dsT/7rN32p61y6r2KN0RPZADIWm+HBx7ce2UT7f6lUUuBd3hJCmojQ1aHPjZMOL6vA=='
)

列出笔记本
result = client.list_notebooks()

列出笔记
result = client.list_notes()

搜索笔记
result = client.search_notes('关键词')

创建笔记
result = client.create_note(
    title='笔记标题',
    content='笔记内容'
)

读取笔记
doc_id = 'xxx'
result = client.get_note_content(doc_id)

追加内容
result = client.append_to_note(doc_id, '追加的内容')

2. 知识库模块操作

列出知识库
result = client.list_knowledge_bases()

搜索知识库内容
kb_id = 'xxx'
result = client.search_knowledge(kb_id, '关键词')

列出知识库条目
result = client.list_knowledge_items(kb_id)

添加网页到知识库
result = client.add_url_to_kb(
    kb_id=kb_id,
    urls=['https://example.com/article']
)

📚 API 接口列表

笔记模块 (openapi/note/v1)

| 功能 | 接口 | 方法 | |------|------|------| | 列出笔记本 | list_note_folder_by_cursor | POST | | 列出笔记 | list_note_by_folder_id | POST | | 搜索笔记 | search_note_book | POST | | 获取笔记内容 | get_doc_content | POST | | 创建笔记 | import_doc | POST | | 追加笔记内容 | append_doc | POST |

知识库模块 (openapi/wiki/v1)

| 功能 | 接口 | 方法 | |------|------|------| | 列出知识库 | search_knowledge_base | POST | | 获取知识库信息 | get_knowledge_base | POST | | 搜索知识库内容 | search_knowledge | POST | | 列出知识库条目 | get_knowledge_list | POST | | 添加网页URL | import_urls | POST |

🔧 实用脚本

运行演示

python "c:\Users\jia'yue\WorkBuddy\Claw\ima_skills_demo.py"

验证配置

python "c:\Users\jia'yue\WorkBuddy\Claw\ima_config_verify.py"

⚠️ 注意事项

1. 编码问题: 笔记内容必须使用 UTF-8 编码 2. 图片限制: 笔记接口不支持本地图片，仅支持网络图片链接 3. 文件上传: 知识库支持 PDF/Word/Excel/PPT/图片等格式 4. 视频限制: 不支持 Bilibili/YouTube 视频链接

📁 相关文件

| 文件 | 路径 | 说明 | |------|------|------| | 主Skill文档 | ~/.workbuddy/skills/ima-skills/ima-skill/SKILL.md | 完整API文档 | | 笔记模块 | ~/.workbuddy/skills/ima-skills/ima-skill/notes/SKILL.md | 笔记操作指南 | | 知识库模块 | ~/.workbuddy/skills/ima-skills/ima-skill/knowledge-base/SKILL.md | 知识库操作指南 | | 演示脚本 | ~/WorkBuddy/Claw/ima_skills_demo.py | 功能演示 | | 验证脚本 | ~/WorkBuddy/Claw/ima_config_verify.py | 配置验证 | | 使用指南 | ~/WorkBuddy/Claw/ima_skills_guide.md | 本指南 |

✅ 当前状态