符号代码智能 akash-digitavision/dsh-serena

dsh-serena

Listed on dsh-plugin.org

一句话价值： 装上它，每个 DeepSeek Harness 智能体都能获得 IDE 级的符号代码智能——find_symbol、find_referencing_symbols、rename_symbol、replace_symbol_body、get_symbols_overview 等等——全部通过 Serena MCP 服务器提供，另外还有会话钩子，让智能体真的会去用它。

能力分类： 工具与能力 (Tools & Capabilities) License: MIT · Compatibility: DSH ≥ 0.2.0-rc.2 (bundles API)；Windows/macOS/Linux；Serena CLI 需要 Python ≥ 3.11

它给配置档里每个智能体加了什么

| 行 | 模块 | 用途 |
| mcp-serena | @deepseek-ai/dsh-mcp-client | 启动 Serena MCP 服务器（stdio）→ mcp__serena__ 工具：符号搜索与总览、查找引用/实现/声明、重命名与安全删除符号、符号化编辑、按项目记忆、诊断 |
| dsh-hooks-claude-code | @deepseek-ai/dsh-hooks-claude-code（本 bundle 的依赖） | 运行 ~/.dsh/hooks.json：会话启动时激活项目提示词、工具漂移时提醒改用 Serena 的工具、停止时清理 |

启动时带上 --context claude-code --project-from-cwd：每个会话都会自动把工作区激活为 Serena 项目，与 DSH 内置功能重复的工具（文件读取/搜索/shell）保持隐藏。

安装

一条命令（推荐）：

dsh plugin --profile web add github:akash-digitavision/dsh-serena

或者在 Settings → Plugin Market（DSH Plugin Hub）里搜索 dsh-serena。

前置条件

1. Serena CLI —— 官方安装方式会把 serena 放进你的 PATH（也是本 bundle 的默认值）： install uv first: https://docs.astral.sh/uv/getting-started/installation/
uv tool install -p 3.13 serena-agent

装在别处？把 bundle 指向那里： setx SERENA_COMMAND "C:\path\to\serena.exe"

Windows 注意（Smart App Control / WDAC）： 应用程序控制策略可能会拦截 uv 管理的未签名 Python 构建。绕过办法：用受信任/已签名的解释器建一个 venv，往里面 pip install serena-agent，再 setx SERENA_COMMAND 指向该 venv 的 serena.exe。
2. 钩子文件 ~/.dsh/hooks.json（Windows：%USERPROFILE%\.dsh\hooks.json）—— 复制 hooks.template.json： {
"SessionStart": [{ "matcher": "", "hooks": [{ "type": "command", "command": "serena-hooks activate --client=claude-code" }] }],
"PreToolUse": [{ "matcher": "", "hooks": [{ "type": "command", "command": "serena-hooks remind --client=claude-code" }] }],
"Stop": [{ "matcher": "", "hooks": [{ "type": "command", "command": "serena-hooks cleanup --client=claude-code" }] }]
}

serena-hooks 随 uv tool install serena-agent 一起安装。如果它不在 DSH 进程的 PATH 上，就在模板里用可执行文件的绝对路径。

然后重启 DeepSeek Harness。让智能体执行 "activate this project with serena"* 来验证。

权限与外部服务

- 会启动本地 serena MCP 服务器进程（语言服务器可能按需下载各语言的工具链）
- 只读写你已激活的项目工作区；记忆按项目存放在 .serena/
- 不需要账号，不需要 API key，没有遥测

已知限制

- hooks-bridge 依赖锁定了版本（@deepseek-ai/dsh-hooks-claude-code 0.2.0-rc.2）；如果你的 DSH 运行时更新，安装因 peer 不兼容被拒，就把版本改成与运行时匹配的
- 在新项目里第一次查询符号会下载该语言的语言服务器——首次调用可能很慢

卸载

从配置档 dsh.profile.bundles + dependencies 里移除 dsh-serena（或用 dsh plugin remove），然后重启宿主。Serena 命令行、venv 和 hooks 文件都与这个 bundle 无关。

致谢

上游：oraios/serena（MIT / GPL-3.0）——这个 bundle 只是把它接进 DeepSeek Harness。