DSH Preset Enhance

为 DeepSeek Harness 加载和编辑 SillyTavern 预设，在请求发送给模型前按顺序表注入消息，并按 DSH 模式或当前会话控制工具。

安装

从 npm 安装当前 RC 版本：

dsh plugin --profile web add dsh-preset-enhance@0.3.2-rc.1

也可以直接安装 GitHub main 分支：

dsh plugin --profile web add github:bychv/dsh-preset-enhance#main

0.3.2-rc.1 和当前 main 分支面向 DSH >=0.1.5-rc.2 <0.1.6。此版本之后的 alpha 分支将用于 DSH 0.1.6 兼容开发；继续使用 DSH 0.1.5 时请固定安装 0.3.2-rc.1。

重新启动 dsh web 后，左侧栏会出现“预设工作台”，新建对话的模式列表中会出现“预设模式”。

预设注入

工作台可以导入、编辑、预览、导出和删除 SillyTavern 预设。导入后会立即保存到全局预设库并成为当前默认；在预设库中切换选择也会立即更新当前默认。删除仍被默认设置或会话引用的预设时，会自动切换到另一个已保存预设；删除最后一个预设会关闭相关会话的注入。最后选择保存在 DSH 状态目录中，重启后继续使用。当前默认预设会用于自动注入；可以在“新会话自动启用预设注入”中选择任意 DSH 模式。保存模式列表只影响之后新建的会话；已有会话保持原状态。专用的“预设模式”始终自动启用。

当前会话可以使用原生命令即时切换，命令由 DSH 本地处理，不会作为聊天消息发给模型：

/preset on
/preset off
/preset status

直接输入 /preset 会在开启和关闭之间切换。

“预设模式”从当前安装的 standard 模式生成，因此拥有标准模式的工具集。它会移除 DSH 的身份 system prompt 和运行环境快照，使发送给模型的提示词完全由预设和真实聊天记录组成。其他模式保留各自原有提示词，同时可以叠加预设注入。

提示词条目分为两个区域：

• 顺序表内：条目已经参与当前顺序表；复选框只控制是否启用，未勾选的条目仍属于顺序表。
• 闲置条目：条目没有加入当前顺序表，不参与注入；点击“加入”后才会移动到使用区。

支持顺序表中 chatHistory 前后的 system、user、assistant/model 消息，以及按聊天深度注入。支持常用 SillyTavern 变量宏，包括 setvar、getvar、global 变量、数值修改、随机选择与骰子。extensions 会原样保留在预设 JSON 中，当前版本不执行其中的扩展行为。

当编译后的最后一条预设消息是 assistant 时（包括顶层 assistant_prefill，以及预设顺序表在 chatHistory 后安排的 assistant/model 条目），工作台会显示预填充续写提醒，消息预览也会标出 Assistant Prefix。这类预设必须使用支持 assistant prefix 的接口。

可以在“Assistant 预填充接口”面板开启“预填充自动兼容”。插件只处理当前请求中匹配到的末条 assistant 预填充：为最后一条 assistant 消息发送 prefix: true；在思考模式下，把 <think> 前缀和兼容接口使用的 reasoning / reasoning_text 映射到 reasoning_content，并保留工具调用历史中的真实思考内容。

• DeepSeek 官方地址：自动把官方 Chat Completion 地址切到 https://api.deepseek.com/beta。官方 Beta 不接受原生工具字段，因此未开启 DSML 处理时也会移除 tools、tool_choice 和 parallel_tool_calls。
• 非官方适配器地址：直接处理适配器实际请求的 Chat Completion 地址，不改写地址，也不需要在工作台重复填写。关闭 DSML 处理时，可用“非官方接口移除原生工具字段”开关选择移除或原样发送工具字段。
• 工具调用处理开启：对官方和非官方地址都生效。插件把可用工具定义注入 system 提示，把历史 tool_calls 和工具结果转换为 DSML，再移除原生工具字段。模型返回的 DSML 会在流式或非流式响应中恢复为标准 tool_calls，交回 DSH 执行；工具结果中的常见 base64 图片也会转换为兼容的图片内容块。

“工具调用后继续请求的预填充”默认继承原预设，也可设置独立提示词（支持变量宏与 <think> 前缀）。开启预填充自动兼容时，该设置仅替换同一轮工具执行后继续请求的末条 assistant 预填充；新一轮用户消息仍使用原预设。自定义文本留空或展开为空时继承原预设。设置全局保存，修改后从下一次请求生效。

普通请求、非预填充请求和没有命中当前会话末条 assistant 前缀的请求不受影响。接口要求见 DeepSeek 对话前缀续写文档。

工具预设

工具面板支持两层配置：

• 模式默认：可以为每个可用的 DSH 模式分别开启或关闭工具。没有独立覆盖的会话会继承该策略，保存后从下一次模型请求开始生效。
• 当前会话覆盖：在同一会话中随时改动工具开关，下一次请求立即使用新策略；“恢复继承”会重新采用当前模式的默认策略。

