前言¶

DeepSeek Harness（DSH）的插件，專注於跑團（TTRPG）與地下城主（DM）場景。它提供中立隨機裁決、按會話隔離的戰役配置以及圖片資源管理，解決 DM 在多輪對話中需要管理角色卡、世界設定、狀態追蹤和配圖複用的痛點。

安裝與啓用¶

安裝前需確認已安裝依賴插件 @changfenhuang/dsh-genui，否則無法渲染界面。

dsh plugin --profile web add @changfenhuang/dsh-genui
dsh plugin --profile web add github:SiriusWJ/dsh-rp-tools

安裝完成後，必須重啓 dsh web 才能使插件生效。

核心功能¶

所有工具僅註冊在 dm 預設作用域下，其他預設不可見。

中立隨機裁決（rp_random）¶

支持骰子表達式、區間、加權抽取和批量擲骰。

圖片資源庫（rp_assets）¶

按會話隔離的圖片資源庫。支持入庫、複用和按標籤/角色檢索。圖片來源可以是宿主 generate_image 返回的結果，也可以是玩家自備的圖片。

戰役配置¶

按會話隔離的世界設定、角色卡、隨機表、宏表和提示詞前綴。

世界書與狀態追蹤（rp_lore, rp_state）¶

支持世界書條目管理和場景/時間/在場狀態追蹤。

PNG 故事書導入¶

支持從 SillyTavern 導入角色卡到會話工作區，並自動切換到 dm 預設。

典型用法¶

1. 擲骰

    rp_random(dice: "2d6+3", count: 5)

2. 圖片入庫
   將宿主生成的圖片或玩家提供的圖片導入資源庫。

    rp_assets(action: "import", path: "<generate_image 返回的 savedTo>", label: "角色名", tags: "立繪")

3. 角色卡管理
   列出或設置角色卡信息。

    rp_character(action: "list")
    // 或
    rp_character(action: "set", name: "玩家", appearance: "描述")

4. 世界書整理

    rp_lore(action: "localize")

5. 導入角色卡
   在未開局的 DM 會話中使用 “📖 導入故事書” 功能。

注意事項¶

• 依賴：必須安裝 @changfenhuang/dsh-genui，否則無法渲染 UI。
• 生圖：插件不負責配圖，依賴宿主的 dsh-image-gen 插件提供 generate_image / edit_image。
• 權限：所有工具僅在 dm 預設作用域註冊。
• 重啓：安裝後必須重啓 dsh web 才能生效。
• 刪除：圖片資源庫不能通過工具刪除，需在面板操作。
• 許可證：MIT