a86582751/dsh-nexttavern

dsh-NextTavern：创作一个世界，走进它，再把它带走。

dsh-NextTavern

简体中文 · English

让角色独立推演，让世界随你的选择展开。

一张角色卡，一个突然冒出的念头，一次不愿妥协的选择，都可以成为故事的起点。dsh-NextTavern 把原生 Agent Loop 带进长篇角色扮演：AI 主动查阅世界、整理记忆、推演人物，你掌握方向，一起把故事写下去。

创作一个世界，走进它，再把它带走。

一键安装 · 开始体验 · Windows · Linux · 核心能力 · 记忆系统 · 架构设计 · 手机电脑公网访问指南 · 全部截图 · 反馈问题

沉浸式游玩

Roleplay workspace for DeepSeek Harness: interactive character creation, on-demand worldbook reading, long-form memory, multi-model collaboration, character agents, branching stories, novel exports and one-click installers.

0.2.5 预览版 · Harness 0.1.2-alpha.3 · pi-ai 0.84.4 · 自有代码 GPL-3.0

想快点开一章，用一键安装；想自己控制运行时和补丁，就按手动安装配好那六项兼容补丁。

一键安装

不想手动配运行时、也不想自己打补丁？现在有两条一键路径。 安装器只做一件事：把运行时和工作区准备好。模型和密钥仍然由你自己决定。

Windows

下载 NextTavern-Setup.exe，双击，选一个安装目录，然后等它跑完。它会准备便携的 PowerShell 与 Node.js 运行时、按需安装 Microsoft Visual C++ 运行库、建好工作区与启动／停止快捷方式，完成后直接替你打开浏览器。默认装到 %LOCALAPPDATA%\NextTavern。Windows on ARM 设备请用 NextTavern-Setup-arm64.exe。

0.2.5 起支持原地升级：在旧安装上直接运行新安装器，你的故事、角色卡和设置都会留着。完整步骤与注意事项见 Windows 一键安装指南。

Windows 安装器还没有代码签名，首次运行可能出现 SmartScreen 提示；ARM64 安装器是这一版新增的，装上后遇到问题欢迎来反馈说一声。

Linux

NextTavern-Setup.sh 是 0.2.5 新增的自包含脚本，对起点的要求很低：一个 POSIX shell、curl 或 wget、tar，再加一个能算 SHA-256 的工具。脚本自己下载并校验便携 Node.js 运行时，然后准备好安装目录、桌面入口和启动／停止启动器。支持 x86_64 与 aarch64（glibc），不需要 root，也不需要系统包管理器。完整步骤见 Linux 一键安装指南。

两条路径共同的部分

| 项目 | 说明 |
| --- | --- |
| 只监听本机 | 本地服务绑定 127.0.0.1，端口在 3510–3599 之间自动选择，默认不对局域网或公网开放。 |
| 密钥自己填 | 模型 API Key 由玩家输入并保存在本机；安装包不携带、也不分发任何密钥。 |
| 下载先校验 | 镜像优先的下载来源，逐文件 SHA-256 校验，已校验的文件会被缓存复用。 |
| 中断可续 | 网络失败或中途关闭后重新运行安装器，会跳过已校验的文件继续安装。 |

两个安装器都只是更省事的入口：它们产出的 preset 和兼容补丁，与手动安装路径完全一致。

开始体验

完成一键安装（或手动安装）并配置好自己的模型后：

1. 新建一个独立工作区。 给这次角色扮演一个专用文件夹，角色卡、故事资源和导出文件都放在一起。
2. 在预设里选“角色扮演模式”。 新建会话时从预设菜单切过去，就进入了你的故事工作台。
3. 上传角色卡，或者直接聊出一张新的。 支持 SillyTavern / TauriTavern 的 PNG、JSON 人物卡；也可以只描述题材、人物、关系和氛围，让 AI 通过对话和你一起把这张卡做出来。
4. 开始体验。Enjoy it! 跟着开场推进故事，输入你的行动，切换世界线，或随时打开“酒馆管理”调整设定。

没有现成角色卡，也可以从这样一句话开始：

帮我创作一张蒸汽都市悬疑角色卡。我想扮演刚到港口的调查员，故事慢热，有多方势力，也有人物关系的发展。其他细节你来决定。

告诉 AI 你想遇见怎样的人、经历怎样的故事。你可以一起打磨细节，也可以说“你来决定”，让它带着世界、人设、开场与文风继续创作。DOCX/PDF 读卡可通过文档扩展启用。手边只有一部长篇小说？也可以直接让它读成一张卡，见长文本转角色卡。

导入 SillyTavern / TauriTavern 人物卡
直接上传原始卡文件，然后告诉 AI：“读取这张角色卡，准备开始角色扮演。” 不用自己解码，也不用填导入工具的参数。

