前言¶
在 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 工作流裏的客戶端增強。
