一个原生的 dsh web 插件，把 DeepSeek Harness 的 Agent 会话变成可检视的执行迷宫——迷宫时间轴、数据轨道、确定性失败分析、多会话对比与回放，且日志数据不出浏览器。
DSH 适配
原生运行时
作者声明
安全审计
未审计
最后核验
2026-08-30
许可证
MIT
01它能帮你完成什么？
把 DeepSeek Harness 的 Agent 会话变成可检视的执行迷宫
同一根时间轴上画清主干路径、失败支路与数据轨道（工具密度、Token 脉冲、上下文压力），并给出确定性失败恢复分析
想看清 Agent 真实干活过程的 dsh 用户与开发者——主干路径、失败支路、重试与恢复一目了然
对比同一任务的多轮跑法，并回放会话看清它如何一步步走到结果
2~5 次跑的同轴对比（轮次对齐、支路盘点、手动锚点），以及最高 300× 重放整场执行
跨模型对比行为、或复盘一场长会话到底怎么走到结果的工程师与评估者
02如何接入 DeepSeek Harness？
前置条件
- 已安装官方 dsh 宿主——README 已对 0.1.0-rc.6 与 rc.8 验证，peer 范围覆盖 rc.6 到当前 rc 线
- 若从源码安装需 Node.js 工具链与 pnpm（`corepack enable && pnpm install && pnpm build`）
安装步骤
- 01
全局安装宿主：`npm install --global @deepseek-ai/dsh@0.1.0-rc.8`
$ npm install --global @deepseek-ai/dsh@0.1.0-rc.8
- 02
添加插件：`dsh plugin --profile web add dsh-maze`
$ dsh plugin --profile web add dsh-maze
- 03
启动宿主：`dsh web`
$ dsh web
验证接入成功
- 重启 `dsh web` 后，侧边栏底部出现「执行迷宫」入口，每个会话视图多一个「实时迷宫」页签。
03DSH 适配与能力边界
通过 `dsh plugin --profile web add dsh-maze` 以一等公民身份安装为 dsh web 插件；在宿主侧边栏注入「执行迷宫」入口，并为每个会话视图添加「实时迷宫」页签。
迷宫时间轴可视化
DSH 会话事件流（.jsonl / .jsonl.zstd）→同一时间轴上的主干路径、失败支路与数据轨道（工具密度、Token 脉冲、上下文压力）
失败恢复与执行分析
已判定的工具调用与 verdict→失败恢复链、工具结果矩阵、耗时分布散点，以及 Agent 关系图谱
多会话对比与回放
同一任务的 2~5 次跑→同轴对比（轮次对齐、支路盘点、手动锚点），以及最高 300× 回放
注入 dsh web 的执行迷宫 UI
运行中的 dsh web 宿主→侧边栏「执行迷宫」入口，外加每个会话视图的「实时迷宫」页签
在 dsh web 侧边栏注入「执行迷宫」入口，并为每个会话视图新增「实时迷宫」页签
04适合谁？何时不该用？
适合
- 想看清 Agent 真实干活过程的 dsh 用户与开发者——主干路径、失败支路、重试与恢复一目了然
- 跨模型对比行为、或复盘一场长会话到底怎么走到结果的工程师与评估者
不适合
- 依赖官方 dsh 宿主的 rc 线：README 已对 0.1.0-rc.6 与 rc.8 验证（peer 范围覆盖 rc.6 到当前 rc 线），并随每个新 rc 复验；宿主版本不被支持时插件无法正确加载。
- 上游 master 的宿主 0.1.2 重新拆分了客户端包、并换掉了会话快照的数据模型，两条线的插件不通用。1.1.x 线（npm 安装路径）与 2.x 线（宿主 0.1.2）相互独立，选错线插件将无法工作。
05兼容性、维护与安全提示
- 依赖官方 dsh 宿主的 rc 线：README 已对 0.1.0-rc.6 与 rc.8 验证（peer 范围覆盖 rc.6 到当前 rc 线），并随每个新 rc 复验；宿主版本不被支持时插件无法正确加载。
- 上游 master 的宿主 0.1.2 重新拆分了客户端包、并换掉了会话快照的数据模型，两条线的插件不通用。1.1.x 线（npm 安装路径）与 2.x 线（宿主 0.1.2）相互独立，选错线插件将无法工作。
MIT · 活跃维护中（最新发布 v1.1.0，2026-08-26）
06常见问题
怎么给 DeepSeek Harness 安装 dsh-maze？
先装官方 dsh 宿主（如 `npm install --global @deepseek-ai/dsh@0.1.0-rc.8`），再运行 `dsh plugin --profile web add dsh-maze`，用 `dsh web` 启动。重启后侧边栏出现「执行迷宫」入口，每个会话多出「实时迷宫」页签。
dsh-maze 支持哪些 session 日志格式？
按文件内容识别格式（文件名任意）。支持纯文本 `.jsonl`（session v0 事件流）和 `~/.dsh/sessions/` 下的原生 `.jsonl.zstd`，均在浏览器端解压。
dsh-maze 会把我的 session 日志发出去吗？
不会。上传 / 可视化页面是自包含的 HTML，运行在沙箱化 iframe 里；解析与渲染全部在浏览器端完成，上传的日志内容不会到达宿主。
支持哪些 dsh 宿主版本？
已对官方 0.1.0-rc.6 与 rc.8 验证（peer 范围覆盖 rc.6 到当前 rc 线），并随每个新 rc 复验。另有 2.x 线追踪上游宿主 0.1.2 的拆包，用 `dsh plugin --profile web add dsh-maze@2.0.0-alpha.2` 安装。
07相关的 DSH 工作流
dsh-better-sidebar
作者 omdsh-dev
开放的侧边栏底座，支持三方拓展注册新侧边栏页面。内置文件渲染编辑/终端/侧边对话/Git/子代理页面 ｜ Open sidebar foundation, supports third-party extensions to register new sidebar pages. Built-in file rendering/editing, terminal, side chat, Git, and sub-agent pages.
dsh-tui
作者 ccch1mneyyy
DSH 官方公众号收录的 TUI 补位插件：Claude Code 风，鲸鱼顶栏/实时状态/流式思考/双击 Esc 回滚/上下文进度+TPS。npm 一键装。 DSH official WeChat featured TUI plugin — Claude Code style: whale bar, live status, streaming thoughts, double-Esc rollback, context bar + TPS. npm one-click.
openpets
作者 alvinunreal
本地优先的桌面陪伴平台，提供动效宠物、插件 SDK 与编码智能体集成。
dsh-tianshu-tui
作者 huiliyi37
官方 DeepSeek Harness 的交互式终端 UI 插件：自研 ANSI 极简交互渲染、流式 Markdown/工具卡、16+ 主题、slash 命令与选择器、输入历史与本地偏好持久化、LSP 诊断、memory记忆，很丝滑的开发体验。
08数据与来源
dsh plugin --profile web add dsh-maze
重启 `dsh web` 后，侧边栏底部出现「执行迷宫」入口，每个会话视图多一个「实时迷宫」页签。
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成；最后核验于 2026-08-30。发现错误？提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件，覆盖各个分类。