前言¶
在 DSH 裏做智能體時，System Prompt 往往散落在 Agent Preset、會話配置或各渠道集成裏。改一句「說話方式」可能要動預設、重建 Session，或在 QQ 羣和工作會話之間各寫一套文案。Amadeus Persona 把「我是誰」（SOUL 核心人格）和「怎麼說話」（可複用的 STYLE 場景卡片）拆開管理，並以獨立 System Prompt 段落注入，便於在同一 Workspace 下按會話或受信 QQ 場景切換風格，而不必每次改模型裝配。
下面介紹該插件的定位、能力與安裝配置方式。事實依據爲倉庫 README、docs/INSTALL_V1_2.md 及 package 元數據；運行時基線爲官方 DSH Desktop 0.2.1-rc.3，目標包 @fg-lab/amadeus-persona@1.2.0（MIT）。
這是什麼¶
Amadeus Persona 由 jeskoky-pixel 維護，npm 包名 @fg-lab/amadeus-persona，在 SkillHub 等社區目錄中歸類爲「趣味換裝」。一句話定位：一份共享的核心身份（SOUL）加任意數量的可複用場景風格（STYLE），以獨立 System Prompt 區塊注入 DSH。
它不新建模型、不擴大工具權限；默認不影響其他 Workspace 與子智能體。空安裝不會注入任何示例人格。同項目 Amadeus 生態裏的其他插件爲可選，按需安裝即可。
核心功能¶
經 README 與 REFERENCE 說明，當前版本側重以下能力（配置是否最終進入請求，應以控制台診斷爲準，而非僅看卡片是否保存）：
- 編輯與版本：維護一份共享 SOUL 核心人格，以及任意多張 STYLE 卡片，支持版本與備份。
- 綁定與覆蓋：爲某個 Workspace 選定默認風格；單個 Session 或受信任的 QQ Scene 可單獨覆蓋。必要時可選 inherit、僅核心（core-only）或 disabled。
- 熱更新人格：在後續模型裝配中更新 persona，而不必改 Agent Preset 或重建已有 Session；進行中的工具調用不會被中斷。
- 雙語控制台：提供庫、綁定與診斷；可查看衝突及最終 System Prompt 可見性。
典型用法（來自 README 示例）：同一項目保留相同核心身份，工作 Session 用簡潔風格，已授權 QQ 羣用偏對話的風格；Scene 成員共享該 Scene 的風格，而不是其他 Scene 的私有記憶。
需注意：人格編輯可能影響請求序列或 prompt-cache 複用；長對話上下文仍可能改變措辭。插件以當前 DSH 進程權限運行，安裝前應閱讀源碼與 MIT 許可證。
安裝與啓用¶
官方要求通過 DSH 插件管理器 安裝預構建 .tgz，並遵循倉庫 docs/INSTALL_V1_2.md，不要手工把配置拷進運行中的 Profile。無需本地源碼構建；普通使用不需要 Node 或 Codex（package 對引擎要求 Node >=22.13.0、dsh >=0.2.1-rc.3 <0.3.0 由插件包聲明，由宿主滿足即可）。
README 寫明 1.2.0 已發佈（GitHub Release 與 npm），安裝時應固定該版本並覈對發行校驗和；後續 main 分支變更不改變該不可變歸檔。
docs/INSTALL_V1_2.md 中的首次安裝步驟概括如下：
- 在 DSH Desktop 中打開目標 Profile 的插件管理器，選擇安裝本地預構建包；正式發佈渠道也可選用
@fg-lab/amadeus-persona@1.2.0（npm 或 GitHub Release 固定版本）。 - 選擇預構建包（文檔示例文件名爲
fg-lab-amadeus-persona-1.2.0.tgz），確認已安裝列表顯示@fg-lab/amadeus-persona@1.2.0，並進入插件設置頁。 - 在 Persona 控制台綁定 Workspace，保存自有的核心卡片，按需創建 STYLE 與綁定關係。
- 按宿主提示重載或重啓，回到設置頁檢查健康狀態；失敗時不要手改數據目錄，保留錯誤信息與安裝包並恢復 Profile 備份。
安裝文檔同時提醒：內部候選包曾通過隔離環境下的官方 dsh plugin 安裝驗證；公開 Market 下載與部分生產場景是否完全驗收，以 REFERENCE 與驗證報告中的限制爲準。
升級、禁用與數據¶
升級前請備份用戶數據。代碼、持久化用戶數據與恢復備份相互獨立；僅恢復舊代碼無法逆轉數據庫遷移。禁用會停止功能但保留數據；卸載意圖是保留安裝包外的用戶數據。相關策略見倉庫中的 docs/UPGRADE_POLICY.md、docs/DATA_MIGRATION.md 與 REFERENCE.md。
適用場景與注意¶
適合需要在 同一 Workspace 內 統一「核心人格」、又在 不同 Session 或 QQ Scene 切換表達風格的 DSH 開發者。不適合指望通過本插件單獨獲得新模型能力或跨 Workspace 默認生效的配置。
DSH 社區目錄（如 SkillHub）爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；安裝第三方插件前請自行審閱倉庫與許可證。
結尾¶
Amadeus Persona 把 SOUL 與 STYLE 做成可版本化、可綁定的 System Prompt 模塊，減少改預設和重建會話的成本。進一步瞭解與安裝說明見 GitHub 倉庫與中文 README；社區條目見 SkillHub 目錄頁。
- 目錄頁：https://www.skillhub.cn/plugins/jeskoky-pixel/amadeus-persona
- GitHub：https://github.com/jeskoky-pixel/amadeus-persona