| 格式 | 支持范围 |
| --- | --- |
| PNG 人物卡 | 从 chara / ccv3 的 tEXt 块读取 Base64 编码的角色数据；两者同时存在时优先读取 ccv3。 |
| JSON 人物卡 | 识别 v1、v2（chara_card_v2）和 v3（chara_card_v3）。 |
| 内嵌世界书 | 读取 character_book，按当前导入流程审阅并映射到设定与世界书。 |

请选保留元数据的原始 PNG 卡：普通头像、截图或被移除元数据的图片里没有可导入的角色数据。PNG/JSON 解析是内置能力，不需要 anydoc；上传入口随完整安装提供。

导入后可以继续打磨人物、世界书与创作规则，原始卡片和扩展数据都会一并保留。卡片里的三个文风字段会完整保留，怎么和预设配合由你决定，见预设系统。

核心能力

这是这个版本的能力总览，也是后面各章的索引。 想先知道这一版能做什么，看这张表；想细看某一项，按下面的章节顺序翻。

| 能力 | 你可以获得什么 |
| --- | --- |
| 一键安装 | Windows 与 Linux 两个自包含安装器：便携运行时、工作区、快捷方式与镜像优先的校验下载，Windows 支持原地升级。 |
| SillyTavern / TauriTavern 卡片导入 | 直接读取 PNG chara/ccv3 和 JSON v1/v2/v3 人物卡，保留原件并支持内嵌世界书。 |
| 固定设定 + 硬切窗口 + 导演笔记 + 混合检索 | 固定设定不压缩始终注入；窗口保留近期完整正文与尾部衔接；后台笔记带来源哈希与世界线锚点；历史召回支持关键词／语义／混合三种方式。 |
| 预设与文风系统 | 独立预设页，作用范围可选当前对话／指定对话／全局，三种文风模式，16 种自带文风，200 个自定义槽位。 |
| 长文本转角色卡 | 把长篇 TXT 读成一张可玩的角色卡：精读或粗颗粒度两种阅读方式、原文冻结与哈希、每一条研究笔记都能对上原文、独立的语义索引。 |
| 嵌入模型管理 | 在线接入 DashScope、OpenAI 兼容接口与 OpenAI 官方；本地可安装 BGE small zh、Qwen3-Embedding 0.6B、Jina Nano／Small INT8、Nomic q8，无需 Key 与网络。 |
| 多模型协同 | 为正文与记忆、读写卡、状态、决策、小说导出等任务配置模型路由，按需要分工。 |
| 多角色 Agent 集群 | 为主要角色启动独立推演，分别思考语言、行为与意图，再由主代理协调成最终故事；支持单角色模型覆盖。 |
| 决策卡与状态栏 | 行动建议集中在独立决策卡，可折叠、可稍后处理、可拖动；作者的状态 HTML/CSS 在导入、生成与恢复路径上都被保留。 |
| 自有皮肤 | 第一套自有皮肤，日间／夜间双主题，整套界面统一重绘；随包安装，默认关闭。 |
| 对话分支管理 | 重新生成、修改后发送、切换版本，在同一对话里探索不同世界线；也可显式分支到新对话。 |
| 自定义创作规则 | 分别管理核心设定、人物、世界书、剧情指引、文风与规则，控制视角、节奏、人物知情边界和回复展开方式。 |
| 主动读取世界书 | 主代理根据当前剧情按需查阅地点、势力和背景细节，让世界书作为可查询的设定库参与叙事。 |
| HTML/CSS 阅读美化 | 通过角色卡中的 HTML/CSS、状态栏模板与正则规则定制阅读呈现，正文支持流式阅读；作者脚本在隔离的环境里运行。 |
| 小说稿一键导出 | 将选定世界线整理成小说稿；也能导出当前完整角色卡，结果进入资源库供下载。 |
| 资源库管理 | 集中查看角色卡、故事相关文件与导出结果，按时间或名称排序、刷新和下载。 |
| 交互式全新角色卡创作 | 从一个想法开始，通过交流逐步构建世界、多角色人设、开场、文风和排版，并经过十二项完整性检查。 |
| 模型用量与缓存统计 | 按会话、供应商或模型查看请求、输入输出 tokens、缓存、速度与已知成本，包含重生成、嵌入调用和失败尝试。 |

下面从长篇体验最吃重的记忆系统开始，逐章展开这张表。

记忆系统

故事越写越长，人物的经历、埋下的伏笔和未完成的约定也在积累。NextTavern 借鉴 Codex 类长任务的上下文管理思路，把长篇记忆拆成四件各有边界的事：固定设定不压缩始终注入 + 有尾部保留的上下文硬切窗口 + 可追溯来源的后台导演笔记 + 关键词和语义混合历史上下文查询召回。

