dsh-nexttavern

dsh plugin --profile web add dsh-nexttavern

dsh-NextTavern

简体中文 · [English](README.en.md)

最新版本：0.2.9-rc.4。 修复 Issue #17：长会话请求超限后的压缩恢复，以及持续推理被误判超时。保留 rc.3 的安装改进和慢模型首响应等待设置。GitHub 与 npm latest 均为 0.2.9-rc.4。

0.2.9 — Distribution & Installation Fix。 这是基于 0.2.8 的安装分发补丁：预置第三方 SDK 依赖，修复首次安装及私有组件重新链接时的构建脚本许可问题。正式来源为 npm dsh-nexttavern 和 v0.2.9 Release，支持 Harness 0.1.7-rc.2／web／Session V4。开发请读[重建指南](CONTRIBUTING.md)。

从 0.2.5 等旧宿主版本迁移，请使用新目录。 先在旧环境导出角色卡或小说，再安装 0.2.9；旧会话不兼容，小说稿不保存完整会话状态。0.2.8 → 0.2.9 延续同一宿主与会话线，更新步骤见[更新、卸载与回滚](#更新卸载与回滚)。

抱歉让大家久等了。0.3 希望兼容更广泛的 SillyTavern 社区卡，包括 MVU 变量、EJS、RUBY 与前端美化；要让它们接入自有状态、结构化事件和恢复机制，难度比预期更大，我们正在加速推进。0.2.9-rc.4 在延续发行、安装与第三方依赖修复的同时，定点修复了 Issue #17；更广泛的社区卡兼容仍在开发。感谢大家继续反馈、陪我们把它打磨好。

0.3 开发进度（2026-10-03）：确定性导入、部分 MVU 状态与恢复路径已有验证；当前先补齐开场选择与初始化、各状态协议的编辑／分支／重开和关键操作，再推进依赖这些合同的动态模板与前端。完整兼容验收尚未完成，这些开发结果尚未包含在 0.2.9 正式包中。

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

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

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

在线文档 · [一键安装](#一键安装) · [开始体验](#开始体验) · [Windows](INSTALL-WINDOWS.md) · [Linux](INSTALL-LINUX.md) · [核心能力](#核心能力) · [记忆系统](#记忆系统) · [架构设计](#架构设计) · [手机电脑公网访问指南](PUBLIC-ACCESS.md) · [全部截图](SCREENSHOTS.md) · 反馈问题

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.9 · Harness 0.1.7-rc.2 · pi-ai 0.85.1 · 自有代码 GPL-3.0

先装宿主，再用[一键安装](#一键安装)的官方插件命令。需要自己指定目录、端口或使用归档时，见[安装](#安装)。

一键安装

已经装好 Harness 的玩家，只需这一条命令：

dsh plugin --profile web add dsh-nexttavern

这里的 dsh-nexttavern 是正式 npm 包名。部分第三方 Hub／市场目录未识别 npm 来源时会回退到 Git 源码安装；目录来源仍待第三方同步。请直接使用上面的官方命令，或下载已校验的 Release 归档。本版未承诺 Git 源码直装，也未扩展到 DSH 0.2／desktop。

第一次使用 DSH，请先安装 Node.js 24+ 和宿主：

npm install -g @deepseek-ai/dsh@0.1.7-rc.2

安装后运行 dsh web --host 127.0.0.1，按终端地址打开浏览器，配置自己的模型与 Key，再选择“角色扮演模式”。所需兼容组件、文档读取组件和自有皮肤由统一插件准备；皮肤随包安装、默认关闭。首次准备需要时间与网络，准备完成后的启动会复用已校验的组件。

从 0.2.5 迁移：先导出，再用新目录。 0.2.5 的旧会话无法直接延续，目录隔离步骤见[安装](#安装)。不要对旧 home 或工作区执行这条命令来尝试迁移会话。

Windows

希望由安装器准备便携运行时与快捷方式，可下载 NextTavern-Setup.exe。Windows on ARM 使用 NextTavern-Setup-arm64.exe。从 0.2.5 迁移时选择新的安装目录；完整步骤、未签名提示与验证范围见 [Windows 一键安装指南](INSTALL-WINDOWS.md)。

两端安装器准备便携宿主后，也通过官方 plugin add 安装已校验的归档；不再向宿主重放旧兼容补丁。安装失败时保留未完成回执，重新运行可以恢复本安装器拥有的工作。

Linux

NextTavern-Setup.sh 准备便携 Node.js、安装目录及启动／停止入口，面向 x86_64 与 aarch64（glibc），不需要 root 或系统包管理器。从 0.2.5 迁移时使用新的 --root；完整步骤与验证范围见 [Linux 一键安装指南](INSTALL-LINUX.md)。

安装与模型费用

安装、字节校验、恢复和卸载由程序完成，不调用故事模型。模型 API Key 由玩家输入，安装包不携带密钥；本机服务绑定 127.0.0.1。故事生成及既有后台记忆、状态等任务仍按所配置模型计费，打开已有会话也可能恢复后台维护。

开始体验

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

1. 新建一个独立工作区。 给这次角色扮演一个专用文件夹，角色卡、故事资源和导出文件都放在一起。

2. 在预设里选“角色扮演模式”。 新建会话时从预设菜单切过去，就进入了你的故事工作台。

3. 上传角色卡，或者直接聊出一张新的。 支持 SillyTavern / TauriTavern 的 PNG、JSON 人物卡；也可以只描述题材、人物、关系和氛围，让 AI 通过对话和你一起把这张卡做出来。

4. 开始体验。Enjoy it! 跟着开场推进故事，输入你的行动，切换世界线，或随时打开“酒馆管理”调整设定。

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

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

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

导入 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；上传入口随完整安装提供。

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

核心能力

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

能力 · 你可以获得什么

一键安装 · 官方一条 plugin add 安装酒馆与所需组件；另有 Windows／Linux 便携运行时安装器。旧版迁移使用新目录。

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、缓存、速度与已知成本，包含重生成、嵌入调用和失败尝试。

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

记忆系统

故

…(truncated)