yuhui-sama/dsh-agentsoul

深度探索工具集的本地人格、记忆与蒸馏层——包含SOUL/IDENTITY/USER/STATE角色文件、跨会话记忆与LLM蒸馏功能,启动时自动加载。

Project Overview项目介绍

AgentSoul is a local persona and long-term memory plugin for DeepSeek Harness. It injects four layered files (SOUL/IDENTITY/USER/STATE) as stable prefixes, appends runtime snapshots, and triggers threshold-based memory distillation (persona/episodic/instruction). Six management tools are registered, with auto global loading via bundle patch. Use it for AI agents requiring cross-session persona continuity and persistent memory. Caveat: never store API keys in persona files; distillation defaults to Harness LLM with independent fallback.

AgentSoul 是 DeepSeek Harness 的本地人格与长期记忆插件。它通过 SOUL/IDENTITY/USER/STATE 四层文件注入稳定前缀、运行时快照和阈值触发的记忆蒸馏(persona/episodic/instruction),并注册 6 个管理工具实现自动全局加载。适合需要跨会话人格延续和长期记忆的 AI 代理场景。注意:人格文件不应写入 API Key 等敏感信息,蒸馏默认走 Harness LLM,独立回退可选。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 3 stars - very few users, little community feedback星标只有 3,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:yuhui-sama/dsh-agentsoul

把 yuhui-sama/dsh-agentsoul 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

AgentSoul for DeepSeek Harness

CI License Stars Node

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 降级

首次启动自动创建缺失文件(只创建,绝不覆盖已有内容,模板为中性示例)。同时兼容 soul/ 子目录布局。

示例人格文件

仓库提供一份完整、可直接复制使用的示例人格包:examples/personality/(SOUL / IDENTITY / USER / STATE 四份 + 使用说明)。复制到数据目录改改名字就能用。

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev adb_dsh_plugin 下一个 Next dsh-mobile →