STS-X v0.2.0
面向 AI Agent 的下一代代码搜索引擎 — AST 感知切块 + BM25 全文搜索 + MCP 原生协议,17MB 单二进制零依赖,开箱即用。
v0.1.0 → v0.2.0 更新内容
🧠 AI 原生设计
| 改进 |
说明 |
v0.1.0 |
v0.2.0 |
| 自说明响应 |
每个 JSON 响应自带 _ai_instructions |
❌ |
✅ |
| 工具发现 |
MCP GET /tools 端点 |
❌ |
✅ |
| 服务自文档 |
MCP GET / 端点 |
❌ |
✅ |
| 默认 top_k |
AI 场景优化 |
5 |
3 |
| 默认 context_lines |
上下文行数 |
8 |
5 |
| /health 方法 |
规范 RESTful |
POST |
GET |
🔧 索引自动化
- 索引自动存入系统缓存目录(macOS:
~/Library/Caches/sts-x/,Windows: %LOCALAPPDATA%/sts-x/cache/)— 不再污染项目目录
- 项目根自动探测(13 种标记文件:.git / Cargo.toml / package.json / go.mod / pom.xml 等)
- 文件变更自动检测 + 索引过期重建
🎯 代码后处理
highlight_lines 字段:精确标注查询词在代码块中的行号
--context N 参数:控制匹配行上下文的行数
- 搜索结果经 postprocess 计算后返回高质量上下文
🌐 跨平台兼容
- Windows POSIX 路径归一化:git bash 传入的
/d/项目 自动转为 D:\\项目
- 新增 Go 语言 AST 支持(tree-sitter-go)
- 自定义 code 分词器,无停用词过滤
- 修复所有 clippy 警告(10 个 lint)
快速上手
# macOS 安装
curl -L https://github.com/cscb603/sts-x/releases/latest/download/sts-x-aarch64-apple-darwin -o sts-x && chmod +x sts-x
sudo mv sts-x /usr/local/bin/
# 直接搜索(自动索引项目)
cd /your-project
sts-x search "token verification"
# MCP 服务模式
sts-x serve
curl -X POST http://127.0.0.1:9876/search -H "Content-Type: application/json" -d '{"query":"search"}'
下载