用 dsh-LorebookMD 把酒館世界書接到 DeepSeek Harness

前言

用大模型寫長篇或做角色扮演,最容易崩的不是文筆,而是設定。人物關係、地名、組織規則一旦只靠會話記憶,寫到後面就會串線:同一角色換了稱呼,世界書裏寫過的禁令被模型隨手改掉。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(tEXt chunk 裏 keyword 爲 chara 的內嵌 JSON)或獨立 JSON(chara_card_v2 以及舊版字段置頂格式)
  • 卡內世界書:extensions.world,以及 SillyTavern 的 character_book(角色書),兩者會合並
  • 獨立世界書:頂層 { entries: [...] },也兼容條目對象和純數組
  • 正則腳本:卡內 extensions.regex_scripts / extensions.regex,或獨立腳本 JSON;源碼註明 DSH 沒有聊天正則渲染管線,導入後只作參考,由模型自行對照,不會像酒館那樣自動替換對話文本

對話工具 prompt_import_tavernprompt_import_worldprompt_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_listprompt_preset_useprompt_preset_offprompt_preset_saveprompt_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 webpackage.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 和源碼可以復現的路徑寫,不額外編造角色卡內容。

  1. 按上一節裝好插件並重啓 web profile,打開 http://127.0.0.1:3080
  2. 把酒館導出的角色卡(.png / .json)或世界書 JSON 放到本機某個絕對路徑。
  3. 在設置頁點導入,或在對話裏讓助手調用工具。角色卡示例(路徑換成你的文件):
導入 C:/cards/xxx.png 角色卡

對應工具是 prompt_import_tavern。獨立世界書用 prompt_import_world,可傳 activate 以便導入後立刻激活「·世界書」預設。

  1. 導入完成後,設置頁會出現該世界書。點 進入創作 激活 名·創作,或點 世界書模式 激活 名·世界書
  2. 創作模式下,按 README 的典型指令給場景,例如「寫一段……」「描寫……的過程」,模型應輸出小說正文。世界書模式下用第一人稱推進,例如「我是……,然後呢?」。
  3. 需要改設定時,點 編輯文檔,用系統默認程序打開 worldbooks/<名>.md。預設正文存在 presets.json,改完後下一輪對話會讀到新內容。
  4. 停用預設後回到普通會話。刪除世界書會同時去掉「·世界書」「·創作」預設和對應 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

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