酷斗斗 IMA 知识管理助手

解决的问题

酷斗斗 面向 IMA OpenAPI 的笔记与知识库操作场景。常见坑不在接口本身，而在执行前的路由和编码处理：用户说“记到知识库里的那篇笔记”时，真正对象可能仍是笔记；PowerShell 5.1 会把请求体静默转成系统 ANSI 编码；非法 UTF-8 写入 notes 后可能产生不可修复乱码。该技能把这些问题前置成强制检查规则。

核心能力与流程

技能按意图分流：

• 笔记模块：搜索笔记、浏览笔记本、读取内容、创建笔记、追加内容，对应 import_doc、append_doc 等操作。
• 知识库模块：上传文件、添加网页链接、搜索知识库、浏览知识库、获取原文或可添加知识库列表。
• 跨模块任务：例如“把知识库内容记到笔记”需要先从知识库读取，再写入笔记，必须读取两个子模块后再执行。

关键步骤包括：

1. 凭证检查：优先读取环境变量或 ~/.config/ima/client_id、~/.config/ima/api_key，缺失时先引导配置，不直接调 API。
2. 路由判断：目标是笔记内容走 notes；目标是知识库条目走 knowledge-base；用户只提到“知识库”但实际操作笔记时，仍路由到 notes。
3. 编码与文件约束：写笔记前校验 title、content 为合法 UTF-8；上传文件时保留原始二进制内容，且 title 必须等于原文件名。
4. 错误处理：同时检查脚本退出错误与后端业务错误，-100 表示程序错误，-200 表示技能需要更新，后端 code≠0 时展示返回 msg。

适用边界

当前资料只明确支持 notes 和 knowledge-base 两类能力。视频文件、Bilibili/YouTube 链接、file:// 链接等不支持，需要提示用户改用 IMA 桌面端。遇到“保存为笔记”但未指定已有笔记时，应先确认是新建还是追加，而不是直接写入。