前言¶

DSH 的理念之一是“一切皆插件”，很多長流程可以拆成可安裝、可回退、可抽查的工作流。對老師或課程整理者來說，一個常見問題是：手裏已經有一批教材 PDF，想把它變成可繼續加工、可審校、可下載的教學藍本，但中間要處理材料解析、知識梳理、章節設計、初稿審校等多個環節。

dsh-craft-your-textbook 是 DeepSeek Harness（dsh）的一個插件包，目標是把教材 PDF 加工成「AI 教學藍本」的 6 階段流水線。下面介紹它是什麼、能做什麼、怎麼安裝，以及典型使用步驟。

這是什麼¶

• 插件名稱：xx-hub/dsh-craft-your-textbook。
• 維護者線索：xx-hub。
• 定位：把教材 PDF 加工成「AI 教學藍本」的 6 階段流水線，是 dsh 的一個插件包。
• 許可證：MIT。
• 使用入口：安裝後，在 dsh 的網頁界面（web profile）中啓用“造書模式”。

核心功能¶

這個插件把教材處理流程拆成幾個可暫停、可拍板、可回退的節點。資料稱，它全程中文，且不需要任何技術知識。

1. 上傳教材 PDF
   支持學生用書、教師用書、考綱、講義、真題等材料，一次可多選。

2. AI 探查材料
   AI 探查上傳材料，並生成源材料索引、知識地圖、重點難點和章節安排。

3. 關鍵方案拍板
   學習目標與方法、章節架構等關鍵方案會做成拍板關卡。資料稱，拍板前流程不會繼續往下走。

4. 生成最佳範例章
   先生成一章作爲全書樣板，支持逐行寫意見、與舊稿對比，並支持按章節列出字數清單。

5. 鋪章
   其餘章節由小助手執筆、小助手審計、主 AI 終審，並支持逐章預覽和寫意見。

6. 全章過目
   全部章節寫完後，會停在「全章過目」卡上，讓用戶逐章查看；全部滿意後，才進入最後檢查。

7. 定點修改、催辦和回退
   - 支持定點修改已經拍板的歷史決定，並提示下游影響；資料稱 10 分鐘內可一鍵撤銷。
   - 支持催辦或戳一下 AI，用於提醒未落賬或停下的任務。
   - 支持回退到上一個拍板點；資料稱舊版本只讀保留。

8. 演示流程
   提供「先建一本演示書試試」的演示流程；資料稱該演示流程不花模型額度。

9. 交付結果
   最後檢查通過後，交付《書名》.md，並附「這本書怎麼用」說明和風格意見落實清單。

安裝與啓用¶

先確認環境：需要先裝好 DeepSeek Harness（dsh），並能打開網頁界面（web profile）。

然後運行 README 推薦安裝命令：

npx dsh-craft-your-textbook

首次使用前，還需要配置兩件事：

1. 配置大模型接口
   資料稱，任何兼容 OpenAI 的接口均可，例如 DeepSeek 官方 key。

2. 配置 MinerU Token
   MinerU Token 用於 PDF 轉換。

配置完成後，點「我配好了，繼續」。

隨後打開插件入口：

1. 重啓 dsh。
2. 在瀏覽器打開 http://127.0.0.1:3080。
3. 新建會話。
4. 在模式裏選擇「造書模式」。
5. 進入工作臺，開始新建書。

典型用法¶

下面是一條可按步驟復現的使用路徑。

1、安裝插件

npx dsh-craft-your-textbook

2、打開工作臺

重啓 dsh 後，瀏覽器打開：

http://127.0.0.1:3080

然後新建會話，並在模式裏選擇「造書模式」。

3、新建書並上傳材料

在工作臺點「＋ 新建書」，填寫書名和目標。

接着上傳教材 PDF，併爲每份材料標記角色，例如學生用書、教師用書、考綱、講義、真題。

完成後點「開始轉換」。

4、查看探查結果

工作臺會出現「探查結果」卡。

如果滿意，點「滿意，繼續設計」。

如果不滿意，點「讓 AI 重做」。

5、處理範例章

對生成的最佳範例章，可以逐行寫意見，也可以點「和第 N 稿對比」查看修改內容。

如果滿意，點「滿意，繼續寫全書」。

6、鋪章階段抽查

鋪章時，可以點「看看這章」預覽某一章。

如果認爲需要調整，點「寫意見」，要求 AI 修改並重新自查。

7、全章過目

全書寫完後，會進入「全章過目」卡。

逐章查看後，如果全部滿意，點「都過了，交工」，進入最後檢查。

8、下載成品

最後檢查通過後，點「下載《書名》.md」。

同時查看「你的風格線條條有着落」清單，確認風格意見在成品中的落實情況。

9、先配置再使用

如果是首次使用，先配置大模型接口和 MinerU Token，然後點「我配好了，繼續」。

適用場景與注意¶

適合誰：

• 需要把已有教材 PDF 整理成可加工、可審校、可下載 Markdown 的教學藍本的人。
• 希望在關鍵方案上保留拍板權，而不是讓 AI 一次性跑完全程的人。
• 希望全程使用中文界面，並在資料稱不需要技術知識的前提下嘗試 dsh 插件流程的人。

需要注意：

• 造出來的內容屬於教學參考，AI 可能講錯，需老師或家長複覈後再使用。
• 書項目數據保存在當前會話工作區目錄；工作區不可用或老書可能位於 ~/.dsh/textbook/projects/。
• 卸載會移除插件並刪除 ~/.dsh/.agent-presets/textbook，但書項目數據保留在 ~/.dsh/textbook/projects。
• README 提到，可以在對話裏告訴嚮導一個預算上限；超過時會先暫停詢問。
• 插件以當前 dsh 進程權限運行。安裝前建議檢查源碼與許可證；本包許可證爲 MIT。
• 這裏的目錄頁只是插件線索，不應理解成官方應用商店；DSH 社區目錄是獨立站點。

鏈接¶

• GitHub：https://github.com/xx-hub/dsh-craft-your-textbook
• 目錄頁線索：https://www.skillhub.cn/plugins/xx-hub/dsh-craft-your-textbook
  該鏈接來自插件線索，未能從本次已抓取資料中獨立覈實。