前言¶

在 DeepSeek Harness（DSH）里做智能体时，常见的问题是：每次会话都要重复说明人设，长期偏好又散落在不同上下文或外部文件里。DSH 的理念是「一切皆插件」，社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系，也不要把它理解为官方应用商店。

下面介绍 dsh-soul-md。先说明它的定位，再看核心功能、安装启用和注意事项。

这是什么¶

dsh-soul-md 是 DeepSeek Harness（DSH）插件，仓库为 Scorp1o117/dsh-soul-md，维护者为 Scorp1o117，许可证为 MIT。

它的一句话定位是：Persona + long-term memory for DeepSeek Harness — zero file management。对用户而言，主要操作是在 Settings → 人设卡 中输入卡片名称和内容并保存，不需要手工维护一组散落的人设文件。

核心功能¶

人设卡¶

• 人设卡内容会被渲染进 system prompt，作为 soul:persona section。
• 支持多张卡片。
• 可以指定默认卡片。
• 可以在 conversation header 的「人设」select 中按 chat 切换。
• soul_read / soul_update 允许 AI 读取并演化自己的人设卡。
• 卡片正文中不要写 {{ / }}，未知变量会导致渲染失败。

长期记忆¶

• 提供 memory_append / memory_read / memory_rewrite 工具，使用持久化 memory file。
• 如果当前 active persona card 存在，则使用该卡片的 memory；否则使用 global memory。
• memory 也会被注入为 soul:memory prompt section，并设置长度上限。
• memory_append / memory_rewrite 拒绝超过 memory.maxBytes，默认值为 1048576。
• 注入 section 的长度由 memory.injectMaxChars 限制，默认值为 8000。

解析顺序¶

每次 prompt assembly 时，人设卡的解析顺序为：

session choice > workspace mapping > default card > none

切换人设从下一轮生效，不需要重启。

工作区方面，Settings → 人设卡 会列出每个 workspace，并提供卡片下拉选择。该 workspace 的 session 默认使用所分配的卡片，session 级切换仍然优先。

安装与启用¶

下面步骤来自已核实的安装与挂载方式。

1、确认运行环境。

Node engine requirement 为：

>=20.18

2、确认 DSH 版本。

dsh-soul-md 0.5.8 and newer 要求 DSH 0.1.0-rc.7 or newer，并且 tested against 0.1.0-rc.7、0.1.0-rc.8、0.1.1-rc.1。

如果当前 DSH 是 0.1.0-rc.6，需要 pin dsh-soul-md@0.5.6，因为它是最后一个带 legacy settings-allowlist compatibility patch 的版本。

3、安装包。

已核实的安装命令为：

pnpm add dsh-soul-md

如果必须 pin 旧版本，则使用：

pnpm add dsh-soul-md@0.5.6

4、挂载到 profile patch。

插件是一个 plain Cordis row。需要挂载到：

$DSH_HOME/profiles/<name>/cordis.patch.yml

加入：

- insert:
    - id: soul-md
      name: 'dsh-soul-md'

5、重启并打开设置页。

dsh web

然后打开：

Settings → 人设卡

输入卡片名称和内容，保存。

典型用法¶

1、创建人设卡。

进入：

Settings → 人设卡

输入卡片名称和内容，例如角色、语气、工作质量要求。保存后，插件会将卡片渲染进 system prompt 的 soul:persona section。

2、按会话切换人设。

在 conversation header 找到「人设」select，为当前 chat 选择卡片。切换从下一轮生效。

3、按工作区指定默认人设。

在：

Settings → 人设卡

页面中会为每个 workspace 提供卡片下拉选择。设置后，该 workspace 的 session 默认使用所分配卡片。

4、让 AI 维护人设与记忆。

AI 可以使用：

soul_read
soul_update
memory_append
memory_read
memory_rewrite

memory_append / memory_rewrite 受 memory.maxBytes 限制。soul_update 用于更新当前可演化的人设卡。

5、从旧版本升级。

如果从 ≤ v0.4 升级，插件会在 first run 时 auto-import 旧 path card 和旧 memory file。

配置与限制¶

插件暴露 soul-md settings namespace，并且不修改 host installation 中的文件。

需要特别注意的配置与限制：

• memory.maxBytes：默认 1048576。memory_append / memory_rewrite 拒绝超过该大小。
• memory.injectMaxChars：默认 8000。限制注入的 soul:memory section 长度。
• 卡片正文中不要出现 {{ / }}。
• 建议把 work-quality rules 写进卡片，例如优先保证任务质量，避免 roleplay 影响实际工作。

适用场景与注意¶

适合这类 DSH 使用场景：

• 希望给不同 chat 使用不同人设，而不是每次手动粘贴角色说明。
• 希望 AI 在多个 session 中保留长期记忆。
• 希望按 workspace 设置默认人设，同时允许 session 级覆盖。
• 希望 AI 通过 soul_read / soul_update 读取并演化自己的人设卡。
• 希望把卡片内容直接渲染进 soul:persona prompt section。

注意：

• 插件会以当前 dsh 进程权限运行。安装前应检查源码、MIT 许可证、依赖和版本要求。
• dsh-soul-md 0.5.8 and newer 要求 DSH 0.1.0-rc.7 or newer。
• DSH 0.1.0-rc.6 用户必须 pin dsh-soul-md@0.5.6。
• 社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系，也不是官方应用商店。

结尾¶

dsh-soul-md 的价值在于把“人设卡”和“长期记忆”放进 DSH 的设置页流程中：创建卡片、选择默认值、按会话或 workspace 切换，同时保留 memory 注入与大小限制。

插件线索给出的目录页为：

https://www.skillhub.cn/plugins/Scorp1o117/dsh-soul-md

GitHub 仓库为：

https://github.com/Scorp1o117/dsh-soul-md