前言¶
DeepSeek Harness (DSH) 提供了插件擴展能力,開發者在使用過程中常面臨結構化內容管理混亂的問題。xiashuo 是一個面向 DSH 的插件,旨在爲課程、公文、小說、論文等創作提供項目級的管理與工作流支持,解決多類型文檔在編寫、校驗與協作中的流程斷層問題。
插件簡介¶
這是一個 AI course-authoring workspace plugin for DeepSeek Harness (DSH)。由用戶 bettermen 維護,採用 MIT 許可證。
其核心價值在於將創作過程結構化:通過首頁統一管理項目,配合可編輯的工作流與門禁機制,確保內容按步驟推進;同時利用知識圖譜與資料庫固化知識點,支持導出與協作。
核心功能¶
插件提供以下核心能力:
-
首頁項目管理
- 支持卡片與列表雙視圖,展示類型、狀態、進度與字數。
- 提供篩選(類型、狀態、關鍵詞)、排序(時間、名稱等)功能。
- 支持新建、編輯、複製、歸檔及刪除項目。
-
多類型支持與可編輯工作流
- 內置四種類型:課程(九階段)、公文(七階段)、小說(九階段)、論文(八階段)。
- 支持用戶自定義類型。
- 工作流支持拖拽排序、增刪階段、修改門禁與提示詞,並提供模板管理。
-
三欄式工作臺
- 左欄:章節列表(支持拖拽排序)、階段門禁導航、流程編輯器。
- 中欄:Markdown 編輯器(支持自動保存、代碼高亮、格式化工具欄)。
- 右欄:資料庫(知識點管理)與知識圖譜(可視化關聯)。
-
門禁式編寫流程
- 前一階段未批准無法進入下一階段。
- 每次提交留檔,支持回退與審計日誌。
-
資料庫與知識圖譜
- 資料庫按項目隔離,支持知識點的新增、編輯、停用與刪除。
- 知識圖譜可視化節點關係,支持防重疊佈局。
-
協作與導出
- 支持生成只讀或可編輯的分享鏈接(帶 Token 鑑權),支持多人協作與衝突檢測。
- 支持導出爲 TXT 或 Word (.docx) 格式。
安裝與啓用¶
安裝前需確保已安裝 DeepSeek Harness(DSH),且運行環境 Node 版本 ≥ 18。
數據僅存儲在本地,不上傳雲端。
- 下載插件文件(通常爲
.tgz包)。 - 在終端執行安裝命令:
dsh plugin --profile web add <該文件路徑>
- 執行
dsh plugin list確認插件已在列表中。 - 刷新 DSH 頁面(Ctrl+Shift+R),側邊欄將出現「蝦說」入口。
典型用法¶
- 創建項目:打開「蝦說」首頁,點擊「+ 新建項目」,選擇類型(如課程)與題材,填寫簡介。
- 編寫內容:進入項目工作臺,左欄切換章節,中欄撰寫 Markdown 正文(停止輸入 2 秒自動保存)。
- 管理流程:在左欄「流程」頁調整階段順序或編輯門禁條件。
- 管理知識:在右欄「資料庫」錄入知識點,在「知識圖譜」中查看結構。
- 導出與協作:頂部點擊「導出」下載文檔,或「分享」生成協作鏈接。
注意事項¶
- 數據路徑:所有數據保存在本地
~/.dsh/xiashuo/,包含projects、lorebook、templates等目錄。 - 分享安全:分享鏈接走獨立
/share/公開路徑,配合 Token 鑑權,不暴露管理憑據。 - 許可證:採用 MIT 許可證,開源使用。
目錄¶
鏈接¶
- 插件目錄:https://www.skillhub.cn/plugins/bettermen/xiashuo
- GitHub 倉庫:https://github.com/bettermen/xiashuo