两层配置都可以保存为工具预设，由模式默认或会话选择引用：

• 工具栏提供范围（模式默认/当前会话）、模式和工具预设选择；模式范围只能选择“自定义”或某个预设，会话范围还可以“继承模式默认”。会话选择完整替换模式策略，不与模式默认叠加。
• “新建”从当前有效策略生成预设（defaultEnabled 为 true，只保存被关闭的工具），“复制”复制规则和分组引用并生成新 ID，“重命名”和“删除”只影响该预设本身。删除仍被引用的预设时，模式默认回到“自定义”、会话回到“继承”，并保留原有逐工具开关，避免权限突然扩大。
• 修改被引用的预设后，引用它的模式和会话从下一次请求更新；工作台显示该预设“被 N 个模式、M 个会话引用”。

工具分组用于组织和批量编辑：

• 工具区按标签页组织：固定的“全部”“未分组”，以及按排序值和名称排列的用户分组；标签显示 名称 · 已启用/总数，标签栏可收起为紧凑下拉框，窄屏自动使用下拉框。
• 每个分组提供三态开关（部分启用显示为不确定状态）和“全开”“全关”“仅启用此组”“恢复预设值”批量操作；顶部“全选/全不选”始终处理当前模式的全部工具，不受标签筛选影响。
• MCP 工具会从当前会话的实时工具目录获取，并按 MCP 服务自动生成“服务名 · MCP”分组；也可以像普通工具一样加入用户分组。“刷新工具列表”可重新读取刚连接或断开的 MCP 服务。服务名始终放在标签开头，过长时从中间省略并保留首尾，完整名称显示在悬浮提示和折叠下拉框中。标签栏展开时保持单行横向滚动并自动滚入当前项；也可折叠为下拉选择，避免大量 MCP 服务挤压页面。
• “管理分组”可新增、重命名、排序、删除分组，并用复选框分配工具；同一个工具最多属于一个用户分组，未分组的工具显示在“未分组”标签。标签栏/内容区折叠状态、最后配置的模式和“自动保存工具开关”都只保存在浏览器 localStorage（键名以 dsh-preset-enhance.tool- 开头），不进入分享文件。

工具视图提供“自动保存工具开关”，默认关闭：

• 开启后，逐工具复选框、全选/全不选、分组三态开关以及“全开”“全关”“仅启用此组”“恢复预设值”等工具开关改动会在约 400 ms 防抖后立即保存（模式默认写入模式，会话覆盖写入当前会话），一次连续编辑只发一个请求，状态栏显示“已自动保存（范围 · 模式）”；页面隐藏或关闭时会尽力再冲刷一次尚未发送的改动。
• 自动保存只覆盖工具开关；“管理分组”中的分组名称、排序和成员结构改动仍需点击“保存分组”。
• 关闭时与手工保存一致：改动需要点击“保存工具开关”。该按钮始终可用，点击时会取消排队中的自动保存并等待在途请求结束，避免同一改动重复提交。
• 开关状态只记在浏览器，不进入分享文件。

工作台会记住最后配置的 DSH 模式（切换模式或保存模式默认工具时记录），刷新页面后优先回到该模式；保存预设、接口设置等其他内容也不会丢弃尚未保存的工具开关草稿。

当前会话的实时目录会同时用于显示与保存校验，因此会话级 MCP 工具、其他插件动态注册的工具可以直接保存到当前会话覆盖，也可以从该会话保存为模式默认。

开发时可用 npm run test:mcp:candidate 运行双 MCP 接入测试。测试会在 candidate 的真实 DSH 工具注册表中启动两个隔离的 stdio MCP 服务，验证两个服务的同名工具都能被发现、分别调用并形成独立分组；测试结束后自动关闭服务，不写入 candidate 配置。

关闭的工具会从发给模型的工具 schema 中移除，执行守卫也会拒绝该工具，避免已有或手写工具调用绕过开关。工具目录通过 DSH 的模式注册表和 standing scope 实时解析；内置模式和其他插件引入的模式都会自动列出，各模式的每个实际工具都能独立开关。若第三方模式本身无法装载，工作台会显示该模式的解析错误。目录中暂时不存在的工具引用会保留并列为“未匹配”，安装对应插件后自动重新匹配。

单文件分享

工作台支持导入和导出单个 .dsh-preset.json 文件，包含完整 ST 预设、预填充接口配置以及工具预设和工具分组。导出时默认只带当前关联的工具预设及其分组，不包含模式默认/会话选择、会话 ID、目录缓存、引用计数或浏览器本地界面状态（折叠、最后模式、自动保存开关）。导入文件本身不会改动接口设置或工具开关：包内接口设置需手动“应用包内接口设置（全局）”，包内工具配置需手动“导入包内工具配置”，应用前会显示新增、复用、重映射和匹配、失配统计。未知的工具子版本仍可导入、编辑和再次导出，但禁止应用。也可用“导出 ST JSON”生成普通预设文件。格式与字段约定见 单文件格式说明。