ima-cli

IMA OpenAPI 命令行工具 — 笔记与知识库管理，设计理念：一切能力通过命令分发，-H 提供详细操作手册（Skill 文档）。

Skill 来源：clawhub.ai/iampennyli/ima-skills（v1.1.2）

安装

npm install -g ima-cli
# 或本地开发
npm install && npm run build && npm link

快速开始

# 1. 配置凭证（https://ima.qq.com/agent-interface）
ima auth config --client-id <id> --api-key <key>
ima auth check

# 2. 笔记操作
ima notes search --title "会议纪要"
ima notes create "# 标题\n\n正文"
ima notes get <doc-id>

# 3. 知识库操作
ima wiki search-base
ima wiki upload --kb-id <id> --file ./report.pdf
ima wiki import-urls --kb-id <id> https://example.com/article

# 4. 安装 Agent Skill
ima skill install --target cursor

-H 操作手册

ima -H                  # 根 Skill 文档
ima notes -H            # 笔记模块手册
ima wiki upload -H      # 上传命令 API 参考
ima skill show wiki     # 查看知识库模块文档

项目结构

| 路径 | 说明 | |------|------| | docs/skills/ima-skill/ | 从官方 zip 同步的 ima-skills 文档 | | src/ | TypeScript CLI 源码 | | dist/ | 构建产物 |

Enhanced TODO 插件

• 插件文件：.opencode/plugins/enhanced-todo.ts
• 作用对象：内置 todowrite / todo 工具
• 实现方式：
  • tool.definition：追加 Enhanced TODO Notes 使用说明
  • tool.execute.before：将误传的独立 note 字段折叠进 content
• 设计边界：
  • 不修改 opencode 源码
  • 不修改内置 TODO schema / 数据库结构
  • 不新增独立 TODO 系统
• 预期收益：让 TODO 在保持原生工具的前提下，带上简短、可观察的验证说明，减少“完成了什么 / 验证了什么”歧义
• 生效方式：重启 opencode 后加载（插件不热更新）

当前验证状态

• 已完成本地导入验证
• 已确认说明注入逻辑正确
• 已确认非法 note 字段会在执行前折叠进 content
• 尚未在真实重启后的会话里做一次人工验收