Tencent Ima Skill

# IMA Skill

Control the **IMA (ima.copilot)** desktop application for AI search and private knowledge retrieval.

## Tools

### ima_search
Launches IMA and performs a search. Supports "Private Knowledge Base" mode via special tags.

- **query** (required): The search query. Prefix with `@个人知识库` or `@knowledge` to search your private knowledge base (requires `config.json`).
- **autoclose** (optional): "true" to close the app after searching. Default: "false".

**Implementation:**
```bash
/usr/bin/python3 /opt/homebrew/lib/node_modules/clawdbot/skills/ima/scripts/ima.py "{query}" --autoclose="{autoclose}"
```

## Configuration

To enable private knowledge base search, you must providing your `knowledge_id`.
The script looks for config in:
1. `~/.clawd_ima_config.json`
2. `skills/ima/config.json`

**Format:**
```json
{
  "knowledge_id": "your_id_string"
}
```

## Examples

- **Public:** `clawdbot ima_search query="DeepSeek analysis"`
- **Private:** `clawdbot ima_search query="@knowledge project update"`

# IMA Agent Skill

[中文](#chinese) | [English](#english)

---

<a id="chinese"></a>

# IMA Skill (中文版)

通过 Chrome DevTools Protocol (CDP) 协议，实现对腾讯 **IMA (ima.copilot)** 桌面客户端（AI 知识库助手）的自动化控制。本 Skill 支持全网自动化搜索，并具备独特的**私有知识库注入**功能，无需手动切换即可在查询中自动调用私有知识库。

## ✨ 核心特性

- **🤖 全自动控制**：自动启动、连接并控制 IMA 桌面客户端。
- **🧠 知识库注入**：当查询包含 `@knowledge` 或 `@个人知识库` 标记时，自动注入配置好的 `Knowledge ID`，无需人工干预即可搜索私有数据。
- **🛡️ 零乱码输出**：采用先进的 DOM 提取技术（DOM Extraction），绕过 CDP 网络层的编码缺陷，确保输出完美的 UTF-8 中文结果。
- **🔌 API 拦截**：通过底层 API 拦截技术，强制开启知识库模式。

## 📦 环境要求

- **操作系统**：macOS (已在 macOS 14/15 上验证)
- **IMA 客户端**：需安装在 `/Applications/ima.copilot.app`
- **Python 3**：需安装 `websocket-client` 库

```bash
pip3 install websocket-client
```

## ⚙️ 配置说明

要使用 **私有知识库** 功能，你需要配置你的 Knowledge ID。

1.  **获取 ID**：
    *   打开 IMA 客户端，手动切换到“知识库”模式。
    *   使用网络抓包工具（或 Skill 提供的嗅探脚本）捕获 `/cgi-bin/assistant/qa` 请求。
    *   在请求体（Body）中找到 `"knowledge_ids": ["YOUR_ID_HERE"]` 字段。

2.  **创建配置文件**：
    将 `config.json.sample` 复制为 `config.json`：

    ```bash
    cp config.json.sample config.json
    ```

    编辑 `config.json`：
    ```json
    {
      "knowledge_id": "YOUR_CAPTURED_ID"
    }
    ```

*注意：`config.json` 已被加入 `.gitignore`，以保护你的隐私。*

## 🚀 使用方法

### 命令行调用

**普通全网搜索：**
```bash
python3 scripts/ima.py "DeepSeek V3 分析"
```

**私有知识库搜索：**
(需要先完成配置)
```bash
python3 scripts/ima.py "@knowledge 年度报告分析"
# 或者
python3 scripts/ima.py "@个人知识库 分析新大陆"
```

### 集成到 Clawdbot

本 Skill 专为 [Clawdbot](https://github.com/clawdbot/clawdbot) 设计。安装到 `skills/ima` 后，你可以直接对 Agent 说：

> "用 IMA 搜一下最新的 AI 新闻"
> "去个人知识库查一下关...