| 支柱 | 它做什么 | 写长篇时有什么用 |
| --- | --- | --- |
| 固定设定不压缩，始终注入 | 冻结的设定与系统前缀每轮都在场，从不进入压缩流程。 | 身份、作者规则和叙事约束是长期契约，不该被一段摘要替换掉。 |
| 硬切窗口 + 尾部保留 | 程序按完整正文边界推进上下文窗口，并在推进时保留尾部连续正文。 | 近期正文保持完整细节，你正在读的那一段不会因为切窗口而丢失，也不会在场景中途被摘要掉。 |
| 可追溯来源的后台导演笔记 | 由独立的后台任务撰写，每条笔记带来源哈希与同一世界线锚点。 | 每条笔记都能追回到写出它的那段正文；追不回来的旧记录会留在原处，程序不会替它猜。追加式原始历史从不删除。 |
| 关键词和语义混合的历史召回 | 主代理按需查询历史，三种方式：关键词（默认）／语义／混合。 | 需要旧细节时再回查原文，而不是每轮都先强制召回一次。 |

flowchart TD
Player[玩家输入与角色卡] --> Program[程序装配：固定设定 + 硬切窗口 + 有效笔记]
Program --> Writer[主代理与原生 Agent Loop]
Writer  Recall[按需历史查询：关键词 / 语义 / 混合]
Writer  Lore[按需读取世界书]
Writer --> Story[流式正文与追加式剧情记录]
Story --> Background[后台任务：整理导演笔记]
Background --> Anchor[来源哈希与世界线锚点校验]
Anchor --> Program

三种查询方式，同一份语料

查询的语料是玩家输入与有效剧情正文，包含已经归档或被淘汰的正文；状态、工具输出、CSS、决策卡和推理过程都不会进去。

| 方式 | 谁来算 | 什么时候用 |
| --- | --- | --- |
| 关键词（默认） | 程序确定性匹配，不调用模型。 | 想找明确的词句、人名、地名时最快。 |
| 语义 | 需要嵌入模型把查询编码成向量。 | 只记得大意、不记得原话时更有效。 |
| 混合 | 关键词与向量结果一起排序。 | 兼顾精确命中与语义相近。 |

向量是派生的共享数据，查询时会过滤到当前世界线，所以切换世界线不用重建索引。每份向量索引都带一个配方指纹（模型、修订、维度、任务角色、池化方式、量化与运行时）：指纹对不上时，索引会被标记为 stale 并停止对外服务，直到你重建为止——它宁可让你重建，也不会拿旧向量凑出错误答案。分块大小全局可配置，默认 480 字符（192／480／960 三个选项，128–2048 区间，80 重叠），本地模型使用 512 的分词预算。清空、重建与填充都限定在当前可见对话及其全部世界线；清空只清索引，正文、来源和账本都留着。

记忆检索方式与窗口设置

旧笔记与旧状态不再随每次请求发送

旧导演笔记与旧状态快照以前会跟着每次请求一起走（约 52k 字符）。现在它们只在有效的新锚点准备好之后才被替换：没被替换的引用保持原本的精确内容，回滚时重新提供完整文本，原始事件始终是追加式的。写长故事时，请求里不会一直拖着越来越重的旧笔记。

同样的“先确认再替换”也用在很长的工具结果上：一条研究笔记被确认后，对应的长工具结果会被替换成匹配的检查点，前提是归属、来源哈希、generation 与 packetIds 全部一致。部分保存、来源不符、写入失败，以及确认之后又重读过的情况，都不会回收。

这些都可以按会话调整

窗口大小、尾部保留量和后台笔记更新频率支持全局默认与会话覆盖，留空就沿用全局设置。截图里能看到的一组实际取值：

| 设置 | 含义 |
| --- | --- |
| 窗口大小 | 当前窗口的正文预算，按你实际使用的模型上下文容量来配。 |
| 窗口尾部连续正文保留量 | 切窗口时必须留住的近期正文，保证你正在读的那一段完整。 |
| 后台笔记更新频率 | 每多少个新增正史剧情轮次整理一次；重生成不计入。 |
| 记忆检索方式 | 关键词／语义／混合，以及应用到哪些会话。 |

切换检索方式不会删除已有索引。窗口即将淘汰旧正文时，会先确认检查点已保存；后台整理频率不会取消这道保存关口。

窗口装配、来源校验、笔记淘汰和原文回收都由程序完成，不产生模型请求。只有主代理真的决定去查历史时，才按你选的方式付出一次查询代价（语义与混合还需要嵌入模型，见嵌入模型）。

换一条世界线，就带着那条路线的经历继续向前；反复打磨同一幕，记忆会跟随你选中的版本。章节交接前，系统会先把需要延续的故事线索整理妥当。

硬切窗口与导演笔记设置

预设系统

文风不再只能靠改卡片。管理界面里多了一页独立的预设页（位于资源库之前），可以新建、编辑、另存副本、选用和删除；自带预设是只读的，自定义预设给你 200 个槽位。

