Sym Dex

MCP开发工具

提供方 husnainpk

开发工具 stdio · 本地进程 Token 社区 / 第三方 CursorWindsurfCline
查看接入方式

SymDex是一个面向AI编程代理的本地符号索引引擎,通过创建代码库的符号索引和检索层,减少代理在浏览代码时的盲目性,提供精确的符号、路由、调用关系等检索功能。

一句话选型结论

按资料字段整理

Sym Dex 属于开发工具类 MCP 服务器,stdio · 本地进程,Token,可直接接入 Cursor、Windsurf、Cline,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类开发工具 传输方式stdio · 本地进程 鉴权Token 部署方式本地部署
GitHub 星标 190 仓库热度,无公开仓库时显示未标注
工具数 21 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

开发工具
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量21暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

AI编程辅助Python本地部署代码检索符号索引本地开发工具多语言支持

安装与配置

stdio · 本地进程 Token
客户端在本机拉起子进程,数据不出本机
pip install symdex

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js 等运行时,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 21 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
代码与仓库操作

在对话里直接查代码、提 issue、走 PR,省掉来回切工具。

本地命令与脚本

把构建、测试、格式化这类重复命令交给模型执行。

接口联调与测试

让模型调你的接口、跑一遍用例,快速定位问题。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 21 个工具,覆盖面较广,能满足多种调用。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Cursor、Windsurf、Cline,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好Token对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在开发工具场景里让模型直接调用外部能力的人。
  • 已经在用 Cursor、Windsurf 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Sym Dex当前 21 stdio · 本地进程 本地部署 有 2026-05-17
Git 838e2ec1 12 stdio · 本地进程 本地部署 有 2026-05-17
Markitdown MCP 2c653a5f 1 stdio · 本地进程 本地部署 有 2026-05-17
JavaGuide 未标注 stdio · 本地进程 本地部署 有 2026-04-11
awesome-claude-skills 未标注 stdio · 本地进程 本地部署 有 2026-04-26
Context7 831acf40 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

开发工具
字段来自项目仓库与公开索引,中文说明由本站标注
提供方husnainpk上游标注的维护方 husnainpk
分类开发工具本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式Token远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

28.9 KB
来自项目仓库与上游目录的原文,未做删改

SymDex 的

代理AI系统的符号索引。

SymDex将签出的存储库转换为代码结构、路由、关系、文档、测试和上下文的本地符号索引,因此AI编码代理可以在不首先读取整个文件的情况下进行推理、检索和操作。

From whole-file browsing to exact repo retrieval

