前言¶
代理完成任務後往往會輸出一段技術文本,包含文件名、代碼、路徑和術語。如果你不閱讀代碼,很難快速判斷任務是否成功,或者需要從哪一步開始跟進。dsh-plugin-brief 將每個代理回覆轉換成簡報幻燈片:結論先行,隨後是步驟,最後是需要你處理的提問。原版文本始終保留在側邊,供需要時查看。
插件簡介¶
這是一個 DeepSeek Harness 插件,旨在爲不閱讀代碼的 Harness 用戶提供更易讀的回覆視圖。它將原本的技術文本重新排版爲幻燈片形式,並提供了“通俗化”重寫功能。
- 維護者:dangxinxing090-svg
- 許可協議:MIT
- 目錄頁:https://www.skillhub.cn/plugins/dangxinxing090-svg/dsh-plugin-plain-slides
- 源碼地址:https://github.com/dangxinxing090-svg/dsh-plugin-brief
核心功能¶
- 幻燈片化展示:回覆內容被拆分爲幾張幻燈片。第一頁爲結論,中間爲執行步驟,最後一頁爲待處理的問題或請求。
- 通俗化重寫:提供“通俗化”按鈕,將結論和步驟翻譯爲通俗語言。重寫僅針對報告內容,不包含工作過程。
- 本地佈局,零成本:默認情況下,幻燈片在本地根據原文自動排版,不消耗模型調用。
- 按需重寫:只有當你點擊“通俗化”按鈕時,纔會發起一次模型調用。重寫成功後會被保留,再次查看無需額外付費。
- 雙版本保留:卡片中會同時保留原文版和通俗化版,可以通過按鈕切換,原版始終可點擊查看。
安裝與啓用¶
在安裝前,請確保你的機器上已安裝 DeepSeek Harness (dsh)。
- 執行以下命令安裝插件:
dsh plugin --profile web add github:dangxinxing090-svg/dsh-plugin-brief
安裝後,插件會自動掛載,無需配置文件。
- 如果希望指定版本,可以追加標籤:
dsh plugin --profile web add github:dangxinxing090-svg/dsh-plugin-brief#v0.1.0
- 重啓
dsh進程使插件生效。
--profile web 中的 web 可以替換爲你使用的其他配置文件名稱(如 tui)。
典型用法¶
安裝完成後,代理的每條回覆都會以幻燈片形式展示在回覆卡片上。
- 查看默認視圖:卡片默認顯示爲“原版”幻燈片佈局。
- 請求重寫:在卡片上點擊“通俗化”按鈕。此時卡片標題會顯示“通俗化中…”。
- 查看結果:
- 若重寫成功,按鈕變爲“原版”,表示當前顯示的是通俗版,點擊可切換回原版。
- 若重寫失敗,按鈕恢復爲“通俗化”,但佈局依然保留(只是未簡化)。
- 查看完整原文:點擊卡片頂部的“完整原文”按鈕,可查看包含技術摘要(耗時、操作數、Token 使用量)的完整 Markdown 原文。
工作原理與成本¶
- 渲染劫持:插件接管了回覆渲染器,將原本的 Markdown 直接渲染改爲幻燈片卡片。
- 摺疊工作過程:插件會隱藏工具行、推理摺疊、注入上下文等干擾信息,只保留必要的對話過程(如失敗信息、審批請求等),這些信息會被保留在 Trajectory 視圖中。
- 成本控制:
- 默認查看幻燈片不產生費用。
- 只有點擊“通俗化”時,纔會調用模型翻譯報告內容。
- 重寫成功後,該結果會被緩存,再次查看或重啓 DSH 後無需再次調用模型。
注意事項¶
- 配置文件編輯:不要手動編輯
cordis.yml(該文件由系統生成),請編輯cordis.patch.yml。 - 發佈一致性:如果你 Fork 該插件併發布自己的版本,必須保持
package.json中的name與cordis.patch.yml中的name一致,否則加載器無法解析模塊。 - 安全檢查:插件以當前 DSH 進程的權限運行,安裝前請檢查源碼與許可證。