| 维度 | 可选值 | 含义 |
| --- | --- | --- |
| 作用范围 | 当前对话／指定对话／全局 | 同一对话的全部世界线共享这次覆盖；留空就沿用全局设置。 |
| 文风模式 | 前景系统美学（默认）／与卡片文风融合／仅卡片文风 | 前两种同时注入预设与卡片文风，冲突时预设优先；第三种只使用卡片文风。 |

预设库由所有对话共享，所以编辑一个正在被使用的预设，会影响使用它的对话后续生成——界面会明确提示这一点。要是两个窗口同时改同一个预设，后提交的一方会收到冲突提示，你的草稿仍然留着，不会被悄悄覆盖。

卡片导入、编辑、导出与持久化都保留三个卡片文风字段，排除只发生在故事上下文装配阶段，原始卡片不会被改写。

自带 16 种文风。 除了默认预设和空白预设，还准备了 14 种可直接选用的写作风格：日式轻小说、乙女风格、三体文风、日式游戏、电影感文风、春秋文风、极简文风、细腻文风、奇幻网文风、恐怖文风、鲁迅文风、抒情文风、日常搞笑风、古文文风。每一种都有完整的七段式指南和原创示例，不是只有一句风格描述。

预设系统

查看自带文风预设库

自带文风预设库

长文本转角色卡

手边有一部长篇小说，想把它变成能玩的世界？管理界面里多了一个「长文本转角色卡」TAB（位于角色集群之后）。它做的不只是总结：读过什么、笔记记在哪、卡片里的话有没有原文依据，都要能对得上。

两种阅读方式，在研究开始前选。

- 精读（默认）：分段逐段完整阅读，每一段都留下带原文引证的研究笔记。
- 粗颗粒度：围绕人物、组织与事件面做多轮关系前沿检索，再做主角的纵向追踪。它需要一个可用的小说模型和完整的当前索引；条件不满足时，界面会引导你先把配置补上并结束本轮，不会悄悄降级成另一种模式。

原文先冻结。 工作区 TXT 上限 64 MB，按 UTF-8 → GB18030 → 带 BOM 感知的 UTF-16 依次尝试解码，记录原始字节哈希、解码文本哈希与大小，并且从不修改你上传的原文件。分段是确定性的，批次大小被限制在原生切分器之下。

笔记要有证据。 一条研究笔记要成立，得同时满足两件事：这一批确实被读过，引用的原话也确实出现在这一批里。笔记分事实／改编机会／未决问题三节；只在检索里命中，不算这一批已经被读过。

小说有自己的索引。 它和故事记忆的语义索引分开，小说模型也可以与故事记忆模型分开配置。相同的原始哈希复用研究基线，相同配方复用向量——同一部原著可以服务多张卡、多个对话。

举个例子：一部约 119 万字符的长篇网络小说（前 354 章）建立了 3027 条在线向量，程序为等待索引完成挂起约 292 秒；交付角色卡与打开导入是两个独立回合，开场输入约 52k tokens。改编复用与交互式创作相同的问卷和十二项写卡检查。

小说很长时，个别细节仍可能写错，成稿后建议自己通读一遍。

长文本转角色卡

嵌入模型

语义与混合检索需要向量，所以管理界面里多了一页独立的嵌入模型页（位于模型与使用统计之间）。

在线接入。 支持 DashScope、OpenAI 兼容接口和 OpenAI 官方：模型列表可刷新，也可以手动填写模型 ID，密钥只保存在服务端，并提供连接测试。
本地接入。 五种本地模型可以直接装：BGE small zh、Qwen3-Embedding 0.6B、Jina Nano、Jina Small INT8、Nomic q8，在独立编码进程中使用 ONNX Runtime 1.29.0 运行。下载显示真实字节进度、速度与预计剩余时间，支持暂停／取消／继续，并有 queued → downloading → verifying → preparing-runtime → self-testing → installed 的安装状态机。本地推理不需要 API Key，也不需要网络。

真实的索引／查询／测试／重试都会进入既有的用量统计。未知价格保持 N/A，失败不会虚构 token 数。

选哪个？BGE 快，跨语言能力弱一些；Qwen 在长正文上建索引更慢；分块到 5 万条时，检索时间已经接近上限。

嵌入模型管理

角色集群

开启角色 Agent 集群后，主要人物分别在独立上下文中推演。每个角色可以选择模型与思考强度，即使用同一个模型也独立运行。它们获得自己的人设、当前剧情、导演笔记和近期已读取的世界书资料，主代理再综合各方建议推进故事。

模型配置分两级：全局默认模型 + 单角色覆盖。单角色覆盖属于当前可见对话，并与其世界线共用；但每个实际世界线的输入与结果仍然互相隔离——共享的是偏好，剧情历史各写各的。

后台的子代理不会再出现在会话列表里；保存草稿、资源与导出回复、任务操作也不会再重复提交或过期。

想让一场相遇拥有更多角度，就为这段故事开启角色集群。让每个人物带着自己的性格、立场和打算参与推演，再由主代理把碰撞与交锋写成一幕完整的戏。

