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