IMA 开放平台统一技能v1.0.0

免责声明：本站部分 Skill 来源于公开渠道，使用前请注意识别相关风险，内容版权归原作者所有，如 Skill 涉及版权问题，请在线反馈，核实后予以下架处理。

概述

本 Skill 是面向腾讯 IMA 开放平台的统一代理能力，整合笔记（notes）与知识库（knowledge-base）两大模块。用户可通过自然语言指令完成笔记的创建、追加、插入图片、搜索浏览，以及知识库的文件上传、网页链接添加、内容搜索、原文查看与导出等操作。内置智能路由机制，能根据用户意图自动区分「操作对象是笔记内容」还是「知识库条目」，跨模块任务（如将知识库内容转存笔记、笔记关联到知识库）会按正确顺序读取子模块说明并串联执行。同时覆盖凭证检测、UTF-8 编码强制校验、PowerShell 5.1 兼容处理、自动更新检查等全链路工程细节，确保中文内容不丢不乱、调用失败即停并给出可读的报错指引。

技能包含

• SKILL.md（本文件）：全局路由规则、凭证配置、API 调用模板、更新机制、跨平台编码与环境兼容说明
• ima_api.cjs：统一 HTTP POST 请求脚本，封装 IMA 官方 API 调用、凭证传递、错误分层处理与自动更新检查
• meta.json：Skill 元信息及运行时依赖声明
• .history/：脚本与元信息的历史版本备份（7 个文件）

核心能力

• 智能模块路由：依据用户意图自动决策进入 notes 模块或 knowledge-base 模块，易混淆场景（如「知识库里的笔记」vs「把笔记加入知识库」）有明确对照表
• 跨模块任务编排：涉及笔记与知识库联动的操作，强制按序读取双模块 SKILL.md 后再执行，避免单模块遗漏导致数据错误
• 凭证安全与自动检测：优先读取环境变量或配置文件中的 Client ID / API Key，缺省时引导用户完成配置，凭证仅发往 ima.qq.com
• UTF-8 强制编码：notes 写入前对 content、title 等字段执行编码校验/转换，提供 Python、Node.js、Unix、PowerShell 多环境转码方案
• PowerShell 5.1 兼容：检测 PS 版本，5.1 环境下将请求 Body 显式转为 UTF-8 字节数组，杜绝中文静默乱码
• 自动更新检查：每日首次 API 调用自动检查 Skill 版本，发现更新时以结构化错误返回更新指引，支持强制触发
• 双层错误处理：区分脚本层错误（stderr，含凭证缺失、需更新等）与后端业务错误（stdout，直接展示 msg），失败即停不兜底

应用场景