編碼智能體在處理任務時,既要理解當前需求,又要記住項目約定,還要找到相關的源碼。把所有內容都塞進請求很浪費,只看眼前的一句話又容易漏掉接口和依賴約束。Context Graph 插件通過掃描代碼和構建語義圖譜,解決了這個問題。
這是一個 DeepSeek Harness 的工程上下文管理插件,由 Mshir0 維護。它通過掃描代碼和構建語義圖譜,精準注入項目上下文。
核心功能¶
- 語義功能與實現文件的關聯管理:在圖譜中管理語義功能與實現文件的關聯。
- 代碼掃描與依賴分析:支持 Python、C 和 C++ 代碼掃描與依賴分析。
- PDF 文檔處理:支持 PDF 文檔按章節讀取、佈局提取與元數據同步。
- 上下文編譯與預算控制:通過 Context Compiler 進行 Token 預算控制。
- 消息與快照審計:利用 Context Firewall 進行消息與快照審計。
安裝與依賴¶
使用前請確保環境滿足以下要求:
- DeepSeek Harness 0.1.0-rc.6+
- Node.js ^22.19.0/>=24
- Python 3
安裝插件:
npx -y @deepseek-ai/dsh@0.1.0-rc.6 plugin --profile web add -w github:Mshir0/context-graph-deepseek-harness
若需使用 PDF 功能,需安裝 PyMuPDF 或 pypdf。
使用方法¶
- 觸發注入:直接在右下角輸入框發送消息,插件會嘗試注入當前任務相關上下文。
- 創建持久任務:使用“上下文”按鈕創建持久任務並選擇任務類型。
- 視圖操作:在“上下文圖譜”視圖中,可使用快捷鍵操作:
Ctrl+S:保存圖譜A:自動排布F:適合畫布
注意事項¶
- 插件不修改源碼,也不猜測未確認的關係(如宏展開、外部符號)。
- 當關閉 autoInject 時,firewallMode 爲 enforce 時仍會使用空快照。
- 需安裝 PyMuPDF 或 pypdf 以支持 PDF 功能。