dsh-env-inspector

🖥️ dsh-env-inspector

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

 ·  更新日志

_{电脑环境 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 计数同步递减。

_{动态高位端口展开抽屉 —— 点击「展开 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 插件管理器安装（推荐）

dsh plugin add @dsh-plugins/dsh-env-inspector

方式 B：手动配置 Profile

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

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

执行安装并重启 DSH：

~/.dsh/restart.sh

进入页面后，点击顶部导航栏中的 「🖥️ 电脑环境」 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。

---

🧩 Webkubor DSH 精选扩展家族 (Plugin Suite)

打造极致的 DeepSeek Harness 开发者与用户套件：

插件	领域	核心功能	快速安装
🎨 dsh-bloom-theme	主题美化	现代毛玻璃美学、暗黑/亮色自适应与 20+ 精选艺术壁纸	dsh plugin install @dsh-plugins/dsh-bloom-theme
⚡ dsh-llm-hub	智能路由	多模型厂商聚合、秒级切换与故障智能重试	dsh plugin install @dsh-plugins/dsh-llm-hub
🪞 dsh-user-mirror	角色记忆	用户数字画像、习惯偏好与记忆沉淀网络	dsh plugin install @dsh-plugins/dsh-user-mirror
🖥️ dsh-env-inspector	运行环境	活跃端口一键释放、CLI 工具链与开发凭据大屏	dsh plugin install @dsh-plugins/dsh-env-inspector

---

License

MIT © webkubor