dsh-view-modes

by nigelyao

2 UI 增强github收录于 08-23

DeepSeek Harness 的查看模式:Verbose、Normal 与 Summary 模式

view modes for deepseek harness, including Verbose, Normal, Summary Mode

安装

dsh plugin --profile web add github:nigelyao/dsh-view-modes

GitHub 源码安装:首次需按提示配置 allowBuilds 构建授权后重试

安装与环境配置指引、插件开发教程见 DSH 中文社区文档 ↗

安装即在你的机器上以你的权限运行第三方代码——它可读写文件、使用凭据、访问网络,DSH 的工具审批不会为插件代码加沙箱。「检测到 manifest」仅代表发现 dsh.bundle / dsh.plugin 清单,不构成兼容性或安全审查;安装前请审阅源码,不熟悉的插件先在不含密钥的环境试用。

README

目录

English · 简体中文

这是一个采用 DSH 官方形态的 bundle 插件(dsh.bundle + dsh.client)。插件只调整浏览器端展示,不修改 DSH 核心文件。

效果预览

普通模式会把相关工具调用和思考合并为语义过程组,同时把正文作为清晰的分界。点击过程标题可以查看原始步骤。

可以直接在会话标题栏切换三种模式。

插件文案会跟随 Harness 设置中的语言。切换到 English 后,模式名称、过程标题和工具标签会自动使用英文:

三种模式

模式 适用场景 展示行为
详尽 排查问题 原样保留 DSH 展示的思考、工具调用、重试、上下文和统计信息
普通 日常使用 按语义阶段折叠过程;思考归入相邻过程组;正文始终独立展示,并作为新分组区间的边界
摘要 只关注结果 运行时隐藏过程噪声并显示流光状态;完成后把过程收成一条可展开摘要

普通模式不会按固定调用数量强制拆组。同一阶段中重复读取多个文件、多次执行命令、连续修改文件、搜索或协调任务,都可以继续聚合;一旦出现可见正文,就会立即结束当前组,正文后的过程从新组开始。

安装

环境要求:

  • Node.js 20 或更高版本
  • DSH 已提供 web profile
  • Git
  • PATH 中可以使用 pnpm(dsh plugin 依赖它;缺少时可执行 corepack enable)

GitHub 公开仓库直装(推荐)

无需 npm 账号:

dsh plugin --profile web add git+https://github.com/NigelYao/dsh-view-modes.git

Windows 本地开发方式

需要修改源码并立即调试时,建议把仓库克隆到 DSH 用户目录所在盘符,避免跨盘 package link 失效。

$pluginRoot = Join-Path $env:USERPROFILE ".dsh\local-plugins\dsh-view-modes"
git clone https://github.com/NigelYao/dsh-view-modes.git $pluginRoot
Set-Location $pluginRoot
dsh plugin --profile web add link:$pluginRoot

如果仓库已经位于其他盘符,可以先在 DSH 用户目录创建 junction,再从 junction 安装:

$source = "D:\Projects\dsh\plugins\dsh-output-mode"
$pluginRoot = Join-Path $env:USERPROFILE ".dsh\local-plugins\dsh-view-modes"
New-Item -ItemType Junction -Path $pluginRoot -Target $source
Set-Location $pluginRoot
dsh plugin --profile web add link:$pluginRoot

不要再在 profile 或用户目录的 cordis.patch.yml 中重复插入 dsh-view-modes;插件自身的 patch 已经注册 bundle id。

启动 DSH Web

安装或更新插件后必须重启 DSH Web,因为客户端 bundle 的版本在进程启动时生成。

npx @deepseek-ai/dsh web

浏览器打开 http://127.0.0.1:3080/。

使用方法

  • 在会话标题栏选择 详尽、普通 或 摘要。
  • 使用 Alt+1、Alt+2、Alt+3 快速切换三种模式。
  • 普通模式中,点击「运行了 2 条命令,思考了 3 次」一类的过程标题,可以展开原始步骤;再次点击标题栏即可收起。
  • 过程组展开后,仍可单独展开某条命令的详细信息。收起过程组会复位这些详情,第二次打开时默认保持折叠。
  • 当前模式保存在 localStorage 中,刷新后继续生效;默认模式为 普通。
  • 所有界面文案跟随 Harness 设置中的语言,在中文和英文之间切换时会自动同步。
  • 运行中的过程标题带流光效果,计数增加时数字向上滚动。

摘要模式会在智能体运行期间展示简短的实时活动信息。任务完成后,过程会变成回答上方的一条可展开摘要。

更新

Set-Location $pluginRoot
git pull --ff-only
npm run check
# 拉取完成后重启 DSH Web。

验证

dsh --profile web --dump-config | Select-String "dsh-view-modes"
npm run check

配置中应只出现一次 dsh-view-modes。DSH Web 运行时,http://127.0.0.1:3080/plugins/dsh-view-modes/client.js 应返回 HTTP 200。

文档

  • 技术说明:架构、分组规则、属性表、性能约束与维护入口

许可证

MIT

原始 README: https://github.com/NigelYao/dsh-view-modes/blob/main/README.zh-CN.md ↗