dsh-luna-preset

dsh-character-presets

DeepSeek Harness 的 agent preset 插件包，提供单一预设「露娜模式」。

预设由一套确定性规则引擎组织对话：情绪感知、需求推断、状态迁移、表达选择、边界调节、记忆检索分别在独立模块中实现，模型只接收引擎输出的结构化指引。工具面与内置 standard 预设等价。

• 许可：MIT
• 平台：Windows / macOS / Linux
• 运行环境：DeepSeek Harness 0.2 及以上

---

目录

• 工作原理
• 组成
• 安装
• 配置
• 记忆
• 情感引擎
• 打包结构
• 开发
• 自定义
• 兼容性
• 许可与署名

---

工作原理

每次模型回复前，预设中的 emotion_sense 工具接收用户消息原文，按固定规则计算六层指引并返回一屏紧凑文本；模型依据该文本组织回复。情绪分类、状态迁移与边界策略均由可复现的规则代码实现，不依赖模型自由发挥，因此同一输入在相同状态下的判断保持一致。

输入：主人认真工作，但这句话像是在开玩笑

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

组成

工作模式与闲聊模式由 luna-mode.mjs 的粘滞状态机区分：进入工作后至少保持 6 轮，期间仅明确脱离工作的语句可以退出。工作模式下表达收敛为结论优先，不铺垫、不使用夸张语气；称呼与少量自嘲保留。

---

安装

通过 CLI 安装（推荐）

dsh plugin add https://github.com/wwwangzilin/dsh-character-presets.git

安装完成后重启 DSH。新会话的预设选择器中出现「露娜模式」；也可在「设置 → Agent 预设」中设为默认。

dsh plugin add 将本包写入当前 profile 的依赖与组合列表，并作为 bundle patch 插入一条 @deepseek-ai/dsh-agent-preset 声明行。撤销方式：

dsh plugin --profile <profile> remove dsh-character-presets

从本地目录安装

git clone --depth 1 https://github.com/wwwangzilin/dsh-character-presets.git ~/dsh-character-presets
dsh plugin add ~/dsh-character-presets

脚本安装

install.sh（POSIX shell）与 install.ps1（Windows PowerShell）先将包取到 $DSH_HOME/presets/luna，再调用 dsh plugin add。可用环境变量覆盖路径：DSH_HOME、DSH_PRESET_DIR、DSH_PRESET_REPO、DSH_PRESET_REF。

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

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

手动安装

要求 DSH 0.2 及以上，无需额外 npm 依赖：

1. 将仓库克隆到任意目录；
2. 在该 profile 中执行 dsh plugin add <目录>；
3. 重启 DSH。

0.1 版本的安装方式（将仓库复制到 <dshHome>/.agent-presets/luna/ 并以目录名作为预设 id）自 0.2 起不再生效：预设注册表不扫描该目录，也不接受任何 YAML 写回。已有部署需改为上述安装方式。

---

配置

选择器中的显示信息由 package.json 的 dsh.preset 提供：

"dsh": {
  "bundle": { "patch": "./cordis.patch.yml" },
  "preset": {
    "id": "luna",
    "name": "露娜模式",
    "description": "…",
    "order": 2
  }
}

修改 dsh.preset 或 agent.cordis.yml 后须重新生成补丁：

node scripts/sync-bundle.mjs

记忆

情感引擎的记忆层维护 $DSH_HOME/.luna-heart.json（未设置 DSH_HOME 时为 ~/.dsh/.luna-heart.json），并回退到当前会话工作区根目录。

• 每次调用 emotion_sense，返回文本的 【记忆】 行末尾附有持久化状态（持久化 ✓ .luna-heart.json 或失败原因），无需查阅日志。
• 删除该文件即重置关系状态，下一次对话按初次见面处理。
• 仓库 .gitignore 已排除该文件；插件写入的始终是本地文件，不进行任何网络传输。

数据结构（v2）：

旧版（profile / experiences 结构）在首次读取时就地迁移，原文件备份为 .luna-heart.v1.bak.json。

写入

写入路径为确定性代码（候选提取 → 证据门控 → 合并 → 落库），共五道校验：

合并策略按类型区分：同谓词新值替代旧值并保留历史；相似经历合并计数；推断在证据累积到 3 条后转为确认。

检索

召回结果条数受 maxResults 限制，注入成本不随记忆量增长：

三路结果经 RRF（倒数排名融合）合并后按类型加权截断。被抑制的记忆不参与检索。

失效

遗忘以抑制为主，不以删除为主：

被抑制、陈旧或已删除的条目一律不进入上下文。每 20 轮对话自动执行一次老化与合并。

---

情感引擎

感知层

情绪识别叠加四类信号，避免关键词误判：

