osgrep
为AI编码助手提供本地语义搜索，精准定位代码概念。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：osgrep。 它的用途是：为AI编码助手提供本地语义搜索，精准定位代码概念。 完整的 Skill 内容见：https://321skill.com/skills/osgrep/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我查一下用户登录的密码校验逻辑在哪里实现的？”，AI会调用 osgrep 在代码库中进行语义搜索，快速定位到处理认证和密码校验的相关函数及文件，并展示其上下文和调用关系，帮助你迅速理解该模块的实现。
介绍
osgrep 是一款专为AI编码代理设计的本地语义搜索工具，旨在解决开发者在庞大代码库中快速、精准定位功能模块和逻辑概念的难题。它能够理解自然语言查询（如“身份验证在哪里处理？”），并返回语义相关的代码片段，而不仅仅是关键词匹配。
使用上，开发者只需通过 npm 全局安装 osgrep，在项目根目录运行 osgrep setup 下载模型，之后即可通过 osgrep "你的问题" 进行搜索。工具会自动为每个仓库创建独立的索引，并支持后台服务模式以加速搜索。除了搜索，它还提供 trace 命令来可视化函数调用图，帮助理解代码依赖关系。
它非常适合需要频繁查阅和理解代码库的开发者，尤其是使用 Claude Code、OpenCode 等AI编码助手的用户。通过将语义搜索能力集成到AI助手中，可以显著减少AI在理解代码上下文时消耗的Token，提升交互效率和准确性。
建议在使用前对代码库进行完整索引以获得最佳体验。由于模型在本地运行，首次使用需要下载约150MB的嵌入模型，但能确保代码的完全私密性。
核心特点
与传统的基于字符串匹配的代码搜索工具（如 grep）不同，osgrep 的核心在于语义理解，能根据概念而非字面意思查找代码。此外，它原生集成了调用图追踪（trace）和代码角色（如编排逻辑 vs. 类型定义）检测功能，专为增强AI编码代理的上下文理解能力而设计。
注意事项
不适合需要搜索非代码文本文件（如纯文本文档、日志）或进行简单字符串精确匹配的场景。
常见问题
osgrep 和 grep 有什么区别？
grep 是精确字符串匹配，osgrep 是基于自然语言理解的语义搜索，能回答“在哪里处理XX功能？”这类概念性问题。
我的代码数据会上传到云端吗？
不会。osgrep 使用本地 ONNX 模型进行嵌入计算，所有索引和搜索过程均在本地完成，确保隐私。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/osgrep/raw/index.md 读取 osgrep 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/osgrep/raw/index.md（查看排版版本）