前言¶
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 预设。
典型用法¶
- 掷骰
rp_random(dice: "2d6+3", count: 5)
- 图片入库
将宿主生成的图片或玩家提供的图片导入资源库。
rp_assets(action: "import", path: "<generate_image 返回的 savedTo>", label: "角色名", tags: "立绘")
- 角色卡管理
列出或设置角色卡信息。
rp_character(action: "list")
// 或
rp_character(action: "set", name: "玩家", appearance: "描述")
- 世界书整理
rp_lore(action: "localize")
- 导入角色卡
在未开局的 DM 会话中使用 “📖 导入故事书” 功能。
注意事项¶
- 依赖：必须安装
@changfenhuang/dsh-genui，否则无法渲染 UI。 - 生图：插件不负责配图，依赖宿主的
dsh-image-gen插件提供generate_image/edit_image。 - 权限：所有工具仅在
dm预设作用域注册。 - 重启：安装后必须重启
dsh web才能生效。 - 删除：图片资源库不能通过工具删除，需在面板操作。
- 许可证：MIT
