前言¶
DeepSeek Harness（DSH）以插件擴展會話、工具與前端能力，但社區裏大量角色卡、預設與世界書仍沿用 SillyTavern（ST）格式。若要在 DSH 裏直接複用這些資源，並保留 swipe、分支、周目等 RP 側欄體驗，通常需要自行轉換格式或維護兩套前端。
pmp-dsh-tavern（倉庫名 dsh-tavern，維護者 Player-MINEPIG）在 DSH 公開擴展點之上增加一層可卸載的 Tavern 兼容框架：不替換 DSH 原生前端，也不復制會話歷史；DSH 仍擁有 durable history、工具權限與最終模型請求。下面介紹其定位、能力與從安裝到首輪對話的步驟。
這是什麼¶
pmp-dsh-tavern 是爲 DeepSeek Harness 提供 Tavern 資源兼容、RP 工作流與第三方前端協議的開源插件。當前文檔對應版本 2.0.0，採用 MIT License；開發驗收基線爲 DSH rc.8。
插件通過 DT 懸浮球在兩種模式間切換：
- 靈珠 / DSH 原生模式：保留 DSH 原生會話、側邊欄與插件生態。
- 魔丸 / RP 模式：按角色卡與周目重組 RP 側欄，提供開場白、greeting、顯示正則、swipe、分支、回退、導入與導出。
卸載後仍可閱讀原始 DSH 會話：插件只保存資源、選擇、周目指針與顯示元數據，不僞造或覆蓋 DSH 歷史。
核心功能¶
v2.0 按模塊劃分的能力如下（均來自項目 README 與文檔索引）：
| 模塊 | 主要能力 |
|---|---|
| 資源 | ST 預設，V1/V2/V3 JSON/PNG 角色卡，獨立/內嵌世界書，用戶資料，資源綁定與導出 |
| RP 前端 | 角色卡/周目側欄、greeting、正文渲染、顯示正則、swipe、分支、回退和顯示層編輯 |
| 周目數據 | DSH 權威 session、樹狀 timeline、工作區 catalog、外部記錄首輪只讀注入、靜態 HTML 與 ST JSONL 導出 |
| 安全 | RP 權限疊加、同源/loopback API、工作區路徑防護、CAS、DOMPurify、無正文 operation log |
| 調試 | Tavern Trace 展示本輪資源、世界書命中與 request/header 對齊信息 |
| 第三方開發 | v2 HTTP API、pmpDshTavernChrome 模式服務、DSH slots/store 與獨立客戶端接入 |
重要邊界需提前知曉：
- 「預設」指 SillyTavern 風格的採樣參數與提示詞編排，不是 DSH agent preset。
- greeting 不進入 timeline，也不會僞造成 DSH 歷史；外部記錄只在首次真實請求中作爲
untrusted只讀上下文注入。 - 顯示正則隻影響魔丸前端渲染，不改寫模型請求、DSH 原始消息或導出所依據的權威正文。
- 魔丸隱藏 reasoning、工具 context 與子 agent 通知；需查看完整運行細節時切回 DSH 原生「對話」視圖。
- 本插件面向本機 loopback DSH Web，不應直接暴露到局域網或公網。
安裝與啓用¶
環境要求：Node.js 20 或更高版本、可從 PATH 調用的 DSH，以及一個已經初始化的 DSH profile（默認 web）。
從 GitHub 克隆並執行插件安裝腳本：
git clone https://github.com/Player-MINEPIG/dsh-tavern.git
cd dsh-tavern
npm install --cache .npm-cache --legacy-peer-deps
npm run plugin:install
安裝完成後重啓 DSH Web。更新已有安裝前請先停止目標 dsh web；安裝腳本會在刷新期間保留插件數據。其他 profile、獨立 DSH_HOME、手動安裝、備份與卸載方法見倉庫內 docs/INSTALLATION.md。
安全提示：安裝本插件等同於允許其代碼在 DSH Host 和瀏覽器頁面中運行。請只從可信倉庫與提交安裝，並在更新前檢查變更、備份插件數據。預設、角色卡、世界書與用戶消息都可能包含 prompt injection；高權限 Agent 仍可能在模型誘導下調用獲准的工具。完整威脅模型見倉庫 SECURITY.md，RP 模式攔截範圍見 docs/RP_SECURE_MODE.md。
典型用法：從角色卡到第一輪 RP 對話¶
項目 README 提供了可復現的 Quick Start；視頻演示見 pmp-dsh-tavern v2.0「靈珠魔丸」。
1、導入角色卡
左鍵點擊 DT 懸浮球打開菜單，進入「角色卡」，導入 SillyTavern JSON 或 PNG 角色卡。導入只創建資源，不會僞造會話或自動發送消息。
2、創建 DSH 工作區
回到 DSH 原生界面，使用 DSH 自己的工作區能力創建一個專門用於 RP 的工作區。所有周目 session 都會歸入同一工作區。
3、進入 RP 前端並選擇工作區
右鍵單擊 DT 懸浮球，或在菜單中點擊「切換到自定義前端模式」。首次進入魔丸時，插件會要求從 DSH 已有工作區中明確選擇 RP 工作區；寫入並回讀確認前不會進入 RP 內容。
4、創建周目
在 RP 側邊欄找到剛導入的角色卡，點擊角色卡右側的 +。插件會創建或複用該角色最近一個完全空白的 N周目，並確保 root session 綁定的是你實際點擊的角色卡。DSH rc.8 外層「新建會話」沒有公開點擊接管 seam；創建周目請使用角色卡右側的 +，而非覆蓋原生按鈕。
5、選擇開場白
空周目的 opening dock 會顯示角色卡 greeting。存在備選開場白時可用左右按鈕選擇；這只是前端展示與首輪提示詞參考，不會僞造成一次已經發生的 assistant 回覆。
6、開始對話
在 DSH 原生輸入欄發送第一條用戶消息。用戶消息會立即出現在 RP 視圖中；隨後可繼續使用 swipe、分支新周目、同周目回退、顯示文字編輯及導入/導出等功能。
完整操作與邊界見倉庫 docs/USAGE_zh-CN.md。
適用場景與注意¶
適合誰
- 已在 SillyTavern 生態積累角色卡、預設或世界書，希望在 DSH 中複用而不維護兩套格式。
- 需要 RP 側欄（周目、swipe、分支、顯示正則）但希望 DSH 仍作爲會話與工具的權威層。
- 計劃基於 v2 HTTP API 或
pmpDshTavernChrome開發第三方 RP 前端或資源管理工具。
使用前注意
- 插件以當前 DSH 進程權限運行；安裝前應檢查源碼與 MIT 許可證，並只從可信提交安裝。
- RP 安全模式在 DSH 權限之上增加只讀與高風險工具限制，但不是虛擬機或系統沙箱，不能約束本機其他進程。
- v1/v2 API 面向本機 loopback；Host、Origin 和 Content-Type 檢查不是登錄認證，不要把 DSH Web 或本插件 API 直接暴露到局域網或公網。
- 顯示正則使用 JavaScript
RegExp，災難性回溯可能凍結頁面；只導入和啓用你信任的模板與正則。 - swipe、分支和周目會創建真實 DSH session，可能增加磁盤佔用；revision/CAS 與路徑檢查不能替代備份。
遇到可疑行爲時，停止 Agent、切回 DSH 原生模式並檢查原始會話與工具記錄。
文檔與鏈接¶
- SkillHub 目錄頁：https://www.skillhub.cn/plugins/Player-MINEPIG/dsh-tavern
- GitHub 倉庫：https://github.com/Player-MINEPIG/dsh-tavern
- 中文使用指南：
docs/USAGE_zh-CN.md - HTTP API：
docs/API.md - 第三方 RP 前端接入：
docs/FRONTEND_INTEGRATION_zh-CN.md
pmp-dsh-tavern 不取代 DSH，而是在其之上提供可測試、可審計、可卸載的 Tavern 兼容層。若你的痛點是 ST 資源與 DSH 會話權威性的並存，可按上述步驟安裝並在獨立工作區中試用魔丸模式。
