IMA 技能安装总结

📅 安装时间

2026年3月19日

✅ 安装状态

IMA 技能已完全安装并配置完成

📁 技能位置

C:\Users\jia'yue\.workbuddy\skills\ima-skills\

🔑 API 凭证配置

已成功配置用户提供的 API 凭证：

• Client ID: 59a1edb848ec905552c0fbc8041213bf
• API Key: NmwwfdyB2ytuws6jeStZlZcouyijpDYiWSLNAS/fzSRKeGAJ1ZILYXK35G9M2CzVMEGepxc88A==

🛠️ 技能功能

IMA 技能提供完整的 IMA 个人笔记管理功能：

1. 搜索笔记 - 按关键词搜索笔记内容
2. 浏览笔记本 - 查看笔记本列表和笔记列表
3. 读取笔记 - 获取笔记详细内容
4. 创建笔记 - 新建笔记到指定笔记本
5. 追加内容 - 向现有笔记添加内容

📋 技能文件结构

已创建完整的技能文件结构：

ima-skills/
├── SKILL.md                    # 主技能描述文件
├── references/
│   ├── api.md                  # API接口文档
│   ├── usage-examples.md       # 使用示例
│   ├── quick-start.md          # 快速使用指南
├── scripts/
│   ├── test-with-creds.py      # Python测试脚本（直接使用凭证）
│   ├── test-api.py             # Python测试脚本（使用环境变量）
│   ├── test-api.sh             # Bash测试脚本
│   ├── test-api.ps1            # PowerShell测试脚本
│   ├── configure.ps1           # PowerShell配置脚本
│   └── set-env.cmd             # CMD环境变量设置脚本

🚀 使用方式

技能已配置为自动触发，当用户提到以下关键词时会自动激活：

• "笔记"、"备忘录"、"记事"、"记录"
• "知识库"、"文档"、"资料"
• "查找笔记"、"搜索笔记"、"查看笔记"
• "创建笔记"、"新建笔记"、"记录一下"
• "追加内容"、"添加内容"、"补充笔记"

🔧 环境变量配置

已创建多种环境变量配置脚本：

1. scripts/configure.ps1 - PowerShell配置脚本
2. scripts/set-env.cmd - CMD环境变量设置脚本
3. scripts/test-with-creds.py - 直接使用凭证的测试脚本

📝 技术细节

1. API 基础 URL: https://ima.qq.com/openapi/note/v1/
2. 请求方法: HTTP POST
3. 请求头: Content-Type, X-OpenApi-ClientId, X-OpenApi-Sign
4. 编码要求: UTF-8 编码
5. 隐私保护: 公开场景只显示标题和摘要

✅ 完成状态

• [x] 技能文件创建完成
• [x] API 凭证配置完成
• [x] 测试脚本创建完成
• [x] 使用指南创建完成
• [x] 环境变量配置脚本创建完成
• [x] 技能文档完善完成
• [x] 手动测试指南创建完成

⚠️ 测试状态

由于系统权限限制，自动测试脚本无法直接运行。需要手动测试API连接。

🚀 手动测试方法

打开 PowerShell，运行以下命令：

$ClientID = "59a1edb848ec905552c0fbc8041213bf"
$ApiKey = "NmwwfdyB2ytuws6jeStZlZcouyijpDYiWSLNAS/fzSRKeGAJ1ZILYXK35G9M2CzVMEGepxc88A=="
$headers = @{
    "Content-Type" = "application/json"
    "X-OpenApi-ClientId" = $ClientID
    "X-OpenApi-Sign" = $ApiKey
}
$body = '{"cursor":"0"}'
try {
    $response = Invoke-RestMethod -Uri "https://ima.qq.com/openapi/note/v1/list_note_folder_by_cursor" -Method Post -Headers $headers -Body $body -TimeoutSec 5
    Write-Host "✅ API 连接成功！"
    Write-Host "状态码: $($response.code)"
    Write-Host "消息: $($response.message)"
    if ($response.data.folders) {
        Write-Host "发现 $($response.data.folders.Count) 个笔记本"
    }
} catch {
    Write-Host "❌ 连接失败: $_"
}

📊 预期结果

• ✅ 成功：返回 code: 0 和笔记本列表
• ❌ 失败：返回错误码或网络错误

IMA 技能已完全安装完成，只需手动验证API连接即可开始使用！