技能介绍

要解决什么问题

官方 IMA OpenAPI 已经支持上传文件到知识库、读写笔记和搜索，但手工归档 WorkBuddy 的持续产出很繁琐：每个新文件都要逐个上传，还要手动指定存入哪个知识库；一旦忘记备份，本地文件和知识库就会脱节。本技能在官方 API 之上补齐整目录批量归档和自动增量备份，让成果「生成即存档」。

核心能力

单文件上传：预检 → create_media → 上传腾讯云 COS → add_knowledge 关联，四步完成，写完文章即可备份
批量目录上传：扫描目录、按扩展名过滤、逐个上传，失败自动重试（退避 2/5/10 秒），结束输出汇总报告
自动增量备份：在 ~/.config/ima-sync/state.json 记录相对路径、mtime、size 指纹，只上传新增或修改的文件
智能路由：按路径前缀和扩展名自动选库，无需每次手动指定
笔记与检索：import_doc / append_doc 创建或追加 Markdown 笔记，支持网页收藏、知识库搜索与笔记正文读取

适用边界与注意点

所有接口均为 POST + JSON，Base URL 为 ima.qq.com，通过 ima-openapi-clientid 与 ima-openapi-apikey 两个请求头认证；凭据与官方一致，可与官方 ima-skills 并存
写入笔记前必须确保 content 是合法 UTF-8，否则 ima 中会出现不可修复的乱码
PowerShell 5.1 的 Invoke-RestMethod 会把 Body 静默转成 GBK，需要显式按 UTF-8 字节数组发送 JSON
上传文件必须以二进制原样传输、不得转码；笔记正文只接受文本/Markdown，本地图片路径不被支持
增量备份依赖指纹文件去重；路由未命中时会列出可写知识库供选择