Exact symbols, routes, callers, callees, file outlines, semantic matches, and token-budgeted context packs for coding agents.```bash

Install the lean core

pip install symdex

Add local semantic search when you want the sentence-transformers backend

pip install "symdex[local]"

Or install the local semantic backend as an isolated CLI tool

uv tool install "symdex[local]"

Or run without installing

uvx symdex --help

Upgrade an existing install

py -m pip install -U symdex
uv tool upgrade symdex
uvx symdex@latest --help

Install the SymDex agent skill globally for supported agents

npx skills add https://github.com/husnainpk/SymDex --skill symdex-code-search --yes --global


______________________________________________________________________

## SymDex做什么

SymDex是一个用于AI编码代理的repo本地符号索引引擎。它将项目映射到精确的符号、文件、路由、关系、文档、测试和检索上下文中,然后通过CLI命令和MCP工具公开该映射。

AI编码代理是有用的,直到他们不得不从头开始重新发现你的仓库。他们打开整个文件,grep宽模式,错过路由处理程序,两次读取相同的实用程序,并花费数千个令牌来进行定向。

SymDex在代理开始读取代码之前为其提供了一个repo本地检索层。您将索引保留在计算机上,仅在语义搜索有用时选择嵌入后端,并通过CLI命令和MCP工具公开相同的项目映射。

它将您的项目索引到一个小型的本地SQLite知识库中,包括:

- 精确的符号和字节偏移
- 文件大纲和回购摘要
- 文字文本搜索
- 可选语义搜索
- 调用者、被调用者和循环依赖性检查
- 提取的HTTP路由
- 查询驱动的上下文包,从符号、路线、文档、测试、文本、图邻居和可选的语义匹配中组装小证据包
- 用于新鲜度、置信度、解析器模式、生成路径和嵌入可用性的检索质量元数据
- 一个repo、多个repo或多个工作树的注册表

然后,代理可以要求他们需要的窄切片:函数、路由、调用链、文件大纲、意图匹配,或者更广泛的功能问题的令牌预算上下文包。这意味着更少的盲目浏览,更少的上下文浪费,以及可以解释SymDex节省了多少代币预算的响应。

SymDex是本地第一。基础 `symdex` 保持符号、文本、路线、图形和MCP特征的精简。安装 `symdex[local]` 只有当你想要本地语义嵌入时,或者当你想要远程嵌入时,将托管后端指向Voyage、OpenAI兼容服务、Gemini或兼容的代理。

此结账中的当前产品功能:

- 当前版本 `0.1.26`;最新公共标签 `v0.1.26`
- 21个MCP工具,涵盖索引、搜索、上下文包、大纲、路由、统计、图形、缓存失效和过时索引清理
- 21种语言界面,包括HTML、CSS、Shell、Svelte、Markdown标题和支持的围栏代码块
- 通过Kotlin、Dart和Swift解析器目标覆盖Android、Flutter和iOS
- 跨Python、JavaScript/TypeScript、Spring/Kotlin、Laravel、Gin-style Go、ASP的路由提取。NET、Rails/Sinatra、Phoenix和Actix
- 成功搜索命令后的一行CLI令牌节省脚注
- 主控程序 `roi`, `roi_summary`,以及 `roi_agent_hint` 字段,以便代理在最终响应中提及节省
- MCP和CLI JSON `quality` 字段,以便代理在从结果推理之前判断置信度、索引新鲜度、解析器模式、生成的路径和嵌入可用性
- `symdex pack` 和MCP `build_context_pack` 用于查询形状、令牌预算的证据包
- 局部语义后端 `sentence-transformers`,Voyage,兼容OpenAI `/embeddings`,以及Gemini嵌入
- `SYMDEX_EMBED_RPM` 托管嵌入提供程序的请求速度
- `symdex index --lazy` 在后台观察器中构建嵌入时快速进行前台结构索引
- 低的 `symdex watch` 默认情况下:结构刷新,不加载嵌入模型,除非 `--embed` 已通过
- 重复观察程序保护、空闲自动退出和状态感知观察程序元数据
- 本地工作区 `./.symdex` Docker、可移植工作区和不希望索引隐藏在主目录中的团队的状态
- 带有确切信息的升级通知 `pip`, `uv tool`,以及 `uvx` 存在较新版本时的命令

______________________________________________________________________

## SymDex代理技能

当您希望受支持的代理在广泛浏览文件之前使用SymDex时,请安装SymDex代码搜索技能:```bash
npx skills add https://github.com/husnainpk/SymDex --skill symdex-code-search --yes --global

如果您希望使用交互式安装程序,请省略 --yes --global.

技能告诉特工:

  • 首先检查回购和索引准备情况
  • 在广泛的Read/Grep/Glob发现之前使用SymDex进行搜索
  • 与完整文件读取相比,更喜欢符号级和轮廓级检索
  • 当调用者、被调用者、路由、仓库统计和语义搜索更适合时,使用它们
  • 在多次单独搜索之前,使用上下文包回答更广泛的“此功能如何工作?”问题
  • 当SymDex不可用或语义嵌入尚未构建时,可以明显回退
  • 保持工作流程以较低令牌代码检索为中心,而不是广泛的文件读取

该技能存在于以下仓库中 skills/symdex-code-search/SKILL.md 并遵循标准 skills//SKILL.md 布局。

通过安装 skills CLI使用与skills.sh索引相同的公共路径。


