dsh-compact-provider — 压缩一体化入口

一句话：把自研压缩引擎（dsh-agent-compact）挂成宿主 compaction 服务，并注册 session_compact 工具原语——压缩何时发生由 agent 自主决策，框架零强制。

为什么值得用：压缩是"整合过去进现在"的存活操作——入口侧负责决策留痕与保命存档：每次调用自动先落一份健康 checkpoint（保活最后防线），再启动压缩；每次请求/拒绝/完成/失败都写进与引擎共用的自证轨迹，一条 tail 能答完五问。

设计形态（2026-09-14 定稿）：仅保留 session_compact 工具路径。曾并入的直触压缩已回退（主人「回退压缩插件版本」）——那套常设授权自动触发失败面成倍，且救不了「指令必达」这个引擎侧问题。本版 = 引擎 0.1.3 ↔ provider 0.2.0 的回退对。

定位与反定位

• 管：入口约束（reason 必填 → compaction seam 在位 → agent 上下文在位）、压缩前自动存档、请求侧留痕。
• 不管：压缩事务（投递/捕获/换血 → 引擎）；「什么时候压」的决策（→ agent 自主，本插件只提供原语）。
• 不是自动压缩：auto: false 不动；本插件无任何定时器/阈值触发。

能力

快速开始

# 预设行（与引擎成对挂载）
- id: compact-provider
  name: dsh-compact-provider
  config:
    thresholdRatio: 0.8
    retainRatio: 0.16
    auto: false        # 必须 false

安装走 self-plugins/ link 依赖 + 预设行（详见生态中心仓）。必须与 dsh-agent-compact 同挂同停——provider 单独拉起会在 seam 缺失时报错。

配置

复用引擎的完整 AgentCompactEngine.Config schema（thresholdRatio 0.8 / retainRatio 0.16 / modelPolicies [] / auto false 等，全表见引擎 README 与 docs/semantic.md §4.1）。本插件自身无独立配置——这是刻意的：入口与引擎共享同一批裁决参数，不存在两处漂移。

落盘与自证

每次 session_compact 调用，请求侧落这些阶段（与引擎侧 begin→queued→waited→surfaced→captured/abort 按 atMs 天然 join 成一笔事务）：

grep '"side":"provider"' "$DSH_HOME/compaction-trace.jsonl" | tail -3
# ② 谁发起 → agentId + commandId + reason      ⑤ 耗时 → waitedMs
# ③ 断在哪 → rejected（判据没过）vs failed（seam 抛错）vs completed（往下看引擎阶段）

判据单一真源：路径解析/序列化/追加实现全部从引擎转出（import { compactTrace } from 'dsh-agent-compact'），本插件不自己实现第二套。

生效判据与回退

生效判据：

1. 调一次 session_compact（空 reason 即可触发 rejected）→ grep '"phase":"rejected"' "$DSH_HOME/compaction-trace.jsonl" 应出现该行；
2. plugin_boot_status 的 liveNow 含本插件；
3. 行为级：真压缩一次 compaction/end 无 error + 上下文 token 实际下降。

重新构建 ≠ 生效；且注意 C7：新增源文件（如 src/trace.ts）不会出现在本插件 node_modules 里对引擎的 pnpm hardlink 副本中——改了引擎新增文件后必须先查消费方副本文件集再重启（预检会替你拦）。

回退：

• 源码级：git revert <commit> → 重建 → preflight_check（full）→ 重启；
• 组合级：disabled: true（引擎同步停）；
• 版本级：与引擎是回退对（0.2.0 ↔ 0.1.3），不可只回退一侧。

测试

npm test        # node --test "tests/*.test.mjs"

33 例离线测试：policy.test.mjs（前置判据 / best-effort 存档吞错 / 文案构造）+ trace-request.test.mjs（10 例：阶段条目构造、reason 摘要、agent 标识安全取用、serialize→parse 往返证明与引擎判据同源、两写者按 atMs join、尸体测试——父路径是普通文件时 appendTraceEntry 返回 false 且不抛）。

设计要点

• 压缩前自动存档（保命优先）：checkpoint 服务不可用或存档失败不阻塞压缩（压缩本身可重试）；存档失败只 warn。
• 不传 exec.signal：工具回合被打断（abort）会触发 agent 取消导致 seam 永不 resolve——用独立 controller 让压缩事务与工具回合解耦。
• 观测绝不反噬：compactTrace 返回 bool，一律忽略——它只影响证据，绝不影响压缩是否发生。

相关文档

License

MIT © jonah791

本插件属于爱丽丝 DSH 自研插件生态（见 alice-digital-life）。