DeepSeek Harness (DSH) 采用插件化架构。默认配置可能无法满足所有场景需求。dsh-malko-prefs 是一个个人偏好配置，作为官方压缩引擎的可调伴侣，为模型页面丰富 llama.cpp 元数据，并提供标签页状态指示器。
插件介绍¶
这是一个为 DeepSeek Harness (DSH) 提供个人偏好的插件，由 malko 维护。它主要解决三个具体问题：提供比官方引擎更灵活的压缩控制、补充 llama.cpp 模型元数据以完善 Models 页面、以及通过标签页颜色和浏览器通知提供会话状态反馈。
核心功能¶
压缩引擎增强¶
官方的 @deepseek-ai/dsh-compaction-basic 引擎是参考行为。此插件将其包装在一个设置页面中，允许你调整以下参数：
* 阈值：支持绝对 Token 数（如 130k）或相对于上下文窗口的比例（如 0.8）。
* 保留策略：配置保留最近上下文的绝对 Token 数或比例。
* 摘要配置：选择摘要模型（默认使用 Session 模型或自定义模型），并设置推理级别。
* 行为控制：开启“回合结束压缩”，并在摘要输出上限、额外压缩尝试等高级选项中进行微调。
* 命令：新增 /force-compact 命令用于手动触发压缩。
llama.cpp 模型丰富¶
插件读取 llama.cpp 服务器暴露的丰富模型元数据（如 meta.n_ctx、architecture.input_modalities、aliases），并将其填充到 llm-pi-ai 的模型条目中，自动填充上下文窗口和文本/图像输入模态性信息。
通知与标签页指示器¶
- 标签页状态灯：浏览器标签页图标颜色会根据会话状态变化：
- 琥珀色：会话等待你处理（提问/审批）。
- 蓝色：会话正在运行。
- 绿色：主会话在你离开时已完成。
- 系统通知：浏览器通知功能，支持不同类型（会话完成、等待中）独立开关、屏幕停留时间设置及音效。
安装与启用¶
通过 DSH 官方注册表安装：
dsh plugin --profile web add dsh-malko-prefs
安装后，重启 dsh web 即可生效。
典型用法¶
- 手动压缩：在聊天界面直接输入
/force-compact强制执行压缩。 - 导入模型：进入插件设置中的“llama.cpp models”标签页，点击“Fetch from server”读取服务器模型列表，勾选需要导入的模型并点击“Import”。
注意事项¶
- 版本要求：需要 DSH 版本
>= 0.1.7-rc.1。 - 依赖：需要可用的
llm-pi-ai提供者（例如你的 llama.cpp 服务器）以支持模型丰富功能。 - 预设覆盖：插件会重述所有内置的代理预设（
preset-cordis,preset-ptc,preset-standard），将其压缩后端指向dsh-malko-prefs/compaction。 - 生成文件：补丁文件（
cordis.patch.yml）由脚本自动生成，非手写，因此代码逻辑可能较为紧凑。 - 风险提示：插件以当前 DSH 进程权限运行，使用前请检查源码，注意潜在的安全风险。
总结¶
dsh-malko-prefs 旨在为 DSH 用户提供一个更精细的控制面板，特别是针对上下文压缩和模型元数据管理。它通过 MIT 许可证开源，适合希望深入定制代理行为和监控会话状态的进阶用户。
