前言¶

在 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