前言¶
用大模型寫長篇或做角色扮演,最容易崩的不是文筆,而是設定。人物關係、地名、組織規則一旦只靠會話記憶,寫到後面就會串線:同一角色換了稱呼,世界書裏寫過的禁令被模型隨手改掉。SillyTavern / TavernAI 這邊已經有成熟的角色卡和世界書(lorebook)格式,條目可以按觸發詞注入;DeepSeek Harness(dsh)這邊則把模型、工具、會話和界面都做成插件,官方倉庫的口號是 Everything is a plugin(一切皆插件)。兩邊的設定格式並不互通。
dsh-LorebookMD 做的就是橋接:把酒館角色卡和世界書導入當前 dsh 進程,落地成可編輯的本地 Markdown,再按「創作」或「世界書」兩種預設注入系統提示詞。社區目錄把它歸在「記憶」分類,維護者是 GitHub 用戶 609476965。本文按目錄詳情頁、GitHub README / package.json / 源碼,以及 npm 頁面交叉覈對,覈實日期爲 2026-08-18。
需要先說明兩件事。第一,DeepSeek Harness 目前仍是 developer preview,官方 README 寫明會有破壞性變更。第二,deepseek-harness-plugin.com 是獨立的社區目錄,About 頁寫明與 DeepSeek / 幻方沒有官方從屬關係,不能當成官方應用商店。
這是什麼¶
dsh-LorebookMD 是一款面向 DeepSeek Harness Web 的世界書驅動創作插件。npm 包名是 dsh-lorebookmd,當前版本 1.0.0,主要語言 TypeScript。package.json 把客戶端平臺聲明爲 web,並聲明瞭 dsh.bundle.patch,安裝後由 profile 自動套用 cordis.patch.yml。
它解決的問題很具體:你已經有酒館角色卡(PNG 內嵌或 JSON)或獨立世界書 JSON,希望在 dsh 裏繼續用同一套設定寫小說或做角色扮演,而不是把條目手工粘進對話。插件只管理你自己提供的設定文本;README 寫明工程內不內置任何「破限 / 越獄」提示詞。
社區目錄頁在收錄時顯示 5 星;GitHub 倉庫在 2026-08-18 查詢爲 13 星。package.json 與 npm 登記許可證爲 MIT,倉庫根目錄目前沒有獨立的 LICENSE 文件,GitHub 元數據因此未識別許可證。安裝前仍應自己打開源碼覈對。
核心功能¶
導入酒館角色卡與世界書¶
README 和 src/tavern.ts 列出的輸入包括:
- 角色卡:PNG(
tEXtchunk 裏 keyword 爲chara的內嵌 JSON)或獨立 JSON(chara_card_v2以及舊版字段置頂格式) - 卡內世界書:
extensions.world,以及 SillyTavern 的character_book(角色書),兩者會合並 - 獨立世界書:頂層
{ entries: [...] },也兼容條目對象和純數組 - 正則腳本:卡內
extensions.regex_scripts/extensions.regex,或獨立腳本 JSON;源碼註明 DSH 沒有聊天正則渲染管線,導入後只作參考,由模型自行對照,不會像酒館那樣自動替換對話文本
對話工具 prompt_import_tavern、prompt_import_world、prompt_import_regex 與設置頁走同一份數據。導入角色卡時需要絕對路徑。
每本世界書三件產物¶
導入成功後,插件爲每本世界書生成三件東西:
| 產物 | 作用 |
|---|---|
名·世界書 預設 |
設定全文 + 關鍵詞自動觸發:對話裏提到觸發詞時,對應條目注入本輪 |
名·創作 預設 |
創作模式:創作指令 + 設定全文,激活後按用戶輸入寫小說正文 |
worldbooks/<名>.md |
本地 Markdown 設定文檔,可用系統默認程序打開後手工編輯 |
世界書條目支持常駐(constant,不依賴觸發詞)和按 keys 匹配。worldTrigger 默認開啓。激活的預設會通過 systemPrompt.section() 注入;切換後下一輪對話生效,不必重載插件。
兩種模式¶
README 把用法分成兩條路徑,可隨時切換,停用後回到正常會話:
| 進入創作(激活「·創作」) | 世界書模式(激活「·世界書」) | |
|---|---|---|
| 輸出 | 第三人稱小說正文,直接寫、不復述設定 | 以世界內角色身份對話、推進劇情 |
| 設定 | 全文注入,模型參考 | 全文注入 + 關鍵詞觸發條目 |
| 交互 | 給場景 / 情節 / 人物,繼續給則續寫 | 以第一人稱參與,模型以角色回應 |
| 適合 | 寫小說、場景描寫 | 沉浸式角色扮演、互動推演 |
源碼裏創作預設的規則是:尊重世界設定中的規則、組織、人物關係和世界觀,不得擅自違背或新增;按用戶給出的場景寫連貫正文,而不是對話式回覆。
設置頁與預設工具¶
package.json 聲明瞭 Web 客戶端注入。啓動後打開默認 Web UI http://127.0.0.1:3080,進入 設置 →「世界書創作」,可以看世界書列表、進入創作、切到世界書模式、用系統程序編輯本地 .md、導入和刪除。終端應打印 [prompt-manager] ready: …(插件內部 Cordis 組件名是 prompt-manager)。
對話裏還可以用預設管理工具:prompt_preset_list、prompt_preset_use、prompt_preset_off、prompt_preset_save、prompt_preset_delete。源碼註釋裏的說法包括「列出所有提示詞預設」「切換到某預設」「停用提示詞預設」。
數據落在本地¶
默認目錄是 ~/.dsh/dsh-LorebookMD(可用配置項 dataDir 覆蓋):
| 數據 | 路徑 |
|---|---|
| 預設(含創作 / 世界書預設正文) | ~/.dsh/dsh-LorebookMD/presets.json |
| 世界書條目(關鍵詞觸發用) | ~/.dsh/dsh-LorebookMD/worldbooks.json |
| 本地設定文檔 | ~/.dsh/dsh-LorebookMD/worldbooks/<名>.md |
watchFile 默認開啓:直接改 presets.json 會熱載入。JSON 損壞時,插件會把原文件備份成 *.broken-* 再以空庫啓動,避免覆蓋用戶數據。
安裝與啓用¶
社區目錄頁給出的安裝命令如下,在 DeepSeek Harness 終端中運行:
dsh plugin add github:609476965/dsh-LorebookMD
如需可復現安裝,目錄頁建議固定 commit 哈希(把 commit 換成實際哈希):
dsh plugin add github:609476965/dsh-LorebookMD#commit
當前 main 在 2026-08-14 的最新提交是 4bc4110efbfb4888286b81aaf53191705dade9dd。插件以當前 dsh 進程的權限運行,安裝時可能執行代碼;安裝前請檢查源代碼倉庫和許可證。
倉庫 README 另外推薦從 npm 裝到 web profile(包已發佈 1.0.0,內置 lib/ 構建產物):
dsh plugin --profile web add dsh-lorebookmd
dsh plugin 會把本包加入 dsh.profile.bundles 並應用 cordis.patch.yml。官方 Harness 文檔要求安裝 bundle 後重啓 profile,例如 dsh --profile web。package.json 要求 Node.js >= 22.18。
也可以直接對 dsh 說:
幫我安裝這個插件https://github.com/609476965/dsh-LorebookMD
README 還提供了 install.cmd / install.ps1 一鍵複製到 profile 的 node_modules,以及臨時用 start-dsh-plugin.cmd 以 --patch 加載 cordis.yml 的方式。自動掛載和 --patch 臨時掛載不要同時使用,否則會重複掛載。
典型用法¶
下面按 README 和源碼可以復現的路徑寫,不額外編造角色卡內容。
- 按上一節裝好插件並重啓 web profile,打開
http://127.0.0.1:3080。 - 把酒館導出的角色卡(
.png/.json)或世界書 JSON 放到本機某個絕對路徑。 - 在設置頁點導入,或在對話裏讓助手調用工具。角色卡示例(路徑換成你的文件):
導入 C:/cards/xxx.png 角色卡
對應工具是 prompt_import_tavern。獨立世界書用 prompt_import_world,可傳 activate 以便導入後立刻激活「·世界書」預設。
- 導入完成後,設置頁會出現該世界書。點 進入創作 激活
名·創作,或點 世界書模式 激活名·世界書。 - 創作模式下,按 README 的典型指令給場景,例如「寫一段……」「描寫……的過程」,模型應輸出小說正文。世界書模式下用第一人稱推進,例如「我是……,然後呢?」。
- 需要改設定時,點 編輯文檔,用系統默認程序打開
worldbooks/<名>.md。預設正文存在presets.json,改完後下一輪對話會讀到新內容。 - 停用預設後回到普通會話。刪除世界書會同時去掉「·世界書」「·創作」預設和對應 Markdown 文件。
適用場景與注意事項¶
適合已經有酒館角色卡 / 世界書、希望在 dsh Web 裏繼續寫小說或做角色扮演的人。它管的是「設定如何導入、落地、按模式注入」,不是通用的跨會話長期記憶,也不是知識圖譜。社區目錄裏同類「記憶」插件(如 graph-memory、mnemon)解決的是另一類問題。
使用時注意這些邊界:
- 客戶端聲明爲 web,設置頁依賴默認 Web UI;不要假定終端 headless 會話裏也有同一塊界面。
- 導入路徑必須是絕對路徑;相對路徑會失敗。
- 正則預設不會在 DSH 裏自動改寫對話,只是把腳本定義存成參考文本。
- 創作模式要求模型不擅自新增設定;實際效果仍取決於當前模型和是否激活了對應預設。
- 數據在本機
~/.dsh/dsh-LorebookMD下,備份或遷移時把這個目錄一起帶走。 - 插件以當前 dsh 進程權限運行。安裝社區插件前應閱讀源碼和許可證;目錄頁也提醒:需要可復現安裝時固定 commit。
小結¶
dsh-LorebookMD 把 SillyTavern / TavernAI 的角色卡和世界書接到 DeepSeek Harness:導入後得到本地 Markdown、關鍵詞觸發的世界書預設,以及專門寫小說的創作預設。維護者是 609476965,社區目錄分類爲記憶,npm 包 dsh-lorebookmd 當前爲 1.0.0。
目錄頁:https://deepseek-harness-plugin.com/zh-CN/plugins/dsh-lorebookmd/
GitHub:https://github.com/609476965/dsh-LorebookMD