前言¶
在 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 生態，可從項目主頁繼續選裝其他集成插件。
