dsh-semble：为 DeepSeek Harness 提供语义代码检索的 DSH plugin

它是做什么的？

Semble 是 DeepSeek Harness（DSH）的语义代码搜索插件，把 Semble 的代码索引以两个原生 MCP 工具的形式接入每个 DSH 会话。它解决的是「知道代码行为、却不知道文件名」的检索难题：grep 需要你先想起具体字符串，而它只需要一句行为描述，比如「请求失败时重试策略在哪里生效」。安装后工具与 read、grep 并列，由 agent 自行判断何时调用索引。

核心功能

• 语义搜索：mcp__semble__search 接收一句描述代码行为或位置的句子，返回按相似度排序的 file:line 命中及代码片段。
• 关联查找：mcp__semble__find_related 接收一个已知位置，返回其邻居——其他实现、调用方与测试。
• 多仓库与内容过滤：repo 参数支持绝对路径、https:// git URL 或列表，content 可选 code、docs、config、all。
• 结果可调：top_k 默认 5，首轮未命中可提到 10–20；max_snippet_lines 默认 10，设为 0 只返回位置。
• 索引复用：首次查询某仓库时建索引（较慢、一次性），后续查询直接复用；分数接近 0.0x 通常意味着此处无相关内容。
• 斜杠命令：注册 /semble，提供 MCP 未暴露的 /semble savings 与 /semble file-types 两个报告子命令。

怎么使用这个插件？

在 DSH 中启用后，直接向 agent 提问「某段逻辑在哪里实现」，它会调用 search 拿到命中位置，再用 read 打开源码作答，而不是猜文件名。调用时 repo 为必填项，可传仓库绝对路径或 git URL；需要扩大范围时调高 top_k，想连文档和配置一起索引则把 content 设为 all。插件依赖 uv 在 PATH 中（由 uvx 启动 Semble），首次启动会下载包与嵌入模型，约 1–2 分钟且之后可离线；安装后需重启一次 DSH。设置页的 semble-mcp 行可调整 args 与 env，例如用 HF_ENDPOINT 应对受限网络、用 SEMBLE_CACHE_LOCATION 迁移索引位置。该插件由 CodeIntegrity 维护，采用 MIT 协议。

报错怎么排查？

安装后设置页条目可能显示「待重启」，重启一次 DSH 即可恢复。若首次查询长时间无响应，通常是正在下载包与嵌入模型，等待其完成即可。网络受限导致模型下载失败时，在设置的环境变量中配置镜像端点后重试。