dsh-soul-md

插件跟随 DSH 的语言设置（DSH 0.2.0-rc.2 内置中文和 English），配置页面、状态提示和插件列表名称/简介同步切换。扩展语言使用宿主的回退链。切换语言保留未保存的设置，无需单独选择插件语言。

v0.9.1：常驻记忆别名与索引上限

• 三个 memory_* 工具均把 topic: "core" / "core.md"（忽略大小写和前后空白）视为省略 topic，读写常驻 core；其它主题不受影响。
• 主题索引标题最多 80 字符，摘要最多 240 字符；主题 key 保持独立，全文不变。
• 已存在的 topics/core.md 不会自动移动或合并。请先备份，通过文件读取核对内容，再将需要常驻的条目合并到 core.md，其余内容移到其它主题 key；新的 memory_read({ topic: "core" }) 会读取常驻 core。

关键词检索与可选召回

开启分层记忆后，可用 memory_search({ query: "Electron 打包", limit: 5 }) 检索主题 key、标题、摘要和全文，只返回 key 与摘要，再用 memory_read(topic) 核对全文。 同名主题优先使用当前人设卡的版本；卡内缺失的主题可回退到全局，和按 topic 读取的顺序一致。 英文忽略大小写，中文还会使用相邻两个字的词组匹配。这是关键词检索，不能保证召回没有共同 字面内容的同义表达；无结果时请换词重试。工具不依赖自动召回开关。

配置页新增独立选项，自动召回和压缩补偿均默认关闭：

• memory.recall: "keyword"：从当前插件运行期间处理的第二条用户消息开始， 通过 soul:recall 提示可能相关的主题 key 与摘要；首条消息、内部上下文和压缩摘要不触发。
• memory.indexMode: "recall"：开启关键词召回时，把全量注入索引改成固定的检索提示， 减少主题数量增长带来的每轮开销。索引生成、标题/摘要截断、原有截断规则以及 memory_read() 返回的完整索引保持原有行为。
• memory.compactionRecall: true：成功压缩或裁剪后的下一条用户消息，重新提示本会话 通过工具读过、追加过或重写过的主题 key 与摘要。该用户回合内保持稳定，下一个用户回合清除； 压缩失败不触发。最多追踪最近 128 个主题 key，仅保存在内存中，插件卸载或重启后重置。

两种补充都不注入主题全文，共用 recallMaxChars（默认 1600，最多 8000）以及 原有记忆段落用完后剩余的 injectMaxChars 预算；core/索引占满预算时不会额外添加行。 每组最多 recallMaxTopics 条（默认 5，最多 20）。动态摘要始终保留字面花括号， 不受 allowTemplates 开关影响；memory.inject: false 和 skipSubagents 也会禁止召回段落。

可在 soul-md 行使用以下配置，或从插件详情页开启：

memory:
  layered: true
  recall: keyword
  indexMode: recall
  compactionRecall: true
  recallMaxTopics: 5
  recallMaxChars: 1600
  injectMaxChars: 24000

配置入口（DSH 0.2.0-rc.2 起）

在首页侧边栏打开 插件 → 已安装 → dsh-soul-md，直接在插件详情页配置并保存。配置页注册到官方的 plugins.bundle.config 接口；全局设置页不再重复显示配置入口。Web 与桌面版使用相同界面，本版要求 DSH 0.2.0-rc.2 或更新的 0.2.x 版本。现有配置无需迁移。

GitHub: Scorp1o117/dsh-soul-md · npm: dsh-soul-md · English

属于 DeepSeek Harness Enhancement Suite —— Vision · Soul/Persona · 长期记忆 · 插件市场。

DeepSeek Harness 的人设 + 长期记忆插件——完全不用管文件：

在 插件 → dsh-soul-md 里输入人设卡的名称和内容，点保存，剩下的插件全包了。

功能

• 人设卡：卡片内容渲染成系统提示词段落（soul:persona）。支持多张卡：设置一张默认卡，聊天框标题栏的「人设」下拉可以给每个会话单独选卡
• 长期记忆：Agent 自带五个工具——
  • memory_append / memory_read / memory_rewrite：持久记忆文件（Agent.md / memory.md 风格）。当前人设卡有自己的记忆，没选卡时用全局记忆；分层模式下可用可选的 topic 参数按主题读写
  • memory_search：检索分层主题正文，返回 key 和摘要，按需再读取全文
  • soul_read / soul_update：AI 自己读、自己演化人设卡——发现自己的稳定特质就折叠进卡片，跨会话持续成长而不是每次重置
  • 记忆会以 soul:memory 段落注入提示词（有上限），AI 随时看得见自己的记忆
