前言¶

DeepSeek Harness（下稱 DSH）的理念是「一切皆插件」。這套設計給了足夠的靈活度，但門檻也留在了界面上：一次任務裏，模型會連續調用一串工具，原生界面上相應滾過一長串工具卡片，術語、參數、狀態混在一起。想先用起來的人，很難從中讀出「這輪到底做了什麼」；熟悉它的老手又需要完整信息，不希望界面被簡化。原生界面只有一種讀法，兩撥人只能遷就同一種呈現。

dsh-prism 針對的就是這一點：給 DSH 的 Web UI 加了兩檔模式，「簡化」給想省事的人，「原生」原樣還給老手，一鍵切換，不用的時候卸掉也不留痕跡。下面介紹它的功能、安裝和用法。

這是什麼¶

dsh-prism 是一個 DSH 客戶端類插件，由 KhalilYamber 維護，MIT 許可證，當前版本 1.2.0（2026-08-18）。一句話定位：DSH 界面兩檔模式插件，簡化 / 原生一鍵切換，工具卡片白話化，降低 DeepSeek Harness 的上手門檻。

默認處於原生檔，產品界面原樣呈現；切到簡化檔，插件纔開始接管界面。切換即時生效，不需要刷新頁面。

核心功能¶

左下角懸浮入口¶

啓動 Web UI 後，左下角會出現一個懸浮按鍵，顯示當前所處模式。點開菜單可以在「簡化 / 原生」之間切換，菜單裏還有一個「隱藏複雜工具」開關。切換即時生效，無需刷新。

簡化檔：工具調用收成摺疊組¶

簡化檔的核心是摺疊組。歸組規則：一次 user turn 內、模型正式回覆之前的全部工具調用算一組。收起時只顯示一行統計「N 個工具 · M 次思考」，行尾帶組狀態：✓ 完成、● 運行中、✕ 有出錯。

文檔化面板與交付文檔¶

點開統計行，展開一個文檔化面板，分三塊：

1、標題區：顯示「本次調用 N 個工具 · M 次思考」；
2、清單區：每個工具一行，類別圖標 + 白話動作/參數摘要 + 狀態圖標；
3、說明區：補充說明。

再點單行，可以展開該工具的「交付文檔」詳情：結果先脫敏，再按 Markdown 子集渲染，支持表格、代碼塊、標題、列表、粗體、行內代碼與 commit 哈希高亮；任何解析失敗都退化爲純文本。

隱藏複雜工具¶

簡化檔面板內，21 個高級工具（目標/計劃、子代理編排、後臺任務、插件系統）默認摺疊成一行白話摘要，點開可以看詳情。這個行爲由菜單裏的「隱藏複雜工具」開關控制，默認開啓，可隨時關閉。

白話文案與雙語界面¶

白話文案來自一張 33 個工具的規則表，例如 pwsh 顯示爲「正在電腦上執行一條命令」。v1.0.0 起，19 個沒有原生卡片的工具由插件卡片接管；v1.1.0 起，摺疊組內的所有工具——包括官方已有產品級卡片的 read、write、web_search——統一按白話規則渲染，原生檔下它們仍是產品原版卡片。

界面文案全部跟隨 DSH 的界面語言（簡體中文 / English），在設置裏切換語言即時生效，無需刷新。這是 v1.2.0 加入的能力。

數據脫敏¶

簡化檔的詳情展示做了三層脫敏：

• 路徑類參數只顯示文件名（file_path 取 basename）；
• token、secret、password、api_key、authorization 等敏感參數名永不展示；
• 結果文本中的常見密鑰形態（sk-xxx、Bearer xxx、key=xxx）替換爲佔位符。

詳情面板只展示白話摘要與脫敏結果，不暴露原始參數。

原生檔與設計原則¶

原生檔下插件不註冊任何工具卡片，產品原貌原樣渲染，切換即時生效。幾條貫穿的設計原則：

• 純展示層：只改界面呈現，模型收到的輸入輸出與原生完全一致，不影響 agent 幹活；
• 內存態切換：檔位存在內存裏，刷新頁面回到原生檔；卸載插件後，界面回到出廠狀態，無配置污染、無殘留；
• 跟隨主題：全部使用官方 --dsw-alias-* 設計變量，明暗主題自適應。

實現上補充一句：簡化檔通過在 conversation.chat.node 槽位以 priority: -1 shadow 產品自帶的 ToolCallTree 渲染器實現歸組，原生檔則完全不註冊；全部客戶端邏輯集中在 lib/client.js，改完刷新頁面即生效。

安裝¶

前置只有一個：裝好 DeepSeek Harness（Node.js 22.19+ 或 24+）。插件自身聲明瞭兩個 peerDependencies：react ^18.2.0、@deepseek-ai/cordis ^4.0.1。

插件未發佈到 npm，通過倉庫克隆或 Releases 產物分發。先克隆倉庫：

git clone https://github.com/KhalilYamber/dsh-prism.git

然後以本地路徑安裝，把 <本倉庫目錄> 換成剛克隆出來的路徑：

npx -y @deepseek-ai/dsh plugin --profile web add ./dsh-prism

這一步把插件以 web profile 裝進 DSH。如果不想克隆倉庫，也可以直接從 GitHub Releases 下載打包產物。裝好後啓動 Web UI，左下角會出現懸浮入口。

典型用法¶

經過上面的步驟，插件已經可用，日常操作如下：

1、啓動 Web UI，點擊左下角懸浮按鍵（顯示當前模式）；
2、選擇「簡化」：一次任務裏的工具調用歸成摺疊組，收起是一行統計，點開展開面板看每個工具的白話行與交付文檔詳情；
3、菜單裏按需開關「隱藏複雜工具」（僅簡化檔生效）；
4、想看完整信息時選「原生」，恢復完整原生界面；
5、刷新頁面回到原生檔。

適用場景與注意¶

適合誰：

• 剛上手 DSH 的用戶：簡化檔把一次任務的工具調用收成一行統計，想知道細節再逐行展開；
• 需要演示或覆盤流程的場景：文檔化面板和交付文檔比原始工具卡片好讀；
• 老手不受影響：默認就是原生檔，切過去也是零改動。

使用前注意：

1、插件以當前 dsh 進程的權限運行，安裝任何第三方插件前都應檢查源碼與許可證。dsh-prism 是 MIT，實現集中在 lib/client.js 一個文件，方便通讀；
2、檔位不持久化：刷新即回原生檔是刻意設計，想持續用簡化檔，每次打開頁面需要重切一次；
3、簡化檔只改你看到的界面，模型收到的輸入輸出與原生完全一致，不會影響任務結果。

結語¶

dsh-prism 不改變 DSH 的工作方式，只改變人讀界面的方式：新手看白話摺疊組，老手要完整原生呈現，兩檔一鍵切換，卸載後無殘留。如果你正被 DSH 的上手門檻勸退，或者想給團隊裏的新手一個更平緩的入口，可以從下面兩個地址開始：

• GitHub 倉庫：https://github.com/KhalilYamber/dsh-prism
• 社區插件目錄收錄頁：https://www.skillhub.cn/plugins/KhalilYamber/dsh-prism （社區獨立站點，與 DeepSeek 官方無從屬關係）