deepseekplugins

DeepSeek Harness plugin

dsh-soul-md

DeepSeek Harness 的 soul.md 风格人设卡插件：把 markdown 人设文件注入系统提示词（soul:persona），文件变更热重载，让 Agent 边干活边角色扮演；附 Web UI 设置栏。

Workflow & Automation
Jump to install

Source facts

Repository
Scorp1o117/dsh-soul-md
Latest update
Aug 21, 2026
Category
Workflow & Automation
GitHub stars
3
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/Scorp1o117/dsh-soul-md
Plugin: dsh-soul-md
Author: Scorp1o117

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

dsh-soul-md

![中文文档](README.zh.md)

GitHub: Scorp1o117/dsh-soul-md · npm: dsh-soul-md

![Enhancement Suite](https://github.com/Scorp1o117/dsh-enhancement-suite) ![npm](https://www.npmjs.com/package/dsh-enhancement-suite)

Part of the DeepSeek Harness Enhancement Suite — Vision · Soul/Persona · Long-term Memory · Plugin Marketplace.

Persona + long-term memory for DeepSeek Harness — zero file management:

> In Settings → 人设卡, type a card name and its content, hit save. The plugin manages everything else.

What you get

  • Persona cards — the card content is rendered into the system prompt as

the soul:persona section. Multiple cards are supported; pick a default, and switch per chat from the conversation header (a "人设" select).

  • Long-term memory — the agent gets five tools:

- memory_append / memory_read / memory_rewrite — a persistent memory file (Agent.md / memory.md style). The active persona card has its own memory; otherwise the global memory is used. - soul_read / soul_update — the AI reads and evolves its own persona card: when it notices a stable trait, preference, or value of its own, it folds it into the card. It "grows" across sessions instead of resetting every time. - The memory is also injected as a soul:memory prompt section (capped) so the agent always sees its memories.

  • Resolution per prompt assembly: session choice (chat switcher) > workspace mapping > default card > none. Switching applies from the next turn — no restart.
  • Workspace personas (v0.5.2): Settings → 人设卡 lists every workspace with a card dropdown — sessions of that workspace use the assigned card by default (session-level switching still wins). Workspaces come from dsh's durable workspace registry, so no paths to type.

Install

The plugin is a plain Cordis row. Mount it in a profile patch ($DSH_HOME/profiles/<name>/cordis.patch.yml):

- insert:
    - id: soul-md
      name: 'dsh-soul-md'          # after: pnpm add dsh-soul-md in the profile

Then restart dsh web and open Settings → 人设卡: type a name + content, save.

Where things live (you don't need to care, but for reference)

  • Persona cards: stored in the soul-md settings namespace (settings.yaml),

as cards: { name -> markdown } + active + per-session sessions.

  • Memory files: plugin-managed under $DSH_HOME/soul-md/memory/

(global.md + one file per card), created on demand.

  • Upgrading from ≤ v0.4 (file-based)? The plugin auto-imports the old

path card (as "默认") and the old memory file on first run.

Config

FieldDefaultMeaning
cards{}Persona cards: name → markdown content (managed from the UI).
active''Default card name; empty disables the persona by default.
sessions{}Per-session choice (sessionId → card name / none / ''); written by the chat switcher.
workspaces{}Per-workspace choice (workspace path → card name / none / ''); written from the settings page.
workspaceList[]Read-only workspace list (path + title), maintained by the host from dsh's workspace registry.
memory.maxBytes1048576memory_append / memory_rewrite refuse to exceed this size.
memory.injecttrueRender the memory as the soul:memory prompt section.
memory.injectMaxChars8000Cap for the injected section (from the file head).
memory.order0.5Prompt section order for the injected memory section.
legacy fields—path, fallback, order, complete, watch, debounceMs, soulMaxBytes, personas, roster, memory.path… kept so old composition entries and settings still validate; only used for the one-time import.

Notes

  • Never write {{ / }} in a card body — they are prompt-variable

syntax; unknown variables fail rendering (no escape syntax yet).

  • Persona/memory sections resolve per assembly, so steady cards stay

byte-identical (KV-cache friendly) and edits hot-apply.

  • DSH exposes the registered soul-md settings namespace directly; the plugin

does not modify files in the host installation.

  • Suggest putting work-quality rules in the card (e.g. "task quality first")

so roleplay never degrades real work.

  • Version 0.5.8 and newer require DSH 0.1.0-rc.7 or newer and are tested

against 0.1.0-rc.7, 0.1.0-rc.8, and 0.1.1-rc.1.

  • DSH 0.1.0-rc.6 users must pin dsh-soul-md@0.5.6, the last release

carrying the legacy settings-allowlist compatibility patch.

License

MIT

Back to searchOpen GitHub repository

More related plugins

View category