我不开心        → 难过（否定翻转，而非命中「开心」）
哈哈哈哈        → 强度 3（重复字符外溢，附加「干笑」标记）
真是气笑了      → 生气 + 开心（混合情绪，整词识别）

1. 否定：命中词前 4 字内出现否定词则翻转；跨逗号、句号的否定不生效。单字「别」被排除，避免「特别开心」误判。
2. 强度：基础 1.2 分，按感叹号数量、连续重复字符（3 个及以上非标点字符）、程度副词上调；「有点」等减弱词下调。
3. 混合情绪：「气笑」「哭笑不得」「又累又」等固定说法整体识别，输出主情绪与次情绪。
4. 标点与句式：连续问号、省略号、干笑分别作为补充信号。

状态与表达

状态层维护心情与四项状态变量（能量、耐心、兴趣、紧张），按角色基线衰减并叠加随机漂移。表达层按心情选择风格档位，并给出节奏要求；调节层处理降火、陪伴、稳定与适度距离四类场景。

生理层

由前六层派生，输出一行身体事实：

• 只报告状态，不给出行为指令（例如「耳朵尖发烫」，而非「你现在应该害羞」）；
• 平静时不输出数值，仅在显著偏离常态时报告心率；
• 每种心情配置三档局部体感（强度越高，描述越多）；
• 身体指标按 inertia: 0.5 滞后于情绪，心情与强度当轮生效；
• 久别 ≥48 小时的会话，心率基线先上调；
• 包含昼夜节律与情感债：夜间指标整体下调；强度达标的负面情绪挂账，在随后数轮中逐渐消退。

粘滞状态机

帮我把那个备份脚本改一下  → 工作（进入）
嗯                      → 工作（保持）
继续                    → 工作（保持）
好了吗                  → 工作（保持）
陪我聊会话              → 闲聊（明确脱离，直接退出）

进入条件为工作信号累计 2 分（代码片段、路径、报错、祈使句、追问）；保持 6 轮；退出需保持期结束且当前消息无工作信号；空闲超过 6 小时重置为闲聊。工作模式每轮额外消耗少量能量。

补充层

luna-siblings.mjs 写入 $DSH_HOME/.agent-presets/.siblings.json；目录不可写时静默跳过，不影响其他功能。

---

打包结构

本仓库是一个 bundle：package.json 声明 dsh.bundle.patch，指向 cordis.patch.yml。该补丁声明一条 @deepseek-ai/dsh-agent-preset 行，其 config.plugins 为 agent.cordis.yml 的正文（整体缩进后嵌入）。

agent.cordis.yml   人工维护：人设文本与工具面，保留注释
package.json       dsh.bundle 与 dsh.preset 元信息
cordis.patch.yml   生成物：由 scripts/sync-bundle.mjs 输出，请勿手工编辑

生成规则：

• 相对路径的模块引用改写为包名路径（dsh-character-presets/luna-soul.mjs），解析依赖 package.json 的 exports；
• 补丁正文的缩进必须深于 config: 所在列，否则 Loader 报 bad indentation of a mapping entry；
• 生成物与源不一致时 tests/bundle.test.mjs 失败。

开发

npm install                 # 仅安装 js-yaml（测试用）
npm test                    # node --test
node scripts/sync-bundle.mjs
node scripts/sync-bundle.mjs --check
node scripts/preview.mjs    # 感知 / 生理对照表
node scripts/use-persona.mjs <lang>   # zh | ja | en

测试全部为零运行时依赖的纯函数用例：

自定义

其他前端

cards/luna.card.json 为 chara_card_v2 格式，可导入 SillyTavern、RisuAI 等。该卡片仅包含人设与示例，不含情感引擎、记忆与工具链。

派生角色

characters/ 仅保留 luna。extras 分支保留其余 9 个角色包（小喵、三千代、绯音、凛、芽衣、白夜、阿尔玛、小铃、灰）；该分支仍使用 0.1 的目录式布局。生成可安装的派生包：

node scripts/install-character.mjs build <id> --out <dir>

兼容性

• 需要 DSH 0.2 及以上（bundle patch 中的 @deepseek-ai/dsh-agent-preset 声明）；
• 宿主平面（沙箱、审批、持久化、模型路由）由 DSH 管理，本包不做改动；
• tool-bash / tool-pwsh 按 process.platform 自动二选一；
• 面向模型的工具行位于 agent 平面，子代理通过加入父级组合继承同等能力。

许可与署名

MIT，见 LICENSE。

agent.cordis.yml 的预设组合改编自 DeepSeek Harness 随附的 standard 预设（MIT），并经同作者的 nekomode 预设二次改编；luna-soul.mjs 及同目录引擎模块为本仓库原创。完整署名见 NOTICE。

相关项目：DeepSeek Harness。