用途
ctx-search 用于检索 context-mode 的持久化 FTS5 知识库，搜索其中此前已索引的本地项目内容、文档或会话记忆。其核心思路是：直接搜索已索引的内容，而不必把原始来源重新读入对话上下文，从而减少上下文占用。
主要能力
- 针对先前索引过的本地项目内容、文档或会话记忆进行检索。
- 基于 context-mode 的持久化 FTS5 知识库。
- 支持批量检索：将相关问题合并到一个 queries 数组中。
- 支持范围限定：当用户指明某个项目或已索引标签时，可用 source 参数限定检索范围。
- 支持通过 MCP 工具与 CLI 两种方式调用。
使用方式
优先使用 ctx_search MCP 工具（当它可用时）。将所有相关问题合并到一个 queries 数组中批量提交；当用户指明项目或已索引标签时，用 source 限定范围；查询应简短、具体，使用两到四个技术术语。
MCP 调用示例：
ctx_search({
source: "project:<name>",
queries: ["authentication middleware", "token refresh"],
limit: 5
})
如果 MCP 工具不可用，则回退到 CLI：
context-mode search "authentication middleware" --source project:<name> --limit 5
如果索引为空，应告知用户先运行 /context-mode:ctx-index 或 context-mode index <path>。
适用场景
- 需要查找此前索引过的本地项目内容、文档或会话记忆时。
- 希望在检索时不把原始来源重新读入对话上下文，以控制上下文规模。
- 需要一次检索多个相关问题，或需要把检索限定在某个项目、某个已索引标签范围内时。
限制
- 依赖 context-mode 已建立的持久化 FTS5 知识库；若索引为空，需先执行索引命令，否则无法检索到内容。
- 调用依赖 ctx_search MCP 工具可用；不可用时需改用 CLI 方式。
- 查询效果与索引内容相关，资料中未提供更多关于索引范围、性能或数据来源限制的说明。