60秒快速入门```bash

Install the lean core

pip install symdex

or

uv tool install symdex

Index a project

symdex index ./myproject --repo myproject

Search by symbol name

symdex search "validate_email" --repo myproject

Search by literal text

symdex text "JWT" --repo myproject

Add local semantic search only when you want embeddings

pip install "symdex[local]"

Search by intent

symdex semantic "check email format" --repo myproject

Build a token-budgeted context pack for an agent

symdex pack "how checkout auth works" --repo myproject --budget 6000

Show HTTP routes

symdex routes myproject -m POST

Start the MCP server

symdex serve


笔记:

- 如果你忽略了 `--repo` 上 `symdex index` 或 `symdex watch`,SymDex会自动从当前的git分支和工作树路径哈希生成一个稳定的repo id。
- 索引后,SymDex会打印一个代码摘要。
- 成功执行搜索命令后,SymDex会打印一行ROI页脚,其中包含大致的令牌节省。
- MCP搜索工具也返回 `roi_agent_hint`,因此代理可以将节省的资金折叠到面向用户的响应中,而不是将其埋在日志中。
- 当存在较新的PyPI版本时,正常的CLI命令会打印精确的升级命令 `pip`, `uv tool`,以及 `uvx`.
- 集 `SYMDEX_STATE_DIR=.symdex` 关于保存回购数据库的第一个索引, `registry.db`,以及 `registry.json` 在当前工作空间内。之后,从工作区运行的命令会自动发现本地状态。
- `--state-dir` 可以全局传递,也可以在子命令之后传递,例如 `symdex --state-dir .symdex repos` 或 `symdex repos --state-dir .symdex`.
- 规范CLI命令包括 `index` 和 `repos`.Shell兼容性别名也接受MCP形状的名称,如 `index-folder`, `index-repo`,以及 `list-repos`.
- 语义搜索需要存储嵌入。如果在启用所需的后端之前对仓库进行了索引,请使用重新索引 `symdex index`, `symdex index --lazy`,或 `symdex watch --embed`.

添加到您的代理配置中:```json
{
"mcpServers": {
"symdex": {
"command": "uvx",
"args": ["symdex", "serve"]
}
}
}

HTTP模式:```json
{
"mcpServers": {
"symdex": {
"url": "http://localhost:8080/mcp"
}
}
}


______________________________________________________________________

## 工作区本地状态和Docker

SymDex默认为 `~/.symdex` 并且还支持用于可移植和容器化工作流的工作区本地状态目录。

在第一次设置时这样使用它:```bash
SYMDEX_STATE_DIR=.symdex symdex index ./myproject --repo myproject

这会产生:

  • ./.symdex/.db
  • ./.symdex/registry.db
  • ./.symdex/registry.json

registry.json 是人类可读的清单。在工作区本地模式下,它存储相对 root_path 和 db_path 值,因此您可以在不打开SQLite的情况下检查索引的内容。

本地状态存在后,SymDex会自动从当前工作区或任何嵌套子目录中发现它。


你得到了什么

功能 详细信息
符号搜索 查找具有精确字节偏移的函数、类和方法
语义搜索 按意图而不是确切名称查找代码
文本搜索 在存储库中按文本搜索索引文件
字节精确检索 只读所需的符号跨度
文件大纲 列出文件中的符号,而不传输整个文件
回购大纲 通过MCP获取目录树和回购摘要
调用图 跟踪调用者、被调用者和循环依赖关系
HTTP路由 提取Flask、FastAPI、Django、Express、Spring/Kotlin、Laravel、Gin-style Go、ASP。NET、Rails/Sinatra、Phoenix和Actix路线
上下文包 从符号、路由、文本、文档、测试、图邻居和可选语义匹配中构建令牌预算证据包
Markdown感知文档 为SDK文档、规范、仓库文档和设计说明索引Markdown标题和支持的围栏代码块
自动监视 更改时重新索引,避免重复监视,默认情况下保持低内存,空闲后自动退出
跨仓库注册表 从一个本地注册表管理多个索引仓库
工作区本地状态 保留仓库数据库, registry.json,以及内部的观察者元数据 ./.symdex 适用于Docker和可移植工作区
搜索ROI页脚 成功搜索命令后,一行近似的代币节省
代理ROI提示 MCP工具返回 roi_agent_hint 因此,代理人可以在回复中自然地提及节省
检索质量元数据 MCP和CLI JSON输出揭示了可信度、新鲜度、解析器模式、语言表面、生成的文件提示和嵌入可用性
代码摘要 索引后的文件、代码行、符号、路由、跳过的文件和语言
可选嵌入后端 使用本地嵌入、Voyage、OpenAI兼容 /embeddings、Gemini,或仅在需要时使用兼容的代理

