dsh-serena：为 DeepSeek Harness 智能体接入符号级代码智能

它是做什么的？

Serena 是 DeepSeek Harness（DSH）的符号级代码智能插件，把 IDE 级别的符号检索与重构能力接进 DSH 智能体。它通过 Serena MCP 服务器提供查找符号、查找引用、重命名符号、替换符号体、查看符号总览等工具，解决智能体只能靠文本搜索理解代码库的痛点。插件由 akash-digitavision 维护，采用 MIT 协议，兼容 DSH 0.2.0-rc.2 及以上的组合包 API，支持 Windows、macOS 与 Linux。

核心功能

• 符号检索与总览：提供查找符号、查看符号总览等工具，让智能体按语义而非纯文本定位代码。
• 引用与实现分析：支持查找引用、实现与声明，帮助判断改动会影响哪些调用方。
• 符号级重构：支持重命名符号、安全删除符号与符号体替换，改动落在符号层面而非字符串层面。
• 项目记忆与诊断：按项目保存记忆，并输出语言服务器诊断信息。
• 会话钩子桥接：通过会话启动、工具使用与停止三类钩子自动激活项目、提醒智能体使用 Serena 工具并做收尾清理。
• 隐藏重复工具：启动时隐藏与 DSH 内置能力重复的文件读取、搜索与 shell 工具，减少干扰。

怎么使用这个插件？

在 DSH 中启用该插件并重启宿主后，每个会话会自动把当前工作目录激活为 Serena 项目，智能体即可直接调用符号类工具。验证方式是让智能体执行「activate this project with serena」这类指令，看它是否走 Serena 通道。使用前需按 README 要求准备 Serena 命令行工具并配置钩子文件，若 Serena 不在 DSH 进程的 PATH 上，可在配置中指向可执行文件的绝对路径。首次在新项目中查询符号时，插件会按需下载对应语言的语言服务器，因此第一次调用可能较慢。

报错怎么排查？

• Windows 上应用控制策略（Smart App Control / WDAC）可能拦截由 uv 管理的未签名 Python 构建，此时可改用受信任的签名解释器创建虚拟环境，再按官方说明把 Serena 命令指向该环境中的可执行文件。
• 若因钩子桥接依赖的版本固定而被判定为对等版本不兼容、安装被拒绝，按官方说明把该依赖版本与当前 DSH 运行时对齐即可。
• 首次符号查询变慢属于正常现象，是语言服务器正在按需下载，等待完成后再试。