CocoSgt/dsh-inspector 预览 preview

CocoSgt/dsh-inspector

Project Overview项目介绍

dsh-inspector is a third-party plugin built natively for DeepSeek Harness (DSH). It adds a dedicated “Instruction Files” panel to the right side of DSH’s web UI, which displays and manages the full instruction chain that is actually active for the current DSH session. The panel strictly follows DSH’s official instruction discovery algorithm, mirroring the order of loading from the global $DSH_HOME/AGENTS.md down through each directory level to the current session’s working directory, and also displays the status of DSH’s four skill roots. What you see in the panel is exactly the set of instructions that the AI model receives for the current session.

To use the plugin, you first open a DSH session with an assigned project workspace directory, then toggle the “Instruction Files” button in the session header to open the panel. The panel automatically updates to match the current session’s active workspace, and supports creating new instruction and skill files directly in place, with pre-seeded templates that match your DSH UI language preference. It includes a dirty change guard that prevents silent data loss when navigating away with unsaved edits, and adds status chips to flag collapsed duplicates, oversized unloaded files, and uncommitted local files. It is designed for DSH users who want to debug instruction loading behavior and manage custom instructions across different layers of their project.

dsh-inspector is distributed under the permissive MIT license, and can be installed via npm or built from source. To build from source, you need to have pnpm installed, clone the repository, run pnpm install to install dependencies, then run pnpm run build to compile the output. Once installed, you can enable the plugin directly in your DSH environment. The plugin has several known limitations: the panel has a fixed width and is not draggable, it does not watch the file system for live changes, uses a plain text editor without syntax highlighting or Markdown preview, and does not reflect actual byte budget truncation or on-demand injection status.

dsh-inspector 是专为 DeepSeek Harness (DSH) 开发的第三方原生插件,它会在 DSH 的 Web UI 右侧新增一个「指令文件」面板,用于展示并管理当前会话实际生效的指令链。面板完全遵循 DSH 官方的指令发现算法,从全局 AGENTS.md 到项目根目录再到当前工作目录逐层展示,同时还会显示四个技能根目录的状态,所见即模型实际获得的指令内容。

使用时,先打开带有工作区的项目会话,再点击会话头部的「指令文件」开关按钮,面板就会自动跟随当前会话的工作目录。它支持原位新建和编辑指令文件与技能文件,自带未保存变更防护机制,还会对重复、超大的文件打上对应状态标签。它主要面向需要调试指令加载逻辑、分层管理自定义指令的 DSH 开发者与普通用户。

该插件采用 MIT 许可证开源,基于 pnpm 开发,需要运行在 DSH 的 Cordis 环境中。已知的局限包括面板宽度固定不可拖动、不监听文件系统实时变更、编辑器是纯文本区域无语法高亮,无法反映实际字节预算截断和按需注入状态。用户可通过 npm 安装或者从源码构建后,在 DSH 中启用该插件。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 2 warnings2 项注意
  • No license declared - all rights reserved by default; ask the author before commercial use or redistribution未声明开源许可证 —— 默认「保留所有权利」,商用或再分发前先问作者
  • Only 6 stars - very few users, little community feedback星标只有 6,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add dsh-inspector

把 CocoSgt/dsh-inspector 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-inspector

简体中文 | English

npm package: dsh-inspector · GitHub repository: CocoSgt/dsh-inspector

A third-party plugin for DeepSeek Harness (dsh): an "Instruction Files" panel on the right side of the Web UI that shows — and manages — the instruction chain actually in effect for the current session, in the harness's real load order: global $DSH_HOME/AGENTS.md → project root → … → the session's cwd, one directory level at a time — plus the status of the four skill roots. The information architecture mirrors the official dsh-agent-instructions discovery algorithm exactly: what you see is what the model gets.

Open a session whose workspace sits in a project directory, then toggle the "Instruction Files" button in the session header; the panel follows the current session's workspace directory automatically. The UI ships in Chinese and English (follows the harness language preference).

The instruction-chain model (matches the harness exactly)

The layers, deduplication, and status flags shown by the panel align with the real behavior of packages/context/agent-instructions:

  1. Global layer: $DSH_HOME/AGENTS.md (default ~/.dsh/AGENTS.md). Only AGENTS.md is recognized; it applies to every session and always loads first.
  2. Project chain: starting from the session cwd, the nearest ancestor containing .git is the project root (the cwd itself if none is found); every directory level from the project root down to the cwd is probed for 4 candidates: AGENTS.md and CLAUDE.md (base), plus AGENTS.local.md and CLAUDE.local.md (local overlays, by convention not committed). Every candidate that exists is loaded; within one directory, candidates whose content is identical after trimming surrounding whitespace are collapsed into the first one (the panel flags this as "Same as X · collapsed to one").
  3. Order is priority: global → cwd goes broad to specific, and the model is told that more specific instructions win; the panel is ordered and annotated accordingly. When the byte budget overflows, the harness omits the broadest entries first; a single file over 1 MB is ignored outright (the panel flags it as "Over 1 MB · not loaded").
  4. Subdirectory injection is on demand: instruction files in subdirectories below the cwd are not preloaded; they are injected as additional instructions only when the model reads or writes a file inside that subdirectory — the panel footnote explains this instead of mixing non-preloaded files into the chain.

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-plugin-diff-review 下一个 Next dsh-tensorlake-sandbox →