• 解析规则：会话选择（聊天框切换）> 工作区人设 > 默认卡 > 无，切换下一轮对话即生效，无需重启
• 工作区人设（v0.5.2）：插件 → dsh-soul-md 里会列出所有工作区，每个工作区可以指定一张人设卡——该工作区的会话默认用它（会话级切换仍然优先）。工作区列表来自 dsh 的工作区注册表，不用输任何路径

桌面端安装

在桌面端的“插件”页面安装，或使用桌面端“应用 → 管理 dsh 命令”注册的命令：

dsh plugin --profile desktop add dsh-soul-md

重启桌面端以加载客户端插件。配置位于 $DSH_HOME/profiles/desktop。

安装

若 Hub 报错 Cannot find module '...app.asar/dsh/node_modules/@deepseek-ai/dsh-desktop-host/lib/cli.js'， 说明桌面宿主的 CLI 引导失败，尚未加载本插件。请重新安装完整的官方桌面发行包， 或尝试官方「插件」页面（绕开 Hub）；把命令改成 Web profile 无法修复桌面应用包。 详见 issue #14。

在 profile 的 cordis.patch.yml（如 $DSH_HOME/profiles/web/cordis.patch.yml）里 insert：

- insert:
    - id: soul-md
      name: 'dsh-soul-md'          # 之前先 pnpm add dsh-soul-md

重启 dsh web，打开 插件 → dsh-soul-md：输入名称 + 内容，保存，完事。

文件在哪（你不用管，仅供参考）

