前言¶
在 DeepSeek Harness（DSH）裏做代碼理解、重構評估或智能體調用工具時，常見的問題不只是“能不能找到某個符號”，而是符號在模塊依賴、調用層級和架構邊界中的位置。比如：某個函數被哪些上游引用？刪除一個模塊會波及哪些文件？兩條跨語言 API 調用鏈是否對應？這些問題需要靜態分析工具給出較確定的結果。
下面介紹 DeepSeek Lens。它是 DeepSeek Harness 的工具插件，名稱爲 @trench-xinxin/dsh-tool-lens，由 trench-xinxin 維護，定位爲面向 DeepSeek Harness 的 Deep AST code graph、symbol call hierarchies 和 refactoring impact analysis 插件。
這是什麼¶
DeepSeek Lens 可以理解爲 DSH 中用於代碼結構分析的工具插件。它圍繞代碼庫的依賴、調用、影響和架構關係，提供一組可調用能力，例如 dependencies、call_graph、impact、circular、action: path、action: unused、action: lint、action: diff_impact、action: slice 和 action: api_contracts。
它支持 Java、Python、Go、Rust、TypeScript、Vue 3、Svelte 等多語言場景。許可證爲 MIT。
核心能力¶
根據已覈實資料，DeepSeek Lens 提供以下能力：
1、模塊與依賴拓撲分析（dependencies）
用於查看模塊之間、依賴之間的靜態關係。
2、作用域去歧義調用層級分析（call_graph）
用於分析符號調用層級，並減少同名符號在不同作用域中造成的混淆。
3、分層重構影響半徑分析（impact）
用於評估修改或移除某個符號後，可能影響到的上下游範圍。
4、循環依賴審計（circular）
用於檢查代碼中是否存在循環依賴關係。
5、最短調用路徑探索（action: path）
用於查看兩個符號之間的調用路徑。
6、死代碼與未使用符號審計（action: unused）
用於發現未被引用的符號或孤立代碼。
7、架構層治理（action: lint）
用於檢查架構邊界或層級依賴規則。
8、Git diff 影響分析與測試推薦（action: diff_impact）
用於結合代碼變更影響做分析，並給出測試推薦。
9、領域架構子圖切片（action: slice）
用於從代碼圖中切出某一領域或某一符號周圍的子圖。
10、全棧跨語言 API 契約跟蹤（action: api_contracts）
用於跟蹤前後端或跨語言之間與 API 契約相關的調用關係。
安裝與啓用¶
資料中給出的啓動命令是：
npx @trench-xinxin/dsh-tool-lens
README 稱該命令會自動下載運行時、處理端口分配，並啓動帶 Lens 的完整 Web UI。也就是說，先執行上面的命令，再在瀏覽器中訪問本地地址即可。
也可以直接運行一次提示詞任務：
npx @trench-xinxin/dsh-tool-lens "Use lens tool to audit circular dependencies in this workspace"
啓動後，瀏覽器可訪問本地地址，例如：
http://127.0.0.1:3080
http://127.0.0.1:3081
另外，資料中提到 peerDependenciesMeta 將 @deepseek-ai/cordis 與 @deepseek-ai/dsh-tools 標記爲 optional。
典型用法¶
1、啓動完整 Web UI
npx @trench-xinxin/dsh-tool-lens
這一步會啓動帶 Lens 的本地 Web UI。啓動後，按照終端提示或本地地址訪問頁面。
2、在終端直接執行一次任務
npx @trench-xinxin/dsh-tool-lens "Use lens tool to audit circular dependencies in this workspace"
這一步適合在終端中直接讓 Lens 對當前 workspace 做循環依賴審計。
3、訪問本地 Web UI
啓動後，在瀏覽器中訪問類似下面的本地地址：
http://127.0.0.1:3080
或：
http://127.0.0.1:3081
實際地址以啓動時的終端提示爲準。
適用場景與注意¶
適合以下場景：
1、在 DSH 工作流中加入代碼結構分析能力。
2、重構前評估符號影響半徑。
3、審計循環依賴、未使用符號或架構邊界。
4、在 Java、Python、Go、Rust、TypeScript、Vue 3、Svelte 等多語言項目中做代碼圖分析。
使用前需要注意：
1、插件在 DeepSeek Harness 中啓用後，會以當前 dsh 進程的權限讀取代碼並執行分析。
2、安裝或啓用前，應檢查源碼、依賴、許可證和運行權限。
3、本插件聲明爲 MIT License © 2026 Trench / DeepSeek Lens Contributors。
4、資料中給出的命令是 npx 啓動/運行命令，未單獨標註爲 install 命令。
5、該插件屬於 DeepSeek Harness 插件生態，社區目錄是獨立站點，不應理解成官方應用商店。
結尾¶
DeepSeek Lens 的價值，是把代碼依賴、調用層級、重構影響、循環依賴和 API 契約分析等能力接入 DeepSeek Harness。對於需要在智能體工作流中做代碼理解與重構評估的開發者來說，它提供了一個可直接通過 npx 啓動的工具入口。
目錄頁：
https://www.skillhub.cn/plugins/trench-xinxin/dsh-tool-lens
