前言¶
在 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（含 简体中文）与 社区目录页。
