609476965/dsh-LorebookMD
60Last commit Aug 14, 2026
dsh-LorebookMD DSH plugin
This plugin for DeepSeek Harness (DSH) imports character cards and worldbooks from SillyTavern/TavernAI, converting them into local Markdown setting documents. It provides two modes: creative writing (generates novel text) and worldbook roleplay (interactive character responses). Settings are managed through a dedicated page and dialog tools.
How to install the dsh-LorebookMD DSH plugin
dsh plugin --profile web add dsh-lorebookmdCopying does not run this command. Review the repository and version before installing the dsh-LorebookMD DSH plugin.
dsh-LorebookMD DSH plugin data source
dsh-LorebookMD DSH plugin snapshot date: Aug 16, 2026
discovered
What the dsh-LorebookMD DSH plugin can do
- Import character cards (PNG embedded / JSON) and independent worldbooks (`{ entries: [...] }`), compatible with `extensions.world`, SillyTavern `character_book`, and common export variants.
- Generate three outputs per worldbook: a 'worldbook' preset with keyword-triggered entry injection, a 'creation' preset for story generation, and a local Markdown document at `worldbooks/<name>.md` that can be manually edited.
- Provide a settings page (Settings → Worldbook Creation) for listing worldbooks, entering creation mode, toggling worldbook mode, editing documents, importing, and deleting.
- Offer dialog tools `prompt_import_tavern` / `prompt_import_world` that share the same data with the settings page.
- Support two modes: 'Creation Mode' outputs novel narrative based on user input, while 'Worldbook Mode' uses keyword-triggered entries for immersive roleplay.
Where the dsh-LorebookMD DSH plugin fits
- Write a novel scene or plot by providing a scenario, letting the model generate coherent third-person narrative with setting details.
- Engage in immersive roleplay where you interact as a first-person character, and the model responds as the world's character, automatically injecting relevant worldbook entries when keywords are mentioned.
- Describe a process or character action in detail, leveraging the full worldbook context for consistency.
Who the dsh-LorebookMD DSH plugin is for
- Novelists and creative writers who want to use DSH with structured worldbuilding settings.
- Roleplay enthusiasts who enjoy character-driven interactions with automatic worldbook integration.
- DSH users who already have SillyTavern/TavernAI character cards and wish to repurpose them in a local Markdown-based workflow.
dsh-LorebookMD DSH plugin limitations
- The plugin only manages user-provided setting texts; it does not include any 'jailbreak' or 'prompt injection' content.
- Requires a DSH environment (profile) and either a local installation via `dsh plugin` or manual setup; the published package includes built artifacts, so no local build environment is needed for installation.
- Data is stored locally in `~/.dsh/dsh-LorebookMD/`; no cloud sync or remote access is provided.
- Currently only supports importing from SillyTavern/TavernAI formats; other worldbook sources are not mentioned.
dsh-LorebookMD DSH plugin: from the repository README
Quoted from the 609476965/dsh-LorebookMD README, the upstream source of the dsh-LorebookMD DSH plugin. Copyright remains with the original authors.
一个面向 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（DSH）的插件：导入酒馆（SillyTavern/TavernAI）角色卡与世界书，落地为**本地 Markdown 设定文档**，激活创作模式后**根据用户输入、参考世界书创作小说**。 > 说明：本插件只管理你自己提供的设定文本；工程内不内置任何"破限/越狱"提示词内容。 ## 功能 - **导入**：角色卡（PNG 内嵌 / JSON）与独立世界书（`{ entries: [...] }`），兼容 `extensions.world`、SillyTavern `character_book`（角色书）与常见导出变体 - **落地本地**：每本世界书生成三件产物—— - `名·世界书` 预设：设定全文 + **关键词自动触发**（对话中按触发词注入对应条目） - `名·创作` 预设：**创作模式**（创作指令 + 设定全文，激活后输入场景即生成小说正文） - `worldbooks/<名>.md`：本地 Markdown 设定文档，可手工编辑 - **设置页**（设置 →「世界书创作」）：世界书列表 / 进入创作 / 世界书模式 / **编辑文档**（系统默认程序打开本地 .md）/ 导入 / 删除 - **对话工具**：`prompt_import_tavern` / `prompt_import_world` 等与设置页共享同一份数据 ### 两种模式怎么用 | | 进入创作（激活「·创作」） | 世界书模式（激活「·世界书」） | | --- | --- | --- | | **输出形态** | **小说正文**：第三人称连贯叙述，细节符合设定风格，直接输出正文、不复述设定 | **对话/角色扮演回应**：以世界内角色身份与你互动、推进剧情 | | **设定使用** | 全文注入，模型自觉参考 | 全文注入 + **关键词自动触发**：提到触发词时对应条目当场注入 | | **交互方式** | 你给场景/情节/人物，模型创作；继续给 → 续写 | 你以第一人称参与，模型以角色回应 | | **典型指令** | "写一段……"、"描写……的过程" | "我是……，然后呢？"、"把名单给我看看" | | **适合** | 写小说、场景描写、剧情创作 | 沉浸式角色扮演、互动推演 | 想"写小说"用「进入创作」，想"扮演/对话"用「世界书模式」；两者可随时切换，停用后回到正常会话。 ## 安装 ### 跟 DSH 说 ```text 帮我安装这个插件https://github.com/609476965/dsh-LorebookMD ``` ### 从 npm 安装（推荐）
Read the full READMEThe repository declares no license. Check with the authors before using it.
dsh-LorebookMD DSH plugin questions
How do I install dsh-LorebookMD?
The recommended way is to run `dsh plugin --profile web add dsh-lorebookmd` in your terminal. This command automatically adds the plugin to your DSH profile's bundles and applies the cordis.patch.yml configuration. You can also manually run the install.cmd script or double-click start-dsh-plugin.cmd for temporary mounting. After installation, restart DSH and open http://127.0.0.1:3080, then go to Settings → Worldbook Creation to use the plugin.
How do I import a character card or worldbook?
Use the settings page at Settings → Worldbook Creation. Click the 'Import' button and select your character card (PNG with embedded JSON or standalone JSON) or worldbook file (JSON with `{ entries: [...] }`). The plugin will automatically generate the three outputs: a worldbook preset, a creation preset, and a local Markdown file. You can also use the dialog tools `prompt_import_tavern` or `prompt_import_world` in the chat to import data.
What's the difference between 'Creation Mode' and 'Worldbook Mode'?
Creation Mode is designed for writing novels: the model outputs third-person narrative text directly, without repeating the setting. Worldbook Mode is for roleplay: the model responds as a character within the world, and when you mention keywords, the corresponding worldbook entries are automatically injected into the context. You can switch between them at any time via the settings page or disable both to return to normal conversation.
Where are the generated files stored?
Presets (creation and worldbook presets) are saved in `~/.dsh/dsh-LorebookMD/presets.json`. Worldbook entry data for keyword triggering is stored in `~/.dsh/dsh-LorebookMD/worldbooks.json`. The editable local Markdown documents are located in `~/.dsh/dsh-LorebookMD/worldbooks/<name>.md`. You can edit the Markdown files with any text editor, and the changes will be reflected in the presets after restarting DSH.
How do I update the plugin?
To update, simply install the new version of the npm package. Run `dsh plugin --profile web add dsh-lorebookmd` again (or use the manual install method with the updated .tgz file). Then restart DSH. The plugin's data in `~/.dsh/dsh-LorebookMD/` is preserved across updates, so your imported worldbooks and settings will remain.