SymDex适合哪里

人工智能代码库工具现在分为几个强大的类别:企业代码搜索、IDE原生助手、LSP支持的代理工具包、仓库映射系统和整个仓库提示打包器。SymDex位于一个更窄但有用的位置:一个本地第一检索层,它结合了精确的符号、文本搜索、可选的语义搜索、查询驱动的上下文包、HTTP路由、调用者、被调用者、文件大纲、仓库大纲、Markdown/围栏代码索引、仓库统计、令牌节省提示、检索质量元数据、CLI访问和MCP访问,而不需要编辑器会话或托管索引。

这使得当代理需要一个可移植的代码库映射时,SymDex最强大,它可以在读取文件之前查询。

需求 常见匹配 SymDex适合的地方
跨多个托管存储库的企业代码搜索 Sourcegraph风格的代码搜索 SymDex更小,本地优先;它侧重于从检出的工作树中检索代理,而不是企业代码搜索操作
IDE原生代码库聊天和自动补全 游标、Continue、Cody和类似的编辑器助手 SymDex与编辑器无关;代理可以从终端、stdio MCP或HTTP MCP客户端使用相同的仓库索引
IDE级语义检索和重构 LSP支持的工具和Serena风格的代理工具包 SymDex并不试图成为重构引擎;它侧重于代理在决定编辑什么之前所需的检索原语
整个存储库上下文打包 Repomix和其他提示打包工具 SymDex从索引证据构建查询驱动的上下文包,而不是将整个存储库打包到一个提示工件中
用于编码会话的代理仓库映射 Aider风格的仓库映射 SymDex公开了可查询索引、令牌预算上下文包、路由、调用图、Markdown标题、语义搜索、ROI提示和检索质量元数据,而不仅仅是一个压缩的映射
跨代码和文档的轻量级本地检索 SymDex SymDex的优势是组合表面:CLI+MCP、SQLite索引、21种语言表面、上下文包、路由提取、调用图、Markdown/MDX支持、检索质量信号、可选嵌入、低内存监视和工作区本地状态

当你需要深度类型系统推理或编辑器原生重构时,使用语言服务器。当您需要组织范围内的搜索、权限和代码监控时,请使用企业代码搜索平台。当您想将整个仓库快照交给模型时,使用提示打包器。当您希望AI编码代理在使用令牌读取文件之前询问精确的仓库本地问题时,请使用SymDex。


