开箱即用，以下全部可选。

变量	默认	说明
`DSH_FORGE_DATA_DIR`	`~/.dsh/forge`	frecency 统计、查询历史、快照、验证与工程私有数据的主目录；不再使用卡片缓存。
`DSH_FORGE_GRAMMAR_DIR`	随包预装	Tree-sitter WASM 语法目录。
`DSH_FORGE_AST_WORKERS`	自动，≤ `8`	符号与 Trace 共用的 Worker 池。`0` 强制顺序，`1..8` 指定上限。
`DSH_FORGE_INDEXER`	自动	原生 sidecar 开关，`0` / `off` 关闭。启动或读取失败自动回退 WASM。
`DSH_FORGE_INDEXER_BIN`	未配置	指向本机的 sidecar 二进制；源码 checkout 也会发现 `rust_indexer/bin`。npm 包不捆绑平台二进制。
`DSH_FORGE_SEARCH_NATIVE`	自动	原生 `glob` / `grep` 开关，`0` / `false` / `off` 时交回宿主内置工具。
`DSH_FORGE_TRACE_NATIVE`	自动	sidecar 可用时用原生提取源码事实，`0` / `off` 保持 WASM。
`FORGE_GLOBAL_INDEX`	`auto`	字面名机器索引后端（旧文档称 `mode=name`，当前公开参数不接受 mode）。`auto`：Windows 上找到 `es.exe` 就用，其余情况静默走 fff。`everything`：强制启用，不可用时在结果里说明原因。`off`：关闭。
`FORGE_ES_PATH`	自动发现	`es.exe` 路径；不配则依次查 `PATH` 与 `Program Files\Everything`。
`FORGE_CONTENT_INDEX`	关	`1` 恢复 fff 的 mmap 缓存与内容索引。仅当进程只开一个索引根时使用——开着它再建第二个索引会让后续索引永久停在扫描中（引擎 0.11.0 缺陷）。

原生加速是可选的：源码 checkout 里装 Rust 1.88+ 后执行 pnpm run build:indexer，产物进 rust_indexer/bin。启用后 Trace 冷启动不再加载 WASM 语法，峰值内存约降一个数量级。

默认只注册检索工具。需要编辑、台账、文件操作和 Trace 时，在用户 patch 层切换完整 surface：


### 工具面配置

默认只注册检索工具。需要编辑、台账、文件操作和 Trace 时，在用户 patch 层切换完整 surface：

```yaml

dsh-forge

同名包的其他仓库