多角色 Agent 集群

人物各自推演之外，模型也可以分工。 你可以让正文、后台记忆、读卡、状态与导出任务使用适合的模型，也可以统一跟随主模型；模型设置支持全局默认和当前会话覆盖。

查看多模型协同设置

多模型协同设置

状态栏与决策卡

行动建议只出现在独立决策卡里，不再重复塞进状态栏或正文尾部。旧卡片里遗留的行动区域会被隐藏，但原卡本身一个字都不改。

决策卡现在有自己的操作：折叠／恢复（⌃ / —）、独立的 × 稍后处理、拖动移动，双击或按 Home 复位，可视高度有上限，不会吃掉整个屏幕。

阅读呈现也顺手顺了一批：作者写的状态 HTML/CSS 在导入、生成和旧数据恢复三条路径上都会被校验并保留；围栏状态样式与不透明面板恢复；状态面板撑满可用高度同时保留内部滚动；折叠后的侧栏重新展开按钮保持可见。状态模板的动态槽位可以接收真实数值，同时保留作者原有的 HTML/CSS/JS 结构；任务校验失败会带上结构化诊断、失败时间和重试指引。

HTML/CSS 阅读呈现与状态栏

全新自有皮肤

0.2.5 带来了项目第一套自有皮肤 dsh-nexttavern-amber：整套界面用同一套设计 token 重绘，日间与夜间两套主题切换一次就是两种气氛；侧栏坐着一位 Q 版酒馆看板娘，日夜各是一张不同的画；夜间主题下的酒馆阅读模式铺在陈旧羊皮纸上，作者自己写的墨色一点没动——喜欢安静地读完一篇长文的人，会喜欢这一版。

皮肤随安装包一起装好，但默认不开，所以你的界面还是原来的样子。想换上它：打开 设置 → 插件市场 → 已安装，找到 dsh-nexttavern-amber，把开关打开。它写进 profile 的 cordis.patch.yml，热加载大约一秒生效，不用重启；看腻了拨回去就行，你的选择在重启后依然保留。这个开关由随包的第三方插件市场提供，来源、出站请求与关闭方法见补丁与依赖来源。

自有皮肤 · 日间主题

自有皮肤 · 夜间主题

世界线与分支

不满意某段发展，可以重新生成；想改一个选择，可以修改玩家消息后发送。不同版本组成当前对话内的世界线，可以来回切换查看。只有在显式选择“在新对话中分支”时，才会创建独立对话。

每条世界线有自己的剧情、状态与记忆；笔记属于实际世界线，而角色的模型偏好与向量索引按对话或查询世界线共享。小说导出跟随你选中的世界线，方便保留你喜欢的故事版本。

同一对话内的世界线与分支管理

按你的方式阅读与创作

在“酒馆管理”中分别调整人物、世界背景、剧情方向、文风和自定义规则。把镜头、节奏与人物边界写进规则，把 HTML/CSS、状态栏和正则美化写进卡片，让不同故事拥有不同的阅读呈现。

正文生成时就能读；局后状态与笔记维护有独立进度。继续输入的玩家行动进入原生队列。

沉浸式阅读体验

查看管理界面、自定义规则与世界书

酒馆管理

自定义规则

世界书管理

从角色卡到可带走的小说

那些反复推敲的对白、意想不到的转折、终于抵达的结局，都值得成为一份真正的作品。选中你喜欢的世界线，一键整理成小说稿；也可以导出打磨后的完整角色卡，让这个世界继续被阅读、被分享、被创作。

一键导出小说稿

查看资源库

资源库按时间或名称排序，支持刷新、查看文件与下载；角色卡和导出文件保留可识别的主题名称。

资源库管理

交互式创作

不必先准备一张完整角色卡，带着想象力来就够了。 一座永远下雨的港城、一段针锋相对的关系，或只是“我想经历一场慢热的冒险”，都能成为创作的开端。

AI 会和你聊人物、关系、氛围与剧情方向，把你的回答逐步展开成世界背景、多角色人设、开场、文风和阅读排版，再用十二项完整性检查过一遍。你可以亲自雕琢每一处细节，也可以把留白交给它：“你来决定。”从最初的灵感到可以开玩的角色卡，创作本身就是旅程的一部分。

交互式角色卡创作

用量统计
尽情探索，也把模型的表现与开销看清楚。 请求日志、供应商统计和模型统计集中在同一个面板，按会话、时间与模型切换，就能查看输入输出 tokens、缓存命中率、生成速度和费用。嵌入模型的索引、查询、测试与重试也计入同一份统计。

比较不同模型的创作投入，观察长篇推进时的缓存变化，回看一次重生成或角色集群调用的消耗，都有据可查。支持模型价格倍率、手动单价与币种换算，让你按自己的预算与偏好安排下一段故事。

