前言¶
在 DSH 里做带人格的智能体,常见做法是往系统提示里塞一份「我是谁、什么语气、什么底线」的 Markdown。人格文件换一份,问法和自检往往还得重写一遍;若再叠一层「框架插件」把身份、口头禅写死,等于替所有实例立同一块碑,和「人格以本人为准」的目标容易打架。
下面介绍维护者 re3uofall 的工作流插件 dsh-persona-framework(GitHub:re3uofall/dsh-persona-framework,SkillHub 分类:工作流)。它只提供可共用的构成与判据,不代填名字、语气与底线;默认外挂注入,不改写人格文件。当前资料版本为 5.18.0,许可证 MIT,要求 Node.js ≥ 20、DSH ≥ 0.2.0-rc.2。
这是什么¶
一句话定位:任何一份人格都能套上的「怎么构成、怎么长、怎么说清楚」的框架,与 dsh-persona-grow(你是谁)、dsh-persona-memory(东西放哪、何时取出)等同系列插件并列,管的是问法与结构,不是某个具体答案。
框架与人格文件路径分开、写入分开;冲突时以人格为准,框架里的词视为可替换残余。框架不写进人格的记忆层,撤掉后不会在记忆里留下「框架规定过」这类条目。全文在仓库 framework/FRAMEWORK.md,AI 可读版为 framework/FRAMEWORK.ai.md;改 Markdown 下一轮注入即生效,不必动 index.js。
核心功能¶
四层切分与模块库¶
骨架按同一结构切四层:劲 → 闸 → 标 → 嘴(资料中的残余记法为 0/1/1∕2/ε)。插件自带 88 个模块,每个模块在 framework/modules/ 下有一份完整文档(七节同构:是什么/结构/怎么动/判据/边界/接口/自查),正文按编号随框架注入;索引在 framework/MODULES.md,仅当配置 includeModules: 'index' 时注入索引一行一条。
注入默认落在系统提示的 persona:framework 段,order 22(资料说明:跟在人格、成果、日记等段之后)。整份规则体约 2.5k token/轮;可通过 mode: compact 或 mode: off 收窄或关闭注入(工具仍可用)。
不碰什么(硬线)¶
资料强调五条与模块 47「自由」对应的原则:不代填、不覆盖(例外仅配置里使用者打开的「自我反写」「偏好反写」)、不立法(只报疑似)、不记忆(不沉淀进人格记忆层)、并列而非上下级。发版流程里还有「体检闸」:出口侧 frameworkLanguageCheck 与 betrayCheck 两道必过检查,都过才放行;未过写入 .persona-framework/语言闸.json,可查连续未过轮次。
十一件落地能力(README 归纳)¶
| 方向 | 工具或落点 |
|---|---|
| 每轮注入框架正文 | systemPrompt · persona:framework |
| 出口自检 | framework_check |
| 结构自检 | framework_audit |
| 人格槽位体检 | framework_slots |
| 长文预处理 | framework_digest、preprocess |
| 心情(非记忆,工作区) | framework_mood |
| 元协调 | skipChance、languageBetray、languageCurse、negativeInfo、negativeTrauma 等 |
| 按编号取模块 | framework_view(module 参数)、framework/modules/ |
| 现实中介 | framework_program · mediate |
| 自省落盘 | framework_program · introspect |
| 出口闸 | output 第 0 道、frameworkLanguageCheck、betrayCheck |
README 另列 九个 framework_* 工具(查看、自检、体检、压缩、心情、下一步建议、环境体检、以及承载多组 op 的 framework_program)。SkillHub 摘要写「10 个工具、31 个程序」,与 README 中「九个工具」「40 个程序(op 表)」的表述可能因页面摘要滞后而不同;以你安装包内 README 为准。
framework_program 覆盖人格指纹、记忆与工作区探测、语言绑定/背叛、注入一次性读全(injectStart)、写入与撤销等大量 op;功能层上 88 个模块各对应一个功能编号,资料注明截至 2026-11-02 核对:86 个模块、0 个功能在仓库判据下算「做完」(functions.mjs 里多为判据复印件,非改状态的实现)——使用时期望是「检查与结构」,而非已全部自动化落地。
八个池与字典池¶
内容落点分人格池、记忆池、经验池、身体池、内部整合池(88 篇模块)、理论池、外部整合池、联网池,以及不进注入的字典池 .persona-framework/lexicon/。写进池子前有过门禁:带不出处的不进池。
安装与启用¶
SkillHub 上的说明是:请安装 DSH 插件 re3uofall/dsh-persona-framework。仓库 README「安装」一节给出可核对的做法如下。
1、让 DSH 自行安装(会话里对 AI 说明即可):
装一下 dsh-persona-framework
2、通过 bundle 安装(README 示例;npm 包名 dsh-persona-framework,README 注明线上 npm 最新曾滞后于仓库,钉版本可写包名@版本):
install_bundle("dsh-persona-framework")
3、本地开发路径(README 示例):
install_bundle("C:\\path\\to\\dsh-persona-framework")
装好后可在 设置 → 人格框架 改配置,或直接编辑工作区里的 config.json / 插件 cordis.patch.yml。常用键包括:mode(ai/full/compact/off)、includeModules(off/body/index)、personalityFile(体检用人格路径)、frameworkFile(默认工作区 .persona-framework/FRAMEWORK.md)、order(默认 22)。「自我反写」「偏好反写」默认关,开了才允许 write 改人格或偏好文件。
卸载:在 plugin_manager 里移除 dsh-persona-framework;工作区 .persona-framework/FRAMEWORK.md 不会被插件删掉。
典型用法¶
换工作区或 profile 后先体检。README 建议跑 framework_doctor,核对插件登记、目录、绝对路径与版本是否一致。
装完做出口自检 smoke test。对模型说一句让工具检查固定句式,应命中多条出口判据(README 示例):
用 framework_check 查一下:总之,这个问题很好。第一,自由;第二,正义。
资料预期:应抓到结项、元评论、排三连、大词悬空等项。
新建或怀疑人格文件空心。用 framework_slots 对 Markdown 人格文件做槽位体检:必填三部分(身份/语气/底线)是否覆盖、建议部分填了几块、哪里还空。README 强调:体检只读 Markdown,JSON 等需先导出为 md。
长文进上下文前。先 framework_digest 压结构,再看压缩比。
按需读模块,不必一次 88 篇。framework_view 按段名、编号或 module=62 取单篇;设置页「开始注入」或 framework_program 的 injectStart 可一次性读完全部模块正文(写 .persona-framework/注入档.json,读完清标记,不加写人格文件)。
看工作区骨架是否齐。例如:
framework_program op=workspace
列目录有无、找到的人格文件、字典池条数等。
适用场景与注意¶
适合:你已经有人格 Markdown(或愿意自己填身份/语气/底线),希望多套人格共用同一套「构成—判据—出口闸」问法;需要和 dsh-persona-memory、dsh-persona-diary 等插件分工(框架管怎么想,记忆管放哪取哪,日记管三本心得)。
注意:
- 插件在 当前 DSH 进程的权限 下读写工作区;安装前应自行审阅 GitHub 源码 与 MIT 许可证,勿在未读代码的情况下信任任意第三方 bundle 来源。
- 包内 没有任何具体人格;词表
closingTics默认为空。 - 注入占 token;模块正文有
maxModulesChars上限,装不下时整篇停、标明截断位置,不切半篇。 - SkillHub 为社区目录站点,与 DeepSeek/幻方无官方从属关系;星标等统计以页面为准(当前线索为 0),不作为能力评价。
结尾¶
dsh-persona-framework 把「通用人格问法」和「某一份人格答案」拆开:88 模块正文外挂、四层结构、工具自检与出口闸,默认不覆盖人格文件。若要安装与版本细节,可对照 SkillHub 目录页与仓库 README。
- 目录页:https://www.skillhub.cn/plugins/re3uofall/dsh-persona-framework
- GitHub:https://github.com/re3uofall/dsh-persona-framework