本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-LorebookMD

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add dsh-lorebookmd

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• 导入：角色卡（PNG 内嵌 / JSON）与独立世界书（{ entries: [...] }），兼容 extensions.world、SillyTavern character_book（角色书）与常见导出变体
• 落地本地：每本世界书生成三件产物——
• • 名·世界书 预设：设定全文 + 关键词自动触发（对话中按触发词注入对应条目）
• • 名·创作 预设：创作模式（创作指令 + 设定全文，激活后输入场景即生成小说正文）
• • worldbooks/<名>.md：本地 Markdown 设定文档，可手工编辑

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装后在 DSH 的哪里使用？

Web 端打开设置 →「世界书创作」分区即可。客户端声明 dsh.client.platform=web，所以 CLI / TUI / 桌面客户端看不到这个分区，只能通过对话工具间接调用。

「进入创作」和「世界书模式」怎么选？

想写小说就激活「·创作」预设，模型会第三人称连贯输出正文；想互动扮演就激活「·世界书」预设，提到触发词时把对应设定条目临时注入本轮。两种模式随时可切换，停用回到正常对话。

导入酒馆角色卡 PNG 时会生成什么？

一个角色卡预设（描述/性格/场景/示例对话/系统提示 拼成），一个「·世界书」预设（关键词触发用），一个「·创作」预设（创作指令 + 设定全文），以及一份本地 Markdown 文档 worldbooks/<名>.md；卡内正则脚本会另存为「·正则」预设。

数据存在哪里？可以手工编辑吗？

三处都在 ~/.dsh/dsh-LorebookMD/ 下：presets.json（预设正文）、worldbooks.json（条目原始数据，关键词匹配用）、worldbooks/<名>.md（可手工编辑的 Markdown 文档）。改 presets.json 时插件会自动热加载。

数据文件写坏了怎么办？

插件启动时如果 JSON 解析失败，会把损坏文件改名成 *.broken-<时间戳> 备份，并以空库启动，不会让后续保存覆盖你的原始数据。建议备份前先看一眼损坏内容。

正则脚本会真的执行吗？

不会。DSH 没有聊天正则渲染管线，导入后的正则脚本只是「·正则」预设里的文字定义，供查看参考；如果需要做等价替换，需要自己按定义里的 pattern 手动处理。

「编辑文档」按钮打不开本地 .md 怎么办？

插件会用系统默认程序打开文件（Windows: start / macOS: open / Linux: xdg-open）。如果系统没有关联 .md 程序或权限受限，spawn 会失败但 API 不会报错——手动用任何编辑器打开 ~/.dsh/dsh-LorebookMD/worldbooks/<名>.md 即可。

需要额外的 API Key 或联网吗？

不需要。预设、设定文档、世界书条目都存在你本地磁盘，只有导入工具读你指定的本地文件，模型生成小说靠 DSH 当前的会话模型。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 未声明（package.json 无 peerDependencies；运行时由 DSH profile 解析 @deepseek-ai/* 包）
• Node: >=22.18（package.json#engines.node）
• Platforms: macOS, Windows, Linux

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则