酒馆模式（Tavern Mode）— DSH 角色扮演扩展
让 DeepSeek Harness 具备 SillyTavern 风格的角色扮演玩法。
文件清单
| 文件 | 说明 |
|---|---|
png2json.js |
工具：角色卡 PNG → JSON（解析 tEXt chunk 中的 chara/ccv3，支持 base64 包裹） |
split-card.js |
工具：角色卡 JSON → 四部分拆分（本体 / 世界书 / 正则 / 酒馆助手脚本），自动合并外部引用世界书 |
tavern-host.js |
插件 Host 半源码（与运行中 pkg-5 一致） |
tavern-client.js |
插件 Client 半源码（与运行中 pkg-5 一致） |
e2e-check.js |
端到端验证脚本（模拟导入链路） |
当前功能（pkg-4，运行中）
- 总开关：设置 → 酒馆模式 → "启用酒馆模式"。真开关：关闭时 Host 拒绝所有业务 RPC。
- 导入角色卡：页面内点击（弹系统文件选择器，在电脑里选文件）或直接拖拽文件到虚线区域。支持 PNG / JSON / Lorebook。
- 选中的文件内容以 base64 传给 Host → 解析 → 四部分拆分 → 写入工作区 → 注册
- 结果卡片显示：绑定世界书个数 / 正则条数 / 脚本个数 / 工作区路径
- 导入成功后自动建同名工作区并跳转（打开该工作区会话），也可点"打开工作区 →"
工作区结构
导入角色卡后，自动创建同名工作区（~/.dsh/tavern-characters/<角色名>/，注册到 harness 工作区列表）：
~/.dsh/tavern-characters/<角色名>/
├── card.json # 本体角色卡（name/description/scenario/first_mes/...）
├── world.json # 世界书（含自动合并的外部引用）
├── regex.json # 正则脚本列表
└── scripts/ # 酒馆助手脚本（.js + .meta.json）样式约定
所有 UI 颜色只使用 harness 主题 token（--dsw-alias-*），不自创视觉。
Host RPC 接口（Client → Host，Package 私有）
| method | 参数 | 返回 |
|---|---|---|
tavern:get |
— | { enabled } |
tavern:set |
{ enabled } |
{ enabled } |
tavern:import-card |
{ fileName, base64 } |
{ ok, cardName, workspacePath, workspaceId, worldNote[], worldMerged, regexCount, scriptCount }（未启用拒绝） |
服务（供后续功能包读取）
tavernMode（Host）：isEnabled()/setEnabled(v)/getCharactersRoot()- 后续功能（正则注入、HTML 渲染、快捷回复等）在
apply时先检查tavernMode.isEnabled()，未开启则不注册。
- 后续功能（正则注入、HTML 渲染、快捷回复等）在
使用流程
- 设置 → 酒馆模式 → 打开总开关
- 点击虚线区域（或拖拽角色卡文件进去）
- 系统文件选择器选角色卡（PNG / JSON）
- 自动建同名工作区并跳转；结果卡片显示世界书 / 正则 / 脚本数量
命令行工具用法
# PNG → JSON
node tavern-plugin/png2json.js character-cards/xxx.png
# JSON → 四部分拆分（自动合并外部世界书）
node tavern-plugin/split-card.js character-cards/xxx.json已知边界
- 动态插件不持久：进程重启后需重新 define/run。源码已落盘，后续可改造成持久 agent preset 或正式插件。
- PNG 解析支持 tEXt chunk（含 base64 包裹 JSON），zTXt/iTXt 暂不支持。
- 世界书若为外部引用（
extensions.world为字符串），需把同名文件（世界书-<名>.json/<名>.json）放入character-cards\才能自动合并。