前言¶
在 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
