dsh-plugin-brief：將 DeepSeek Harness 回覆轉換爲幻燈片

前言¶

DeepSeek Harness (DSH) 是一個用於智能體開發的工具。智能體完成任務後，通常輸出大量技術文本，如文件路徑、代碼片段和複雜說明。對於不閱讀代碼的用戶，這些內容難以快速獲取核心結論。dsh-plugin-brief 旨在解決這個問題，它提供了一種替代的閱讀方式，將技術文本轉化爲簡短幻燈片。

插件介紹¶

這是一個 DeepSeek Harness 插件，插件 ID 爲 brief，由 dangxinxing090-svg 維護，採用 MIT 許可證。它不改變智能體的原始輸出邏輯，而是接管了渲染流程，爲每個回覆提供幻燈片視圖。

核心功能¶

插件主要提供以下功能：

幻燈片視圖：將每個代理回覆轉換爲幻燈片。優先展示結論、後續步驟以及等待用戶決策的問題。
本地渲染：默認情況下，回覆以幻燈片形式在本地渲染，不產生調用成本。
通俗化重寫：提供“通俗化”按鈕，將當前技術文本重寫爲通俗語言。
重試機制：重寫失敗時，插件會自動重試，最多重試 3 次。
信息過濾：在對話流中隱藏工具行、系統提示、推理過程摺疊等內部細節，僅保留 Trajectory（軌跡）。
歷史保留：成功的歷史翻譯會保留，再次查看時無需重新調用模型。

安裝與啓用¶

使用以下命令安裝插件：

dsh plugin --profile web add github:dangxinxing090-svg/dsh-plugin-brief

安裝後需要重啓 dsh 才能生效。包目前不在 npm 上，只能通過 GitHub 倉庫安裝。

如果需要手動安裝，請執行以下步驟：

    cd ~/.dsh/profiles/web

安裝包：

    pnpm add github:dangxinxing090-svg/dsh-plugin-brief

編輯 cordis.patch.yml 文件，添加插件配置：

    - insert:
        - id: brief
          name: 'dsh-plugin-brief'

重啓 dsh。

典型用法¶

在 DSH 界面中，安裝插件後，回覆區域會顯示爲幻燈片卡片。用戶可以點擊“通俗化”按鈕將技術文本重寫爲通俗語言，或點擊“完整原文”查看原始 Markdown。

配置插件行時，必須包含 id: brief 和 name: 'dsh-plugin-brief'。如果需要完全移除重寫按鈕，可以在配置中設置 disabled: true。

卸載插件的命令如下：

dsh plugin --profile web remove dsh-plugin-brief

適用場景與注意¶

適用場景：適合需要向非技術背景人員彙報智能體工作結果的場景，或者需要快速瀏覽工作結論的場景。
配置文件：編輯 cordis.patch.yml 時，不要修改 cordis.yml（後者是生成的）。
成本與性能：默認情況下回復成本爲 0，僅在點擊“通俗化”時調用模型。僅翻譯最後一步的報告，不翻譯工作過程。滾動回不重新請求。
權限：插件以當前 dsh 進程的權限運行，安裝前應檢查源碼與許可證。

短結尾¶

該插件通過改變默認顯示方式，降低了非技術用戶閱讀 DSH 輸出的門檻。更多細節和源碼，請參考 GitHub 倉庫。