前言¶
在 DeepSeek Harness（DSH）里跑智能体任务时，Web 界面会持续刷新会话列表、Composer、通知等元素。任务本身在后台照常执行，但界面仍会分散注意力。常见做法是手动最小化窗口或切到其他应用，DSH 侧并没有内置「只保留进度、隐藏整套 GUI」的模式。
下面介绍社区插件 dsh-zen-mode（维护者 Clmzz-gra，分类：客户端）：进入禅模式后，用全屏极简页盖住整个 DSH Web 客户端，任务不暂停、不打断；你只看到计时、本回合内完成的会话名，以及退出入口。
这是什么¶
dsh-zen-mode 是面向 DeepSeek Harness 的禅模式插件。npm 包名与插件 ID 均为 dsh-zen-mode，当前发布版本 0.2.0，许可证 MIT。
插件以纯覆盖层方式工作：进入或离开不会写会话日志、不改设置、不向模型注入内容；也不会暂停或打断任何会话，仅根据公开的 running 状态展示「本回合哪些任务已从运行变为空闲」。
核心功能¶
全屏界面布局¶
在侧栏 插件 与 自动化任务 下点击 禅模式 / Zen mode 后，整个 GUI 被一次性覆盖。此时无法打开会话列表、Composer、设置或 Toast；要进某个会话须先退出禅模式。
| 区域 | 内容 |
|---|---|
| 左侧 | 计时器。默认 正计时：从 00:00 累计，超过一小时显示为 h:mm:ss。在设置中可改为 倒计时。 |
| 右侧 | 已完成会话 / Completed sessions：本回合内从 running 变为 idle 的会话名，按完成顺序列出。尚无完成项时，该列整列不显示。 |
| 右下 | 退出 / Exit 按钮；旁侧为 mascot 循环动画（纯装饰，不可点击；Host 未提供 mascot 路由时会隐藏）。 |
计时方式¶
路径：Settings → General → 计时方式 / Timer direction。
- 正计时 / Count up（默认）：从 00:00 起累计，不会自动结束；离开须显式操作。
- 倒计时 / Count down：可配置 倒计时时长 / Countdown length，整分钟 1–120，默认 25；每次进入禅模式重新从该时长开始，到
00:00自动退出。选正计时时该字段隐藏。
本回合「已完成会话」的判定¶
会话在 running 状态变为 idle 时计入列表；子 agent 会话排除。插件不区分正常结束、中止、阻塞或失败——凡停止都会以同样方式列出，因为页面只回答「还有哪些任务不必再干等」。
仅统计当前这一轮禅模式内的完成项；进入前已结束的会话不会回放。
退出方式¶
文档列出四种彼此独立的出口，避免页面「困住」用户：
- 点击 退出 / Exit。
- 按
Esc。 - 倒计时模式下计时到
00:00自动退出（正计时无此路径）。 - 刷新页面：激活状态只存在于页面内存，刷新后恢复完整 DSH。
若显式退出后卸载异常导致仍被覆盖，插件会在短时间后重新加载文档。
边界与兼容¶
- 全局覆盖：一个客户端一次一层；多浏览器标签各自独立一轮。
- 退出后落点：侧栏入口属于 panel，客户端无公开的「当前 panel」读取 API，退出后回到对话视图，而非进入禅模式前的任意 panel。
- 覆盖范围：仅 Web 视口；桌面窗口原生标题栏按钮与浏览器级快捷键（刷新、关标签、DevTools）仍在覆盖层外。
- 无遥测：插件不向任何位置上报数据。
在 Windows 上针对 DSH 0.2.1-rc.2 做过测试。插件不声明对 @deepseek-ai/dsh-* 的 npm 依赖：浏览器端从 Host 模块表解析 React，仅通过 slot API 注册。需要 Host 提供 sidebar.panellist、shell.overlay、main、settings.general.item 等 Web 客户端能力。
安装与启用¶
安装命令（摘自官方 README）：
dsh plugin --profile <your-profile> add dsh-zen-mode
插件以 bundle 形式追加到 dsh.profile.bundles，无需手改 cordis.patch.yml。安装后需重启页面或客户端，以便浏览器加载新的 UI 模块。
卸载：
dsh plugin --profile <your-profile> remove dsh-zen-mode
典型用法¶
- 在 DSH 中已启动或即将启动需要等待的智能体任务。
- 侧栏打开 禅模式 / Zen mode，界面进入全屏极简态；后台任务继续执行。
- 需要番茄钟式等待时：先在 Settings → General 将计时改为倒计时并设定分钟数，再进入禅模式。
- 右侧列表出现会话名时，表示该任务在本回合内已从运行变为空闲；全部关心的任务出现后，用退出按钮、
Esc、倒计时归零或刷新页面回到完整界面。
mascot 由 Host 半在 /zen-mode/mascot.webp 提供静态资源；仓库内为 160×160、约 283 KB 的 animated WebP，仅作视觉装饰。
适用场景与注意¶
适合：长时间跑 agent、自动化任务时，希望减少 DSH Web UI 对注意力的占用，同时仍能看到 elapsed/remaining 时间与「刚结束的任务名」。
注意：
- 插件与当前 DSH 进程同权限运行；安装前请阅读 GitHub 仓库 源码与 MIT 许可证，确认符合你的环境策略。
- DSH 生态强调「一切皆插件」；SkillHub 目录页 为社区站点，与 DeepSeek / 幻方无官方从属关系，并非官方应用商店。
- 禅模式不能替代任务监控：列表不区分成功与失败，也不展示子 agent；深度排查仍须在退出后于正常界面查看会话。
结尾¶
dsh-zen-mode 用全屏计时与「本回合已完成会话」列表，在任务照常运行的前提下遮住整套 DSH Web GUI，适合需要专注等待 agent 完成的场景。
