dsh-env-inspector-plus

在 DSH（DeepSeek Harness）网页版「设置 → 环境体检」加一个只读分页，一眼看清当前宿主进程的处境。

同时给模型一个只读工具 env_inspect，让 AI 也能回答「现在跑在哪个目录、用哪个 profile、Node 什么版本」。

关于包名：本包是 dsh-env-inspector 的重命名版本 —— npm 上 dsh-env-inspector 已被第三方占用（维护者 geeklei），故加 -plus 后缀发布。功能为同一份实现。

展示什么

宿主身份

• 进程 id（pid）
• 入口脚本路径
• 当前工作目录
• Node 版本、平台
• 已运行时长

环境变量分组

• 总数
• DSH_ 前缀组
• 凭证形态组（KEY / PASSWORD / SECRET / TOKEN）
• 其余

逐条变量清单：只含键名、是否以 DSH_ 开头、是否命中凭证形态、是否已设值、值长度 —— 每个变量一行。

安全边界（重要）

凭证形态变量的值一律不出宿主。命中的键只返回布尔与长度，明文绝不进入模型上下文，也绝不进入 HTTP 响应体。

承诺范围是精确的：逐条变量清单（env.entries 与两组键名）只含键名与元数据，不含任何环境变量的值。

唯一携带原值的字段是 4 个 host 身份字段 —— host.cwd、host.profileDir、host.profile、host.entry（分别对应 PWD / DSH_PROFILE_DIR / DSH_PROFILE / 入口路径）。这是刻意的：「现在在哪个目录跑、用哪个 profile」正是体检最该回答的问题，掩掉就等于删掉主要用途；且这些值本来就会出现在会话里。

要看某个变量的明文，请用 dsh-settings-params 的 env_param_get —— 那条路有独立的显式授权。

安装

dsh plugin --profile web add github:felixpu/dsh-env-inspector-plus

安装后重启宿主进程。

使用

网页：设置 → 环境体检

模型工具：

env_inspect

无参数，返回上述快照。适合在排查「环境变量没生效」「跑的是哪个 profile」这类问题时让模型自己看。

宿主贡献

类型	值
注入服务	['tools', 'webServer']
只读路由	GET /dsh-env-inspector/snapshot

路由路径保留原名 dsh-env-inspector（未随包名改为 -plus）， 以避免既有 profile 的注册点失效。

设计说明

本包不 import 任何 @deepseek-ai/* 包。作为树外插件包，插件目录下没有 node_modules，import '@deepseek-ai/dsh-tools' 会抛 ERR_MODULE_NOT_FOUND，宿主侧表现为 failed to import、插件根本装载不上。

因此工具定义是手写对象（零 dsh 依赖）：{ name, description, parameters, output, execute }，其中 parameters 是显式 JSON Schema 根对象。这与官方 defineTool 语法糖编译出的形状等价。

客户端 bundle 仅 require 平台种子表内的模块（react）。

许可证

MIT © felixpu

仓库

https://github.com/felixpu/dsh-env-inspector-plus