前言¶

在 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