# @dsh-plugins/dsh-env-inspector 中文文档

规范地址：https://npmcn.com/package/%40dsh-plugins/dsh-env-inspector/

版本：0\.2\.11
npm 元数据更新时间：2026-10-27T06:45:34.290Z
中文译文更新时间：2026-11-13T05:21:45.456Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40dsh-plugins/dsh-env-inspector
原文对照：https://npmcn.com/package/%40dsh-plugins/dsh-env-inspector/?lang=original
项目主页：https://github.com/webkubor/dsh-env-inspector#readme
源码仓库：https://github.com/webkubor/dsh-env-inspector

弃用说明：This package is no longer maintained\.

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：118 kB，10 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2026-09-22T06:50:51.779Z
- 最新版本发布：2026-10-27T06:45:33.255Z
- 近 30 天下载量：2202（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：12（近 12 个月 12 个）

## 中文简介

DSH 环境自检与端口大屏：零外部依赖洞察系统架构、CLI 工具链（含广义 AI CLI）、DSH 插件生态、模型与环境凭据就绪状态、活跃监听端口与硬件概况（屏幕/GPU/显示器），支持端口安全释放与一键复制完整诊断。零联网、零私有凭钥明文泄露。

## 安装

```sh
npm install @dsh-plugins/dsh-env-inspector
```

也可以使用：`pnpm add @dsh-plugins/dsh-env-inspector`、`yarn add @dsh-plugins/dsh-env-inspector`、`bun add @dsh-plugins/dsh-env-inspector`

## README

# 🖥️ dsh-env-inspector

> ⚠️ **\[DEPRECATED / 已弃用\]** 本插件已停止维护。

**看清你的电脑装了什么，一键释放残留占用的开发端口。**  
DeepSeek Harness (DSH) 环境自检与端口运维插件 —— 现代卡片仪表盘，零运行时依赖；网络出口检测仅在用户点击时发生，绝不展示秘钥明文。

