前言¶
DeepSeek Harness (DSH) 的设计理念是「一切皆插件」。在智能体开发或代码生成场景中,模型仅凭对话上下文往往难以精准定位当前工作区的代码结构。dsh-ide-context 插件通过读取 Claude Code 的 IDE 集成桥接文件,将 IDE 中当前打开的文件列表和选中的文本直接注入到每次模型轮次中,减少人工粘贴上下文的操作。
插件定位¶
dsh-ide-context 是一个 DeepSeek Harness bundle。它复用了 Claude Code CLI 使用的 ~/.claude/ide/<port>.lock 文件和 MCP-over-WebSocket 协议,因此能同时支持 IntelliJ IDEA 和 Visual Studio Code。插件会将文件路径、行/字符范围以及选中的文本作为上下文传递给模型。
核心功能¶
- 读取桥接文件:读取 IDE 的集成桥接文件以获取状态。
- 注入上下文:注入当前打开的文件和文本选择。
- 项目过滤:将上下文过滤到当前项目的范围内,忽略无关项目和虚拟文档。
- 跨平台支持:支持 macOS 和 Windows 原生平台。
安装与启用¶
在终端中执行安装命令:
dsh plugin add github:LSAI2023/dsh-ide-context
安装完成后,启动包含此 bundle 的 profile:
dsh --profile web
配置说明¶
插件允许在 profile 的 cordis.patch.yml 中覆盖配置。常用配置项包括:
* refreshIntervalMs:注入间隔。设为 0 或省略表示每次变更都注入;正数表示在最后一次注入后等待指定毫秒再注入。
* pollIntervalMs:轮询间隔,默认为 5000。用于 VS Code 获取文件状态。
* lockDir:锁文件目录,默认为 ~/.claude/ide。
示例配置:
- id: ide-context
config:
refreshIntervalMs: 30000
pollIntervalMs: 5000
lockDir: ~/.claude/ide
注意事项与依赖¶
- 运行环境:需要运行 Claude Code IDE 会话,且沙箱必须允许读取
~/.claude/ide目录。如果权限不足,插件会记录警告并跳过注入。 - 平台差异:IntelliJ IDEA 的选择是推送的,VS Code 支持轮询。WSL(Linux 主机 + Windows IDE)路径转换尚未实现。
- 依赖项:运行时依赖
@deepseek-ai/dsh-llm和@deepseek-ai/schemastery。
总结¶
该插件通过集成 IDE 上下文,使 DeepSeek Harness 能更精确地理解当前代码状态。更多详情可查阅插件目录或 GitHub 仓库。