前言¶
在 DSH 裏跑 Agent 時，模型上下文窗口、輸出上限和 compaction 預算往往要在 Settings → Models 和 Agent preset 裏手工對齊本地推理棧。若後端用的是 Strata Server，模型在服務端切換或 Strata 更新了已驗證的 context、輸出公式時，DSH 側仍可能沿用舊配置，長對話裏的 summary 觸發點也會和真實窗口脫節。
下面介紹社區插件 dsh-strata-sync（維護者 ethan741205）：在 DSH 設置頁裏讀取 Strata 當前加載的模型信息，預覽差異後備份並寫回 DSH 的自定義模型與壓縮策略。插件對 Strata Server 只讀，不會切換或加載服務端模型，也不會改服務端設置或發送探測推理請求。
這是什麼¶
dsh-strata-sync 是 DSH 的客戶端類插件（npm 包名 dsh-strata-sync，當前版本 0.12.11，MIT 許可證）。一句話定位：用原生設置 UI，把 DSH 連接到 Strata Server 裏已加載的模型，並在同一頁面管理模型參數與 summary 長度控制。
社區目錄頁：skillhub.cn/plugins/ethan741205/dsh-strata-sync。源碼與文檔：github.com/ethan741205/dsh-strata-sync。DSH 生態強調「一切皆插件」；SkillHub 等目錄爲社區站點，與 DeepSeek / 幻方無官方從屬關係。
核心功能¶
以下能力均來自項目 README，且與 0.12.x 行爲一致。
同步模型設置
- 上下文窗口、響應輸出上限，以及已確認的輸入類型與 reasoning 等級。
- 未在服務端確認的 capability 保留 DSH 原有值。
對齊 compaction 預算
- 更新已啓用 DSH Agent preset 中與之匹配的策略。
- 預覽中會展示 conversation budget、compaction headroom、summary output cap、有效 compaction 觸發閾值與 recent-content 保留比例，並說明計算公式。
控制 summary 長度
- 爲支持的 summary 請求附加可編輯的長度說明，並調整兩個目標長度比例（Dynamic summary target）。
- 0.12.11 起，summary guidance 支持原生圖片附件（含工具返回的圖片）；源長度與輸出空間估算會單獨計圖，且不改變原始消息與附件。
啓動與運行期檢測
- 可選：Automatically sync when DSH starts（默認關閉，下次啓動生效，運行中任務期間也只同步一次）。
- 插件激活後立即只讀檢查一次；之後每 60 秒比對 Strata 與 DSH 的模型及 context / 輸出 / capability；設置頁每 15 秒刷新展示狀態。檢測到變更或 mismatch 會告警，不會自動改進行中的會話。
審閱與恢復
- 流程：Check differences → Review changes → Back up and sync；可查看最近一次同步結果。
診斷與審計（較新版本）
- 原生會話診斷記錄每次計算的 summary 目標、指令是否應用及跳過原因；流式結果可關聯 DSH 既有 compaction 事件。
- 診斷使用固定類別標識不支持內容與無效字段；會話正文、圖片數據、附件路徑等不會寫入審計記錄。詳見倉庫內
SUMMARY_AUDIT.md、VALIDATION.md。
安裝與啓用¶
前置：Strata 連接
- 在 Strata Server 中加載模型。
- 在 DSH → Settings → Models 中爲該模型配置 OpenAI 兼容 provider、API URL 與憑據，並添加明確的 custom model 條目。
插件複用上述連接，無需在插件內再填 API key。
安裝插件
在 DSH 插件管理器中選擇 Add plugin，輸入：
dsh-strata-sync
或在結束當前任務並完全退出 DSH Desktop 後，使用官方 CLI：
dsh plugin --profile desktop add dsh-strata-sync --registry=https://registry.npmjs.org/
按需重新打開 DSH 以加載設置頁。若插件被禁用，在插件管理器中啓用即可。
典型用法¶
打開 Settings → dsh-strata-sync。主流程在頁面上方；Sync preferences 與可選的 Dynamic summary target 默認摺疊，展開後可改選項或編輯 supplemental prompt。
- 選擇 Strata provider，點擊 Save preferences。
- 點擊 Check differences，查看服務端加載模型與擬議變更。
- 點擊 Back up and sync。
- Start a new conversation，新的模型與 Agent preset 預算纔會生效；已有會話仍保留原模型路由與 preset 修訂。
若希望下次啓動自動對齊，開啓 Automatically sync when DSH starts 並保存。
Strata 側換模型後
使用 Check differences → Back up and sync，再開新會話。頁面上「最近一次同步結果」是歷史記錄，不能證明舊會話已使用新 budget。
輸出上限相關選項（摘要）
- 保持 Follow Strata output limit 開啓可自動選取；關閉後在 Advanced settings 下手工覆蓋。
- 無明確上限時，插件遵循 Strata 本地公式：
max(4096, min(32768, floor(context × 0.3)))（與 Strataprofile.mjs一致）。 - 啓用 Follow the loaded Strata model as the default 時，默認模型跟隨 Strata 當前加載的文本模型。
同步時通常設置 4096 token 的 summary output cap 與 compaction headroom；窗口較小時會按 README 規則壓到剩餘對話預算的一半（例如 8K 窗口下爲 2048）。
適用場景與注意¶
適合誰
- 本地或內網用 Strata Server 承載模型，希望在 DSH 裏少手工抄 context、輸出與 compaction 參數的智能體開發者。
- 需要在 Strata 換模型或升級後，用預覽 + 備份方式一次性更新 DSH 與多個 Agent preset 的場景。
- 關心長對話 summary 長度與 compaction 行爲，並願意在設置頁微調 supplemental prompt 與比例的用戶。
務必知曉
- 插件以當前 DSH 進程權限運行；安裝前請自行審閱 GitHub 源碼 與 MIT 許可證，勿安裝未信任來源的同名包。
- 運行期檢測不會自動同步；換模型後仍需手動 Back up and sync 並新開對話。
- 部分診斷依賴 DSH 實驗性 plugin-record API；不可用時不會阻斷 summary，但日誌可能減少。
- 包要求 Node >= 22（見
package.jsonengines），與 DSH Desktop 內置運行時由宿主負責，CLI 安裝路徑需滿足 DSH 插件管理要求。
結尾¶
dsh-strata-sync 把「Strata 裏實際加載的模型」與 DSH 的模型路由、壓縮預算和 summary 控制收攏到一頁設置裏，並在服務端變更時給出可操作的 diff 與備份同步路徑。進一步說明見倉庫 README（含 簡體中文）與 社區目錄頁。
