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,独立回退可选。
请帮我安装这个 DSH 插件。安装前先完成【兼容性检查 + 安全性检查】,检查通过再动手。
插件:dsh-agentsoul(yuhui-sama/dsh-agentsoul)
仓库:https://github.com/yuhui-sama/dsh-agentsoul
本站详情页:https://www.yhbd.top/plugins/yuhui-sama-dsh-agentsoul/
本站登记:类型 plugin · 归类 原生 DSH 插件 · 许可证 MIT · ⭐ 3 · 最近提交 2026-08-15 · 主语言 JavaScript
按下面顺序执行,每步先把结论告诉我,再进入下一步:
【1 兼容性检查】
① 我这边:DSH 版本、Node 版本、操作系统、当前 profile(web / desktop)。
② 读它的 README、package.json、插件 manifest,列出它要求的 DSH 版本 / Node 版本 / 操作系统 / 外部依赖 / 需要另外先装的运行时。
③ 逐条比对,结论只写「满足 / 不满足 / 未知」三种;不满足的给出可行替代方案。
④ 检查是否和我已装的插件冲突:命令名重复、skill / tool 重名、端口占用、重复注册的 MCP server。
【2 安全性检查】
① 仓库可信度:和上面「本站登记」是否一致;star / fork 数、创建时间、最近提交,是否归档或长期停更。
② 安装脚本:逐行看 package.json 的 preinstall / install / postinstall,以及 install.sh、setup.ps1 之类脚本。出现 curl|bash、下载后直接执行、混淆代码、访问与插件功能无关的域名,立刻停下来告诉我,不要继续装。
③ 依赖:列出新增依赖,标出无人维护、或与知名包拼写近似的可疑包(typosquatting)。
④ 权限与副作用:它会读写哪些目录、访问哪些域名、需要哪些 DSH 权限(filesystem / network / shell / clipboard 等),以及怎么卸载和回滚。
⑤ 如果它要求 sudo / 管理员权限,或权限明显超出功能所需,先停下来问我。
【3 安装】
上面两步没有「不满足」和「高危项」时才执行;用官方推荐方式安装,不要自行提权。
【4 汇报】
用表格输出:检查项 / 结论 / 依据 / 是否需要我决策。拿不准的一律写「未知」并说明要我怎么确认——不要猜,也不要替我决定。
Send this message to DSH in your current session: it verifies compatibility and security first (answering met / not met / unknown item by item) and only installs once everything checks out — it will stop and ask you if it finds a high-risk item. The box scrolls; the copy is the full prompt. CLI install commands may not be accurate across systems, so DSH is the safer route.把上面这条消息直接发给当前会话里的 DSH:它会先核对兼容性与安全性(逐条给「满足 / 不满足 / 未知」),确认没问题再安装,有高危项会停下来问你。框内可滚动,复制到的是完整提示词;安装命令不一定准确,发给 DSH 更稳。
- 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
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 →
Aik358/dsh-auto-memory
QIANLING-0831/dsh-memory-plus
knqiufan/powercontext-dsh
paulalesius/dsh-hindsight-advanced
Spirtxiaoqi7/mindspace-dsh-session-memory