前言¶
开发过程中常遇到端口被残留进程占用、环境配置不清晰或需频繁确认系统状态的情况。dsh-env-inspector 是一个面向 DeepSeek Harness (DSH) 的环境自检插件，提供系统环境、CLI 工具链、模型 Key 状态以及活跃端口的可视化仪表盘，支持一键安全释放端口。
核心能力¶
端口探测与释放¶
插件基于系统底层 API 实时探测所有监听端口。界面区分核心服务端口与动态端口，高位动态端口支持折叠与展开。对于占用的端口，支持一键安全释放（Kill 进程）。
* 安全机制：核心端口（如 DSH 的 :3080）及 DSH 宿主进程被永久锁定，禁止终止；系统核心 PID 也会被强制拦截。
* 状态同步：释放端口后，页面会自动刷新，无需手动重载。
环境与工具链看板¶
顶部 Tab 独立展示环境概览，包含：
* 系统状态：操作系统信息。
* CLI 工具链：实时探测 12 款常用开发 CLI（如 Node、Git、Docker 等）的就绪状态。
* 大模型 Key：全局展示已配置模型 Key 的存在性，不输出明文。
插件与网络接口¶
- 插件列表：列出当前 Web / Local profile 下加载的 DSH 扩展插件及其实际生效版本。
- 网络信息：区分展示局域网 IP 与公网出口 IP。公网出口 IP 仅在用户点击时检测。
安装与启用¶
通过 DSH 插件管理器安装：
npx @deepseek-ai/dsh plugin --profile <你的 profile> add @dsh-plugins/dsh-env-inspector
安装完成后，进入页面，点击顶部导航栏中的 「🖥️ 电脑环境」 Tab，即可开始使用。
安全与架构¶
- 零运行时依赖：代码完全基于 Node.js 原生 API 与纯 React 构建，无第三方包膨胀。
- 本地自检：默认不联网，本地自检不访问外部服务；网络出口检测仅在用户点击时发生。
- 隐私保护：所有接口与组件绝不输出、不读取、不传递任何密钥明文；所有接口强制校验
Sec-Fetch-Site: same-origin，杜绝恶意跨站探测。
适用场景¶
该插件适用于需要快速排查端口占用、确认开发环境一致性或检查大模型配置的场景。插件以当前 DSH 进程权限运行，安装前建议检查源码与许可证。
结尾¶
dsh-env-inspector 通过可视化仪表盘，将系统状态与端口管理集成在 DSH 界面中，减少了频繁切换终端或查阅文档的时间。
- 项目主页：https://github.com/webkubor/dsh-env-inspector
- 插件目录：https://www.skillhub.cn/plugins/webkubor/dsh-env-inspector
