前言¶
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 倉庫。