yomu (Thkt)

英语 | 日本语

yomu

AI代理的前端代码搜索。当你不知道代码的名字时，按概念查找代码。

问题

你需要找到聊天流挂钩 vercel/ai （3535个文件），但你不知道函数被调用了 useChat.

典型的代理工作流程：

glob "**/chat*"                                      → 12 files. None are it (it's called use-chat.ts).
grep "stream.*hook"                                  → 0 files.
grep "chat"                                          → too many results. Try reading a few...
read packages/react/src/use-chat.ts                  → Found it. What does it import?
read packages/ai/src/ui/process-ui-message-stream.ts → Now I have context.

3-5次工具调用，反复试验，上下文窗口中有噪音。

与yomu：

yomu search "streaming chat hooks"

## packages/react/src/use-chat.ts
Imports: @ai-sdk/provider-utils, @ai-sdk/ui-utils
Siblings: UseChatOptions [type_def], UseChatHelpers [type_def]

1. useChat [hook] — 58:210 (similarity: 0.85)
export function useChat({ api, ...options }: UseChatOptions): UseChatHelpers {
  ...full function body...
}

## packages/rsc/src/streamable-value/use-streamable-value.ts
2. useStreamableValue [hook] — 12:45 (similarity: 0.72)
...

## examples/ai-e2e-next/.../chat-context.tsx
3. useSharedChatContext [hook] — 8:22 (similarity: 0.68)
...

1个电话。实现是第一个结果——在130个包含“useChat”的文件中，索引中总共有9015个块。

每个结果都包括完整的代码体、文件导入和兄弟定义。不需要后续阅读。

为什么不只是grep？

Claude Code的开发人员发现 这种代理搜索——让模型迭代地使用glob和grep——在代码导航方面优于RAG。他们是对的。当代理可以使用不同的关键字重试、读取目录结构并优化其搜索时，grep的工作效果非常好。

yomu不会与这种工作流程竞争。它 减少迭代次数:

经典的RAG问题——索引同步延迟、陈旧嵌入、冷启动——得到了解决：

当你知道grep的名字时，它是一个合适的工具。yomu是在那之前的一刻——当你知道概念但不知道标识符的时候。

何时使用yomu（何时不使用）

yomu不能取代grep。它涵盖了grep不能的情况：按概念搜索。

设置

安装

brew install thkt/tap/yomu

或者从源代码构建（需要Rust 1.85+）：

cargo build --release

配置

语义搜索使用局部嵌入模型(鲁里V 3约1.2GB）。如果模型已经在本地缓存， search 自动使用它-不需要API密钥。

如果模型未安装或不可用， search 返回到纯文本模式（FTS5）。所有其他命令(index, rebuild, impact, status)没有模型的工作。

没有手动索引。 search 第一次调用时自动索引。

平台说明

命令

全球旗帜

--json 可以出现在子命令之前或之后：

$ yomu --json status
{"files":42,"chunks":187,"embedded_chunks":187,"embeddable_chunks":187,"embed_percentage":100,"references":156,"last_indexed":"2025-03-29 01:23:45"}

yomu search [query] --按概念搜索

返回带有完整上下文的排名结果。每个结果包括：

选项：

--from 使用目标的存储嵌入——不需要重新嵌入：

yomu search --from src/query/mod.rs           # files similar to this file
yomu search --from src/query/mod.rs:rerank    # files similar to this function
yomu search --from src/query/mod.rs "filter"  # hybrid: similar to file + FTS on "filter"

yomu impact --爆炸半径变化

显示哪些文件依赖于目标文件或符号。

$ yomu impact "packages/ai/src/ui/ui-messages.ts" --symbol UIMessage --depth 2

## Impact analysis: `packages/ai/src/ui/ui-messages.ts`

### Direct symbol references
- packages/ai/src/ui/process-ui-message-stream.ts
- packages/react/src/use-chat.ts
  ...34 files

### All transitive dependents
#### Depth 1
- packages/ai/src/ui/process-ui-message-stream.ts
  ...37 files
#### Depth 2
- packages/react/src/use-chat.ts
  ...18 files

Total: 55 dependent file(s)

vercel/ai的实际输出。一个调用替换了手动跟踪导入。

选项： --symbol （可选，过滤到特定导出）， --depth （默认值：3，最大值：10）

--json 返回结构化响应。 dependents[].references 为直接（深度=1）边填充，并列出每个边 (ref_kind, via_symbol) 从源文件中配对。传递性（深度>=2）依赖项通过中间文件到达目标，因此它们的 references 是 []:

{
  "target": "src/storage.rs",
  "in_index": true,
  "dependents": [
    {
      "file_path": "src/indexer.rs",
      "depth": 1,
      "references": [
        {"ref_kind": "named", "via_symbol": "Db"},
        {"ref_kind": "named", "via_symbol": "open_db"}
      ]
    },
    {
      "file_path": "src/main.rs",
      "depth": 2,
      "references": []
    }
  ],
  "symbol_refs": [],
  "total": 2
}

ref_kind 是其中之一 named / default / namespace / type_only / side_effect. via_symbol 是 null 用于名称空间/副作用导入，其中在导入站点上没有命名单个符号。

yomu index / yomu rebuild / yomu status

运作原理

Source files → tree-sitter AST → Semantic chunks → Local embeddings (Ruri v3) → Hybrid search

支持的文件类型

其他文件则退回到基于字符的重叠分块。

局限性

发展

设置

克隆后运行一次：

git config --local core.hooksPath .githooks

这将安装一个运行的预提交钩子 cargo fmt --check 和 cargo clippy --all-targets --all-features -- -D warnings 每次提交之前。违规行为会中止提交。跳过一次提交： git commit --no-verify.

常用命令

cargo test                                                # all tests
cargo clippy --all-targets --all-features -- -D warnings  # lint (matches CI)
cargo fmt -- --check                                      # format check

建筑

src/
├── main.rs              CLI entry point (clap)
├── lib.rs               Crate root, public API
├── config.rs            Runtime configuration
├── modernbert.rs        ModernBERT model (mlx backend)
├── tools/               Application facade — orchestrates indexer, query, storage per command
├── indexer/
│   ├── mod.rs           Orchestration: incremental index, embed budget
│   ├── chunker/         tree-sitter AST → semantic chunks
│   ├── embedder.rs      Local embedding (ModernBERT/Ruri v3 via mlx-rs or candle)
│   └── walker.rs        File discovery, .gitignore filtering
├── resolver.rs          Import path resolution (tsconfig aliases, index.ts probing)
├── query/               Hybrid search + IDF reranking
└── storage/
    ├── mod.rs           Schema, CRUD, types
    ├── search.rs        Vector similarity, name matching, FTS5
    ├── embed.rs         Embedding storage, vec_chunks
    └── graph.rs         Import graph traversal, dependents, siblings

单一二进制，零运行时依赖关系。SQLite和SQLite-vec是静态链接的。

许可证

麻省理工学院