前言¶
做 DSH Web 客户端长会话时，经常要同时看当前会话的 Token 用量、上下文压力、全部历史消息，以及当前工作区里的文件。这些信息分散在会话、日志和工作区里，查起来不方便。
下面介绍 dsh-workspace-inspector。它是一个 DeepSeek Harness (DSH) Web 客户端右侧面板插件，把当前会话 Token 用量、全部历史消息目录、上下文压力和工作区文件树集中展示在右侧详情列中。它跨平台支持 macOS / Windows / Linux。
这是什么¶
先说定位：dsh-workspace-inspector 是 DSH Web 客户端插件，由 GIGHT111 维护，许可证为 MIT。
它解决的问题是：在同一个会话里，快速核对会话级 Token、上下文状态、历史消息位置，以及工作区文件状态。经过上面的描述，可以看到它的价值集中在“右侧面板汇总查看”，而不是替代对话主流程。
核心功能¶
Token 用量¶
在右侧详情列展示当前会话 Token 用量，包括输入、缓存读取、输出及各自占比。这些数据来自 tokenUsage 投影。
全部历史消息目录¶
展示全部历史消息目录。目录由 host 重放会话持久化日志重建，支持折叠展开，并显示摘要与工具调用次数。
点击条目会跳转到对应消息行并高亮。消息目录摘要为启发式文本提炼，非 LLM 生成。如果目标消息行尚未在对话视图中加载，会提示先加载更早历史。
上下文压力¶
展示上下文压力，包括下一次请求预计 token 数、上下文窗口容量与占用百分比。这些数据来自 contextPressure 投影。
工作区文件树¶
展示工作区文件树：以当前会话工作区为根，目录懒加载，可展开/折叠，文件显示大小。
点击文件会用系统默认应用打开。面板支持隐藏文件开关与刷新。
右侧列开关¶
支持关闭和重新打开右侧列。使用 ✕ 关闭后，可通过会话头部「📊 概览」按钮重新打开，并恢复原生拖拽分栏调整大小。
该插件以更低 priority 遮蔽默认右侧 DetailsPanel，并在会话存在时自动打开；卸载后恢复原状。
安装与启用¶
先确认环境已安装 dsh，并且 pnpm 在 PATH 中。再执行下面的 GitHub 安装命令：
dsh plugin --profile web add github:GIGHT111/dsh-workspace-inspector
安装后需要重启 web profile 才能激活：
dsh --profile web
典型用法¶
本地路径安装¶
如果已有本地插件目录，可以使用本地路径安装：
dsh plugin --profile web add /path/to/dsh-workspace-inspector
tgz 包安装¶
如果使用打包文件，可以执行：
dsh plugin --profile web add /path/to/dsh-workspace-inspector-0.1.0.tgz
构建与测试¶
修改插件代码后，需要重新构建并刷新页面；如果 manifest 或行结构变更，需要再次重启 web profile。
构建与测试命令如下：
npm install && npm run typecheck && npm run build && npm run test:host && npm run test:client
配置目录条目上限¶
可以在 profile 的 cordis.patch.yml 中配置 workspace-inspector.config.maxEntriesPerDir，用于限制单层目录最多返回条目数。示例值为 1000：
- id: workspace-inspector
config:
maxEntriesPerDir: 1000
适用场景与注意¶
适合需要长期跟踪 DSH Web 会话上下文、消息历史和工作区文件的开发者。
安装前应检查源码与 MIT 许可证。该插件以当前 dsh 进程权限运行，并涉及工作区文件读取、文件打开和 localhost HTTP 路由，因此只建议在可信环境中使用。
需要注意以下边界：
1、文件树路由仅限 host cwd 或已注册 workspace 根之下的绝对路径；Windows 下大小写不敏感。
2、文件树经 localhost HTTP 路由读取，list/open 路由均使用 Cache-Control: no-store。
3、资料提醒：请勿在不可信网络环境中暴露 3080 端口。
4、消息目录跳转依赖对话视图已加载对应消息行；未加载时会提示先加载更早历史。
5、修改代码后，需要重新构建并刷新页面；manifest 或行结构变更时，需要再次重启。
结尾¶
dsh-workspace-inspector 把当前会话 Token 用量、上下文压力、全部历史消息目录和工作区文件树集中到 DSH Web 客户端右侧面板，适合在长会话和工作区操作中快速核对状态。
相关链接来自安装命令与仓库标识，可用于查找目录页和仓库：
- 目录页：https://www.skillhub.cn/plugins/GIGHT111/dsh-workspace-inspector
- GitHub 仓库：https://github.com/GIGHT111/dsh-workspace-inspector
