前言¶
在 DSH 裏寫智能體工作流時,常見的做法是把「讀一本書」塞進一個閒聊式請求:用戶發一句「幫我講講某本書」,模型回一段或長或短的梗概,質量取決於提示詞,也說不清這本書到底講了什麼。
dsh-plugin-book-deconstruct 把這件事固化成插件。它在對話裏充當「書籍解讀」工具,由智能體調用,輸出固定爲兩部分:講清整本書的劇情,和一段有深度的思考。對需要做拆書、講書、內容整理的 DSH 開發者來說,這是可以直接接進 profile 的方案,而不是一段每次重寫的提示詞。
下面介紹這個插件的來歷、安裝方式和用法。
插件信息¶
插件倉庫爲 zmz123612/dsh-plugin-book-deconstruct,維護者是 zmz123612,發佈在社區目錄 SkillHub 上,分類爲工作流。從安裝路徑和 README 看,它是一個 DeepSeek Harness Host 插件:裝進 profile 之後出現在插件列表,任意會話裏都能調用,不需要在每個會話裏重新加載。
包信息裏有幾點值得留意:
1、package.json 聲明的 name 是 dsh-plugin-book-deconstruct,version 是 1.3.1。
2、license 爲 MIT,作者字段寫的是 Kang。
3、engines 裏限制 dsh: ">=0.2.0",說明它依賴較新的 DSH 運行時。
4、倉庫描述寫的是「書籍拆解:/dsh-plugin-book-deconstruct slash + dsh-plugin-book-deconstruct tool for full book walkthroughs」。
5、目錄站和 GitHub 上顯示星標爲 1,fork 爲 1。
核心功能¶
插件提供兩個入口:
1、聊天自然語言觸發,例如「幫我解讀書籍 xxx 作者xxx」。
2、Slash 命令觸發,例如 /dsh-plugin-book-deconstruct 書名 | 作者。
實際執行時由智能體調用 dsh-plugin-book-deconstruct 這個工具名,把書名和作者傳給插件。
輸出固定爲兩段:
1、故事情節——講清整本書,不是一句話短評,也不灌水。
2、一段有深度的思考——只寫一整段,不拆成多段或列表。
這兩段輸出構成了插件的全部行爲,沒有額外的參數開關。README 附帶兩張使用方式截圖,對應上面的兩種觸發路徑。
安裝與啓用¶
從 npm 安裝,README 推薦這條命令:
dsh plugin --profile desktop add dsh-plugin-book-deconstruct
從 GitHub 安裝,README 給出的形式是:
dsh plugin --profile desktop add github:OWNER/dsh-plugin-book-deconstruct
裝完後需要完全退出並重新打開 DeepSeek Harness,插件纔會出現在列表中。這一步容易被忽略,只重載窗口未必生效。
可選配置¶
在 profile 的 cordis.patch.yml 裏按行 id dsh-plugin-book-deconstruct 覆蓋,配置項是 provider 和 model:
- id: dsh-plugin-book-deconstruct
name: dsh-plugin-book-deconstruct
config:
provider: '' # 與 model 成對;空則用默認模型
model: ''
provider 要與 model 成對填寫;兩個都留空則使用默認模型。
典型用法¶
裝好之後,直接在對話裏發需求即可。下面兩種方式都能觸發插件。
方式一,自然語言:
幫我解讀書籍 活着 作者餘華
方式二,Slash 命令:
/dsh-plugin-book-deconstruct 書名 | 作者
例如按第二種形式輸入:
/dsh-plugin-book-deconstruct 沙丘 | 弗蘭克·赫伯特
調用之後,插件會先輸出整本書的故事劇情,再輸出一段獨立成段的思考。
適用場景與注意事項¶
適合的場景大致有兩類。一是內容整理和講書,需要把一本書的主線講清楚,而不是一句帶過。二是 DSH 智能體開發,需要把拆書能力作爲工具掛到 profile 裏,讓不同會話複用同一套解讀邏輯。
需要注意幾點:
1、插件以當前 dsh 進程的權限運行,安裝前應先檢查源碼與許可證,再決定是否接入生產 profile。
2、星標和 fork 都只有 1,社區驗證程度低,建議先在本機跑通再推廣。
3、配置項很少,沒有針對輸出長度的開關,如果希望控制劇情部分的詳略,需要自己在會話裏追加要求。
小結¶
這個插件的價值不在於多麼複雜,而在於把「解讀一本書」固定成兩個固定結構的輸出:劇情加思考。配合 profile 安裝和 Slash 命令,可以在任意會話裏複用。安裝命令和配置項都來自 README,版本號、許可證這類信息來自 package.json。
目錄頁:https://www.skillhub.cn/plugins/zmz123612/dsh-plugin-book-deconstruct
GitHub:https://github.com/zmz123612/dsh-plugin-book-deconstruct