Leviathan Skill 技能

技能简介

Leviathan 是面向智能体的"大数据集深度记忆"技能：一个静态二进制文件，把你的记录（JSONL、JSON、CSV/TSV、SQLite，或任何数据库 CLI 能导出的格式）一次性建成带排名的全文索引。智能体用自然语言提问，拿到的是约 450 token 的引用结果卡——无论数据集多大，回答长度都恒定，再也不用 grep 原始日志再逐条阅读。

核心能力

• 多格式接入：JSONL/JSON/CSV/TSV/SQLite 以及任意数据库 CLI 的输出都能索引，Leviathan 从不持有数据库凭据。
• 排名全文检索：自然语言查询返回带相关度分数的引用卡片，100 万条记录下 top5 相关命中率 99.0%。
• 分组作用域：-g 参数按客户/租户等分组检索，组名模糊或未知时列出候选而非乱猜；组内无结果自动回退其他组并标注 OTHER CUSTOMER。
• 灵活过滤：--where 字段过滤、--since/--until 时间范围、短语与排除语法组合使用。
• 增量维护：原子构建、内容无变化自动跳过，upsert/delete 保持索引常新。
• 恒定低开销：任意规模下每问中位 436 token（对比最佳 grep 策略 107,122 token，节省 245 倍），中位延迟 33 毫秒。
• 双形态调用：既可命令行直接使用，也内置 skills/leviathan 技能包，任何有 shell 的智能体都能按技能说明调用。

安装配置

• 预编译二进制：从 GitHub Releases 下载对应平台版本，无运行时依赖，索引即一个 SQLite 文件。
• 源码安装：cargo install leviathan-index，或 cargo install --git 仓库地址。
• 技能安装：把 skills/leviathan 目录复制进智能体的技能目录（Claude Code 等）即可获得自然语言调用能力。

使用步骤

1. 初始化：运行 leviathan init ./export 自动推断并生成带注释的 leviathan.toml 配置。
2. 建索引：leviathan index tickets.csv --id "Ticket ID" --group customer_id --date created_at 映射字段；或由智能体根据 schema 写配置后 leviathan index -c tickets.toml。
3. 查询：leviathan search -g acme "sso login loop after password reset"，返回带引用的结构化结果卡。
4. 查看结构：leviathan describe 列出字段、分组、过滤值与示例调法。
5. 接入数据库：psql/duckdb 等经各自 CLI 导出 JSON 流入 Leviathan 索引，全程不暴露账号密码。

适用场景

客服工单与日志的智能体检索、跨会话的智能体长期记忆、多租户 SaaS 数据的隔离检索、大规模导出文件的快速问答。

适用人群

AI Agent 开发者、数据工程师、SRE 与客服系统构建者——凡是需要让智能体"问大数据集拿短答案"的人都适用。

工作原理

索引阶段把记录解析为带字段映射的条目，写入单个 SQLite 全文索引（构建原子化，未变更自动跳过）；检索阶段用排名算法把自然语言查询与条目匹配，截取最相关的少数记录，格式化为约 450 token 的引用结果卡返回，因此回答长度与数据集规模解耦。

官方链接

GitHub 仓库：https://github.com/elstongun/leviathan