CLI参考```bash

Indexing and maintenance

symdex index ./myproject --repo myproject # Index with an explicit repo id
symdex index ./myproject # Auto-name from git branch + path hash
symdex index ./myproject --repo myproject --no-embed # Skip semantic embedding work
symdex index ./myproject --repo myproject --lazy # Index code now, embed in a background watcher
symdex watch ./myproject --repo myproject # Keep an index fresh without loading embedding models
symdex watch ./myproject --repo myproject --embed # Also refresh semantic embeddings on change
symdex invalidate --repo myproject # Force re-index of a repo
symdex invalidate --repo myproject --file app.py
symdex gc # Remove stale index databases
symdex repos # List indexed repos

Search

symdex search "validate_email" --repo myproject
symdex search "validate_email" # Search across all indexed repos
symdex find validate_email --repo myproject # Exact lookup
symdex text "JWT" --repo myproject
symdex semantic "check auth token" --repo myproject
symdex pack "how auth token refresh works" --repo myproject --budget 6000
symdex pack "document checkout API" --repo myproject --include routes,docs,tests --format json

Navigation

symdex outline auth/utils.py --repo myproject
symdex callers validate_email --repo myproject
symdex callees validate_email --repo myproject
symdex routes myproject
symdex routes myproject --method POST
symdex routes myproject --path /api

Server

symdex serve
symdex serve --port 8080


MCP目前公开了其他未作为专用CLI命令显示的repo树和repo统计视图: `get_file_tree`, `get_repo_outline`, `get_index_status`,以及 `get_repo_stats`.

______________________________________________________________________

## MCP工具

SymDex目前公开了21个MCP工具:

|工具|目的|
|---|---|
| `index_folder` |为本地文件夹建立索引并返回索引统计信息|
| `index_repo` |为回购建立索引并在中央注册表中注册|
| `search_symbols` |按名称查找函数、类和方法|
| `semantic_search` |使用嵌入相似性按意义查找符号|
| `search_text` |按文本搜索索引文件并返回匹配的行|
| `build_context_pack` |为代理查询构建令牌预算证据包|
| `get_symbol` |按字节偏移量读取一个符号|
| `get_symbols` |批量精确名称符号查找|
| `get_file_outline` |在单个文件中列出符号|
| `get_file_tree` |返回一个没有文件内容的目录树|
| `get_repo_outline` |返回回购树和摘要统计信息|
| `get_callers` |返回调用命名函数的符号|
| `get_callees` |返回由命名函数调用的符号|
| `search_routes` |查询提取的HTTP路由|
| `get_index_status` |返回符号计数、文件计数、代码行数、过期时间和观察者状态|
| `get_repo_stats` |返回回购指标,如语言组合、扇入、扇出和循环依赖计数|
| `get_graph_diagram` |生成Mermaid调用图|
| `find_circular_deps` |检测循环依赖关系|
| `list_repos` |列出所有索引仓库|
| `invalidate_cache` |下次使用时强制重新索引|
| `gc_stale_indexes` |删除磁盘上不再存在的存储库的索引数据库|

______________________________________________________________________

## 支持的语言

python `.py` |
JavaScript · `.js`, `.jsx`, `.mjs`, `.cjs`, `.cjsx`, `.mjsx`
TypeScript · `.ts`, `.tsx`, `.mts`, `.cts`, `.mtsx`, `.ctsx`
去吧 · `.go`
生锈 · `.rs`
Java `.java` |
Kotlin · `.kt`, `.kts`
飞镖 · `.dart`
Swift · `.swift`
PHP · `.php`
C `.cs` |
C `.c` |
C `.h`, `.hh`, `.hpp`, `.hxx`, `.cpp`, `.cc`, `.cxx` |
HTML · `.html`, `.htm`
CSS · `.css`, `.scss`, `.sass`, `.less`, `.stylus`, `.styl`
壳牌 · `.sh`, `.bash`, `.zsh`
灵丹妙药 · `.ex`, `.exs`
红宝石 · `.rb`
查看 · `.vue` 解析为JavaScript或TypeScript的脚本块
斯维尔特 · `.svelte` 解析为JavaScript或TypeScript的脚本块
Markdown · `.md`, `.markdown`, `.mdx` 标题加上支持的围栏代码块

由...驱动 树保姆 用于代码,语言包语法回退,以及用于标题和围栏代码示例的本地Markdown扫描器。

______________________________________________________________________

## 支持的平台

SymDex适用于任何支持stdio或流式HTTP的MCP客户端。

|平台|典型设置|
|---|---|
|Codex CLI |添加到MCP设置|
|Gemini CLI |添加到MCP设置|
|光标| `.cursor/mcp.json` |
|Windsurf |添加到MCP设置|
|GitHub副本| `.vscode/mcp.json` |
|Roo |添加到MCP设置|
|Continue.dev| `config.json` |
|Cline|添加到MCP设置|
|千码| VS码MCP设置|
|Zed |添加到MCP设置|
|OpenCode| `opencode.json` |
|任何MCP客户端| `uvx symdex serve` 或 `symdex serve --port 8080` |

______________________________________________________________________

## 语义嵌入后端

基础 `symdex` 仅安装贫芯。选择与语义搜索工作方式相匹配的嵌入额外内容:

- `symdex[local]` 用于本地 `sentence-transformers`
- `symdex[voyage]` 用于Voyage文本嵌入
- `symdex[voyage-multimodal]` 适用于Voyage文本、图像和PDF

远程OpenAI兼容和Gemini后端使用Python标准库HTTP客户端,因此它们不添加所需的依赖关系。

### 本地模式```bash
pip install "symdex[local]"

SYMDEX_EMBED_BACKEND=local \
SYMDEX_EMBED_MODEL=all-MiniLM-L6-v2 \
symdex index . --repo myrepo

