revnovel润色（dsh-tavern-rewrite）

revnovel润色：每轮正文写完后，把正文发给 revnovel 改写台 的 OpenAI 兼容 API 润色一次，再用 editTurn 把显示和存档里的正文替换成润色后的版本。

GitHub：https://github.com/bigmalove/dsh-tavern-rewrite

这是独立维护的插件仓库（原在 dsh-tavern/examples/ 下，已移出，不占用本体仓库的提交）。内部包名和安装目录仍用 dsh-tavern-rewrite，界面显示为「revnovel润色」。

它怎么工作

1. 后台结算开始时，插件的结算任务（parallel 阶段）先并行润色这一轮；正文写完、结算结束后再调用 editTurn 替换，因此通常不会在结算结束后额外等很久。
2. 润色只改文字段落：HTML 状态栏、details、表格、```html 围栏、脚本整块原样保留；插件标记（image###…###）、URL、行内代码、宏、叙事标签会先换成占位符，回来再还原；MVU 的 <UpdateVariable> / <InitVar> 变量块整块跳过。提交前会做一次结构自检，HTML 有任何变化就放弃这次润色，保留原文。
3. 改写台要求输入至少 400 字。插件按 1000 字左右切段（可在面板里调），每段单独调用；不足 400 字的段落跳过，正文整体太短时这一轮就不润色。
4. 模型输出会做校验：长度比例、和原文的二字组重合度、复读、是否被截断、是否有占位符丢失。不合格会降温度重试一次，仍不合格就跳过这一段。跳过的段落保留原文，其余段落照常替换。
5. editTurn 会再触发一次 onTurnSettled。插件用 textVersion、润色文本哈希和 onTimelineChanged 的 edit/regenerate 事件做防循环，不会反复润色。玩家手动编辑过的正文也不会被自动覆盖。
6. 面板里有「自动润色」总开关；每局也可以在「本局设置 → revnovel润色」里单独关闭。输入框上方的「revnovel润色」按钮可以手动重跑当前这一轮。

安装

在 DSH Tavern 的「设置 → 插件」里粘贴仓库地址：

https://github.com/bigmalove/dsh-tavern-rewrite

点安装，刷新页面。

也可以本地安装。本仓库就是一个 Tavern 插件文件夹，在仓库根目录运行：

npm run install:tavern

默认复制到：

~/.dsh/profile-data/tavern/data/plugins/dsh-tavern-rewrite/

也可以用 DSH_TAVERN_PLUGIN_DIR 指定别的插件目录：

DSH_TAVERN_PLUGIN_DIR=/path/to/plugins/dsh-tavern-rewrite npm run install:tavern

脚本只更新代码和说明，不会覆盖目标目录已有的 config.json。

装好后刷新 Tavern 页面，打开侧栏「revnovel润色」，把 API 密钥粘贴到「API 密钥」里点「保存密钥」。密钥保存在 DSH 凭据 DSH_TAVERN_REWRITE_API_KEY 中。

config.json 是可选的非密钥配置（参考 config.example.json），只放服务地址、模型、温度这些：

{
  "baseURL": "https://rewrite.revnovel.org",
  "model": "rewrite-v9-c600-nvfp4",
  "temperature": 0.15,
  "maxChars": 1000,
  "concurrency": 2
}

宿主侧（index.mjs / lib/）改动后要重启 DSH/Tavern 才生效；浏览器侧（client.js）刷新页面即可。

也可以手动把 package.json、index.mjs、client.js、lib/、README.md、config.example.json 复制过去，效果一样。

配置项

字段	默认	说明
auto	true	自动润色总开关；面板里也有勾选框
baseURL	https://rewrite.revnovel.org	服务地址，不带 /v1；直接贴 /api 文档页也可以
model	rewrite-v9-c600-nvfp4	服务当前只提供这一个模型
temperature	0.15	越低越保守。0.4 以上容易改写过度或复读，不建议
maxChars	1000	单次送进 API 的目标字数；400–2000。短尾巴会并入前一段，实际单段可能到 1.5 倍
minChars	400	低于这个字数不送；改写台自己也会拒绝
concurrency	2	同时发几段；1–4
timeoutMs	90000	单次请求超时
retries	2	429/5xx/网络错误的自动重试次数

密钥不在这张表里：它只在「revnovel润色」面板里配置，存进 DSH 凭据。

改写台 API 备忘

• 文档页是 https://rewrite.revnovel.org/api（需要 Discord 登录，登录后能创建/查看密钥）。
• OpenAI 兼容根地址是 https://rewrite.revnovel.org/v1，GET /v1/models 返回 rewrite-v9-c600-nvfp4。
• 调用方式：POST /v1/chat/completions，Authorization: Bearer sk-rw-…，messages 里放一个 user（正文），stream: false。用 curl/Node 时记得带 User-Agent，Cloudflare 会拦默认的 Node UA。
• 输入至少约 400 字，否则返回 400 input_too_short。它面向约 420 字以上的训练片段，短文本容易复读。
• 它本质上是「去 AI 腔」的改写模型，不是严格的同义润色：低温度（0.1–0.2）下基本保留情节和段落，温度高会自己加戏。服务端对复读有截断，响应里的 revnovel.truncated / finish_reason: "length" 不能当成完整结果。
• 输出常见是一行一句。插件会按原段落重新排版；段内句子顺序由模型保持，跨段边界用句子相似度对齐。
• Tavern 的插件接口没有「首次显示前替换流式正文」的钩子，公开的替换路径只有结算后的 editTurn。所以生成和后台结算期间先看到原文，结算结束后切换成润色版；预润色只是把切换前的额外等待压到最小。

作者 / 反馈

改写台作者 Discord：加入频道

已知限制

• 正文不足 400 字：改写台直接拒绝，插件会跳过并在面板里记一条「跳过」。
• 行内 HTML：像 <b>她的声音很轻。</b> 这种夹在句子中间的标签必须原样保留，插件会把它当成分段边界。标签前后的文字如果各自不足 400 字，就不润色；不会为了润色去改 HTML。
• 插件标记在句子中间：标记会换成占位符；模型如果弄丢占位符，这一段就跳过。像 image###…### 这样单独一行的标记通常能保留。
• 模型仍可能改写风格：这是改写模型，不是校对器；它可能调整标点、合并句子、偶尔加一个「……」过渡。觉得太激进就把温度降到 0.1。
• 只润色最新的、已经结算完的一轮：editTurn 的接口限制；手动按钮也只对最新一轮可用。
• 开场白不自动润色：onTurnSettled 不为开场白发通知；如果开场白是最新一轮，可以手动点「revnovel润色」补一次。

测试

npm test

• tests/polish.test.mjs：切段、HTML/MVU 结构保护、占位符、段落重排、输出校验，不需要网络。
• tests/plugin.test.mjs：用假的 fetch 跑宿主侧注册、预润色、editTurn、防循环、设置和密钥处理，不需要网络。
• 结构交叉检查默认读同级的 dsh-tavern 本体（../dsh-tavern）的 editableReplyParts；没有本体时退化为插件自己的 collectProtected 检查。可以用 DSH_TAVERN_REPO=/path/to/dsh-tavern 指定。

发布

已发布在 https://github.com/bigmalove/dsh-tavern-rewrite。更新代码后推送到 main 即可；DSH Tavern 的「设置 → 插件」按默认分支安装/更新。发布前确认 config.json 没有被提交。

卸载

删除插件文件夹，刷新页面。插件数据里只保存非密钥设置；密钥在 DSH 凭据里，可在面板里清除，或删掉 DSH_TAVERN_REWRITE_API_KEY 凭据。