AgentSoul for DeepSeek Harness

AgentSoul 是 DeepSeek Harness 的本地人格、身份、状态与长期记忆层插件。

核心设计理念：SOUL / IDENTITY / USER / STATE 四层人格文件、本地记忆、人格保护、 历史不是指令、故障隔离、Token 控制，全部基于 DeepSeek Harness 的 Cordis 插件机制实现：

AgentSoul 概念	DeepSeek Harness 实现
人格注入（SOUL / IDENTITY / USER）	ctx.systemPrompt.section() 稳定前缀（order -50，mtime 缓存）
当前状态（STATE.md）	独立 system prompt section（order -40）
近期记忆	ctx.systemPrompt.context() 运行时上下文快照（自动取代、不累积）
记忆蒸馏	阈值触发的 ctx.llm 辅助调用，提取 persona / episodic / instruction 三型记忆
会话消息捕获	session/event 监听（只记录用户文本与助手最终文本）
管理工具	ctx.tools.register() 注册 6 个模型可见工具
自动全局加载	bundle patch（dsh.bundle.patch）+ profile bundles，每次启动自动应用

---

安装（自动全局加载）

插件以 bundle 形式安装进 profile。Bundle 会写入 profile 的 dsh.profile.bundles 列表，因此之后每次启动 DeepSeek Harness 时 AgentSoul 都会自动、全局加载，无需任何启动参数：

dsh plugin --profile web add file:D:/C#/agentsoul-dsh
dsh plugin --profile headless add file:D:/C#/agentsoul-dsh   # 其他 profile 同理

重启 Harness 后即可验证：

dsh web --dump-config          # 应看到 id: agentsoul 的插件行

卸载：

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

卸载不会删除人格文件与记忆数据。

数据目录

默认：$DSH_HOME/agentsoul（本机为 C:\Users\\.dsh\agentsoul）

agentsoul/
├── SOUL.md          # 核心人格：如何判断（稳定，注入）
├── IDENTITY.md      # 身份：我是谁（稳定，注入）
├── USER.md          # 用户长期信息（稳定，注入）
├── STATE.md         # 当前任务与跨会话状态（注入）
├── TUNING.md        # 人格调教手册（不注入）
├── CHANGELOG.md     # 人格变更历史（不注入）
└── memory/
    ├── memory.db    # SQLite 近期记忆
    └── fallback.json# SQLite 不可用时的 JSON 降级