IMA 知识库上传

要解决什么问题

团队或个人用 IMA 知识库沉淀文档时，常见痛点是：在 IDE 或 Agent 里写完 .md、.txt 后还要切到网页手动粘贴，且若把整篇文档塞进对话再让模型「帮忙上传」，会白白吃掉大量上下文 Token。

本技能把单向上传做成固定工作流：由 Shell 脚本读写文件与调用 API，文档正文不进入 AI 上下文，只在结果里返回 note_id 与知识库名称等 JSON 字段。

如何工作

典型流程如下：

1. credential.cjs check：读取 ~/.config/ima-upload/ 中的凭证；未配置则引导到 IMA Agent 接口页 获取 Client ID 与 API Key，并通过 setup 写入（无需手建文件或环境变量）。
2. 确定知识库：用户显式指定则用指定库；否则查询当前项目目录的默认绑定（bind / status）。
3. upload.sh：将文件作为笔记上传（media_type=11），自动检测编码并转为 UTF-8；文件名作为笔记标题。
4. 依赖同生态的 ~/.codebuddy/skills/ima-skills/ima_api.cjs（需先安装 ima-skills）。

触发词包括「上传到知识库」「ima上传」及英文 upload to knowledge base、ima upload 等。

边界与注意

• 只写不读：不会从知识库拉取或同步回本地，不适合「双向同步」场景。
• 凭证与项目代码分离，且目录对 git 不可达；换机需重新 setup。
• 支持 Markdown 与纯文本；其它格式是否可用取决于上游 IMA API 与 ima-skills 能力。