IMA 技能安装总结
📅 安装时间
2026年3月19日✅ 安装状态
IMA 技能已完全安装并配置完成📁 技能位置
`C:\Users\jia'yue\.workbuddy\skills\ima-skills\`🔑 API 凭证配置
已成功配置用户提供的 API 凭证:🛠️ 技能功能
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. 隐私保护: 公开场景只显示标题和摘要✅ 完成状态
⚠️ 测试状态
由于系统权限限制,自动测试脚本无法直接运行。需要手动测试API连接。🚀 手动测试方法
打开 PowerShell,运行以下命令:```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 "❌ 连接失败: $_" } ```