前言¶

在 DeepSeek Harness 的插件化擴展中，Agent 經常需要穩定的角色、用戶偏好和跨會話記憶，而不是每次都依賴單次上下文。AgentSoul 面向這類需求，提供本地人格、身份、狀態與長期記憶層。它以 bundle 插件形式安裝到 profile，每次啓動自動全局加載。

這是什麼¶

AgentSoul 是 DeepSeek Harness 的本地人格、身份、狀態與長期記憶層插件，倉庫標識爲 yuhui-sama/dsh-agentsoul，許可證爲 MIT，要求 Node.js >=22.5.0。它適合需要讓 Harness Agent 在本地保留角色設定、用戶長期信息和可檢索記憶的開發者。

核心能力¶

人格文件¶

支持 SOUL / IDENTITY / USER / STATE 四層人格文件。人格變更有保護：插件不會自動改寫 SOUL / IDENTITY / USER / STATE。

記憶與蒸餾¶

提供本地長期記憶與記憶蒸餾。記憶後端可使用 SQLite；SQLite 不可用時自動降級爲 JSON 存儲。

加載與異常隔離¶

以 bundle 形式安裝後，每次啓動自動全局加載。插件異常不會阻斷 Harness Agent Loop。

安裝與啓用¶

1、先確認本機環境滿足運行要求：

Node.js >=22.5.0

2、以 web profile 爲例安裝本地插件目錄：

dsh plugin --profile web add file:D:/C#/agentsoul-dsh

3、重啓 Harness 後檢查插件加載：

dsh web --dump-config

如需卸載：

dsh plugin --profile web remove @agentsoul/dsh-agentsoul

卸載不會刪除人格文件與記憶數據。

配置示例¶

在 profile 的 cordis.patch.yml 中，可配置 enabled、memory.backend、distill.threshold 等項。示例：

- id: agentsoul
  config:
    enabled: true
    memory:
      backend: sqlite
    distill:
      threshold: 10

其中 memory.backend 用於配置記憶後端，distill.threshold 用於配置蒸餾相關閾值。

管理工具¶

插件註冊 6 個模型可見管理工具。例如可使用：

• agentsoul_status
• agentsoul_memory_search
• agentsoul_memory_distill

這些工具用於查看插件狀態、搜索記憶和手動觸發蒸餾。

適用場景與注意¶

適合：

• 在 DSH 中維護穩定人格、身份和狀態；
• 需要本地長期記憶和記憶蒸餾；
• 需要 SQLite 與 JSON 降級存儲；
• 需要模型可見的管理工具進行狀態檢查和記憶維護。

安裝前注意：

1、插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。
2、許可證爲 MIT，運行環境要求 Node.js >=22.5.0。
3、請勿把 API Key、密碼等敏感信息寫入人格文件。
4、插件默認不接觸 API Key；主模型失敗時可回退 Harness 默認 LLM。
5、如使用可選蒸餾直連，需在本機 profile 的 cordis.patch.yml 配置 apiKey、baseURL、model，且這些敏感配置不能提交到插件倉庫。

鏈接¶

GitHub：https://github.com/yuhui-sama/dsh-agentsoul