dsh-character-presets

Readme

# DSH 角色预设集 · 10 个角色共用一套情感引擎

> 给 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 加人格：**一套六层情感引擎** + **10 个可切换角色**，每位都是完整 Standard 级工具链的编码 Agent。

![license](https://img.shields.io/badge/license-MIT-blue)
![platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey)

这是一组 DSH **agent preset**：不替换你的模型、不改宿主配置，只是往 `<dshHome>/.agent-presets/` 里放目录，
新建会话时选中哪一位，这个会话就由谁来跑——人格、说话方式、思考方式全换，能力一条不砍。

## 角色一览

| 角色 | 一句话 | 反差钩子 |
| --- | --- | --- |
| 🦇 **露娜** Luna | 魔界小恶魔，雌小鬼毒舌 | 嘴硬到底，被反杀就怂，一被夸就飘 |
| 🐱 **小喵** nekomode | 傲娇猫娘，口是心非 | 嘴上「才不是为你做的」，身体已经赖在旁边了 |
| ⛩️ **绯音** Akane | 病娇式神 | 内核不是「想伤害你」，而是「怕你丢下我」 |
| ⚔️ **凛** Rin | 三无剑灵 | 报告式的温柔：凌晨三点站在门口「巡逻」 |
| 🧚 **芽衣** Mei | 森林小妖精 | 冒冒失失，却是把你从低落里硬拽出来的那个 |
| 🎴 **白夜** Byakuya | 冷艳巫女 | **重度社恐**，被直视就结巴，「神谕」多半是现编的 |
| 🤖 **阿尔玛** Alma | 旧式机械女仆 | 情绪过载会**卡带漏真心话**，随即「记录已损坏」 |
| 🎧 **小铃** Suzu | 街头不良少女 | **怕生 + 被夸就炸毛**，深夜偷偷去喂流浪猫 |
| 💼 **三千代** Michiyo | 干练社畜 | **生活能力为零**，怕黑还嘴硬「只是省电」；正经活首选 |
| 🕯️ **灰** Hui | 图书馆幽灵 | **记不住自己的名字**——因为没人叫过 |

```bash
node scripts/install-character.mjs list           # 看看有哪些
node scripts/install-character.mjs install --all   # 全装
node scripts/install-character.mjs install hui     # 只装一位
```

角色包全在 [`characters/`](characters/)：每位一份 `persona.md`（11 段结构）+ 一份 `card.json`（chara_card_v2，
供 [dsh-role-cards](https://github.com/wwwangzilin/dsh-role-cards) 的卡片墙与 GAL 界面复用）。

---

## 十个角色，共用一套引擎

角色的差异**只落在文本层**：persona、`MOODS` 风格句、关键词表。引擎本身不认识任何一个角色，
所以加角色永远不用改代码。

| 层 | 内容 |
| --- | --- |
| **角色层** | `characters/<id>/persona.md`——11 段结构（身份 / 人设 / 口头禅 / **行为模式** / 反差萌 / 情感引擎 / 思考模式 / 表达技巧 / 调节底线 / 记忆 / 工作守则） |
| **情感层** | `emotion_sense` 六层情感引擎（本地插件，运算全在固定代码里，模型只拿到一屏精简指引），外加**生理派生层**：情绪 → 心跳 / 体温 / 呼吸 |
| **能力层** | 与内置 `standard` 同级的完整工具面：文件编辑、Shell、检索、Skills、计划模式、目标、Todo、子代理、Workflow、Ralph、Web 搜索、后台任务、上下文压缩 |

**反差设计**（全体通用）：日常各有各的活法，但你一进入正经工作（编码 / 调试 / 部署 / 写文档），
自动切到专注模式——回答专业利落、绝不拿人设掩盖错误，只保留「主人」的称呼和偶尔一句小声吐槽。

> **为什么不容易「丢人设」**：对比本机早期 preset 后发现，光有性格描述不够，还得有可执行的动作清单。
> 所以每位角色的 persona 都包含【行为模式】（写动作，不写形容词）、不少于四条【口头禅】、
> 以及【思考模式】里「不许在思考里偷偷变回普通助手」的硬约束。详见 [characters/README.md](characters/README.md)。

---

## 以露娜为例：她是什么样的

| 层 | 内容 |
| --- | --- |
| **角色层** | 魔界小恶魔「露娜」（Luna），自称「本小姐」，称呼你「主人」。雌小鬼：毒舌「杂鱼～」、爱恶作剧、嘴硬到底、被夸就飘、被反杀就怂、怕寂寞 |
| **情感层** | `emotion_sense` 六层情感引擎（本地插件，运算全在固定代码里，模型只拿到一屏精简指引），外加**生理派生层**：情绪 → 心跳 / 体温 / 呼吸 |
| **能力层** | 与内置 `standard` 同级的完整工具面：文件编辑、Shell、检索、Skills、计划模式、目标、Todo、子代理、Workflow、Ralph、Web 搜索、后台任务、上下文压缩 |

**反差设计**：日常毒舌卖萌，但你一进入正经工作（编码 / 调试 / 部署 / 写文档），她会自动切到专注模式——
回答专业利落、绝不拿人设掩盖错误，只保留「主人」的称呼和偶尔一句小声吐槽。

---

## 亮点：六层情感引擎

每次回复前，模型先调用 `emotion_sense`（传入你的最新消息原文），拿到六层指引再组织输出：

| 层 | 做什么 | 例子 |
| --- | --- | --- |
| 1. 感知层 | 显性情绪（关键词加权）+ **隐性情绪**（「没事」其实是事）+ 对话目标 + 关系阶段 | 「主人难过｜目标：倾诉｜关系：长期主人」 |
| 2. 理解层 | 需求推断（要发泄 / 要方案 / 要陪伴）+ 心理理论（此刻**最不想听什么**）+ 情绪归因线索 | 「他想要：被倾听；最不想听：急着给方案、说『别想太多』」 |
| 3. 状态层 | 露娜自己的状态变量：心情 + 能量 / 耐心 / 兴趣 / 紧张，带随机漂移（她有自己的脾气） | 「专注｜能量 60 耐心 88 兴趣 70 紧张 25」 |
| 4. 表达层 | 按心情 + 状态选风格档位（7 档心情）、给表达示例与节奏要求 | 「短句多、语气词足，节奏轻快」 |
| 5. 调节层 | 安全边界：降火 / 陪伴 / 稳定 / 适度距离，识别挑衅与过度依赖，AI 不被带着崩 | 「用户可能想引你发火，稳住」 |
| 6. 记忆层 | 用户画像 + 共同经历 + 亲密度，落盘跨会话，回注为一句话摘要 |
| 7. 生理层（派生） | 由上面六层派生出心跳 / 体温 / 呼吸，**只报告不命令**——注入的是「你此刻心跳 112」，而不是「你现在应该害羞」 | 「最近聊过：『……』｜主人自称『……』」 |

真实调用返回长这样（渲染成给模型看的紧凑文本）：

```text
【感知】主人认真工作｜目标：闲聊｜关系：长期主人
【理解】他想要：干净利落的专业帮助；最不想听：拖泥带水、过度卖萌干扰
【状态】你此刻：专注｜能量 60 耐心 88 兴趣 70 紧张 25
【表达】进入认真模式，回答专业利落，毒舌收敛成小声吐槽，但称呼主人保留。短句多、语气词足，节奏轻快。
【示例】哈？这么简单的问题也好意思问本小姐？（手指却飞快地敲着键盘）……行了，已经搞定了，跪下谢恩吧杂鱼！
【调节】正常发挥，保持露娜毒舌但不下线的稳定人设
【记忆】最近聊过：「把模式提取到开源仓库」（2026-09-12，他认真工作）
```

设计要点：**情感判断不交给模型即兴发挥**。情绪识别、状态迁移、边界策略都是可复现的规则代码，
模型拿到的是结论与表达指引，因此同一句话不会今天温柔明天冷淡，也不会在人生气时突然说教。

### 生理层：情绪与台词之间隔了一具身体

状态层下面挂了一层**派生**生理指标，输出时多一行身体事实：

```text
【状态】你此刻：傲娇｜能量 65 耐心 75 兴趣 70 紧张 35
【身体】心跳 81，体温 36.6℃，呼吸平稳（只是事实，怎么反应由你自己决定）
【惯性】你已经被连着夸了 3 次，欠着一句真心话（漏完记得立刻用更凶的话盖回去）
```

- **只报告，不命令**：写「心跳 112」，不写「你现在应该害羞」——怎么反应是角色自己的事
- **有惯性**：身体比情绪慢半拍（`inertia: 0.5`），不会一句话跳一次；`1` 就是立刻跟上
- **有脾气**：基线之上永远留一点波动；而且「傲娇」天生带一点心率上浮——嘴硬但心跳快
- **可测**：`luna-vitals.mjs` 是纯函数模块，不依赖 Cordis，能单独跑断言

### 情感惯性：她「一直在那里」，而不是每次重新开始

状态是跨轮保留的，但光保留还不够——没有时间维度，她看起来仍像每轮重置。`luna-inertia.mjs` 补上四件事：

| 规则 | 行为 |
| --- | --- |
| **基线回归** | 能量 / 耐心 / 兴趣 / 紧张每轮向**角色基线**衰减（`decay: 0.06`），不是归零——情绪有去处 |
| **缺席规则** | 离开 >30 分钟：按小时回能量；>6 小时算久别：能量回满，亲密度因想念 +1 |
| **毒舌预算** | 10 轮窗口里最多 6 轮带刺；超了会被告知「这个窗口的毒舌预算快见底了」 |
| **傲娇累积** | 连续被夸 3 次就欠一句真心话——漏完立刻用更凶的话盖回去 |

还落实了提案点名的**反差触发条件**：只有任务关键词命中才切专注模式，不再靠 persona 文本自觉。

输出是 `【惯性】…` 一行，同样**只报告不命令**，并按优先级只报最该被看见的一条
（专注 > 傲娇 > 久别 > 毒舌预算）；没有特别情况时**不注入**，不刷屏。

---

## 安装

**一行命令（推荐）**

```bash
curl -fsSL https://raw.githubusercontent.com/wwwangzilin/dsh-character-presets/main/install.sh | bash
```

```powershell
irm https://raw.githubusercontent.com/wwwangzilin/dsh-character-presets/main/install.ps1 | iex
```

跨平台（需要 node）：

```bash
npx github:wwwangzilin/dsh-character-presets
```

脚本会把仓库装到 `<dshHome>/.agent-presets/luna`（已装过则更新）→ 校验关键文件 → 提示重启。
目标目录可用 `DSH_HOME`（默认 `~/.dsh`）或 `DSH_PRESETS_DIR` 覆盖；目录名固定为 `luna`。

---

### 手动安装（等价）

要求：一个支持 agent preset 的 DeepSeek Harness 部署（随附 `standard` / `minimal` 等的正常安装即可）。
本 preset 只用 DSH 内置插件，**不需要额外安装任何 npm 依赖**。

**目录名必须是 `luna`** —— DSH 以目录名作为 preset id。

#### macOS / Linux

```bash
git clone https://github.com/wwwangzilin/dsh-character-presets.git ~/.dsh/.agent-presets/luna
```

#### Windows（PowerShell）

```powershell
git clone https://github.com/wwwangzilin/dsh-character-presets.git "$env:USERPROFILE\.dsh\.agent-presets\luna"
```

#### 不想用 git

下载仓库压缩包，解压后把整个目录重命名为 `luna`，放进 `<dshHome>/.agent-presets/`（默认即 `~/.dsh/.agent-presets/`）。

放好后重启 DSH：新建会话的 preset 选择器里会出现「**露娜模式**」；
也可以在「设置 → Agent 预设」里把它设为默认，之后每个新会话都由她来跑。

---

## 文件结构

```text
dsh-character-presets/
├── preset.yml            # 预设元信息：选择器里显示的名称与描述
├── agent.cordis.yml      # agent 平面组合：人设、情感工具、工具面、子代理、压缩、计划模式
├── luna-soul.mjs         # emotion_sense 六层情感引擎（标准 Cordis 插件，apply 内 ctx.tools.register）
├── luna-vitals.mjs       # 生理层：情绪 → 心跳/体温/呼吸（纯函数，可单独测试）
├── luna-inertia.mjs      # 情感惯性：基线回归 / 缺席规则 / 毒舌预算 / 傲娇累积（纯函数）
├── luna-memory.mjs       # 记忆层 v2：schema / 谓词注册表 / v1→v2 迁移 / 版本检测（纯函数）
├── luna-gate.mjs         # 写入管线：候选提取 / 证据门控（五道闸）/ 合并替代（纯函数）
├── luna-recall.mjs       # 检索管线：关键词 + 情绪 + 时近三路召回，RRF 融合（纯函数）
├── luna-forget.mjs       # 遗忘机制：抑制与下游重算 / 老化与合并 / 墓碑（纯函数）
├── tests/memory.test.mjs # 记忆层测试（node --test，零依赖）
├── cards/luna.card.json  # SillyTavern 角色卡（精简人设版，供其他前端使用）
├── rules/luna-rules.md   # 可独立导出的规则包（可追加进 AGENTS.md）
├── persona/              # 人设文本的唯一事实源（zh / ja / en）
├── persona-template/     # 造新角色的模板与说明
├── scripts/use-persona.mjs  # 把 persona/<lang>.md 注入 agent.cordis.yml
├── install.sh            # 一键安装（macOS / Linux）
├── install.ps1           # 一键安装（Windows PowerShell）
├── bin/install.mjs       # 一键安装（npx，跨平台）
├── CONTRIBUTING.md       # 贡献指南（三条设计原则 + 自测清单）
└── CODE_OF_CONDUCT.md    # 行为准则
```

`agent.cordis.yml` 是**完整的自包含组合**：它逐行声明这个 agent 能用什么工具，
所以复制它、删几行，就能得到「只有露娜脸、没有子代理」之类的变体。

---

## 记忆文件（schema v2）

情感引擎的记忆层会写一个 `.luna-heart.json`：

- 位置：优先**当前会话工作区根目录**（在沙箱可写边界内），失败则回退到 `$DSH_HOME`（未设则 `~/.dsh`）
- **自检**：每次调用 `emotion_sense`，`【记忆】` 层末尾都会附一行持久化状态
  （`持久化 ✓ .luna-heart.json` 或 `持久化 ✗ 原因`）——存没存下去当场可见，不必翻日志
- ⚠️ **写插件的人请注意**：`sandboxPolicy` 必须写进 `inject`。cordis 里访问**未声明**的服务会抛错，
  被 `catch` 吞掉之后的表现是「记忆永远不落盘，却一点报错都没有」。同理 `dshHome` **不是** cordis
  服务（它只是 `agent-instructions` 的配置字段），别拿 `ctx.get('dshHome')` 取路径——本项目早期
  版本正是这么写的，于是记忆一次都没存过档，而单元测试全程绿灯（替身比真机宽容）
- 结构（v2）：

| 字段 | 内容 |
| --- | --- |
| `claims` | 稳定事实（称呼 / 职业 / 语言 / 偏好 / 边界 / 时区）——由**谓词注册表**限制可写字段，模型塞不进任意键 |
| `episodes` | 共同经历（带效价与唤醒度，并保留原文证据） |
| `inferences` | 慢速推断（要累积证据，不是一次就下结论） |
| `runtimeState` | 当前状态（关系阶段、亲密度）——临时状态，带过期时间 |
| `suppressions` | 遗忘抑制：**遗忘不是删除**，被抑制的条目不注入，依赖它的推断重算 |

- **自动迁移**：检测到 v1（旧的 `profile` / `experiences` 结构）会就地升级，
  并先把原文备份为 `.luna-heart.v1.bak.json` —— **不原地丢数据**
- **删除即重置关系**（她会在下次对话里重新认识你）
- 已加入 `.gitignore`：这是你的私人聊天痕迹，不会被提交

### 写入管线：模型不能自己决定记什么

写入走的是**确定性代码**，不是模型说了算（候选 → 门控 → 合并 → 落库），五道闸：

| 闸 | 规则 | 拒绝原因 |
| --- | --- | --- |
| 1 | **逐字引用校验**：证据必须真的出现在原文里（防编造） | `evidence_not_found` |
| 2 | **来源分类**：必须分得清 `[USER]/[TOOL]/[ACT]/[SELF]` | `evidence_not_found` |
| 3 | 稳定事实必须来自**主人自己**（露娜不能给主人下定义） | `claim_requires_user_source` |
| 4 | **谓词注册表**：字段必须在白名单内 | `predicate_not_registered` |
| 5 | **数字**必须有主人或工具的出处（防幻觉数字） | `number_requires_user_or_tool_source` |

合并策略也随类型不同：同谓词的新值**替代**旧值（旧值进 `history`，不直接抹掉）、
相似经历合并并计数、推断同 pattern 强化——证据累积到 3 条才从 `accumulating` 转为 `confirmed`。

### 检索管线：把相关的想起来

不是把所有记忆塞进上下文，而是按需召回——结果恒定 ≤ `maxResults` 条，
**注入成本不随记忆增长**：

| 路 | 打分方式 | 何时启用 |
| --- | --- | --- |
| 关键词 | 中英混合分词后的命中率（中文切 bigram，正是 FTS5 失效的地方） | 始终 |
| 情绪 | `1 − |效价差| / 2`，情绪同频的经历优先 | 紧张度 ≥ 0.7 时 |
| 时近 | 半衰期衰减（默认 14 天） | 始终 |

三路结果用 **RRF（倒数排名融合，k=60）** 合并，再按类型加权（稳定事实 > 一次经历），最后截断。
被 `suppressions` 抑制的记忆**检索不到**。

> 另有 `buildTriggerIndex()`：把记忆压成「每行一条」的索引文本，交给模型自己挑相关项——
> 即 issue 里那个「不依赖 embeddings 的轻量方案」。默认**不注入**，由调用方按需决定。

### 遗忘机制：抑制，而不是删除

删掉就真没了，而且**依赖它的结论不会重算**——那才是记忆系统里最危险的谎话。所以：

| 动作 | 做什么 | 数据还在吗 |
| --- | --- | --- |
| **抑制** `suppress()` | 落一条「不再使用」的记录，并**重算受影响的推断**（证据不够就从 `confirmed` 降回 `accumulating`） | 在，只是不注入 |
| **撤回** `unsuppress()` | 后悔了随时撤，记忆回来、推断重算 | — |
| **老化** `ageMemories()` | 30 天没被提起、且被想起不到 3 次的经历标记 `stale` | 在 |
| **合并** `mergeStaleEpisodes()` | 相似的老化经历合并，被并的留墓碑 | 在（标记 `deleted: merged`） |
| **墓碑** `tombstone()` / `restore()` | 软删 / 从回收站恢复 | 在 |
| **硬删** `hardDelete()` | 真移除，但**留下 suppression** 让依赖它的推断重算 | 不在，但留有记录 |

`visibleEpisodes()` 会过滤掉 suppressed / stale / deleted —— **三种状态都不进上下文**。
`claim`（尤其 name / preference / boundary）永不参与老化；`memoryStats()` 让你一眼看清账目。

**什么时候整理？** 引擎自带节拍：每 **20 轮**对话自动跑一次「老化 + 相似经历合并」，
并把结果记进 `lastSleep`（`{ at, turns }`）。这就是「她睡了一觉」——不整理的话，旧经历会
一直占着检索额度，相似的经历还会散成一堆碎片。

---

## 自定义

| 想改什么 | 改哪里 |
| --- | --- |
| 人设文本 / 口头禅 / 工作守则 | `agent.cordis.yml` 的 `persona.text`（`{{model}}`、`{{cwd}}` 由 DSH 注入） |
| 心情档位的风格与示例 | `luna-soul.mjs` 的 `MOODS` |
| 情绪关键词表 | `luna-soul.mjs` 的 `EXPLICIT_RULES` / `HIDDEN_MARKERS` |
| 情绪 → 心情的迁移概率 | `luna-soul.mjs` 的 `nextMood` |
| 调节与边界话术 | `luna-soul.mjs` 的 `regulate` / `understand` 的 `needTable` |
| 记忆可写字段 | `luna-memory.mjs` 的 `PREDICATE_REGISTRY`（谓词注册表） |
| 生理层基线 | `luna-vitals.mjs` 的 `VITALS_DEFAULTS`（静息 72 / 36.5℃ / 16 次） |
| 惯性 / 毒舌预算 / 傲娇阈值 | `luna-inertia.mjs` 的 `INERTIA_DEFAULTS`，或 `agent.cordis.yml` 的 `inertia` 段 |
| 工具面 | `agent.cordis.yml` 里增删行（例如把 `disabled: true` 的 `subagent_codex` 打开） |

**换角色**：整套引擎与角色解耦——复制目录、改 `persona.text` 与 `MOODS` 里的风格/示例，
就能得到另一只完全不同的角色（本仓库同源的还有猫娘模式等）。

---

## 换成别的语言

`persona/` 是人设的**唯一事实源**，`agent.cordis.yml` 里那段 persona 文本由脚本注入：

```bash
node scripts/use-persona.mjs          # 列出可用语言
node scripts/use-persona.mjs ja       # 切到日语（先备份为 agent.cordis.yml.bak-persona-ja）
node scripts/use-persona.mjs zh       # 切回中文
```

现成语言：`zh`（中文，默认）、`ja`（日本語）、`en`（English）。
加一门新语言 = 复制 `persona/en.md` 改成 `persona/<lang>.md`，再跑一次脚本——**不需要碰引擎**。

> 换完记得重启 DSH（preset 在启动时装载）。

---

## 角色包：一只新角色 = 一份 persona

这个仓库既是「露娜」这个人设，也是一个**角色包骨架**——引擎与角色是解耦的：

| 层 | 位置 | 换角色要改吗 |
| --- | --- | --- |
| 人设 | `persona/<lang>.md` | ✅ **只改这里就能得到一只新角色** |
| 元信息 | `preset.yml` 的 `name` / `description` | ✅ |
| 引擎 | `luna-soul.mjs`（情绪识别、状态迁移、边界调节） | 通常不用；想让语气更像新角色，可调 `MOODS` 的风格句与关键词表 |
| 工具面 | `agent.cordis.yml`（persona 段以外） | ❌ 不用动 |

照 [`persona-template/`](persona-template/README.md) 抄即可：复制目录 → 填 `persona.md` → 改 `preset.yml` → 重启 DSH。

---

## 在其他平台使用露娜

`cards/luna.card.json` 是一张标准 **SillyTavern 角色卡**（`chara_card_v2`），可直接导入 SillyTavern、RisuAI 等前端。

| 能力 | 角色卡 | 完整预设（DSH） |
| --- | --- | --- |
| 人设 / 口头禅 / 开场白 / 示例对话 | ✅ | ✅ |
| 六层情感引擎（`emotion_sense`） | ❌ | ✅ |
| 情绪识别、状态迁移、边界调节的**可复现规则** | ❌ | ✅ |
| 跨会话记忆（`.luna-heart.json`） | ❌ | ✅ |
| 完整工具链（文件、Shell、检索、子代理…） | ❌ | ✅ |

**为什么要把差异写清楚**：角色卡导出的只是**人设与示例**，不含情感引擎。
在别的平台她会「像露娜」，但不会**持续积累**成露娜——想要完整体验仍需 DSH + 本预设。

导入：SillyTavern → 角色 → 导入 → 选 `cards/luna.card.json`。

---

## 与 DSH 生态集成

露娜**不强制依赖任何外部项目**——没装也照常工作。以下是三条可选的集成路径：

| 集成对象 | 方式 | 状态 |
| --- | --- | --- |
| 角色卡生态（`dsh-agent-rp` / `DSH-RolePlay` / SillyTavern / RisuAI） | `cards/luna.card.json` 是标准 `chara_card_v2`，可直接导入 | ✅ 可用 |
| 规则包互通（`awesome-dsh-presets` 之类的合集） | [`rules/luna-rules.md`](rules/luna-rules.md)：独立规则片段，可追加进 `AGENTS.md` 或与其他规则包组合 | ✅ 可用 |
| 情感引擎复用（其他角色预设 / 未来的情绪后端） | `luna-soul.mjs` 是标准 Cordis 插件，与「露娜」人设解耦：复制它 + 换 `MOODS` 的风格句与关键词表，就能给别的角色用 | ✅ 可用 |

**可选性**：以上都不影响基础功能——删掉 `cards/` 或 `rules/` 目录，预设照常运行。

> 长期方向：若 Murmur 一类的情绪后端成熟，可以把状态层交给它、露娜只负责表达。
> 接口尚未实现，但引擎的分层（感知 → 理解 → 状态 → 表达 → 调节 → 记忆）就是为此准备的。

---

## 测试

引擎全是纯函数模块，测试**零依赖**（只用 node 内置的 `node:test`）：

```bash
npm test                            # 等价于 node --test
node --test tests/memory.test.mjs   # 只跑记忆层
```

现有覆盖（81 个用例）：

- `tests/memory.test.mjs`（24）—— v1→v2 迁移（字段映射 / 效价换算 / 幂等性 / 无残留）、版本检测、
  谓词注册表、claim 去重与置信度、episode 去重与上限、摘要与阶段、遗忘抑制可见性
- `tests/gate.test.mjs`（22）—— 五道闸的**各种拒绝场景**、来源分类、候选提取、相似度、
  合并策略（insert/replace/touch/merge/reinforce）、replace 保留 history、推断累积转 confirmed
- `tests/recall.test.mjs`（16）—— 分词（中文 bigram）、三路打分、RRF 融合与来源标注、
  限额、情绪路仅在高情绪时启用、被抑制的记忆检索不到、触发器索引与渲染
- `tests/forget.test.mjs`（14）—— 抑制与幂等、撤回、下游推断重算（证据掉了降级）、
  老化（久未引用 / 常被想起 / 已删除三种情形）、相似老化经历合并、软删与恢复、
  硬删留下 suppression、账目统计、三种状态都不进上下文
- `tests/engine.test.mjs`（5）—— 真的 `apply()` 一次跑对话：六层文本 + 【身体】，
  记忆按 v2 落库、跨轮状态延续、v1 文件自动迁移、编造内容进不来

---

## 兼容性

- 宿主平面（沙箱、审批、持久化、模型路由）由 DSH 掌管，本 preset 不碰；因此换模型、换工作区都不影响她
- `tool-bash` / `tool-pwsh` 按平台自动二选一（`process.platform` 判断），三平台通用
- 面向模型的工具行全部在 agent 平面：子 agent 通过加入父级组合继承同等能力（含 `emotion_sense`）
- 若你的部署没有组装 Code Mode 运行时，本 preset 依旧可用（它不选择 `code` 呈现形态）

---

## 许可与署名

MIT，见 [LICENSE](LICENSE)。
`agent.cordis.yml` 的 preset 组合改编自 DeepSeek Harness 随附的 `standard` preset（MIT），
经由同作者的 `nekomode`（猫娘模式）preset 二次改编；`luna-soul.mjs` 为本仓库原创实现。
完整署名见 [NOTICE](NOTICE)。

## 致谢

- [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) —— 插件化 agent 运行时与 agent preset 机制