航行文本模式```bash

pip install "symdex[voyage]"

SYMDEX_EMBED_BACKEND=voyage \
VOYAGE_API_KEY=... \
SYMDEX_VOYAGE_MODEL=voyage-code-3 \
symdex index . --repo myrepo

SYMDEX_EMBED_BACKEND=voyage \
VOYAGE_API_KEY=... \
symdex semantic "parse source code" --repo myrepo


### OpenAI兼容模式

将其用于OpenAI、本地OpenAI兼容服务器和暴露 `POST /embeddings`.```bash
SYMDEX_EMBED_BACKEND=openai \
SYMDEX_EMBED_BASE_URL=https://api.openai.com/v1 \
SYMDEX_EMBED_MODEL=text-embedding-3-small \
SYMDEX_EMBED_API_KEY=... \
SYMDEX_EMBED_RPM=60 \
symdex index . --repo myrepo --lazy

对于本地或代理提供程序,设置 SYMDEX_EMBED_BACKEND=custom,点 SYMDEX_EMBED_BASE_URL 在其 /v1 基本URL,并设置它所期望的模型名称。如果提供程序不需要API密钥,则忽略 SYMDEX_EMBED_API_KEY.

Gemini模式

Gemini使用 RETRIEVAL_DOCUMENT 当索引和 RETRIEVAL_QUERY 搜索时。```bash
SYMDEX_EMBED_BACKEND=gemini \
GEMINI_API_KEY=... \
SYMDEX_EMBED_MODEL=text-embedding-004 \
SYMDEX_EMBED_RPM=60 \
symdex index . --repo myrepo --lazy


### 航行多式联运模式```bash
pip install "symdex[voyage-multimodal]"

SYMDEX_EMBED_BACKEND=voyage
SYMDEX_VOYAGE_MULTIMODAL=1
VOYAGE_API_KEY=...
SYMDEX_VOYAGE_MULTIMODAL_MODEL=voyage-multimodal-3.5
symdex index . --repo myrepo

多模式模式允许SymDex将支持的图像、屏幕截图和PDF作为可搜索的资产条目进行索引。

笔记:

  • 基础 symdex 保留符号、文本、路由和调用图特征,而无需拉入本地嵌入堆栈。
  • 如果 SYMDEX_EMBED_BACKEND 如果未设置,SymDex在以下情况下使用本地后端 symdex[local] 已安装。
  • 本地语义搜索需要 symdex[local] 并在首次使用时下载该模型。
  • 航行文本模式需要 symdex[voyage].
  • 航行多式联运模式需要 symdex[voyage-multimodal].
  • OpenAI兼容模式读取 SYMDEX_EMBED_BASE_URL, SYMDEX_EMBED_MODEL,可选 SYMDEX_EMBED_API_KEY 或 OPENAI_API_KEY.
  • Gemini模式读取 SYMDEX_EMBED_MODEL, SYMDEX_EMBED_BASE_URL,以及 SYMDEX_EMBED_API_KEY, GEMINI_API_KEY,或 GOOGLE_API_KEY.
  • SYMDEX_EMBED_RPM 将请求定步应用于远程后端。当免费层或代理强制执行每分钟请求限制时,请使用它。
  • symdex index --lazy 首先执行快速结构索引,然后启动后台 symdex watch --embed 这样嵌入就可以在不阻塞前台命令的情况下填充。
  • symdex index --no-embed 完全跳过语义嵌入工作。
  • 如果缺少所选的后端额外功能,SymDex会打印一个可操作的安装提示。
  • 多模态索引仅在以下情况下处于活动状态 SYMDEX_VOYAGE_MULTIMODAL=1.

常见问题

什么是SymDex?

SymDex是一个用于AI编码代理的repo本地符号索引引擎。它将项目索引到本地SQLite知识库中,这样代理就可以检索精确的符号、文件大纲、HTTP路由、调用者、被调用者、文本匹配、语义匹配、令牌预算上下文包和仓库摘要,而无需先读取整个文件。

SymDex为AI编码代理解决了什么问题?

