IMA Knowledge Management Assistant

Problems It Addresses

Cool Dou Dou targets note and knowledge-base operations over the IMA OpenAPI. The failure modes are often less about raw API calls and more about routing and encoding: a phrase like “save this to the note in the knowledge base” may still mean a note object; PowerShell 5.1 can silently convert request bodies to the system ANSI code page; invalid UTF-8 written to notes can produce irreversible garbled text. This skill makes those checks mandatory before execution.

How It Works

The skill routes intent by module:

• Notes: search notes, browse notebooks, read content, create notes, and append content through operations such as import_doc and append_doc.
• Knowledge base: upload files, add web links, search the knowledge base, browse entries, and retrieve source content or the list of writable knowledge bases.
• Cross-module tasks: for example, moving knowledge-base content into a note requires reading the knowledge base first and then writing the note, so both submodules must be loaded before execution.

Key steps include:

1. Credential check: prefer environment variables or ~/.config/ima/client_id and ~/.config/ima/api_key; if missing, guide setup before calling APIs.
2. Intent routing: use notes when the target is note content; use knowledge-base when the target is a knowledge-base entry; route to notes even if the user only mentions the knowledge base as the location.
3. Encoding and file constraints: validate title and content as UTF-8 before note writes; upload files with original binary content unchanged, and set title equal to the original filename.
4. Error handling: inspect both script-level exit errors and backend business errors; -100 indicates program errors, -200 indicates a skill update is required, and non-zero backend code values should surface the returned msg.

Boundaries

The provided material only documents notes and knowledge-base capabilities. Video files, Bilibili/YouTube links, and file:// URLs are unsupported, so the skill should direct users to the IMA desktop client. If the user asks to “save as a note” without naming an existing note, confirm whether to create a new note or append before writing.