Skip to content

v3.2.0 · 智能路由 + 聚合去重

Choose a tag to compare

View all tags
@cscb603 cscb603 released this 27 Jul 13:24
· 1 commit to main since this release
v3.2.0
586aa18

STS-X v3.2.0（v5.1-3 毕业版）

AST 感知切块 · BM25 极速全文搜索 · 零依赖单二进制 · Mac / Windows 双平台通用
当前形态：行业标杆毕业版 —— 27MB、0.5s 索引、30ms 搜索、中文可用、AI 零摩擦、0 命中能自救

给 AI 用的搜索工具，先解决「搜不到」的绝望

用 AI 写代码时最烦的不是 AI 笨，是搜不到东西时 AI 原地打转——同一个词反复查，越查越空。STS-X 用一句话解决：搜不到时，它告诉你该怎么救。

v5.1 / v5.1-3 新特性

  • 0 命中自救引导（核心）：搜不到时自动返回自救攻略——「换英文关键词（如 缓存→cache）/ 换符号名 / 换文件名 / 加 --path-filter」。中文查询给中文攻略，英文给英文，AI 照着做就能找到，不再死循环。CLI 和 MCP 全路径生效。
  • 有结果更省 token：命中时有结果就直接给结果，不再附带 741 字使用说明（实测 expand 省 38%、file 省 27% 流量）。
  • LLM 缓存友好：输出字段顺序稳定、波动字段置尾——重复查询命中模型前缀缓存（如 DeepSeek 缓存命中价比未命中便宜 50 倍）。
  • 中文可用：中文按 bigram 索引，搜「缓存」能找到 cache.rs；token 估算 CJK 按 1.5 加权，中文项目预算不超量。
  • 过滤全路径生效：--path-filter 在 locate 兜底和 --all 全文件搜索里同样生效。
  • 项目根识别更稳：孤立 package.json 不再误判为项目根（防多项目目录索引整个聚合根），带爬升上限 8。
  • 单测 20 → 28，双平台一致。

v3.2.0 既有能力

  • R1 智能路由：自动判断「符号」走 locate（行级超省 token）、「自然语言」走 expand（整块 AST）。
  • R2 符号快路径：符号查询精确匹配，绕过 BM25，更快更准。
  • R3 聚合去重：同名多命中自动聚合成组，响应体积实测降约 62%。
  • R4 workspace 根探测：多 crate workspace 自动爬真实根，带护栏不退化全局搜索。
  • R5 MCP 支持：stdio MCP 直连（无 Python 桥、无端口），WorkBuddy / Claude Desktop 即插即用。

下载

平台 资产 大小
macOS（arm64） sts-x ~27 MB
Windows（x64） sts-x.exe ~28 MB
Win 发布包（exe+说明书+AGENTS） STS-X-3.2.0-v5.1-3-Win.zip ~6 MB
源码包（双平台同源，解压即编） STS-X-3.2.0-source.zip ~11 MB

解压后放入 PATH：

  • macOS：sudo cp sts-x /usr/local/bin/，终端跑 sts-x --version 应显示 3.2.0
  • Windows：sts-x.exe 直接双击或命令行运行，无需安装、无运行时依赖

用法速览

# 日常首选（AI 智能路由：符号→locate，自然语言→expand）
sts-x ai "查询" -p <项目>

# 行级定位（省 token） / 整块展开（要完整代码）
sts-x search "词" -p <项目> --locate
sts-x search "词" -p <项目> --expand

# 文件名搜索（零索引，rg 后端）
sts-x file "词" -p <目录>

# 精确圈定 / 最近修改 / 省 token
sts-x search "词" -p <项目> --path-filter cache.rs
sts-x search "词" -p <项目> --sort-recent
sts-x search "词" -p <项目> --no-hint

MCP（AI 客户端接入）

sts-x mcp -p <默认项目目录>

WorkBuddy / Claude Desktop 在 MCP 配置里加一行即可，工具自动出现 search 和 file。

Assets 7
Loading