🎉 AgentSoul for DeepSeek Harness
DeepSeek Harness 的本地人格、身份、状态与长期记忆层插件。让 Agent 跨会话、跨上下文压缩之后，仍然保持稳定身份、记得用户的长期偏好、延续未完成的任务。
✨ 功能特性
四层人格文件：SOUL（如何判断）/ IDENTITY（我是谁）/ USER（用户长期信息）/ STATE（当前状态），本地 Markdown，可读可改可迁移
人格注入：SOUL/IDENTITY/USER 走 system prompt 稳定前缀（字节级恒定，命中 prefix cache）；STATE 与记忆走运行时上下文快照（自动取代、不累积）
记忆捕获：只记录用户文本与助手最终文本，跳过插件/工具消息，按消息 ID 去重
记忆蒸馏：未蒸馏消息积累到阈值后，后台一次模型调用提炼成 persona / episodic / instruction 三型记忆（带优先级），支持 new / skip / update 去重；单飞互斥 + 失败冷却防烧钱
蒸馏模型路由：默认走 Harness ctx.llm（零密钥接触）；可选配 GLM 免费 flash 直连，失败自动回退 DeepSeek flash
管理工具：agentsoul_status / agentsoul_memory_list / agentsoul_memory_search / agentsoul_memory_distill / agentsoul_memory_clear / agentsoul_personality_reload
自动全局加载：bundle 机制，安装后每次启动 Harness 自动加载，无需任何启动参数
故障隔离：人格文件缺失/损坏跳过、SQLite 降级 JSON、插件异常不阻断 Agent Loop
🧠 架构亮点
核心与适配层解耦：personality / memory / context / distill 不依赖 Harness API，宿主适配集中在一个文件，Harness 生命周期变化时只需改适配层
缓存友好：稳定前缀恒定、动态快照在请求尾部，STATE 编辑和蒸馏更新不会击穿 prefix cache
安全边界：蒸馏只写蒸馏层，绝不自动改写人格文件；历史记录始终标注为不可信参考数据
🚀 安装
text
dsh plugin --profile web add https://github.com/yuhui-sama/dsh-agentsoul
或本地目录安装：dsh plugin --profile web add file:<路径>。安装后重启 Harness 即自动全局加载。
✅ 质量
35 项单元测试（GitHub Actions CI 自动运行）
支持 Node 22.5+
📄 许可
MIT License
🙏 致谢
记忆蒸馏的分层记忆与提炼设计参考 TencentCloud/TencentDB-Agent-Memory（MIT）。