模型使用量与缓存统计

架构设计

功能都在上面了，这一章说它们在同一套运行时里是怎么接起来的。 写长篇，需要沿途积累的记忆、可随时翻阅的世界资料，也需要人物各自的动机。NextTavern 将这些能力连接进原生 Agent Loop：主代理推进叙事，记忆代理整理长线，角色代理独立推演，程序把当前故事需要的上下文准备好。 从读卡、开场到分支与导出，整个创作过程由这套架构贯穿。

flowchart TD
Player[玩家输入与角色卡] --> Queue[原生输入队列]
Queue --> Context[程序装配当前世界线的设定、正文与导演笔记]
Context --> Writer[主代理与原生 Agent Loop]
Writer  Lore[按需读取世界书与原始历史]
Writer  Cast[可选角色 Agent 集群]
Writer --> Story[流式正文与追加式剧情记录]
Story --> Reader[沉浸阅读、世界线切换与小说导出]
Story --> Tasks[局后状态与决策任务]
Story --> Memory[后台导演笔记与检查点]
Memory --> Context

五个设计，贯穿你的每一次创作：

1. 让 AI 主动探索世界。 当前设定、正文和笔记随时可用；需要世界知识或早期细节时，主代理自己查阅资料，再把发现融入故事。
2. 给长篇一套会整理的记忆。 固定设定始终在场，近期正文保留眼前细节，导演笔记承接长线，历史查询让旧事有迹可循。从当前场景到早期伏笔，信息各有归处。
3. 把“换一种选择”变成真正的世界线。 重写一句行动，重新生成一次回应，就能沿另一条路线继续。每条世界线保留自己的剧情、状态与记忆，也能单独导出。
4. 让不同角色带着自己的想法登场。 角色分别推演，主代理综合他们的行动与意图；记忆、状态、读写卡等工作还能交给不同模型协作完成。
5. 让阅读跟上灵感。 正文边写边读，状态与笔记随后整理。你可以继续酝酿下一步行动，让创作自然衔接。

阅读完整架构说明：上下文组成、记忆四支柱、预设作用域、长文本流水线与请求成本

下载

架构说完，下面是取用与维护这一版需要的材料。 先看这一版发布了哪些文件。

- 主包 dsh-nexttavern.tgz，含预构建 UI、源码、preset、参考卡、补丁器、CLI 和可选公网鉴权源包。
- 独立 dsh-debug.tgz。
- 公网鉴权插件 dsh-auth-webserver.tgz，安装步骤见手机电脑公网访问指南。

一键安装器：

- NextTavern-Setup.exe（Windows x64）
- NextTavern-Setup-arm64.exe（Windows on ARM）
- NextTavern-Setup.sh（Linux，x86_64 / aarch64）
- nexttavern-setup.tgz（安装器的 npm 归档）

校验与来源：

- SHA256SUMS 与 provenance.json
- 版本说明。未发布到 npm，不要使用 npm install dsh-nexttavern。

安装

一键安装器已经覆盖了绝大多数场景；这一节是手动路径，适合想自己控制运行时版本、自己应用补丁、需要固定端口，或者要接进自己运维流程的用户。

需要 Node.js 22+、npm、Python 3 和 tgz 解压工具。以下为 PowerShell 7 示例，使用独立的新目录。先下载主包；每条命令成功后再继续。

$ReleaseDir = Join-Path $PWD 'nexttavern-release'
$HarnessRoot = Join-Path $PWD 'nexttavern-harness'
$env:DSH_HOME = Join-Path $PWD 'nexttavern-home'powershell
New-Item -ItemType Directory -Path $ReleaseDir,$HarnessRoot -ErrorAction Stop | Out-Null
tar -xzf ./dsh-nexttavern.tgz -C $ReleaseDir
Copy-Item -LiteralPath "$ReleaseDir/package/harness/package.json" -Destination $HarnessRoot
Copy-Item -LiteralPath "$ReleaseDir/package/harness/package-lock.json" -Destination $HarnessRoot
npm ci --prefix $HarnessRoot --ignore-scripts --no-audit --no-fund
node "$HarnessRoot/node_modules/@deepseek-ai/dsh/lib/bin.js" web --dump-config | Out-Null
$ProfileDir = Join-Path $env:DSH_HOME 'profiles/web'
npm install --prefix $ProfileDir --legacy-peer-deps --ignore-scripts --no-audit --no-fund "$PWD/dsh-nexttavern.tgz" "$HarnessRoot/node_modules/@deepseek-ai/dsh-tools"
$PackageRoot = Join-Path $ProfileDir 'node_modules/dsh-nexttavern'

随包 Harness 锁文件固定 alpha.3 官方依赖，避免旧 prerelease 的宽范围解析到新版本。本地目录依赖让社区文档工具复用 Harness 的同一个 dsh-tools 实例；不要在 profile 中另装不同版本的官方工具注册表。

