dsh-sillytavern

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/request waterfall 应用到每个 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 .