# DSH 酒馆模式

> **当前预发布：0.4.2-rc.4**。修复实时消息显示、共同记忆重复存储和失败后整轮重跑，安装包可直接使用。详见 [更新说明](REPAIR_RC4.zh-CN.md) 和 [发布页面](https://github.com/3121455692atou-sudo/dsh-tavern-mode/releases/tag/v0.4.2-rc.4)。

在 DeepSeek Harness 中导入 SillyTavern 角色卡、预设和世界书，使用原生聊天界面进行互动写作。

支持普通模式与多 agent 模式、HTML 前端组件、独立角色记忆、表格更新、台词框和跨会话共享头像。

## 安装

安装前需要：

| 项目 | 要求 |
|---|---|
| Node.js | 26.4 或更新版本，包含 npm |
| DeepSeek Harness 自身 | 已实测版本为 0.1.5-rc.1，命令 `dsh` 可用 |
| pnpm | 已验证版本为 11.21.0，命令 `pnpm` 可用 |
| 网络 | 能访问 GitHub Release 和 npm registry |
| 使用方式 | dsh Web 版及浏览器；生成内容需配置模型提供方 |

当前版本已在 macOS arm64（Node.js 26.8.2、DSH 0.1.5-rc.1）完成插件运行验证。早期版本另有 Linux x86_64 验证；Windows 尚未完成运行实测。

先查看现有版本：

```bash
node --version
dsh --version
pnpm --version
```

缺少 pnpm 时安装：

```bash
npm install -g pnpm@11.21.0
```

以下短行命令适用于 macOS/Linux 的 zsh 或 bash，整块复制即可，保留续行符 `\`：

```bash
dsh_url=https://github.com
dsh_url+=/3121455692atou-sudo
dsh_url+=/dsh-tavern-mode
dsh_url+=/releases/download/v0.4.2-rc.4
dsh_url+=/dsh-tavern-mode-0.4.2-rc.4.tgz
dsh plugin --profile web add \
  --allow-build=esbuild "$dsh_url"
```

安装或升级前先停止正在运行的 `dsh web`。已有插件直接执行同一条 add 命令，无需卸载。安装后重新启动 `dsh web` 并刷新已打开的页面，在输入框上方的模式菜单选择「酒馆模式」，再导入自己的角色卡。发布包已经包含前端构建产物。安装参数 `--allow-build=esbuild` 用于安装脚本编译器，供 HTML 模块加载和酒馆助手更新使用。

使用 npx 启动 dsh 时，在上面的短行代码已设置 `dsh_url` 后执行：

```bash
npx @deepseek-ai/dsh@0.1.5-rc.1 \
  plugin --profile web add \
  --allow-build=esbuild "$dsh_url"
npx @deepseek-ai/dsh@0.1.5-rc.1 web
```

模型使用 dsh「设置 → 模型」中已经配置的提供方。插件的模型选项留空时跟随输入框中的模型。

## 使用

- **普通模式**直接读取历史原文。最大输入默认为 200,000 个估算 token，应用不设置数值上限；超出预算时从最早的历史开始截断。入口为输入框上方的「最大输入与模型」。
- **多 agent 模式**执行角色召回、场景组合、剧情推进、写作和状态更新。写作读取上一条正文原文、本轮输入，以及已有摘要、记忆和状态。各阶段模型和并发数可以单独配置。
- **台词框**支持角色、玩家、情绪差分、格式和图片设置。头像全局共享、按内容去重，切换或删除对话后继续保留，手动删除后才从头像列表移除。
- **资源导入**支持 PNG/JSON 角色卡、世界书、酒馆预设、正则和 ZIP 资源包。推进预设和表格模板可选。
- **共同事件记忆**按知情范围保存一份事件正文，各角色保留引用与个人变化；私人信息仍隔离。表格或记忆失败后可仅重试未完成更新。
- **消息操作**支持编辑、删除、重新生成和分支，关联的表格与角色记忆随剧情版本更新。

固定提示词和稳定工具 schema 优先复用前缀。普通模式的输入预算使用本地估算，实际分词和缓存命中率由所选模型与提供方决定。

酒馆助手接口随包提供，并可在设置中检查上游更新。直接依赖 SillyTavern 后端或其他扩展私有接口的脚本可能仍需适配。

## 数据位置

默认数据目录为 `~/.dsh/tavern/`，设置 `DSH_HOME` 时使用对应目录。

插件文件按安装位置定位，数据文件按数据目录定位。`dataDir` 的相对路径以 dsh 数据目录为基准；本地导入的相对路径以酒馆数据目录为基准。资源和头像使用标识引用，移动数据目录后继续有效。

| 内容 | 位置 |
|---|---|
| 会话及剧情版本 | `tavern/sessions/` |
| 导入资源目录 | `tavern/library/` |
| 共享头像索引 | `tavern/runtime/avatars.json` |
| 独立图片文件 | `tavern/assets/` |
| 酒馆模式注册 | `.agent-presets/tavern/` |

已有本地酒馆模式配置会保留，首次启动只创建缺少的模式注册文件。

## 开发

```bash
npm ci
npm test
npm run check
npm run build
npm pack
```

源码位于 `src/`，构建脚本位于 `scripts/build.mjs`。上游组件的来源和许可见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。

## 卸载

```bash
dsh plugin --profile web remove dsh-tavern-mode
```

重启 dsh 后，在模式设置中删除「酒馆模式」的本地注册即可。剧情数据保留在数据目录中。

[DSH 官方插件安装文档](https://deepseek-harness.github.io/deepseek-harness/develop/basic/publish) · [发布版本](https://github.com/3121455692atou-sudo/dsh-tavern-mode/releases)