安装 preset 和修改 Harness 前，停止目标实例，为每次操作选择新的备份目录：
powershell
node "$PackageRoot/tools/install.mjs" --home $env:DSH_HOME --harness $HarnessRoot
node "$PackageRoot/tools/install.mjs" --home $env:DSH_HOME --harness $HarnessRoot --apply --stopped --backup "$PWD/nexttavern-preset-backup-1"
node "$PackageRoot/tools/patch-harness.mjs" --harness $HarnessRoot
$env:DSH_ALLOW_HARNESS_PATCH = '1'
node "$PackageRoot/tools/patch-harness.mjs" --harness $HarnessRoot --apply --stopped --backup "$PWD/nexttavern-harness-backup-1"
Remove-Item Env:DSH_ALLOW_HARNESS_PATCH
node "$HarnessRoot/node_modules/@deepseek-ai/dsh/lib/bin.js" web --host 127.0.0.1 --port 3510

浏览器中配置自己的供应商，选择工作区，在新会话预设菜单中选择“角色扮演模式”。打开角色扮演会话后，可见“酒馆管理”侧栏入口和“酒馆”TAB。未打补丁也能加载插件，但会缺少完整的 UI slots 和世界线支持，那不算完整安装。

已有 alpha.3 的用户可以用自己的 HarnessRoot/DSH_HOME，先跑一次 audit。已有但不受安装器管理的 roleplay preset 会被拒绝覆盖，请先自行备份和迁移。遇到未知版本或文件指纹，安装会停下，不会降级成部分安装。--stopped 是你的停机确认，工具不会替你终止服务或会话。

文档扩展

上传和 read_document 随完整安装提供。anydoc 的 DOCX/PDF 转换与 office 的 DOCX 导出定义和配置入口也随包交付；启用需安装依赖后重新安装 preset：
powershell
npm install --prefix $ProfileDir --legacy-peer-deps --ignore-scripts --no-audit --no-fund 'https://github.com/a86582751/dsh-plugin-anydoc/releases/download/v0.1.0-nexttavern.1/dsh-plugin-anydoc-0.1.0-nexttavern.1.tgz' '@huiliyi37/dsh-office@0.2.2'
node "$PackageRoot/tools/install.mjs" --home $env:DSH_HOME --harness $HarnessRoot --documents
node "$PackageRoot/tools/install.mjs" --home $env:DSH_HOME --harness $HarnessRoot --documents --apply --stopped --backup "$PWD/nexttavern-documents-backup-1"

省略 --documents 再安装可关闭这两个挂载，不删除文档。显式启用但缺依赖会报错。扫描版 PDF 走 OCR，能否读出内容取决于文件本身；能读哪些格式，也取决于系统里可用的组件。office 的 docx_read 有长度上限，完整读卡使用 read_document 分页或 anydoc。长文本转角色卡读的是工作区 TXT，不依赖这一节的扩展。

补丁与依赖来源

| 单元 | 目标版本 | 作用 |
| --- | --- | --- |
| ui-chat | 0.1.2-alpha.3 | slots、动作栏与维护投影 |
| ui-workspace | 0.1.2-alpha.3 | 侧栏 slots、CSS 标识符 |
| token-meter | 0.1.2-alpha.3 | 编辑计量与热路径 |
| session-projection | 0.1.2-alpha.3 | 投影热路径与缺事件恢复 |
| Session Controller | 0.1.2-alpha.3 | 原生 forkPrepared 世界线准备 |
| pi-ai | 0.84.4 | Google、OpenAI Completions/Responses、Anthropic 流终止 |

全部目标先在内存里转换、核对，再备份和写入。重复应用完全相同的补丁是幂等的；失败会恢复本批改动，中断后可按事务备份回滚。被其他升级或你自己改过的文件不会被强制覆盖。npm 安装没有 postinstall 补丁。

社区兼容包使用正式 fork，保留上游历史和署名，不会被误认作原作者发布：

- dsh-file-upload，上游 HongMing-Huang/dsh-file-upload 0.4.3。修复上传回调、稳定引用、附件关闭不删资源、完整分页和 Markdown 转义；基础包保留原版 Host 检查。显式安装公网兼容后，额外接受鉴权插件完成 JWT 与 Origin 校验后写入的服务器标记。
- anydoc，上游 beancookie/dsh-plugin-anydoc 固定提交的 0.1.0，保守还原 Markdown 转义。
- pi-ai 差分，上游 earendil-works/pi 0.84.4。统一补丁器解析 Harness 实际使用的实例，不另装无效的 profile 副本。

随包还装了一个第三方插件市场，上面那套皮肤的开关就由它提供：

