dsh-active-context-pruning 让 DeepSeek Harness 的模型自己决定哪些历史值得压缩、自己写检查点摘要，再通过官方 ctx.compaction.compactRegion 从下一次请求的表层中隐藏这段历史。 这不是官方 @deepseek-ai/dsh-acp；后者指 Agent Client Protocol。本插件只复用 DSH 已有的 compaction 事务，不修改原始 session.events。 ## 功能 | 工具 | 作用 | |---|---| | acp_status | 用量、表层 seq 表、检查点 | | acp_compress | 用模型提供的 summary 替换一个表层 seq 范围 | | acp_decompress | 读取被隐藏的原文；不撤销表层替换 | | acp_search | 搜表层和已压缩原文 | /acp 是给人看的状态命令。工具使用 DSH 的表层 seq，不是 OpenCode 的 m00001。 官方 dsh-compaction-basic 自动压缩仍可作为兜底。若只想让模型主动压缩，可在 profile 中将其 auto 设为 false。 ## 配置与限制 - 解压不能撤销 replace。原文仍在 session.events，只作为工具结果返回。 - 不能压最新 preserveRecent 条表层（默认 2，含当前未闭合工具调用）。 - 范围必须工具配对平衡，摘要必须比被藏内容短，否则官方引擎会拒绝。 ## Config yaml - id: active-context-pruning config: enabled: true minContextLimit: "60%" maxContextLimit: "70%" preserveRecent: 2 minTokens: 200 nudge: true config 是 profile patch 行的完整替换，不是深合并；修改时请保留所有需要的键。 ## 安装 官方 CLI 的正确格式是 dsh plugin --profile <profile> add <source>。Desktop 默认使用 web profile；如果使用其他 profile，请替换 web。 sh # 最新 main dsh plugin --profile web add github:aerince/dsh-active-context-pruning # 可复现安装：v0.1.0 release dsh plugin --profile web add github:aerince/dsh-active-context-pruning#v0.1.0 # 不可变 commit pin dsh plugin --profile web add github:aerince/dsh-active-context-pruning#5ecc5eb1c0380fd6d0b3be1354f1ba3b1405b37f 本包是零构建 JavaScript，没有 prepare，不需要为它添加 pnpm allowBuilds。安装前提是可用的 dsh、pnpm 和 git。没有 CLI 时，可在 Desktop 插件面板粘贴同一个 github: source spec。 DSH 会把插件写入 $DSH_HOME/profiles/<profile>；请确认 CLI 与 Desktop 使用的是同一个 DSH home。安装后重启 DSH。 ## 验证与卸载 sh dsh --profile web --dump-config # 在源码目录运行纯函数自检（可选） node check.js 配置树中应出现 active-context-pruning；新会话中应出现 acp_* 工具和 /acp。实际调用 acp_compress 前，还需要加载提供 ctx.compaction.compactRegion 的 @deepseek-ai/dsh-compaction-basic。 ## 卸载 sh dsh plugin --profile web remove dsh-active-context-pruning ## DSH 官方安装对照 本仓库按 DSH 当前官方基线（deepseek-ai/deepseek-harness commit 47f943859bef60e4160492346772ded9b24f765a）核对： | 官方要求 | 本项目 | |---|---| | 普通 package entry | package.json → index.js | | dsh.bundle.patch | 已配置 ./cordis.patch.yml | | YAML patch 的 name 可解析 | dsh-active-context-pruning 与 package name 一致 | | Git source 可直接安装 | 零构建 JS，无 prepare | | profile 安装命令 | 使用 dsh plugin --profile web add github:... | | 安装后验证 | 使用 dsh --profile web --dump-config | 官方参考：https://github.com/deepseek-ai/deepseek-harness/blob/master/docs/user/develop/basic/publish.zh.md、https://github.com/deepseek-ai/deepseek-harness/blob/master/apps/cli/src/plugin.ts。 ## 安全与权限 插件是 host plugin，需要 tools；自身不发起网络请求，也没有 prepare 安装脚本。它通过 DSH compaction API 替换表层范围，原始事件仍保存在 session log 中。 ## License MIT