Yur0918/dsh-soul

dsh-soul v2（SoulFusion）

dsh-soul × dsh-soul-md 融合增强插件：人设卡 + 记忆 + 审计 + 自演化一体化人设插件。

包名沿用 dsh-soul，版本 2.0.0（major 升级，升级即迁移、旧配置无损）。

English: README.en.md

界面

设置页「个性化」→「关于你与风格」Tab（9 种风格 + 生效提示词只读预览）与「记忆与演化」Tab（记忆文件状态 + append-only 审计 + 按 tool 分槽的确认槽）：

(界面示意稿——仅表布局与信息层级；图中数值与文案均为示意数据，非真实配置。)

开发状态

已验证（2026-09-09，dsh web 0.1.1-rc.2）：设置页「个性化」分区保存 style=roast 经 /dsh-soul/config 生效（日志 config saved via HTTP (style=roast)）；prompt 段 soul:persona/soul:memory 惰性注册、下一次回复生效。

Test Files  7 passed (7)
Tests       74 passed (74)

本仓库为可测试骨架 + 真实运行时接入的混合体：核心逻辑（配置/迁移/编译/记忆/审计/确认）全部纯函数实现并有单测覆盖；DSH 运行时接入已真实落地——plugin.ts 注册 soul:persona / soul:memory prompt 段、/soul 命令（show/set/reset/enable/disable）、/dsh-soul/config HTTP API 与设置页「个性化」分区，并在本机 dsh web 加载验证。6 Tab 面板、记忆/审计/确认槽的 runtime 接线、md 导入仍属 MV2/MV3 范围（见「/soul 命令表」规划区）。

功能清单

• 配置 schema v2：v1 全字段保留 + md 字段（cards / cardActive / cardSessions / cardWorkspaces / workspaceList / memory.*）+ 新增板块（evolution / audit / behavior / importedFrom）
• 校验：字段白名单 + 类型 + 长度 + 枚举；未知字段整单拒绝，非法返回字段级错误明细
• 迁移：
  • v1 → v2：style 别名表（efficient→pragmatic、casual→friendly、humorous→humorous 保留第 9 风格）、traits 归一化（对象/平铺兼容）、备份标记 importedFrom
  • dsh-soul-md → v2：cards/active/sessions/workspaces/memory.* 映射 + ≤v0.4 legacy path 字段兜底；importedFrom 幂等（二次导入跳过）
• 9 种回复风格（zh/en 双语文案）：default / professional / friendly / straight / whimsical / pragmatic / roast / coaching / humorous（v2 新增）
• prompt 编译流水线：全局注记（风格 ≤ 任务指令/准确性/安全）→ 关于你 → 风格段（含示例与禁止项）→ 特质修饰 → 语言 → 自定义指令 → 人设卡加性层 → 记忆段（头截断 injectMaxChars）
• 记忆服务：global.md / <card-slug>.md 分域读写；maxBytes 超限拒绝写入；注入取文件头
• 审计：soul-audit.jsonl append-only；条目 {ts, sessionId, actor, tool, target, oldHash, newText, status, source}；status：pending | applied | rejected | superseded | expired
• 确认槽：按 tool 分槽（set_persona / soul_update / memory_rewrite 各一槽）；confirm / reject / 替换（superseded）/ 过期

HTTP API（同源，web profile）

v1 迁移说明：v1 用户配置文件（$DSH_HOME/soul-config.json）在 v2 新路径缺失时会被只读自动发现并内存迁移，首次保存才写入新路径（旧文件永不改写）。v1 的 /api/soul/personas 对位端点即上表 /dsh-soul/personas。

安装

# 首次安装
dsh plugin --profile web add @yur0918/dsh-soul

# 升级（v1 → v2 自动迁移，旧配置备份后无损升级）
dsh plugin --profile web update dsh-soul

peerDependencies 声明（@deepseek-ai/dsh-system-prompt 系列）为契约占位， 以 peerDependenciesMeta.optional 标记，不必真实安装；本机无 DSH 环境的开发/测试不受影响。

/soul 命令表

当前已实现并在本机验证加载的命令面（其余为 v1 语义参考、MV2/MV3 规划范围，见「开发状态」）：

下表为 v1 语义参考与 MV2/MV3 规划，尚未在本仓实现，勿当作当前功能使用：

9 种回复风格

所有风格共用全局注记：风格只约束表达方式与语气，不改变任务要求、事实准确性与安全约束；与任务指令冲突时以任务指令为准；不得干扰工具调用与结构化输出格式。

与 dsh-soul-md 的关系（二选一）

• dsh-soul v2 已内置 dsh-soul-md 全部能力（人设卡、会话/workspace 切换、记忆注入），不依赖其包；
• 请卸载 dsh-soul-md，二选一安装：两个插件同装会同时注册 soul:persona 段，可能叠加/冲突；
• md 用户注意：/soul import md 属 MV3 规划，尚未在本仓实现（见「/soul 命令表」的规划区）。当前版本不会自动读取 dsh-soul-md 的卡片与记忆，需要手工迁移；字段映射逻辑见 src/config/migrate.ts 的 importFromMd（其 /soul import md 运行时入口同样待 MV3 接入）。

目录结构

src/
├── config/    schema.ts（字段/常量/默认值）· validate.ts（白名单+类型+长度+枚举）· migrate.ts（v1/md 迁移）
├── prompt/    styles.ts（9 风格文案）· compilePrompt.ts（流水线）· sections.ts（order 常量）
├── memory/    service.ts（记忆读写/截断）· audit.ts（append-only 审计）· confirm.ts（按 tool 分槽）
├── bridge/    systemPrompt.ts / inject.ts（运行时接线适配层；systemPrompt 已真实注册）
├── ui/        index.tsx（Tab 结构组件清单注释骨架）
└── index.ts   纯函数 API 汇聚
tests/         styles / compilePrompt / validate / migrate / confirm / audit（vitest 单测）

许可

MIT