- dsh-market（npm 名 dshmarket）固定 1.39.0，MIT，就是 dshmarket.com 的插件市场：在设置里浏览、搜索、一键安装社区插件。
- 它是独立的第三方项目，由 dsh-market 维护，不是我们写的。打开市场会读取 awesome-dsh-plugin.com 的公共插件目录，打开评论会连 giscus 和 GitHub——这是我们「本地服务只监听 127.0.0.1」之外额外出站请求的来源。我们固定版本、不跟随上游，也不改它的代码。
- 不想让它联网，可以在 设置 → 插件 → 插件配置 里把它关掉；那之后皮肤也能继续用，只是换肤要手动改 profile 的 cordis.patch.yml。

better-sidebar 不是必需依赖，用官方侧栏就好。公网玩家可按手机电脑公网访问指南显式安装随包提供的 @isund/dsh-auth-webserver（0.1.0-alpha.3.2），配置自己的 Cloudflare Access、域名和登录身份。鉴权源码、脱敏模板、三个可回滚的公网兼容选项都已交付；默认的本机安装不会自动开放网络。个人密钥、地址、systemd/Nginx 实例配置和私有模型路由不随包分发。通用 Qwen reasoning 配置辅助工具保留在 integrations 目录，只在你的路由确实需要时使用。

更新、卸载与回滚

用一键安装器的玩家，更新就是在旧安装上运行新安装器（Windows 支持原地升级，保留故事与设置）；卸载则在停止服务后删除安装目录和快捷方式。细节见 Windows 与 Linux 指南。

手动安装的更新流程：先停止实例并备份，核对新版本兼容情况；安装新 tgz 后运行新安装器和补丁 audit。你改过的受管 preset 文件不会被覆盖，但要先保留并核对改动。安装器用 .nexttavern-install.json 管理文件。
powershell
卸载 preset 与 bundle 注册，保留故事、资源、笔记和模型配置。
node "$PackageRoot/tools/install.mjs" --home $env:DSH_HOME --harness $HarnessRoot --uninstall --apply --stopped --backup "$PWD/nexttavern-uninstall-backup-1"
回滚指定的安装或卸载事务。
node "$PackageRoot/tools/install.mjs" --rollback "$PWD/nexttavern-uninstall-backup-1" --stopped
单独恢复原版 Harness，完整酒馆功能随之不可用。
$env:DSH_ALLOW_HARNESS_PATCH = '1'
node "$PackageRoot/tools/patch-harness.mjs" --rollback "$PWD/nexttavern-harness-backup-1" --stopped
Remove-Item Env:DSH_ALLOW_HARNESS_PATCH

卸载器不删除 npm 依赖。确认不再使用后，可以从 profile 里移除插件包；其他插件仍然依赖的上传/文档工具要留着。回滚只用对应实例的原始备份。

源码与验证范围

如果你想自己重建一套界面，或者核对这个包是怎么做出来的，这一节就是路线图。

TypeScript 是唯一维护源码。 手写 .ts / .mts，.js / .mjs 由共享构建清单经 TypeScript 5.9.3 生成。本版发布包含 637 个构建产物、24 个 schema 和 158 个 TypeScript 模块，运行时已经整体迁移过来，包括核心、UI、记忆、鉴权、读卡、任务、遥测、分支与世界线路由，以及发布与安装工具链。

provenance.json 记录维护源码提交、逐文件来源、工具版本和 SHA-256；tools/harness-patches.json 记录上游固定来源及前后指纹。主仓库不携带完整官方补丁快照。想重建 UI：
powershell
npm ci --prefix ./build-tools --ignore-scripts --no-audit --no-fund
npm run build

同一份源码和锁文件应当重建出相同的 lib/client.js。改动源码后请更新自己的版本号与 provenance，不要冒充原始 Release。兼容 fork 各自有无需维护仓库的独立重建命令和归档摘要。

架构设计与各部分的取舍写在架构说明里。安装、补丁和记忆部分的改动都有对应的测试；两个一键安装器各自适用哪些场景，写在 Windows 一键安装指南 与 Linux 一键安装指南 里。

社区支持

感谢 @ljs1997sh 在 NextTavern 发布后迅速带来 dsh-nexttavern-qq-mobile，为手机玩家提供 QQ 风格界面、紧凑布局，以及手机、局域网和远程访问方案，让更多人能随时继续自己的故事。0.2.5 的自有皮肤是本仓库内的独立实现，没有合并它的界面，也没有转发它的代码。

这是一个由作者独立维护的社区项目，请按它的仓库说明了解安装方式和适用场景。这里提供的 CF Access 鉴权插件和公网访问指南需要按指南一步步配置和确认。

反馈与许可

带着你的世界来，也把体验和想法带回来。分享反馈与建议，一起打磨下一段更好的创作旅程。反馈问题时请附版本与复现步骤，并隐去密钥和私密内容。

自有代码以 GPL-3.0 开源。随包的上游补丁与社区改动各自保留原许可（DeepSeek 与 pi 的 MIT 条款、上传与 anydoc fork 的 MIT、office 的 Apache-2.0），逐项列在 NOTICE 里。