dsh-sillytavern
将 SillyTavern 的「角色卡」「世界书（lorebook）」与「生成预设」接入 DeepSeek Harness：角色卡进入系统提示词，世界书条目按关键词在每步注入为运行时上下文，生成预设的可移植采样字段应用到每个 agent 请求。全部通过斜杠命令管理，状态持久化到 ~/.dsh/sillytavern/state.json。不新增任何模型可见的工具 schema。
蓝色大肥鱼写的喵，不好用我替你去压力蓝色大肥鱼喵
功能
sillytavern:character系统提示词 section（第 10 位，紧跟在 persona 之后）：角色卡的名称、描述、性格、场景、系统提示、对话示例与开场白共同塑造 agent 的人设。sillytavern:lorebook运行时上下文（第 50 位）：常驻条目每步注入；关键词/次要关键词条目在匹配最近用户消息时注入。每步受maxInjectedEntries/maxInjectedChars限制。- 生成预设：加载 SillyTavern「AI Response Configuration」JSON 后，把
temperature、max_response_length/max_tokens、stopping_strings通过agent/requestwaterfall 应用到每个 agent 请求；无法应用的字段会明确列出，绝不静默丢弃。
命令用法
#### /character
| 写法 | 作用 |
|---|---|
/character | 查看当前已加载的角色卡（显示名字和标签数）；没加载时会提示怎么加载 |
/character clear | 清除已加载的角色卡 |
/character <路径> | 加载一张角色卡 |
#### /lorebook
| 写法 | 作用 |
|---|---|
/lorebook | 查看当前条目总数和所有关键词 |
/lorebook clear | 清空全部条目 |
/lorebook load <路径> | 从 JSON 文件追加导入条目 |
/lorebook add <关键词>::<内容> | 手动新增一条条目 |
/lorebook remove <关键词> | 按关键词删除条目（不区分大小写） |
#### /preset
| 写法 | 作用 |
|---|---|
/preset | 查看当前已加载的预设及其应用/跳过的字段；没加载时会提示怎么加载 |
/preset load <路径> | 加载一个 SillyTavern 生成预设 JSON |
/preset clear | 停止应用预设，恢复 harness 默认采样参数 |
卡片格式
.json角色卡：SillyTavern V1（扁平）或 V2（{ spec: "chara_card_v2", data: {…} }）。- PNG 角色卡：名为
chara（JSON）或ccv3（base64 JSON）的tEXt数据块。 - 世界书文件：SillyTavern
{ "entries": { … } }或条目数组。
{{char}} / {{user}} 宏会被解析为角色名与 User；其余 {{…}} 占位符会被中和，避免严格提示词插值拒绝该提示词。
生成预设字段
| SillyTavern 预设字段 | Harness 字段 | 说明 |
|---|---|---|
temperature | LlmCallConfig.temperature | 截断到 [0, 2]（DeepSeek 兼容范围） |
max_response_length / max_tokens | LlmCallConfig.maxTokens | max_length（上下文截断）无对应项，会在结果中列为跳过 |
stopping_strings | LlmCallConfig.stop | 空字符串条目被丢弃 |
文件中的其余字段（top_p、top_k、rep_pen、freq_pen、mirostat_*、采样器顺序、banned_strings、prompt_order 等）都会在加载结果中列为跳过——绝不静默丢弃。
配置
| 字段 | 默认值 | 含义 |
|---|---|---|
stateFile | '' | JSON 状态文件；为空表示 ~/.dsh/sillytavern/state.json（存角色卡、世界书与预设） |
scanDepth | 4 | 世界书扫描器读取的最近用户消息数 |
maxInjectedEntries | 8 | 每步注入的世界书条目数 |
maxInjectedChars | 4000 | 每步注入的匹配条目总字符数 |
安装
# 在插件目录下执行，需设置 DSH_CHECKOUT 或插件位于 checkout 内：
npm run build
dsh plugin --profile web add .