---
name: IMA Knowledge Base
slug: ima-knowledge-base
category: AI Engineering
description: IMA Knowledge Base uses IMA OpenAPI to search knowledge base content, inspect hits, list items, upload files, and import web pages. Use it when working with knowledge bases,资料库, or adding content to a knowledge base.
github: "https://github.com/countbot-ai/CountBot/tree/main/workspace/skills/ima-knowledge-base"
language: Python
stars: 767
forks: 100
install: "npx degit https://github.com/countbot-ai/CountBot/tree/main/workspace/skills/ima-knowledge-base ~/.claude/skills/ima-knowledge-base"
installs_to: ~/.claude/skills/ima-knowledge-base
source_path: workspace/skills/ima-knowledge-base/SKILL.md
collection_size: 14
category_size: 2451
collection_url: "https://dirskills.com/collections/countbot-ai/CountBot"
added: 2026-08-23T05:19:16.922Z
last_synced: 2026-08-23T05:19:16.922Z
canonical_url: "https://dirskills.com/skills/ima-knowledge-base"
---

# IMA Knowledge Base

IMA Knowledge Base uses IMA OpenAPI to search knowledge base content, inspect hits, list items, upload files, and import web pages. Use it when working with knowledge bases,资料库, or adding content to a knowledge base.

**Install:**

```bash
npx degit https://github.com/countbot-ai/CountBot/tree/main/workspace/skills/ima-knowledge-base ~/.claude/skills/ima-knowledge-base
```

## README

# IMA Knowledge Base

入口：

```bash
python skills/ima-knowledge-base/scripts/ima_kb_tool.py <command> ...
```

## 执行规则

- 用户说“搜、查、找、看看有没有”时，先 `search-kb`
- 默认直接返回命中片段，不堆字段
- `search-kb` 搜的是内容，不是知识库列表
- 用户给了 `kb-id` 或 `kb-name` 时，加定向参数
- 默认优先 `--keyword`，只有明确要把多个词合成一次搜索串时才用 `--query`
- 宽搜建议加 `--show 5 --limit 10`；知识库很大再加 `--search-pages 2` 或更高

## 查看单条结果

- 默认先 `show-kb-hit`
- 只有命中像图片、截图、OCR 文档、菜单图，或 `show-kb-hit` 太短时，才用 `inspect-kb-hit`
- 一条 `--keyword "推荐 菜单 餐厅 美食"` 会拆成多次搜索，同一标题可能重复出现
- 宽搜后稳定定位优先级：更窄关键词 > `--title` > `--media-id` > `--pick`

## 常用命令

```bash
python skills/ima-knowledge-base/scripts/ima_kb_tool.py search-kb --keyword "orslow"
python skills/ima-knowledge-base/scripts/ima_kb_tool.py search-kb --keyword "推荐 菜单 餐厅 美食" --show 5 --limit 10
python skills/ima-knowledge-base/scripts/ima_kb_tool.py search-kb --kb-name "个人知识库" --keyword "菜单"
python skills/ima-knowledge-base/scripts/ima_kb_tool.py show-kb-hit --keyword "orslow" --pick 1
python skills/ima-knowledge-base/scripts/ima_kb_tool.py inspect-kb-hit --keyword "orslow" --pick 1
python skills/ima-knowledge-base/scripts/ima_kb_tool.py list-kb
python skills/ima-knowledge-base/scripts/ima_kb_tool.py list-kb-items --kb-name "个人知识库" --limit 20
python skills/ima-knowledge-base/scripts/ima_kb_tool.py upload-file --kb-name "个人知识库" --file "/path/to/report.pdf"
python skills/ima-knowledge-base/scripts/ima_kb_tool.py import-url --kb-name "个人知识库" --url "https://example.com"
```

## 推荐类问题

用户问“知识库里有什么推荐”时：

1. 先宽搜：`search-kb --keyword "推荐 菜单 餐厅 美食" --show 5 --limit 10`
2. 命中太杂就补对象词，例如 `search-kb --keyword "orslow 推荐"`
3. 锁定单条后先 `show-kb-hit`
4. 只有需要 OCR 扩展片段时才 `inspect-kb-hit`

## 写入安全

- `upload-file`、`import-url` 会真实写入知识库，执行前先确认目标知识库
- 需要配置时查看 `scripts/config.json` 和 `config.help.md`

## 如何配置 

下载最新的IMA客户端（比如Android），登陆后点击 “我” --> Claw配置  --> 复制  client_id和api_key参数，提供给CountBot后会自动调用文件编辑工具修改config.json。