ima-skills

name	ima-skills
description	ima笔记与知识库管理（读取、写入、检索）；统一 IMA OpenAPI 技能，支持 notes 与 knowledge-base 两个模块。
version	1.1.8
homepage	https://ima.qq.com
display_name	腾讯ima
display_name_en	Ima Skills
description_zh	ima笔记与知识库管理（读取、写入、检索）
description_en	IMA notes & knowledge base management (read, write, search)
visibility	public

ima-skill

Unified IMA OpenAPI skill. Currently supports: notes, knowledge-base.

⛔ MANDATORY RULES — read before ANY operation

1. UTF-8 encoding (notes writes only): Before calling import_doc or append_doc, ALL string fields (content, title) MUST be validated as legal UTF-8. Non-UTF-8 content causes irreversible garbled text. See Detailed Rules for platform-specific methods.
2. File upload naming: title MUST equal file_name (with extension). Never rename, shorten, translate, or modify the original filename.
3. Unsupported file types: Reject immediately with a clear message. Do NOT ask user "do you still want to try?" Video files, Bilibili/YouTube URLs, and file:// URLs are not supported — tell user to use IMA desktop client.
4. File upload integrity: Keep file content as-is during upload. No encoding conversion for binary files (PDF, images, Excel, etc.).
5. PowerShell 5.1 (all modules): If running in PowerShell, detect version before first API call. PS 5.1 silently converts request Body to GBK — must use UTF-8 byte array mode. See Detailed Rules.

模块决策表

用户意图	模块	读取
搜索笔记、浏览笔记本、获取笔记内容、创建笔记、追加内容	notes	notes/SKILL.md
上传文件、添加网页链接、搜索知识库、浏览知识库内容、获取知识库信息、获取可添加的知识库列表	knowledge-base	knowledge-base/SKILL.md
查看原文、分析原文、导出原文（需要 media_id）	knowledge-base	knowledge-base/SKILL.md

⚠️ 易混淆场景

用户说的	实际意图	正确路由
"把这段内容添加到知识库XX里的笔记YY"	往已有笔记追加内容	notes — 先搜索笔记获取 note_id，再用 append_doc
"把这个写到XX笔记里"、"记到XX笔记"	往已有笔记追加内容	notes — append_doc