deepseekplugins

DeepSeek Harness plugin

dsh-workspace-inspector

右侧面板插件：展示当前会话 Token 用量（tokenUsage/contextPressure 投影）与工作区文件树（host HTTP 路由 + client 面板）

Development & Runtime
Jump to install

Source facts

Repository
GIGHT111/dsh-workspace-inspector
Latest update
Aug 14, 2026
Category
Development & Runtime
GitHub stars
1
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/GIGHT111/dsh-workspace-inspector
Plugin: dsh-workspace-inspector
Author: GIGHT111

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

dsh-workspace-inspector

DeepSeek Harness (DSH) Web 客户端插件：在右侧详情列显示当前会话的 Token 用量、消息目录（全部历史） 与 工作区文件树。跨平台（macOS / Windows / Linux）。

> English: A right-side panel plugin for the DeepSeek Harness web UI. It shows token usage with per-part breakdown, a collapsible full-history message outline (click to jump to the message), context pressure, and a workspace file tree (click a file to open it with your system default app). Cross-platform: macOS / Windows / Linux. > > Install (GitHub, recommended — no build needed): > ``sh > dsh plugin --profile web add github:GIGHT111/dsh-workspace-inspector > dsh --profile web # restart to activate > ` > Requirements: dsh installed and pnpm on PATH`. After restarting, the panel opens on the right side; close it with ✕ and reopen it with the 📊 Overview button in the session header.

功能

  • Token 用量（本会话累计）：输入（未缓存）、缓存读取、输出及各自占比（不含缓存写入），总计 = 输入+缓存读取+输出 —— 来自 tokenUsage 会话投影。
  • 消息目录（全部历史）：host 重放会话完整持久化日志重建目录（客户端事件窗口只有最近约 50 条消息，看不到全部历史）。每条用户消息可折叠展开看该轮回复摘要与工具调用次数；点击条目滚动对话到对应消息行并高亮（若目标消息不在当前已加载窗口，会提示先加载更早历史）。摘要为启发式文本提炼，非 LLM 生成。
  • 上下文压力：下一次请求的预计 token 数、上下文窗口容量与占用百分比 —— 来自 contextPressure 投影。
  • 工作区文件树：以当前会话工作区为根，目录懒加载、可展开/折叠，文件显示大小；点击文件行用系统默认应用打开（插件自有 host 路由，与官方 openPath 同机制）；隐藏文件开关与刷新。
  • 关闭/重开：✕ 一次关闭右侧列（无悬浮模式）；会话头部右侧出现「📊 概览」按钮，点击重新打开右侧列，恢复原生拖拽分栏调整大小。

架构

双面（dual-face）插件：

半面入口职责
hostlib/index.js（src/index.ts）注册三个 webserver 精确路由：GET /__dsh-workspace-inspector/list?path=<abs> 返回单层目录条目（目录+文件+size+hidden）；GET /__dsh-workspace-inspector/outline?session=<id> 重放会话日志重建完整消息目录；GET /__dsh-workspace-inspector/open?path=<abs> 用系统默认应用打开文件（macOS open / Windows Invoke-Item / Linux xdg-open）。list/open 仅允许 host cwd 或已注册 workspace 根之下的绝对路径（Windows 大小写不敏感）；均 Cache-Control: no-store。
clientlib/client.js（src/client/index.tsx + src/client/matching.ts）认领右侧 details 列（single/session，priority -1 遮蔽默认 DetailsPanel），有会话时自动打开右侧列；✕ 一次关闭，会话头部「概览」按钮重新打开。消息目录 key 计算在 matching.ts（纯函数，可单测）。

client bundle 遵循官方 __ModuleLoader__.load({ id, factory }) 协议：平台模块（react 等）external，由浏览器模块表应答；其余依赖内联。

构建与测试

npm install        # devDeps: esbuild / typescript / @types/*
npm run typecheck
npm run build      # 产出 lib/index.js + lib/client.js + lib/types
npm run test:host    # host 路由行为 + 完整消息目录重建（含边界）
npm run test:client  # client 消息目录 key 纯逻辑

安装

本地路径

# 需要 pnpm 在 PATH 中
dsh plugin --profile web add /path/to/dsh-workspace-inspector

GitHub（推荐）

仓库已提交构建产物 lib/，从 Git 安装无需执行任何构建脚本：

dsh plugin --profile web add github:GIGHT111/dsh-workspace-inspector
# 或带分支/提交：github:GIGHT111/dsh-workspace-inspector#<branch>

> Install from GitHub (English) — this repo ships its built lib/, so no build step is needed on install: > ``sh > dsh plugin --profile web add github:GIGHT111/dsh-workspace-inspector > ` > Pin a stable commit with #v0.1.0` (or any tag/commit) if you prefer.

安装后重启 web profile：

dsh --profile web

之后每次修改插件代码只需 npm run build 并刷新页面（bundle 内容变更走 client HMR；manifest/行结构变更需再次重启）。

打包发布

npm install       # 安装构建依赖（仅开发需要）
npm run typecheck && npm run build && npm run test:host && npm run test:client
npm pack          # 生成 dsh-workspace-inspector-<version>.tgz（npm pack 自动包含 lib/ + README + LICENSE + cordis.patch.yml）

*.tgz 也可直接安装：

dsh plugin --profile web add /path/to/dsh-workspace-inspector-0.1.0.tgz

配置

可在 profile 的 cordis.patch.yml 中覆盖该行配置：

- id: workspace-inspector
  config:
    maxEntriesPerDir: 1000   # 单层目录最多返回条目数

说明与边界

  • 右侧列默认由 ui-conversation 的 DetailsPanel 占用（当前无任何代码会打开它，处于休眠态）；本插件以更低 priority 遮蔽它并在会话存在时自动打开。卸载插件后恢复原状。
  • tokenUsage/contextPressure 来自 host 端 token-meter 投影（本会话累计）。
  • 消息目录由 host 从持久化日志重建，覆盖全部历史；跳转依赖对话视图已加载对应消息行，未加载时会提示。
  • 文件树经 localhost HTTP 路由读取，仅限工作区根之内的路径；不在浏览器 RPC 信任围栏内，请勿在不可信网络环境中暴露 3080 端口。uan
Back to searchOpen GitHub repository

More related plugins

View category