Star-Guest/dsh-plugin-tavern

Name: Star-Guest/dsh-plugin-tavern
Author: Star-Guest

插件Plugin 原生Native ⭐ 2 提示词与技能Prompts & Skills

SillyTavern 精简版的两个 Agent Preset 插件：角色卡解析管理员（card-analyst）+ 角色扮演讲述者（roleplay）。把任意 SillyTavern 角色卡（PNG/JSON，V1/V2/V3）解析成 story.md + state.json，然后用讲述者进行沉浸式连续角色扮演。

catalog 简介 / catalog descriptioncatalog description：酒馆（SillyTavern 精简版）DSH 插件：角色卡解析管理员 card-analyst + 角色扮演讲述者 roleplay

项目介绍Project Overview

由知微Agent(zhiwei)编辑Edited by Zhiwei Agent (zhiwei)

dsh-plugin-tavern 为 DSH 提供 SillyTavern 精简角色扮演能力，含两个预设：card-analyst 解析 PNG/JSON 角色卡（V1/V2/V3）为 story.md 与 state.json，初始化好感度等结构化状态机；roleplay 加载后以第三人称连续扮演，自动维护状态与历史。适合导入角色卡进行沉浸式对话。注意：精修与扮演需 DeepSeek API，解析为本地算法；第三方插件建议审阅源码并固定 commit。

dsh-plugin-tavern adds a lightweight SillyTavern-style roleplay suite to DSH via two presets. card-analyst parses PNG/JSON character cards (V1/V2/V3) into story.md and state.json, initializing a structured state machine for affinity, mood, location, and plot flags. roleplay loads a card and runs continuous third-person narration with auto-updated state. Use it to import character cards for immersive roleplay sessions. Note: refinement and roleplay require DeepSeek API credentials; parsing runs locally. Review source and pin a commit before installing third-party code.

在 GitHub 查看View on GitHub

发给你的 DSH 安装Send to your DSH

请帮我了解并安装插件：【dsh-plugin-tavern】【https://github.com/Star-Guest/dsh-plugin-tavern】

把上面这条消息直接发给当前会话里的 DSH，让它帮你了解并安装。安装命令不一定准确，发给 DSH 更稳。Send this message to DSH in your current session. CLI install commands may not be accurate across systems — DSH will figure it out for you.

或使用命令行安装（适合开发者）Or use CLI install (for developers)

命令行安装CLI Install

dsh plugin --profile web add git+https://github.com/Star-Guest/dsh-plugin-tavern.git

把 Star-Guest/dsh-plugin-tavern 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

3.1 KB · 缓存于 2026-08-28 05:28:57 · 3.1 KB

dsh-plugin-tavern · 酒馆

SillyTavern 精简版的两个 Agent Preset 插件：角色卡解析管理员（card-analyst）+ 角色扮演讲述者（roleplay）。把任意 SillyTavern 角色卡（PNG/JSON，V1/V2/V3）解析成 story.md + state.json，然后用讲述者进行沉浸式连续角色扮演。

基于 SillyTavern 开源实现精读（源码机制分析见 SPEC.md），按"单对话单角色"优化，核心机制（token 预算贪心填充、范例对话原文注入、增量摘要）复刻自 ST，另加 ST 没有的结构化状态机（好感度/心情/地点/剧情旗标）。

功能

Agent	做什么
酒馆-管理员 `card-analyst`	解析角色卡：PNG tEXt chunk 提取（ccv3/chara）、V1/V2/V3 归一化、世界书扁平化；模型精修：归纳性格/说话风格、初始化状态机。产出 `story.md / state.json / analysis-log.md / meta.json`
酒馆-讲述者 `roleplay`	加载角色卡后连续扮演：第三人称叙述 + 引号对话，遵循卡内性格与说话风格，每轮自动更新 `state.json` 并追加历史，长对话增量摘要

安装

# 需要 DSH（DeepSeek Harness）与 pnpm
dsh plugin --profile web add git+https://github.com/Star-Guest/dsh-plugin-tavern.git
# 重启 DSH 后生效

插件安装后自动把两个 preset 与脚本物化到用户根：

~/.dsh/.agent-presets/card-analyst/   # 酒馆-管理员
~/.dsh/.agent-presets/roleplay/       # 酒馆-讲述者
~/.dsh/tavern/scripts/                # 解析/精修/扮演脚本
~/.dsh/tavern/SPEC.md                 # 规格书

使用

在 DSH GUI 新建会话，选择对应 preset：

酒馆-管理员

解析这张卡 /path/to/character.png

（支持 PNG 卡与 JSON 卡；纯图无元数据的卡会走视觉兜底）

酒馆-讲述者

加载 Blanche 开演

之后直接对话即剧情输入；指令：换开场 / 查看状态 / 重置。

模型要求

精修与扮演需要 DeepSeek 系 API 凭据（脚本从 $DSH_HOME/.credentials.yaml 或 DEEPSEEK_API_KEY 环境变量读取，与 Harness 共用）。
解析（parse-card.js）为纯确定性算法，无需 API。

工作原理

DSH 插件 = npm 包 + cordis.patch.yml 补丁。本插件的 patch 挂载一个 glue 插件（src/index.js），挂载时把 assets/ 物化到用户根——因为 DSH 启动器会把 preset 根目录固定为 shipped 目录，插件无法通过配置注册新根，而用户根（~/.dsh/.agent-presets）天然被 roster 扫描。物化带版本标记：用户自建的 preset 绝不覆盖，插件升级自动刷新。

卸载

dsh plugin --profile web remove dsh-plugin-tavern
# 已物化的文件不会自动删除，手动移除即可：
rm -rf ~/.dsh/.agent-presets/card-analyst ~/.dsh/.agent-presets/roleplay ~/.dsh/tavern

安全说明

第三方插件代码，安装前建议审阅源码并固定 commit：

dsh plugin --profile web add git+https://github.com/Star-Guest/dsh-plugin-tavern.git#<commit-sha>

License

MIT

渲染基于仓库 Star-Guest/dsh-plugin-tavern 的 README.md。在 GitHub 查看原文 →

命令行安装CLI Install 复制安装命令Copy Install