【免费下载链接】cscodespelunker - CLI code search tool that understands code structure and ranks results by relevance. No indexing required with CLI, TUI, MCP and HTTP support.项目地址https://gitcode.com/gh_mirrors/cs/cs点击查看免费下载cscodespelunker是一个无需建立索引的 CLI 代码搜索工具它会把文件解析为代码 / 注释 / 字符串三类内容再按相关性排序。今天重点讲它的结构过滤标志位用--only-comments只搜注释里的 TODO用--only-strings只搜字符串字面量用--only-declarations直跳定义行用--only-usages只找调用点——彻底告别 grep 式翻遍全仓库的低效搜索。为什么 grep 找不到你要的 TODO想象你要在仓库里搜索TODOgrep会把注释、代码、字符串里的所有命中全部打印出来而你要找的可能只是注释里那句待办。反过来找错误提示文案时又不想被同名变量干扰。cs 的思路是既然它本来就在逐字节标注每个字符属于代码、注释还是字符串默认权重 code 1.0 / string 0.5 / comment 0.2那就允许你按内容类型过滤匹配位置。这就是结构过滤标志位的价值。结构过滤标志位速查表 标志位作用典型场景--only-code只保留代码中的匹配找真正的函数调用跳过注释提及--only-comments只保留注释中的匹配搜 TODO / FIXME / HACK--only-strings只保留字符串字面量中的匹配找错误提示、日志文案--only-declarations只显示声明行func、type、class、def等直跳在哪里定义的--only-usages只显示使用行排除声明找所有调用点五个标志位在 main.go 中注册定义互斥性检查见 main.go。场景一--only-comments只搜注释里的待办 ✅这是最经典的用法配合 OR 查询语法把常见标记一次搜齐cs FIXME OR TODO OR HACK --only-commentscs 会在每个命中词的位置上检查它落在哪类内容中不在注释里的匹配直接剔除逻辑实现在 search.go 与 search.go 的filterMatchLocations中。测试用例 search_filter_test.go 也验证了保留注释命中、剔除代码命中的行为。场景二--only-strings定位错误文案 ⚡想知道 error 出现在哪些用户可见文案里而不是变量名或函数名cs error --only-strings这对排查国际化、日志文案、报错提示非常顺手。同理想找某段逻辑在真实代码中的位置而不被文档干扰cs database --only-code场景三--only-declarations直跳定义行搜索一个函数名时通常第一个想要的结果就是它在哪里声明的cs handleRequest --only-declarations # 跳到定义func、class、def 等声明行的识别基于各语言的行首模式Go、Python、JavaScript、TypeScript、Rust、Java、C/C、C#、Ruby、PHP、Kotlin 等 30 种语言的规则表维护在 pkg/ranker/declarations.go。对const、var这类模式还做了精细处理右值上的调用会被归为使用而非声明。场景四--only-usages只找调用点与上一面之镜跳过定义只看谁在用它cs handleRequest --only-usages # 每个调用点跳过定义本身声明/使用的分类由 pkg/ranker/declarations.go 中的ClassifyMatchLocations完成未支持的语言会退化为按文本相关性排序--only-code/comments/strings三个内容过滤则对任何 scc 可识别的语言都有效。注意事项互斥与自动切换 ⚠️五选一不可叠加同时传多个会报错退出error: --only-code, --only-comments, ... are mutually exclusive见 main.go。自动切换排序器使用--only-code/--only-comments/--only-strings时会自动启用structural排序器并给出提示main.go。缓存隔离不同过滤条件会使用独立的缓存前缀见 config.go 的ContentFilterCachePrefix结果不会被串用。可与lang:go、path:pkg、--dedup等过滤器自由组合例如cs TODO --only-comments lang:go,python。不止 CLITUI、HTTP、MCP 里怎么用 TUI 模式裸运行cs进入交互界面按F2即可循环切换default / only-code / only-comments / only-strings / only-declarations / only-usages底部状态栏实时显示当前过滤状态切换逻辑见 tui.go。HTTP 模式cs -d启动本地搜索服务后页面下拉框可直接选择过滤条件本质是 URL 参数cfonly-comments参数解析见 http.go。MCP 模式cs --mcp作为 LLM 工具的 MCP 服务器时search工具提供code_filter参数同样支持这五种取值方便让 AI 编程助手按只搜注释/只找定义的意图检索代码库说明见 mcp.go。快速上手 需要 Go ≥ 1.25.2go install github.com/boyter/cs/v3latest也可以克隆源码构建仓库地址https://gitcode.com/gh_mirrors/cs/cs然后到任意项目目录下试试本文的第一个命令cs FIXME OR TODO OR HACK --only-comments小结你的意图一条命令待办清单cs FIXME OR TODO OR HACK --only-comments错误文案cs error --only-strings找定义cs handleRequest --only-declarations找调用点cs handleRequest --only-usagescs 的结构过滤标志位把内容类型变成了一等公民的搜索维度不用索引、不用插件一条命令就能让 TODO 搜索不再翻遍代码。配合 TUI 的 F2 快捷键或 HTTP 页面的下拉框这套过滤方式可以嵌入你日常的每一个搜索习惯中。赞分享【免费下载链接】cscodespelunker - CLI code search tool that understands code structure and ranks results by relevance. No indexing required with CLI, TUI, MCP and HTTP support.项目地址https://gitcode.com/gh_mirrors/cs/cs点击查看免费下载相关推荐Claude Code 只读搜索 AgentRead-only Search Agent解析大规模扇出代码检索的结论式搜索方案Claude Code 只读搜索 AgentRead only Search Agent解析大规模扇出代码检索的结论式搜索方案 本指南聚焦 Claude文档提示工程人工智能炉石传说插件 HsMod 完整上手指南55 项免费功能从安装到进阶一篇讲透炉石传说插件 HsMod 完整上手指南55 项免费功能从安装到进阶一篇讲透 你刚攒了 60 包卡点开第一包动画播了五秒第二包又是五秒。等机械地点到第游戏开发Android-RobotoTextView完全指南如何在Android应用中优雅集成Roboto字体家族Android RobotoTextView完全指南如何在Android应用中优雅集成Roboto字体家族 Android RobotoTextView是一个创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考