前言¶
DeepSeek Harness（DSH）使用中，经常遇到 AI 忘记既定人设、每次对话都要重申立场与工作契约、或者反复询问是否继续的情况。whale-persona 把这些需要反复交代的内容变成一份可配置的文件，随会话自动加载。
它出厂是空白的，默认不改变任何 AI 行为，需要什么写什么。与其他方案不同的是，它的长期记忆机制由代码强制：AI 只能提议，必须经过人工确认才会生效。
基本信息¶
- 插件名：whale-persona
- 维护者：shenA2024
- 分类：记忆
- 开源协议：MIT
- 核心定位：人设引擎 / DeepSeek Harness 插件
核心功能¶
插件通过配置文件管理 AI 的行为与状态，主要能力包括：
- 自称与称呼：支持按具体模型分档指定自称与对用户的称呼。
- 立场与性格：定义 AI 的基本立场与性格正文。
- 形象与语气：
- 形象：默认关闭，可注入身份与外貌描述。
- 形象卡：支持存储本人、用户及第三方卡片（摘要进提示词，正文留配置）。
- 语气：默认关闭，仅调整措辞与节奏，不改变结论与证据标准。
- 工作契约：支持逐条可勾选的契约，
on: false即停用。 - 思维链语言：仅修改思考过程的语言，不影响最终回复语言。
- 长期记忆：采用“提议-确认”模式，只有人工确认后记忆才会入库。
- 分类路由：支持记忆条目按
kind分类路由到不同文件。 - 注入体积计量：计量提示词各段字符数，面板与 CLI 可见。
- 条件反射：支持用户编写规则，命中后在代码层注入指令（默认零规则）。
- 零行为改变：不配置时全为空，确保装上插件不改变原有行为。
安装与启用¶
安装前请确保环境满足要求：Node.js >= 20，DeepSeek Harness >= 0.1.6-alpha.1。
- 执行安装命令：
npx -y whale-persona
安装完成后需重启 DSH。
- 重启后，插件默认为空白配置。在设置面板中新建或编辑
config.json，填入所需的自称、立场、契约等内容。
典型用法¶
安装完成后，可以通过脚本查看当前配置的实际注入效果，或管理预设人设。
- 查看注入内容（预览）：
node scripts/render-preview.mjs --config examples/demo-config. --cwd D:/work/demo
该命令会打印出实际注入提示词的三段文本。
- 管理预设：
node scripts/presets.mjs list
node scripts/presets.mjs import starter-plus.
node scripts/presets.mjs apply starter-plus
注意事项¶
- 纯 ESM：插件使用纯 ESM 模块，无运行时依赖。
- 零联网：插件不联网、不执行命令、不读取工作目录，安全可控。
- 记忆确认：长期记忆的生效必须经过人工确认，代码层强制执行，而非单纯依赖提示词约束。
- ZCode 适配器：ZCode 适配器已停止开发。
