🖥️ 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)
🧩 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