[![npm](https://img.shields.io/npm/v/%40dsh-plugins%2Fdsh-env-inspector?style=for-the-badge&color=3fb950&logo=npm&label=npm)](https://www.npmjs.com/package/@dsh-plugins/dsh-env-inspector) [![downloads](https://img.shields.io/npm/dm/%40dsh-plugins%2Fdsh-env-inspector?style=for-the-badge&color=6d7f9c&label=downloads)](https://www.npmjs.com/package/@dsh-plugins/dsh-env-inspector) ![DSH](https://img.shields.io/badge/DSH-%E2%89%A50.1.5--rc.2-4d6bfe?style=for-the-badge) ![deps](https://img.shields.io/badge/runtime_deps-0-5A9E6F?style=for-the-badge) ![MIT](https://img.shields.io/badge/license-MIT-777?style=for-the-badge)

[![DSH Plugin](https://img.shields.io/badge/DeepSeek_Harness-Plugin-4d6bfe?style=for-the-badge)](https://github.com/deepseek-ai/deepseek-harness) [![dsh-plugin](https://img.shields.io/badge/topic-dsh--plugin-4d6bfe?style=for-the-badge)](https://github.com/topics/dsh-plugin)  ·  [English](https://npmcn.com/package/%40dsh-plugins/dsh-env-inspector/README.en.md) · [更新日志](https://npmcn.com/package/%40dsh-plugins/dsh-env-inspector/CHANGELOG.md)

![电脑环境仪表盘预览图](https://cdn.jsdelivr.net/gh/webkubor/free-imgbed@main/dsh-env-inspector/dsh-env-tab-final-default.png)  
**电脑环境 Dashboard** —— 4 项核心 Hero KPI 指标行 + 现代双列网格卡片，系统状态、工具链与端口一目了然。

* * *

## 🎯 解决什么痛点

| 场景 | 以前的困扰 | dsh-env-inspector 的解法 |
| --- | --- | --- |
| **端口常遭占用报错** | 关了终端后残留的 Node/Python 进程仍霸占端口，下次启动频繁 `EADDRINUSE` | **实时探测所有监听端口，鼠标一键点击「×」安全释放（Kill 进程），页面即时自动刷新** |
| **全网监听未察觉** | 服务不经意监听在 `0.0.0.0`，暴露在局域网存在安全隐患 | **醒目黄色警告圆点标注全网监听端口**，提醒开发者关注访问控制 |
| **繁杂端口视觉干扰** | 系统高位动态端口（49152+）动辄几十个，严重干扰排查 | **智能抽屉机制**：常用开发端口一目了然，高位动态端口平滑折叠，支持一键展开/收起 |
| **排查环境低效繁琐** | 协同或调试时需频繁在终端反复敲 `node -v`、`git --version`、`lsof` 截图 | **顶部 Tab 独立大看板**：操作系统、12 款常用 CLI 就绪状态、大模型 Key 存在性全局掌控 |

* * *

## ✨ 核心特性

### 1\. 🔌 活跃端口全景透视与一键安全释放 (Kill Process)

-   **实时探测**：底层基于系统 `lsof` 探针，补全 macOS 守护进程最小 `PATH` 路径，完整捕获服务端口与占用进程名；
-   **高位动态端口折叠**：区分核心服务端口与动态端口，保持界面清爽；
-   **坚不可摧的安全护栏**：
    -   🛡️ **防自杀保护**：DSH 核心端口 `:3080` 永久锁定（显示 `🔒` 徽标），DSH 宿主自身的 `process.pid` 永久锁定，严禁终止；系统核心 PID 强制拦截；
    -   🔍 **状态一致性核验**：执行前服务端再次校验目标 PID 确实正在监听目标端口，杜绝因 PID 复用导致的误杀；
    -   ⚡ **两阶段退出**：优先发送 `SIGTERM` 允许平滑清理，未退出时再升级为 `SIGKILL` 彻底回收；
    -   🔄 **联动即时自检**：终止后无需刷新浏览器，页面自动重拉自检，该端口瞬间消失，KPI 计数同步递减。

![端口展开抽屉](https://cdn.jsdelivr.net/gh/webkubor/free-imgbed@main/dsh-env-inspector/dsh-env-tab-final-expanded.png)  
**动态高位端口展开抽屉** —— 点击「展开 N 个端口 ▾」即可浏览全部动态端口，并支持逐一释放。

### 2\. 🛠️ 命令行工具链与版本嗅探

双列黑曜石圆角卡片，实时探测 12 款常见开发工具的安装与版本状态：

-   基础 CLI：`node` / `npm` / `pnpm` / `yarn` / `git` / `cs` / `docker` / `mise` / `brew`
-   AI CLI：`codex` / `gemini` / `claude` / `opencode` / `agy`，另含常见 AI IDE 与本地模型工具
-   语言运行时：`python3` / `go` / `rustc`，只展示成功读取到版本的已安装运行时

### 3\. 🔐 AI 模型与开发凭据（零明文、零私有泄露）

-   **高低层级分明**：自动提炼并翡翠绿高亮已配置生效的模型能力（如 DeepSeek、MiniMax 等）；
-   **低对比度辅助**：未配置的环境变量以微型灰度标签展示，视觉清爽不抢戏；
-   **安全红线**：所有接口与组件**绝不输出、不读取、不传递任何密钥明文，零私有凭据泄露**。

### 4\. 🧩 扩展插件与网络接口全览

-   自动列出当前 Web / Local profile 下加载的 DSH 扩展插件及其实际生效版本；
-   区分展示局域网 IP、公网出口 IP，并标出是否检测到显式代理配置；公网出口 IP 只在用户点击后检测。

* * *

## 📦 安装与启用

### 方式 A：通过 DSH 插件管理器安装（推荐）

> 前提：装好 Node.js 即可，**无需全局安装 dsh** —— 官方入口就是 `npx @deepseek-ai/dsh`。已全局安装的可把它换成 `dsh`。

```bash
npx @deepseek-ai/dsh plugin --profile <你的 profile> add @dsh-plugins/dsh-env-inspector
```

再把 `@dsh-plugins/dsh-env-inspector` 加进该 profile 的 `package.json` 的 `dsh.profile.bundles` 数组，然后按下方重启 DSH。

> **桌面端用户**：官方 Electron 端独占 `desktop` profile，命令行对它做插件操作会被拒 （`profile "desktop" is managed exclusively by the Electron application`）—— 请在应用内的**插件管理**里安装与升级。下面的 CLI / 手改配置两种写法只适用于自建 profile。

### 方式 B：手动配置 Profile

在你的 DSH profile 配置（如 `~/.dsh/profiles/<你的 profile>/package.json`）中添加依赖与 bundle 声明：

```json
{
  "dependencies": {
    "@dsh-plugins/dsh-env-inspector": "^0.2.4"
  },
  "dsh": {
    "profile": {
      "bundles": [
        "@dsh-plugins/dsh-env-inspector"
      ]
    }
  }
}
```

执行安装并重启 DSH：

```bash
npx @deepseek-ai/dsh plugin --profile <你的 profile> install
# 然后重启该 profile 的 DSH（桌面端是退出并重开 app；自建 profile 重新跑 dsh <profile>）
```

进入页面后，点击顶部导航栏中的 **「🖥️ 电脑环境」** Tab，即可开始使用。

* * *

## 🛡️ 架构与安全承诺

-   **零运行时依赖**：代码完全基于 Node.js 原生 API 与纯 React 构建，无任何第三方三方包膨胀；
-   **默认不联网**：本地自检不访问外部服务；用户主动点击“检测出口 IP”时，浏览器才向公网 IP 服务发起一次请求；
-   **同源防护**：所有接口强制校验 `Sec-Fetch-Site: same-origin`，彻底杜绝恶意网页跨站探测。

* * *

## 🗺️ 后续落地规划 (Roadmap)

-   [ ] **项目目录反查**：针对端口占用的进程，自动反查并展示其当前的工作目录（如 `/Users/.../my-vite-app`）；
-   [ ] **开机幽灵端口对比**：提供“基准端口对比”模式，高亮提示当前会话中新开启但未退出的残留端口；
-   [ ] **官方命名平滑演进**：待维护账号收敛后，无缝兼容并迁移至 `@dsh-plugins/dsh-env-inspector` 与 `dsh-env-inspector`。

* * *

## 🧩 DSH 插件全家桶

![DSH 插件全家桶：主题美化 / 模型管理 / 用户记忆 / 电脑环境](https://img.webkubor.online/projects/dsh-plugins/dsh-plugins-family.png)

[🎨 主题美化](https://github.com/webkubor/dsh-bloom-theme) · [⚡ 模型管理](https://github.com/webkubor/dsh-llm-hub) · [🖥️ 电脑环境](https://github.com/webkubor/dsh-env-inspector)

一行装齐（只需 Node.js），装完重启 DSH 即可：

```bash
PROFILE=<你的 profile>
npx -y @deepseek-ai/dsh plugin --profile "$PROFILE" add dsh-bloom-theme @dsh-plugins/dsh-llm-hub @dsh-plugins/dsh-env-inspector && PROFILE="$PROFILE" node -e 'const f=(process.env.DSH_HOME||require("os").homedir()+"/.dsh")+"/profiles/"+process.env.PROFILE+"/package.json",p=require(f),b=p.dsh.profile.bundles;for(const n of Object.keys(p.dependencies))if(/^(dsh-bloom-theme|@dsh-plugins\/)/.test(n)&&!b.includes(n))b.push(n);require("fs").writeFileSync(f,JSON.stringify(p,null,2)+"\n")'
```

* * *

## License

[MIT](https://npmcn.com/package/%40dsh-plugins/dsh-env-inspector/LICENSE) © [webkubor](https://github.com/webkubor)

## 常见问题

### @dsh-plugins/dsh-env-inspector 是什么？

DSH 环境自检与端口大屏：零外部依赖洞察系统架构、CLI 工具链（含广义 AI CLI）、DSH 插件生态、模型与环境凭据就绪状态、活跃监听端口与硬件概况（屏幕/GPU/显示器），支持端口安全释放与一键复制完整诊断。零联网、零私有凭钥明文泄露。注意：该包已被作者标记为弃用——This package is no longer maintained\.

### 如何安装 @dsh-plugins/dsh-env-inspector？

在项目目录运行 npm install @dsh-plugins/dsh-env-inspector，或使用 pnpm add / yarn add / bun add。

### @dsh-plugins/dsh-env-inspector 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @dsh-plugins/dsh-env-inspector 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @dsh-plugins/dsh-env-inspector 可以商用吗？

@dsh-plugins/dsh-env-inspector 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @dsh-plugins/dsh-env-inspector 的下载量有多少？

根据 npm 官方下载统计，@dsh-plugins/dsh-env-inspector 在 2026/10/13 – 2026/11/11 这 30 天内被下载 2,202 次，日均约 73 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @dsh-plugins/dsh-env-inspector 还在维护吗？

最新版本 0\.2\.11 发布于 2026/10/27（17 天前）；至今共发布 12 个版本，其中过去 12 个月发布了 12 个；首次发布于 2026/09/22。作者已将其标记为弃用，新项目建议寻找替代方案。