DeepSeek Harness(DSH)采用插件化架构,具备高度的可扩展性。在处理 SillyTavern 的角色卡、世界书和预设文件时,开发者通常需要在本地文件系统、JSON 编辑器和 DSH 之间频繁切换。dsh-stcardwriter 插件在 DSH 中集成了 SillyTavern 的创作环境,提供本地化、可视化的资源管理方案。
该插件由 bychv 维护,遵循 MIT 许可证,旨在解决多格式资源的管理、预览与迁移问题。
核心功能¶
- 酒馆创作模式与工作台:插件支持 DeepSeek Harness
0.1.2-rc.1。它提供了“酒馆创作模式”Agent 预设和三栏工作台。左侧用于连接 Harness 并管理项目,中间用于编辑资源,右侧用于编辑世界书注入内容并支持实时预览。 - 模式切换:在酒馆工作台顶部可通过“工具模式”下拉框切换“标准模式”或“极简模式”。极简模式仅保留
tavern_*酒馆资源工具及少量交互工具,隐藏 Shell、文件操作等,以减少工具定义占用的上下文。 - 本地连接器:内置本地 SillyTavern 连接器,通过本地文件直连,不依赖 HTTP 接口,也不受 CSRF 或鉴权限制。酒馆无需处于运行状态即可进行同步。
- 格式支持与修复:支持 Character Card V1/V2/V3 的识别与编辑。支持世界书格式检查与修复,支持 Preset Plus 0.1.5。
- 资源管理:支持批量导入角色卡文件(.json, .png, .charx, .zip)。支持 CHARX 中除
card.json以外的任意文件及 PNG 二进制资源的保留。
安装与启用¶
通过官方 CLI 安装:
dsh plugin --profile web add github:bychv/dsh-stcardwriter
安装或升级后重启 DSH Host。首次启动会自动创建 tavern-authoring 和 preset-plus 两个 Agent 模式。
典型用法¶
- 激活 Preset Plus:在 DSH 设置的“预设增强”中创建、导入或激活 Preset Plus 预设。
- 选择模式:新建会话并选择“酒馆创作模式”。此时 Preset Plus 预设会与完整的
tavern_*工具同时生效。 - 导入资源:打开“酒馆创作”面板,可新建空项目,也可批量导入
.json、.png、.charx或.zip文件。 - 连接本地酒馆:在连接器面板填写 SillyTavern 目录(安装根目录或
data/<用户>目录)进行连接,用于浏览和同步本地酒馆资源。 - 切换工具模式:在酒馆工作台顶部的“工具模式”下拉框中,根据需要切换“标准模式”或“极简模式”。
注意事项¶
- 依赖关系:插件目前尚未发布到 npm,需直接从 GitHub 安装。
- Agent 数据读取:Agent 项目读取默认只返回摘要,需显式传入
detail=full参数才能获取完整 JSON。 - 数据安全:导出规范化操作不会改写工作区源资源,需持久化时需使用修复工具或直接导出。
- 脚本执行:格式检查不执行卡内脚本,且不测试第三方扩展的可用性。
- 权限与隔离:连接器通过本地文件直连,不涉及 HTTP 权限问题。工具目录精简功能仅改变工具可见性,不影响权限隔离或沙箱边界。