MuseAI Tavern · DeepSeek Harness 的 MuseAI 标签

English | 中文

在 DeepSeek Harness 的会话标签栏「轨迹」右侧，新增一个 MuseAI 标签，把 MuseAI 桌面的五个页面（背景 / 聊天 / 冒险 / 羁绊 / 设置）搬进 DSH Web GUI，并让所有模型调用复用 DSH 已配置的模型 —— 不需要任何额外的 API / 密钥配置。

主要功能

• MuseAI 会话视图标签：注册于 conversation.view 插槽（order 15，位于「轨迹」order 10 右侧），点击后整个会话面板渲染 MuseAI 视图；标签内五页导航（背景/聊天/冒险/羁绊/设置）。
• 背景页（不含 AI 智能提取世界书/角色卡）：世界书 / 角色卡手动管理（自定义字段、按世界书分组的角色卡目录）、JSON 导入导出、MuseAI / SillyTavern 双格式导出与 SillyTavern 转换预览、文风预设、记忆 AI 浓缩、删除世界书（仅删/连带删）。
• 聊天页：伴侣对谈。绑定世界书 + 角色卡，流式对话（Markdown + Thinking 折叠 + 停止生成）、会话历史/标题编辑、文风预设、封存记忆、上下文用量圆环。
• 冒险页：文字冒险 / GM 跑团。世界书 + 多角色卡选择（勾选世界书自动带出角色卡）、动态角色加载、三种输入模式、流式故事 + [[TOOL]] 特殊气泡 + <choices> 候选选项、多角色卡封存记忆、会话保存。
• 羁绊页：角色关系概览、羁绊时间线、关联的聊天/冒险会话展示。
• 设置页：全部系统提示词（逐字复制 MuseAI 默认值，可编辑/重置）与 Agent 采样参数（temperature / maxOutputTokens / maxContextTokens / thinkingDepth 等）；模型区域为「DSH 模型选择」：跟随 DSH 默认模型，或从 DSH 已配置的 provider/model 目录中挑选，无任何 baseUrl / API Key / 连接测试。
• 持久化：数据（世界书、角色卡、会话、设置、风格预设）经插件服务端存储域落盘 $DSH_HOME/storages/museai.json（storage-domain json backend），浏览器 localStorage 仅作离线镜像；重启不丢。

快速安装

要求 DeepSeek Harness >=0.2.0-rc.1（包括 0.2.0-rc.2）。可用 dsh --version 检查本机版本；旧的 0.1.x 不再支持。

支持两种安装方式，均无需本地构建（构建产物 lib/ 已提交进仓库，且不设 prepare/prepack 脚本）。

方式一：npm 安装（推荐）

# 从 npm 安装（首次使用会初始化该 profile）
dsh plugin --profile web add @yejiming/dsh-museai-tavern

方式二：GitHub 源码安装

# 从 GitHub 源码安装（仓库已提交构建产物 lib/，安装时无需构建）
dsh plugin --profile web add github:yejiming/dsh-museai-tavern

安装后验证：

dsh --profile web --dump-config   # 输出中应出现 museai 与 museai-routes 行

启动 Web GUI：

dsh --profile web

在 Web GUI 中：打开任意会话 → 标签栏「轨迹」右侧出现 MuseAI → 先到「设置」页确认模型（默认跟随 DSH 默认模型，或从目录中选择）→ 在「背景」页创建世界书/角色卡 → 「聊天」页与角色对话、「冒险」页跑团、「羁绊」页查看关系。

模型前提：DSH 中需已配置至少一个模型（provider/model），否则设置页显示空态引导，聊天/冒险请求返回错误提示。

架构

浏览器 (apps/web)                         宿主进程 (dsh --profile web)
┌─────────────────────────────┐          ┌──────────────────────────────────────┐
│ MuseAI 会话视图 (conversation│  fetch   │ @yejiming/dsh-museai-tavern (宿主行) │
│  .view, order 15)           │ ───────▶ │  · museaiStore 服务（存储域/内存）    │
│  · 背景 / 聊天 / 冒险 / 羁绊 │          │ @yejiming/dsh-museai-tavern/routes    │
│  · 设置（DSH 模型选择器）    │          │  · /plugins/museai/models|chat|       │
│  · zustand + syncStorage    │          │    complete|store/*|sessions/*        │
└─────────────────────────────┘          └──────────────┬───────────────────────┘
                                                       │ ctx.llm（DSH 模型）
                                                       ▼
                                              DeepSeek / 其他已配置适配器

一个 npm 包两个装载面、宿主两条行：

| 面 | 入口 | 装载位置 | |---|---|---| | 宿主行（存储服务/配置） | lib/index.js（行 museai） | 宿主组合：打开 museai 存储域（失败降级内存）、提供 museaiStore；headless 可用 | | 路由行（模型桥/存储/会话） | lib/routes.js（行 museai-routes） | 宿主组合：webserver 存在时经嵌套 inject 注册 /plugins/museai/*；headless 自动跳过 | | 浏览器半体（标签/页面） | lib/client.js（dsh.client 声明） | 浏览器：注册 MuseAI 标签与五页视图 |

配置

所有字段都有 loader 默认值；无库级默认值；无任何凭据字段。

| 键 | 说明 | |---|---| | chatTimeoutMs | 流式生成端到端超时（默认 120000 毫秒） | | completeTimeoutMs | 非流式生成超时（默认 120000 毫秒） | | modelsTimeoutMs | 模型目录查询超时（默认 10000 毫秒） | | maxCompleteChars | 非流式输出捕获上限（默认 20000 字符） |

# cordis.patch.yml 或 profile 层覆盖示例
- id: museai
  config:
    chatTimeoutMs: 180000

HTTP 面（浏览器半体使用）

• GET /plugins/museai/models — DSH 模型目录 {groups, failures, defaultSelection}
• POST /plugins/museai/chat — 流式生成（NDJSON：start/delta/thinking_delta/done/error/aborted）
• POST /plugins/museai/complete — 一次性生成 {text, reasoning}
• GET/PUT /plugins/museai/store/<key> — 一个 store 数据（settings/partners/partnerChat/story/stylePresets/agent）
• GET /plugins/museai/sessions/<kind> 与 GET/PUT/DELETE .../sessions/<kind>/<id> — 会话记录（kind=partner|story）

开发

pnpm install
pnpm build        # tsdown 双半体 + 类型声明
pnpm typecheck    # 服务端类型检查（客户端见下）
npx tsc -p tsconfig.client.json --noEmit   # 客户端类型检查
pnpm test         # vitest（服务端路由/存储域 + 移植 utils）

lib/ 已提交进仓库，安装与调试（含 dsh plugin add .）都不需要先构建。重新 构建产物时直接 pnpm install 即可：@deepseek-ai/* 等依赖均已发布到 npm， 无需再从本地 DSH checkout 复制/链接 node_modules。pnpm-workspace.yaml 采用 dsh 同款约定（nodeLinker: hoisted）；pnpm 11 的供应链策略会拦截「发布不久」 的包与依赖构建脚本，仓库已预置 minimumReleaseAgeExclude（0.2.0-rc.1 及其配套依赖）与 allowBuilds: esbuild。

开发依赖固定在最低兼容版本 0.2.0-rc.1，宿主 peer 依赖声明为 >=0.2.0-rc.1。客户端使用 Cordis Context 与新版 dsh-client-ui-renderer 服务；模型桥识别新版 finish.reason 中的错误与取消状态。 修改源码后需运行 pnpm build 并一并提交 lib/，确保源码安装使用最新产物。

许可

MIT