SymDex减少了盲目的回购浏览。代理可以向SymDex询问当前任务所需的特定函数、路由处理程序、调用图边缘、Markdown标题或文件大纲,而不是打开宽泛的文件并在方向上花费数千个令牌。

SymDex可以帮助代理查找错误或检查代码逻辑吗?

是的,作为代码理解和证据层。SymDex本身并不能证明错误,也不是一个完整的静态分析器。它通过检索精确的定义、调用者、被调用者、路由、文件大纲、文本匹配、语义匹配、文档锚和查询驱动的上下文包来帮助代理调查逻辑,然后附加高质量的元数据,以便代理在提出索赔之前可以查看证据是否新鲜、解析器支持、生成或缺少嵌入。

SymDex是MCP服务器吗?

对。SymDex包括一个MCP服务器,其中有21个工具,用于索引、符号搜索、语义搜索、文本搜索、上下文包、文件大纲、存储库大纲、路由搜索、调用图遍历、存储库统计、缓存失效和过时索引清理。它还为同一仓库本地检索工作流提供CLI命令。

哪些AI编码代理可以使用SymDex?

任何支持stdio或流式HTTP的MCP客户端都可以使用SymDex。典型的设置包括Codex CLI、Gemini CLI、Cursor、Windsurf、GitHub Copilot、Roo、Continue.dev、Cline、Kilo Code、Zed、OpenCode和其他MCP兼容客户端。

SymDex与grep、ripgrep、嵌入或LSP有何不同?

SymDex将精确的结构搜索与可选的语义搜索和令牌预算上下文包相结合。Grep和ripgrep查找文本;语言服务器提供编辑器本机类型的导航;只嵌入系统可以找到近似意义;整个repo打包器会产生大量的提示工件。SymDex为代理提供了一个预先索引的本地映射,在一个工作流中包含符号、字节偏移、路由、调用图、文本搜索、语义搜索、质量元数据、上下文包和MCP工具。

SymDex会取代语言服务器吗?

不。SymDex不是一个完整的类型检查器或自动重构引擎。当编辑器本机类型推理或重构很重要时,使用语言服务器。当代理需要快速的仓库本地检索、路由发现、代码大纲、语义搜索、上下文包和跨一个或多个仓库的低令牌导航时,请使用SymDex。

SymDex索引哪些语言和文件?

SymDex目前涵盖了21种语言:Python、JavaScript、TypeScript、Go、Rust、Java、Kotlin、Dart、Swift、PHP、C#、C、C++、HTML、CSS家族样式表、Shell、Elixir、Ruby、Vue脚本块、Svelte脚本块和Markdown。Markdown支持包括 .md, .markdown,以及 .mdx 标题加上支持的围栏代码块。

SymDex可以提取HTTP路由吗?

对。SymDex提取跨Python、JavaScript/TypeScript、Spring/Kotlin、Laravel、Gin-style Go、ASP的HTTP路由。NET、Rails/Sinatra、Phoenix和Actix。代理可以直接查询路由,而不是手动扫描路由器、装饰器、控制器或框架入口点。

SymDex是否帮助文档、SEO或生成引擎优化团队?

是的,当技术内容依赖于代码库时。文档、SEO和生成引擎优化(GEO)团队可以使用SymDex-powered代理构建源代码支持的上下文包,查找SDK示例、API路由、Markdown标题、功能实现和源代码支持答案,然后再更新开发人员文档、变更日志、比较页面或AI搜索友好的技术内容。SymDex是一个代码检索层,而不是关键字研究或排名跟踪工具。

语义搜索需要互联网吗?

不,默认情况下不是。安装 symdex[local] 用于本地 sentence-transformers 语义搜索;模型下载一次,然后脱机运行。Voyage、OpenAI兼容和Gemini嵌入模式需要网络访问,除非配置的基本URL指向本地服务器或私有代理。

SymDex可以在没有语义嵌入的情况下运行吗?

对。 pip install symdex 保持核心符号、文本、路由、文件大纲、仓库大纲、调用图和MCP功能的精简。使用 symdex index --no-embed 完全跳过嵌入工作,或稍后添加嵌入 symdex[local]、Voyage、OpenAI兼容、Gemini、, symdex index --lazy,或 symdex watch --embed.