• 人设卡：存在当前 Profile patch 的 soul-md 配置里，即 cards: { 名称 -> 内容 } + active 默认卡 + 会话级 sessions
• 记忆文件：插件托管在 $DSH_HOME/soul-md/memory/（global.md + 每张卡一个文件），按需自动创建
• 可选分层记忆（默认关闭）：memory/<卡名>/core.md 在注入上限内参与注入，memory/<卡名>/topics/*.md 只把标题和首个正文行注入为索引；memory_read({ topic: "..." }) 按需取回主题全文。开启后若尚未建立目录结构，会继续读取旧的 <卡名>.md，首次追加 core 时也会保留旧内容
• 从 ≤ v0.4 的文件版升级？插件首次运行会自动导入旧 path 卡片（名为「默认」）和旧记忆文件

配置

字段	默认值	含义
cards	{}	人设卡：名称 → Markdown 内容（界面管理）
active	''	默认卡名称；空 = 默认不启用
sessions	{}	会话级选择（sessionId → 卡名 / none / ''），聊天框切换器写入
workspaces	{}	工作区级选择（工作区路径 → 卡名 / none / ''），设置页写入
workspaceList	[]	工作区列表（路径 + 标题），由服务端从 dsh 工作区注册表维护
memory.maxBytes	1048576	memory_append / memory_rewrite 超过此大小会拒绝
memory.inject	true	把记忆渲染为 soul:memory 提示词段落
memory.layered	false	启用渐进式分层记忆：core + topics 索引
memory.recall	off	off / keyword；从第二条用户消息起自动召回主题
memory.indexMode	all	all / recall；后者只在关键词召回启用时省略全量注入索引
memory.compactionRecall	false	成功压缩或裁剪后的下一用户回合补偿已查阅主题的 key 和摘要
memory.recallMaxTopics	5	每组召回/补偿的主题上限，最多 20
memory.recallMaxChars	1600	召回与补偿合计字符上限，最多 8000，同时受剩余注入预算约束
memory.injectMaxChars	8000	注入记忆内容的字符上限；单文件模式保留开头与最新尾部，分层模式先保留主题索引，再保留 core 首尾。memory_read 超过 20000 字符时也保留首尾。
memory.order	0.5	注入的记忆段落顺序
allowTemplates	false	默认将人设卡和记忆中的 {{…}} 原样注入；开启后由宿主解析提示词变量，未知变量会使渲染失败
skipSubagents	false	子代理会话（DSH 标记为 origin: "subagent"）不注入 soul:persona / soul:memory 两段提示词；工具作用域不变
legacy 字段	—	path、fallback、order、complete、watch、debounceMs、soulMaxBytes、personas、roster、memory.path… 保留以兼容旧配置，仅用于一次性导入

skipSubagents 默认关闭，保持 v0.7.0 的现有行为。开启后，DSH 以 origin: "subagent" 创建的委派子会话不再收到人设卡与记忆段落—— 子代理通常只做一件小事，不必每轮都背着主会话的完整人设与长期记忆。

它只作用于提示词注入：cardNameOf、memoryTarget 与三个 memory_* 工具的作用域完全不变，子代理的读写目标与未开启时一致， 不会因为跳过注入而落到 global.md。

兼容性：已验证 @deepseek-ai/[email protected] 与 0.1.7-rc.2（npm next）；npm latest 是 0.1.5-rc.3。新版使用 Profile patch 与客户端 configForms。旧宿主请使用插件旧版；alpha 构建仍标记 unknown。

v0.8.1：人设切换与分层记忆截断修复

• 会话人设写入被拒时显示错误并回滚到宿主快照；写入期间锁定下拉，避免重叠修改。
• 分层记忆超限时优先保留主题索引，core 保留首尾，并在提示词中写明省略内容。
• 已通过 DSH 0.1.5-rc.3 一次性 Profile 的安装、Web 启动、首页与客户端 Bundle HTTP 检查，以及卸载验证。

v0.8.0：子代理提示词控制与 DSH next 兼容

• 新增默认关闭的 skipSubagents：开启后，DSH 标记为 origin: "subagent" 的委派子会话不再注入 soul:persona / soul:memory 两段提示词。
• 只作用于渲染路径；cardNameOf、memoryTarget 与 memory_* 工具的作用域不变。
• 设置页「长期记忆」分组提供开关，与 memory.inject / memory.layered 共用保存按钮。
• 记录 DSH 0.1.5-rc.3（next）兼容性；未验证的 alpha 版本继续标记 unknown。

v0.7.0：分层记忆

• 新增默认关闭的 memory.layered，保持旧用户的单文件行为不变。
• 开启后，core.md 作为常驻记忆，topics/*.md 只向提示词提供标题和一行摘要。
• 三个 memory_* 工具均支持可选 topic 参数，按需读取、追加或重写主题全文。
• 旧 <卡名>.md 会继续作为 core 回退来源，首次分层追加时自动带入，不会因切换模式丢失可见记忆。
• 已完成 DSH 0.1.5-rc.2 一次性 Profile 的安装、Web 启动、客户端 Bundle 和卸载冒烟。

v0.6.2：写入改为原子提交并校验

此前所有保存都以单独一次 scope.set()/unset() 提交，写完只管弹「已保存」，从不确认是否真的生效。 问题在于 scope 的契约是「完成写入与恢复读取后结算」，不是「被拒就抛错」——被宿主以 settings/conflict 拒绝的写入同样会 resolve，于是界面显示成功而值静默回退。

具体修掉三处：

• 同一个命名空间被绑了两个 scope（设置栏一个、聊天框标题栏的人设切换器一个）。每个 scope 各自维护 pendingRevision 与写入队列，于是两边可能各自按一个已被对方超越的 revision 去写入 —— 宿主要么拒绝， 要么接受后立刻被后来者覆盖。现在合并为一个共享 scope（scope 本就是设计成跨挂载点共享的）。
• 删除人设卡时并行写入：Promise.all([set("cards"), unset("active")])。两处修改现在放进同一次 mutate()，共用一个 revision 栅栏。
• 写完不校验：现在写入结算后回读命名空间 section，只有确认生效才报「已保存」，否则提示 「写入未生效」并重新载入表单。「不启用」选项也从直接 scope.unset 改走同一条校验路径。

另外删掉了 6 处 if (typeof scope.load === "function") scope.load()。SettingsScope 接口从来没有 load()（读走的是共享的 describe 镜像，由宿主 settings/document-updated 驱动刷新），这些守卫是照 臆测 API 写的死代码，只会让人误以为"已经刷新过了"。

注意事项

• v0.8.5 起默认保留花括号原文：人设卡和记忆里的 {{demo}} 不再触发宿主插值。若旧卡片依赖 {{cwd}} 等宿主变量，请在设置页开启「允许人设与记忆使用提示词变量」（allowTemplates: true）；开启后未知变量仍会使渲染失败。
• 人设/记忆段落按组装解析：稳定卡片字节不变（KV Cache 友好），编辑即时生效。
• DSH 会直接公开插件注册的 soul-md settings 命名空间；插件不会修改宿主安装目录中的文件。
• 建议在人设卡里写清工作准则（如"任务质量优先"），避免角色扮演影响干活质量。
• 从 0.5.8 起最低支持 DSH 0.1.0-rc.7，已针对 0.1.0-rc.7、 0.1.0-rc.8 和 0.1.1-rc.1 测试。仍使用 DSH 0.1.0-rc.6 的用户请锁定 [email protected]；这是最后一个包含旧 settings 白名单兼容补丁的版本。

License

MIT