dsh-better-compact

把压缩从黑盒变成可观察、可调节的过程，并让每一档设置立即反映到过程图。

Better DSH 插件集合 · 安装 · 它拥有什么 · 设置 · 与 Better DSH 的关系

它做什么

• native / goal / file-handoff / custom 四种模式（custom 提示词默认填入 goal 指令模板）
• 预算、阈值、headroom 与保留策略
• 摘要模型 / 路由 / 输出预留
• 只读诊断与实时过程可视化

安装

# 只安装这个插件
dsh plugin --profile <profile> add dsh-better-compact@0.4.1

# 或安装 Better DSH（会自动带上所有独立插件）
dsh plugin --profile <profile> add dsh-better-dsh@0.10.0

安装 / 升级 / 换包后必须重启对应 profile；只刷新网页不够。

它拥有什么

稳定行 id	dsh-better-compact + dsh-better-compact-engine
入口 / 工具	压缩引擎行 · /better-compact/api/inspect · 压缩设置页
设置	模式、auto、阈值 / headroom / 保留、摘要模型、重试、模型规则
npm 包	dsh-better-compact@0.4.1
仓库	https://github.com/omdsh-dev/dsh-better-compact

设置

可以在 Plugins 页的 dsh-better-compact + dsh-better-compact-engine 行设置，也可以在 Better DSH 详情页的「集成设置」里打开同名页面。两个入口共用同一份配置和同一个设置组件，不会产生第二份存储。

• 引擎使用载入时冻结的快照；保存设置后需要重载 profile 才会被采用。
• Better DSH 的两套工程预设内直接带 engine 行；移除独立 bundle 不会移除它。

与 Better DSH 的关系

• 同一个稳定行：独立安装或由 dsh-better-dsh 装配，行 id 和设置命名空间都不变。
• 旧入口兼容：早期 Apollo 集成使用的行配置键仍然注册，指向同一份配置。
• 可以单独使用：不安装 Better DSH 也能工作；只是不会得到工程预设、流程技能或后台 job 守卫。
• Apache-2.0：本仓库与 Better DSH 的其他仓库统一使用 Apache License 2.0。

开发

npm test        # 单元 / 组件测试
npm run smoke   # 如仓库提供运行时冒烟

实现与测试说明见 docs/DEVELOPMENT.md。

许可

Apache License 2.0。