dsh-tavern-renderer
适用于 DeepSeek Harness 的自包含 SillyTavern 风格安全消息渲染器
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:LiweiDonVee/dsh-tavern-renderer#d164e0285dd9558b09486999428765f88f8998f7Tavern Renderer 以 dsh-tavern-renderer 发布，当前版本为 0.4.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
面向 DeepSeek Harness 的自包含“酒馆式”消息渲染插件。它以 Harness 原生 Cordis keyed slot 接入，不改 Harness 源码，并提供有序正则、宏/变量、安全表达式、Markdown、HTML/CSS 清洗、角色模板、主题系统，以及八种可复用的沉浸式文档模板。
规格依据见 SPEC.md，架构与安全决策见 DESIGN.md，外部参考与许可证见 SOURCES.md。
当前版本 0.4.0 适配 DeepSeek Harness 0.2.1-rc.2 / 0.2.1-rc.3 / 0.2.1-rc.5，支持 Web 和桌面端，要求 Node.js 24+。发布包包含构建后的 lib/client.js，宿主安装插件时无需运行构建脚本。旧 DSH 0.1.x 请继续使用旧插件版本。
cd dsh-tavern-renderer
npm ci
npx --yes @deepseek-ai/dsh@0.2.1-rc.2 plugin --profile web add .
npx --yes @deepseek-ai/dsh@0.2.1-rc.2 --profile web
启动后使用终端打印的完整 Web URL（含一次性 token）进入；不要把 token 固化进配置、分享链接或测试产物。认证由宿主处理，插件无需自行管理 token。
bundle 会向当前 profile 插入 tavern-renderer 行。客户端以 priority: -100 覆盖 assistant-step、user 和 steering 三个消息 renderer。消息 slot 由 @deepseek-ai/dsh-client-ui-chat 声明，语言域为 chat；图片通过官方 conversation.images.content Factory 和宿主传入的 loadImage 加载。插件不重复声明原生 renderer 的图片子 slot，因此可以与原生组件并存。删除或停用插件后原 renderer 自动恢复：
npx --yes @deepseek-ai/dsh@0.2.1-rc.2 plugin --profile web remove dsh-tavern-renderer
桌面端使用同一套渲染组件，dsh.client.platform: "web" 也适用于桌面端；无需改成 desktop。但插件安装在独立的 desktop profile 中，Web profile 已安装插件不会自动同步过去。
先启动一次桌面端初始化 profile，然后完全退出应用。使用桌面端随附的 CLI 安装本地仓库或打包文件，例如 Windows 安装目录中的 resources/runtime/cli/bin/dsh.cmd：
# 把下面两个路径替换为实际安装位置与本地仓库绝对路径
$desktopDsh = 'C:\path\to\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd'
& $desktopDsh plugin --profile desktop add 'C:\path\to\dsh-tavern-renderer'
& $desktopDsh plugin --profile desktop list
重新打开桌面端即可使用。不要用 npx @deepseek-ai/dsh 修改桌面端 profile；它由桌面程序管理。卸载同样在应用完全退出后执行 & $desktopDsh plugin --profile desktop remove dsh-tavern-renderer。支持桌面端 dsh-app://app/ 协议、原生授权图片加载和字体/字号设置；主题及配置保存在各客户端自己的 localStorage 中，Web 与桌面端分别保存。
regex -> macros -> expressions -> documents -> markdown -> sanitize -> template
每一环都可关闭，也可在指定环节前后注册扩展。插件只改变 DOM 展示，不修改持久会话事件，也不会改变送给模型的 prompt。
在会话顶部点击 显示正则，再点 导入并用于本会话，选择 JSON 文件。支持单条 ST 正则、正则数组，以及整份 ST 预设中的 extensions.regex_scripts。导入后只给当前会话选择这一规则集；其它会话分别选择。下拉框选 无 即可停用，无需刷新已有消息。
只运行 ST 的显示分支（markdownOnly: true），保留禁用、仅 prompt 和不支持的规则并显示说明。不会执行预设中的其它扩展脚本，不会修改原始 JSON 文件、原文复制、Session 记录或模型输入。规则库和会话选择保存在当前浏览器的 localStorage，Web 与桌面端分别保存；保存失败会在面板提示。
ST 规则按文件顺序执行，位置 1 为用户/引导消息、2 为助手正文、6 为推理。原生聊天的深度从最新消息 0 倒数，用户/引导/助手节点各算一条，推理与正文共用所在消息的深度。未能确认深度时，有界规则跳过并报告 DEPTH_UNAVAILABLE。正文和推理产生的 HTML/CSS 仍经过安全清洗。
旧版浏览器 API 继续支持紧凑 /pattern/replacement/flags 语法：
DeepSeekTavernRenderer.configure({
regexRules: [
'/([A-Z]+)-(\\d+)/编号 $2，角色 {{char}}，类型 $1/g',
],
})
只有 findRegex/replaceString/roles 等旧字段的对象也保持原行为：
DeepSeekTavernRenderer.configure({
regexRules: [{
name: 'dialogue',
findRegex: '/“([^”]+)”/g',
replaceString: '<span class="dialogue">“$1”</span>',
roles: ['assistant'],
trimStrings: [],
}],
})
旧规则保留 $1..$99、$<name>、$& 和 $$ 语义，无斜杠表达式默认全局匹配；legacy 的 {{match}} 维持既有未展开行为，完整匹配请用 $&。导入的 ST 规则使用独立方言：无斜杠表达式默认只替换第一处；$0 / {{match}} 为完整匹配，数字捕获按完整索引处理（$12 不回退为 $1 加 2），未知捕获为空，其它 JavaScript 特殊替换符保持字面值（如 $& 和 $$）。trimStrings 对每个插入的捕获先展开宏再作字面删除，之后才展开完整替换串的宏。
ST 的 substituteRegex 支持 0 不展开查找宏、1 原样展开、2 仅转义宏返回值中的正则字符。宏能力限于本插件已有 registry；未知宏保留并报告诊断。runOnEdit 只在调用者明确传入 isEdit: true 时筛选，普通流式更新和重渲染不属于编辑。
程序接口也可导入并为明确会话选择规则集：
const imported = DeepSeekTavernRenderer.importRegexRuleSet(presetJson, {
sessionId: '具体会话 ID', name: '我的显示规则',
})
DeepSeekTavernRenderer.selectRegexRuleSet('具体会话 ID', null) // 停用全部正则
DeepSeekTavernRenderer.selectRegexRuleSet('具体会话 ID', imported.id)
未选择过的会话沿用历史 configure({regexRules}) 全局规则；选择规则集后只运行所选集，选择“无”则全部停用。render() 仍使用全局配置。独立使用 dsh-tavern-renderer/core 的客户端显式传入 regexRules 与 context.depth/placement；它们不会自动读取原生聊天的浏览器选择。
{{char}} {{user}} {{role}}
{{persona}} {{description}} {{scenario}}
{{time}} {{date}} {{weekday}} {{isotime}} {{isodate}}
{{newline}}
{{setvar::mood::calm}}
{{getvar::mood}}
{{addvar::score::2}}
{{incvar::turn}}
变量按 Harness Session 隔离。setvar/addvar 不输出文本，incvar 输出更新后的数值。宏支持内向外嵌套，未知宏保持原样。
注册扩展宏：
const unregister = DeepSeekTavernRenderer.registerMacro('upper', ({ args }) =>
args.join('::').toUpperCase(),
)
SillyTavern 当前消息渲染源码没有任意内联 JavaScript 宏。本插件明确增加以下 Harness 扩展语法：
{{js::1 + 2 * 3}}
{{js::user + " -> " + char}}
{{js::score >= 10 ? "win" : "continue"}}
这不是任意 JavaScript。只允许字面量、扁平变量、括号、一元运算、算术、比较、相等、逻辑/空值合并和三元运算。属性读取、索引、赋值、函数调用、new、模板字符串、浏览器全局、原型和构造器全部拒绝；实现中不调用 eval 或 Function。
支持：
HTML 清洗采用 DOM 树和显式标签/属性白名单。script、iframe、表单、SVG/MathML、事件属性、内联 style、危险协议等均被移除。链接只允许绝对 HTTP(S)/mailto，并自动加 noopener noreferrer；图片只允许绝对 HTTP(S)。
消息可包含 <style>，但 CSS 会移除 at-rule、远程资源、动态表达式和高风险属性，并把选择器限定在 .dsh-tr-message-content 下。消息类名统一改写为 custom-*：
<style>.status { color: #167565; font-weight: 600 }</style>
<span class="status">ready</span>
模型只需输出一个短围栏，不需要手写复杂 HTML。首行选择模板，--- 之前是 key: value 元数据，之后照常写 Markdown；结尾使用单独一行 :::：
:::letter
from: {{char}}
to: {{user}}
date: {{date}}
place: North Observatory
subject: The signal after midnight
seal: crimson
---
Dear **{{user}}**,
The receiver woke at 23:40.
:::
内置模板及推荐字段：
| 类型 | 用途 | 推荐字段 |
|---|---|---|
letter | 信件、情书、正式函件 | from, to, date, place, subject, seal |
exam | 试卷、测验、审讯问卷 | title, course, student, date, duration, total, instructions |
postcard | 明信片、旅行短笺 | from, to, location, date, stamp |
cipher | 密信、密码电文、机密备忘录 | classification, code, from, to, date, key, status |
telegram | 电报、紧急短讯 | priority, from, to, station, date, time, operator, charge |
newspaper | 报纸剪报、新闻报道 | name, date, edition, section, headline, deck, byline |
dossier | 人物档案、案件卷宗 | agency, file, subject, classification, status, date, handler |
diary | 日记、航海日志、私人记录 | owner, date, time, location, mood, weather, title |
每种模板都有独立的语义结构和视觉语言，而不是只替换颜色：例如信件带折痕与火漆，试卷带考生栏和评分框，明信片带邮票/邮戳/地址线，密信带分级条和删节线。所有元数据都先按文本转义，正文按 Markdown 渲染后进入统一 HTML 白名单；字段值不能生成类名、样式或属性。
完整样例见 demo/documents-message.txt。文档围栏不支持嵌套；未知类型或最终仍未闭合的围栏按普通文本显示。生成期间，已知但未闭合的围栏会以 Draft 状态增量渲染，闭合后自动转为最终文档。
程序化调用可从 core 导入：
import { DOCUMENT_TEMPLATE_IDS, renderDocument } from 'dsh-tavern-renderer/core'
const html = renderDocument('postcard', {
from: 'Luna', to: 'Alex', location: 'Selene Harbor', stamp: 'airmail',
}, 'Wish you were **here**.')
renderDocument() 返回尚未经过最终 DOM 清洗的模板 HTML，只有受信任的插件代码应直接调用；普通消息应始终使用完整 renderer。
DeepSeekTavernRenderer.setTheme('harness')
DeepSeekTavernRenderer.setTheme('tavern-dark')
DeepSeekTavernRenderer.setTheme('paper')
DeepSeekTavernRenderer.setCustomCss(`
.dsh-tr-message { line-height: 1.85 }
.custom-dialogue { color: #a13f4b }
`)
主题和自定义 CSS 保存在浏览器 localStorage。自定义 CSS 同样会清洗，并限定到 [data-dsh-tavern-renderer]；不能隐藏或改写整个 Harness 页面。
默认角色模板分别使用 aside、section、article 包装 system/user/assistant。可用替换点：{{content}}、{{role}}、{{char}}、{{user}}。
DeepSeekTavernRenderer.configure({
char: 'Luna',
user: 'Alex',
templates: {
assistant: '<article class="dsh-tr-message">{{content}}</article>',
},
})
content 已清洗，身份变量按文本转义，模板包装完成后还会再次清洗。Harness 当前 chat-node contract 没有角色卡字段，因此默认值是 Assistant/User，可用上述配置注入实际名称。
DeepSeekTavernRenderer.setStageEnabled('expressions', false)
const removeStage = DeepSeekTavernRenderer.registerStage({
name: 'append-marker',
after: 'macros',
run: value => `${value}\n\n---`,
})
内置阶段名：regex、macros、expressions、documents、markdown、sanitize、template。扩展阶段在浏览器本地以受信任代码运行；不要注册来源不明的回调。
npm test
npm install --prefix .host --ignore-scripts --no-audit --no-fund @deepseek-ai/dsh@0.2.1-rc.2
npm run check
npm pack --dry-run
test:host 默认读取 .host/node_modules，也可用 DSH_HOST_NODE_MODULES 指向另一套宿主包。CI 在 Windows/Linux 上分别检查 0.2.1-rc.2 和 0.2.1-rc.3。私有 RP dock 测试仅在提供 DSH_RP_UI_DIR 时运行。
测试文件为九项原始验收能力和八种文档模板各提供至少一条“输入 -> 期望输出”样例，并额外覆盖 slot 优先级、编码后的危险协议、SVG/iframe/form、CSS 远程加载、恶意角色模板、文档字段注入与流式草稿。
插件加载后可在页面控制台读取 window.DeepSeekTavernRenderer。常用方法：
| 方法 | 用途 |
|---|---|
render(text, context) | 离线运行完整管线并返回 { html, trace, diagnostics } |
configure(partial) | 更新身份、正则、模板和阶段配置 |
getConfig() | 返回可序列化配置副本 |
registerMacro() / unregisterMacro() | 扩展宏注册表 |
registerStage() / setStageEnabled() | 扩展或切换管线阶段 |
setTheme() / setCustomCss() | 切换主题和注入安全作用域 CSS |
页面根节点的 data-dsh-tavern-renderer-version="0.4.0" 可用于部署探针；每条渲染内容还带 data-render-trace 诊断属性。
apply()、dsh.bundle.patch、dsh.client.inject 和 window.__ModuleLoader__.load 继续使用；客户端依赖显式包含 ui-chat 和提供图库 Factory 的 ui-attachment。已按实际 0.2.1-rc.2 / rc.3 npm 包验证完整注入闭包和 engines.dsh 兼容检查，无需版本豁免。ApiProxy、后端 Remote 服务或自定义 settings card；会话显示正则入口使用公开的 conversation.session.header.utilities，主题/宏配置继续由浏览器 API 和 localStorage 管理。assistant-step / user / steering 的展示节点，不读写 V4 Session 日志，也不参与 RP settlement。保留流式 running 与最终 settled / interrupted 语义，并遵循 groupPart 和回合思考折叠状态；文件、图片附件保持原始顺序，会话引用标签保持可见。snapshotEvents、eventAt 和 ownEvents 已从渲染器边界排除；agent 生命周期、Profile plugin settings、Remote 双向流和 preset plugin bundles 由宿主负责。渲染器按 Session ID 取得会话作用域，因此多个 Session 可同时拥有独立变量与 renderer 实例。npm run check 覆盖核心渲染、真实 slot 装配、Session 隔离、授权图片入口，以及 Web / 模拟桌面 dsh-app://app/ 环境中的停用、重新启用和配置恢复。桌面协议使用 JSDOM 模拟；不等同于在签名 Electron 安装包中完成登录和端到端验收。