前言¶
在 DSH 里做带人格或长期陪伴向的智能体时，常见做法是只靠对话上下文或外部 Memory 插件堆事实。会话一换、规则一改，很难回答「当前情绪、精力、某项兴趣权重是怎么变过来的」——既没有可检查的当前值，也没有可审计的变更轨迹。Amadeus State（社区目录条目 jeskoky-pixel/amadeus-state）面向的是另一类需求：在工作区维度维护共享状态（mood、energy、curiosity、兴趣权重等），并把事件与演化历史持久化，供原生设置界面查看与调规则。它不负责替代 Persona 身份，也不等同于长期 Memory；与 Memory 的分工在官方 README 里写得很清楚。
这是什么¶
Amadeus State 是 maintainer jeskoky-pixel 发布的 DSH 插件，npm 包名为 @fg-lab/amadeus-state@1.2.0，MIT 许可证。一句话定位：Shared Workspace state with persistent evolution history——绑定 Workspace 的状态层，带持久化演化历史。
在 SkillHub 社区目录中归类为「记忆」相关插件；功能边界上它管的是 State（当前条件与变化），Memory 仍管事实、经历与长期知识。官方说明：QQ 专属 Scene 规则、以及未实现的可选 Memory 写入契约，不能默认当作已支持，细节见仓库 REFERENCE.md。
已验证的运行基线为官方 DSH Desktop 0.2.1-rc.3（package.json 中 engines.dsh 为 >=0.2.1-rc.3 <0.3.0，Node >=22.13.0）。插件通过 Cordis patch 注入客户端，并在设置侧依赖 @deepseek-ai/dsh-client-ui-settings 与 @deepseek-ai/dsh-client-ui-plugin-manager，提供多页原生控制台（包描述中为 seven-page native console）。
核心功能¶
下面介绍 README 与中文 README 中已列出的能力，不展开未在资料中出现的配置字段。
-
状态维度与权重
维护 mood、energy、curiosity 以及兴趣（interests）权重，并记录与之相关的事件。 -
演化历史
状态变更带持久化事件与 evolution history，便于回溯「怎么变成现在这样」，而不是每次改长期记忆正文。 -
Workspace 绑定与规则
绑定一个 Workspace，配置已支持的 Session 覆盖（overrides）、排除项（exclusions）与演化规则（evolution rules）。 -
原生设置可视化
在 DSH 原生设置里查看当前值、规则与存储的历史；README 提供的界面截图为docs/verification/screenshots/state-v1.1-overview-desktop.png，文档注明截图不代表所有平台能力均已通过当前发行门禁。 -
与 Amadeus 生态的关系
其他 Amadeus 插件为可选联动，按集成需求单独安装。项目主页见 Amadeus-dsh。
安装与启用¶
安装方式以仓库 docs/INSTALL_V1_2.md 为准：使用官方 DSH 插件管理器安装预构建 .tgz 到目标 Profile，不要手工把配置拷进正在运行的 Profile，也不需要本地从源码构建（普通用户不需要 Node 构建链）。
英文 README 写明 v1.2.0 已发布至 GitHub Release 与 npm，并建议安装固定版本后校验发行 checksum；中文 README 同时说明产品化候选与公开发行的门禁差异。实际操作时以你拿到的安装包来源（Release / npm / 预构建 artifact）与 DSH Desktop 提示为准。
首次安装（摘自 INSTALL_V1_2.md 步骤）：
- 在 DSH Desktop 打开目标 Profile 的插件管理器，选择安装本地预构建包；正式发布后也可选择
@fg-lab/amadeus-state@1.2.0的 npm 源或固定版本 GitHub Release。 - 选择预构建包
fg-lab-amadeus-state-1.2.0.tgz，确认已安装列表显示@fg-lab/amadeus-state@1.2.0，并打开插件设置页。 - 在设置中选择 Workspace，检查会话规则与状态持久性。
- 按宿主提示重载或重启，回到设置页检查健康状态。安装失败时不要改数据目录；保留错误信息与安装包，并恢复备份的 Profile。
启用后，在 DSH 原生设置中选择 Workspace，查看状态并配置演化规则。更完整的字段与限制见 REFERENCE.md。
典型用法¶
文档给出的可复现思路是「看—改—验」，而不是改长期 Memory 正文：
- 在设置可视化中打开某项 interest，查看当前 weight 与 event history。
- 调整对应的 evolution rule。
- 触发或等待后续状态更新，确认变化符合规则，且历史被追加记录。
经过上面的步骤，你可以在不动长期知识库的前提下迭代「当前状态怎么演化」的策略。具体入口以 DSH Desktop 设置 UI 为准。
升级、禁用与适用注意¶
升级： 旧版升级前先导出 DSH Profile，停止插件写入，并备份用户数据。默认数据库路径为 $DSH_HOME/amadeus-state/state.sqlite（文档中的 databasePath）。在同一 Profile 安装 v1.2.0 包，不更换 Workspace、插件 ID 和数据路径。代码、持久数据与恢复备份是分开的；只回退旧程序不能自动撤销数据库迁移。详见仓库 UPGRADE_POLICY.md、DATA_MIGRATION.md。
禁用与卸载： 禁用仅停止功能，保留数据；卸载默认只移除代码，用户数据在安装包外。卸载前务必导出 Profile。
适合谁： 需要在 DSH 里做 Workspace 级「可观测、可规则化」状态与兴趣演化、并愿意用原生设置页运维的开发者或高级用户。
安全与权限： 插件以当前 DSH 进程权限运行，会读写配置与用户数据路径。安装前应阅读源码与 MIT 许可证，并理解社区目录（如 SkillHub 目录页）为独立站点，与 DeepSeek / 幻方无官方从属关系；DSH 生态本身是「一切皆插件」的扩展模型。
结尾¶
Amadeus State 把「当前 mood / energy / curiosity / 兴趣权重」和演化轨迹从对话里抽出来，落到 Workspace 绑定的持久层，并用 DSH 原生设置做检查与调规则。若你要对接同一 Amadeus 生态，可从项目主页继续选装其他集成插件。
