前言¶
在 DeepSeek Harness（DSH）里跑智能体时，对话视图会持续刷工具调用、命令输出、推理行和上下文折叠信息。任务在后台推进时，界面往往比「最终结论」更占注意力。若你希望在 agent 运行期间只看状态、自己的上一条消息和最终 Markdown 回复，而不是整屏中间过程，就需要在 Web 客户端侧做视图裁剪，而不是改 agent 本身。
下面介绍社区插件 dsh-zen（目录名 john-walks-slow/dsh-zen，npm 包 @johnnren/dsh-zen）：它在 DSH Web GUI 增加 Zen 标签页，并提供前台盯屏时长与每日/每周「禅值」统计。插件归类为客户端，纯前端实现，README 写明零权限（无网络、无文件系统、无外部服务）。
这是什么¶
dsh-zen 由维护者 john-walks-slow 发布，仓库 https://github.com/john-walks-slow/dsh-zen，社区目录页 https://www.skillhub.cn/plugins/john-walks-slow/dsh-zen。SkillHub 为独立插件目录站点，与 DeepSeek / 幻方无官方从属关系。
一句话定位：在默认 web profile 的 DSH Web 客户端里，增加 对话 / Zen / 轨迹 中的 Zen 视图，并在可选配置下自动进出禅模式；同时用浏览器 localStorage 记录「窗口在前台」与任务总运行时间的比例，换算成禅值（100% − 盯屏比例）。
核心功能¶
以下能力均来自仓库 README，安装前可在 GitHub 源码与 cordis.patch.yml 中自行核对。
Zen 视图标签页¶
插件注册 conversation.view 插槽，提供独立 Zen 标签，界面刻意极简：
- 可配置的运行中 / 完成状态标题（及可选副标题）
- 生成中展示用户消息、上一轮回复与动态提示；完成后以 Markdown 渲染 AI 最终回复
- 单行轮次统计：
步数 N · 用时 Nm · 统计（各块可在设置中开关）
数据来自 Web 客户端已有会话快照（如 uiConversation.binding(sessionId).target("chat")），不额外请求网络。
前台时间与禅值¶
Foreground time tracker 按会话记录「窗口可见」时长与任务总运行时长，持久化在 localStorage（键前缀 dsh.zen.*）。设置面板展示 今日禅 / 本周禅 及当前禅等级；禅值定义为 100% − 盯屏比例。
对话视图辅助¶
- 隐藏中间过程：会话头按钮
隐藏中间过程，通过 CSS 隐藏聊天里的工具调用、命令、上下文、压缩、推理等行 - 自动进入 / 解除禅：可选在任务开始时切到 Zen 标签，完成时回到对话
- 快捷键：任意处按
Alt+Z在 Zen 与对话视图间切换 - 动效开关：可关闭 Zen 视图入场动画，改为即时渲染
安装与启用¶
插件以 DSH bundle 分发，需要具备 Web 能力的 profile（默认 web）。安装后需重启 dsh web；bundle 的 cordis.patch.yml 会把 zen 行写入 profile composition，Web 客户端由仓库提交的 lib/client.js 提供。
从 Git 仓库安装（README 推荐）¶
将 <40-character-commit> 替换为要固定的 40 位 commit SHA（README 建议 pin 精确 commit，避免浮动分支被 force-push）：
dsh plugin --profile web add github:john-walks-slow/dsh-zen#<40-character-commit>
然后重启 dsh web。
从 npm 安装（README 注明发布后可用）¶
dsh plugin --profile web add @johnnren/dsh-zen
package.json 当前版本为 1.1.0，许可证 MIT。
卸载¶
dsh plugin --profile web remove @johnnren/dsh-zen
也可从 profile composition 移除对应行。清除 localStorage 里前缀为 dsh.zen. 的键可删掉本地统计与设置。
典型用法¶
- 在 DSH Web GUI 打开任意会话。
- 点击 Zen 标签，或按
Alt+Z进入禅视图；agent 在后台跑时在此查看状态与最终回复。 - 若仍留在对话页，可用头栏 隐藏中间过程 折叠中间节点。
- 打开 Settings → Zen 设置，按需开关：
- 显示进行中标题 / 副标题、显示结束标题
- 生成中显示用户消息、上轮回复、动态
- 显示本轮轮次和用时、显示盯屏时间统计
- 自动进入禅 / 自动解除禅、动效
设置页会同步展示今日禅、本周禅与当前禅等级。
适用场景与注意¶
适合谁：长时间让 DSH agent 在 Web 里跑任务、希望减少界面噪音、又想知道自己在任务运行期间有多少时间在「盯屏」的用户。
兼容性：README 写明需要带 Web 客户端模块系统的 DeepSeek Harness，并在 0.2.0-rc.2 上做过验证（见仓库 docs/issues/261011-dsh-02-compat）。使用的插槽包括 conversation.view、conversation.session.header.actions、settings.section；升级 DSH 主版本时应对照目标版本的 slot 契约是否仍一致。
权限与安全：插件声明零权限；host 侧为空的 apply()，数据仅在浏览器 localStorage。安装前仍建议阅读源码、cordis.patch.yml 与 LICENSE，并确认与你当前 dsh 进程、profile 一致——DSH 生态是「一切皆插件」，第三方 bundle 会 patch 你的 Web profile。
开发侧：若自行改插件，客户端改动刷新页面即可；host 侧改动需重启 DSH。构建与 e2e 说明见仓库 README 的 Development 一节。
结尾¶
dsh-zen 把 DSH Web 对话里的「看过程」和「看结果」拆开：Zen 标签给 agent 运行期一块安静表面，盯屏统计则把前台时间量化成每日/每周禅值；配合隐藏中间过程、自动进出禅与 Alt+Z，适合作为默认 Web 工作流里的客户端增强。