为什么 symdex semantic 假设一个repo没有语义嵌入?

该仓库在没有嵌入后端的情况下进行了索引,并使用 --no-embed,或通过默认的低内存监视模式保持新鲜。启用所需的后端,然后运行 symdex index, symdex index --lazy,或 symdex watch --embed 因此,语义向量被写入索引中。

意志 symdex watch 在内存中保留一个大的嵌入模型?

不,默认情况下不是。 symdex watch 刷新结构索引而不加载本地嵌入模型,除非 --embed 已通过。监视模式还拒绝同一repo/root的重复监视程序,可以在空闲时间后自动退出,并将监视程序元数据存储在活动状态目录中。

SymDex索引存储在哪里?

默认情况下,每个仓库都有自己的SQLite数据库 ~/.symdex,以及一个中央注册数据库。集 SYMDEX_STATE_DIR=.symdex 或使用 symdex --state-dir .symdex ... 为了保持仓库数据库, registry.db, registry.json,以及当前工作区内的观察者元数据。

SymDex可以跨多个仓库和工作树工作吗?

对。SymDex维护一个索引仓库的注册表,支持显式 --repo 名称,并且可以在以下情况下从当前分支和工作树路径自动生成稳定的仓库id --repo 省略。使用 symdex repos 列出索引和 symdex gc 在删除工作树后清理过时的条目。

SymDex如何报告代币节省?

成功的CLI搜索命令会打印一行ROI页脚,其中包含大约节省的令牌。MCP搜索工具返回结构化 roi, roi_summary,以及 roi_agent_hint 字段,以便代理可以在面向用户的响应中提及检索节省。

什么是SymDex检索质量信号?

MCP结果和CLI JSON输出包括 quality 具有以下字段的对象 confidence, confidence_reason, index_fresh, last_indexed, parser_mode, language_surface, is_generated, has_embeddings,以及 route_confidence。代理可以使用这些字段来避免过度信任过时的索引、回退文本匹配、生成的文件或来自存储库的语义搜索,而无需嵌入。

索引打印什么?

索引后,SymDex会打印一个代码摘要,其中包含文件计数、代码行数、符号计数、路由计数、跳过的文件、错误和语言细分。这有助于团队在依赖搜索结果之前确认索引内容。

可以排除生成的文件吗?

对。添加a .symdexignore 使用gitignore样式模式在repo根目录下创建文件。默认情况下,SymDex还会跳过常见的生成、依赖和构建路径。

为什么有些日志说 index_folder 或 list_repos 而CLI文档说 index 和 repos?

index_folder 和 list_repos 是MCP工具名称。规范的shell命令是 symdex index 和 symdex repos,以及兼容性别名,例如 symdex index-folder 和 symdex list-repos 也被接受。

现有用户是否收到更新通知?

对。交互式CLI命令可以打印简短的升级通知,其中包含以下确切命令 pip, uv tool,以及 uvxJSON输出保持安静,因此结构化消费者不会被破坏。

SymDex可以在没有AI代理的情况下使用吗?

对。所有核心搜索和导航功能都可以通过CLI使用,包括符号搜索、精确查找、文本搜索、语义搜索、上下文包、路由搜索、调用者、被调用者、大纲、仓库列表和过时索引清理。


贡献

欢迎发布问题和PR github/husnainpk/SymDex.

如果SymDex为你保存了代币,那么一颗星星会帮助其他人找到它。

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Sym Dex 怎么安装?

在客户端按下面的安装命令接入:pip install symdex。装完在客户端配置里引用同一个包或端点。

Sym Dex 怎么在 Cursor、Windsurf、Cline 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Sym Dex 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Sym Dex 需要 API Key 吗?

资料标注需要Token认证,使用前准备好对应凭据,并按最小权限配置。

Sym Dex 支持哪些客户端?

资料标注支持 Cursor、Windsurf、Cline;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Sym Dex 能提供哪些能力?

资料显示约 21 个工具;能力标签包括 AI编程辅助、Python、Cline。具体工具清单以官方文档为准。

Sym Dex 需要什么运行环境?

属于本地进程,需要在本机装好运行环境。

Sym Dex 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。