前言¶
在 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