技能名称: index1
详细描述:

index1

面向编码智能体的AI记忆系统，采用BM25+向量混合搜索。提供6个MCP工具，用于智能代码/文档搜索和认知事实记录。

功能特性

• - 双重记忆：语料库（代码索引）+ 认知（情景事实）
• 混合搜索：BM25全文搜索 + 向量语义搜索，支持RRF融合
• 结构感知分块：支持Markdown、Python、Rust、JavaScript、纯文本
• MCP服务器：6个工具（recall、learn、read、status、reindex、config）
• 中日韩优化：支持中文/日文/韩文查询检测，动态权重调整
• 内置ONNX嵌入：开箱即用的向量搜索，无需Ollama
• 优雅降级：无嵌入服务时仍可工作（仅BM25模式）

安装

bash

推荐

或通过pip

或通过npm（自动安装Python包）

一键插件设置：

bash
index1 setup # 为Claude Code自动配置钩子+MCP

验证：

bash
index1 --version
index1 doctor # 检查环境

配置MCP

在项目根目录创建.mcp.json：

json
{
mcpServers: {
index1: {
type: stdio,
command: index1,
args: [serve]
}
}
}

如果index1不在PATH中，请使用which index1获取的完整路径。

添加搜索规则

添加到项目的.claude/CLAUDE.md：

markdown

搜索策略

本项目已配置index1 MCP服务器（recall + 其他5个工具）。搜索代码时：

1. 1. 已知标识符（函数/类/文件名）-> 直接使用Grep/Glob（4毫秒）
2. 探索性问题（XX如何工作）-> 先使用recall，再用Grep获取细节
3. 针对英文代码的中日韩查询 -> 必须使用recall（Grep无法跨语言）
4. 高频关键词（预期匹配50+）-> 优先使用recall（节省90%+上下文）

效果：

无规则：Grep search -> 881行 -> 35,895 tokens
有规则：recall -> 5条摘要 -> 460 tokens（节省97%）

索引项目

bash
index1 index ./src ./docs # 索引源代码和文档
index1 status # 查看索引统计
index1 search your query # 测试搜索

可选：多语言增强

index1 v2内置ONNX嵌入（bge-small-en-v1.5）。如需更好的多语言支持：

bash
curl -fsSL https://ollama.com/install.sh | sh
ollama pull nomic-embed-text # 标准版，270MB

或

index1 config embed_backend ollama
index1 doctor # 验证设置

无需Ollama，ONNX嵌入即可提供开箱即用的向量搜索。

Web界面

bash
index1 web # 在端口6888启动Web界面
index1 web --port 8080 # 自定义端口

MCP工具参考

故障排除