trench-xinxin/dsh-tool-lens

Project Overview项目介绍

DeepSeek Lens is a native DSH plugin for high-performance, deterministic AST code graph and architectural analysis built exclusively for DeepSeek Harness. It equips DSH AI agents with deep topological awareness of codebases, enabling a wide range of analysis capabilities from module dependency exploration, circular dependency auditing, and inheritance tracing to full-stack API contract tracking and change impact analysis. To use it with zero extra configuration, you can simply run npx @trench-xinxin/dsh-tool-lens in your terminal, which automatically downloads the required runtime, handles port allocation, and launches the full pre-loaded Web UI accessible via your local browser.

This plugin is designed for software developers working on any size of codebase, from small solo projects to large enterprise multi-language applications. Before starting a refactor, developers can use it to audit circular dependencies, detect unused dead code, and assess the blast radius of planned changes to avoid unexpected breakages in production. For developers new to a large unfamiliar codebase, it can help map out the overall architecture, check that architectural boundaries are being respected, and trace call paths between different components.

DeepSeek Lens is released under the open source MIT license, so it is free to use for both personal and commercial projects, with no associated costs or restrictions beyond the standard terms of the MIT license. It does not require a pre-installation of DeepSeek Harness to run, as the zero-config npx launch will handle all required setup automatically. After launch, you can access the full featured Web UI at the local address provided in your terminal output, and start analyzing your codebase immediately, with no extra dependencies needed for most use cases.

这是一款专为DeepSeek Harness(DSH)设计的原生AST代码图与架构分析插件。它为DSH智能体提供深度代码库拓扑感知能力,支持模块依赖探索、符号调用层次消歧、面向对象继承追踪、循环依赖审计、架构耦合度量、Git变更影响分析、全栈API契约追踪等多项功能。插件自带零配置启动能力,无需预安装DSH即可独立启动完整的Web分析界面。

开发人员可以在重构前用它分析变更影响范围,审计循环依赖,检测死代码,也可以用它梳理陌生项目的整体架构,检查架构分层是否符合预先设定的规范。对于需要做跨语言全栈分析的项目,它还支持Java、Python、Go、Rust、Vue等多种主流编程语言和前端框架的代码分析。它适合日常开发、架构治理、大型项目重构等多种场景下的开发者使用。

该项目遵循MIT开源协议,免费供个人和商业项目使用,无需任何付费。它支持零配置一键启动,执行npx @trench-xinxin/dsh-tool-lens即可自动下载运行时、分配端口并启动完整Web界面,用户可直接通过浏览器访问指示的本地地址开始使用。目前没有明确的额外使用限制,用户可根据自身需求自由使用和修改源码。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 4 stars - very few users, little community feedback星标只有 4,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:trench-xinxin/dsh-tool-lens

把 trench-xinxin/dsh-tool-lens 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

DeepSeek Lens (@trench-xinxin/dsh-tool-lens)

English | 简体中文

CI npm version npm downloads [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://github.com/trench-xinxin/dsh-tool-lens/blob/main/LICENSE)

[![DeepSeek Harness](https://img.shields.io/badge/DeepSeek-Harness%20Plugin-0066FF.svg)](https://github.com/deepseek-ai/deepseek-harness)

DeepSeek Lens is a high-performance, deterministic AST code graph and architectural analysis tool plugin designed for the DeepSeek Harness agent foundation.

It empowers AI Agents with deep codebase topological awareness, enabling instant module dependency exploration, disambiguated symbol call hierarchies, OOP inheritance tracing, circular dependency audits, architectural coupling metrics, Git diff change impact audits, domain architecture slicing, and full-stack API contract tracking.


⚡ Zero-Config All-in-One Launcher (No Extra Setup Required)

💡 Stand-alone Execution: You do NOT need to pre-install @deepseek-ai/dsh, nor do you need to start any background Harness services beforehand.
Running the command below will automatically download the runtime, handle port allocation, and launch the complete Web UI with Lens pre-loaded:

# 🚀 Zero-config launch full Web UI (Out of the box)
npx @trench-xinxin/dsh-tool-lens

# Or execute a one-off prompt directly in terminal
npx @trench-xinxin/dsh-tool-lens "Use lens tool to audit circular dependencies in this workspace"

Once launched, your browser can access the Web UI at the indicated local address (e.g. http://127.0.0.1:3080 or http://127.0.0.1:3081).

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-commander 下一个 Next dsh-im-channel →