dsh-minimal-mode-compaction
为 DeepSeek Harness 极简模式增加自动上下文压缩、/compact、/context 和模型主动压缩，解决极简模式长任务无法持续工作的问题。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:wicm84266964/dsh-minimal-mode-compaction#0cae9aae278de07cba52044190824ad007bd2a9bMinimal Mode Compaction 以 dsh-minimal-mode-compaction 发布，当前版本为 0.2.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
为 DeepSeek Harness 的极简风格 agent 增加长会话所需的三种压缩路径：
compaction-basic 的 token 压力自动压缩和上下文溢出恢复；/compact；compact_now，由插件排队到当前回合结束后执行。本项目不复制官方压缩引擎。它只提供一个用户 preset 和一个调度工具，底层复用 DSH 自带的 dsh-compaction-basic、dsh-command-compact 和 dsh-compaction-tool-result-pruner。
它还注册一个 /context 命令：直接输入 /context 显示当前有效上下文窗口，输入 /context 256k、/context 1m 或纯 token 数值时写入 DeepSeek 模型设置。命令写入的是 DSH 原生 llm-deepseek 设置，后续请求实时使用新容量；自动压缩仍按 preset 的阈值比例计算。
公开生态里已经有相近项目：
wangxiang0605qvq/dsh-auto-compact 只有模型主动调度工具，要求 preset 已经挂载 compaction-basic；songoao25/dsh-auto-compact 只给已有压缩引擎调整阈值，并跳过出厂 minimal；KitDoesIt/dsh-compaction-instant 是另一个无模型压缩引擎，也需要用户把压缩能力挂进 preset。本项目的目标是把官方 minimal 的工具组合原样保留，只增加一个可选择的 minimal-compaction 用户 preset，因此不修改 DSH 出厂文件，也不替换摘要引擎。
用户只需要执行一次下面的命令：
npx --yes github:wicm84266964/dsh-minimal-mode-compaction
安装器会自动完成以下步骤：
web profile；minimal-compaction preset；agent-presets.default 设置为 minimal-compaction。安装结束后重启 DeepSeek Harness。已有会话不会中途切换 preset，重启后新建的会话会默认使用 minimal-compaction。用户不需要再手动执行 dsh plugin、pnpm install 或 preset 安装命令。
安装器默认把 profile 依赖指向 GitHub 仓库，而不是 npx 的临时目录；因此 Linux/WSL 使用 npx 部署不会因为 npx 缓存清理而失效。系统有 dsh 时会复用它；没有独立 dsh 命令时会自动调用 npx @deepseek-ai/dsh。如果没有可直接调用的 pnpm，还会自动回退到 npx pnpm。
如果不希望安装器修改默认 preset，可执行：
npx --yes github:wicm84266964/dsh-minimal-mode-compaction --no-default
这时安装仍然自动完成，但需要在 Harness 中手动选择 minimal-compaction。
从源码运行安装器时，默认使用当前 checkout：
node scripts/install.mjs
也可以显式指定 profile、DSH_HOME 或安装来源：
node scripts/install.mjs --profile web --dsh-home "$DSH_HOME" \
--source file:/mnt/c/saveproject/LBJ-workspace/open-source/dsh-minimal-mode-compaction
重复安装时，已有 preset 会先改名为带时间戳的 .backup-* 目录，再安装新版本。若要保留已有 preset 内容，增加 --keep-preset；先预览将使用的路径可以执行 node scripts/install.mjs --dry-run。
只有在一键安装失败、需要逐步查看 profile 状态时，才需要手动执行：
dsh plugin --profile web add github:wicm84266964/dsh-minimal-mode-compaction
cd "$DSH_HOME/profiles/web"
pnpm install --config.auto-install-peers=true
node /path/to/dsh-minimal-mode-compaction/scripts/install-preset.mjs \
--dsh-home "$DSH_HOME" --force
然后重启 DSH，在 agent preset 选择 minimal-compaction（显示名：DeepSeek Harness 极简模式长会话）。
DeepSeek Harness 当前没有独立的官方插件市场或审核提交入口。官方插件机制以 GitHub/npm 包为分发来源，用户通过 dsh plugin add 安装；本项目优先使用 GitHub 发布，后续如有需要再同步发布 npm 包。
插件不会把模型上下文强行设成 1M，也不会覆盖用户的模型设置。compaction-basic 使用 DSH 最终解析的模型容量：
llm-deepseek.models[] 中该模型的 contextWindow；llm-deepseek.defaultContextWindow；Web UI 中的位置是：设置 → 模型 → DeepSeek → 编辑模型 → 容量/高级 → 上下文窗口。
也可以直接参考 settings.example.yaml，例如把 V4 Pro 的有效窗口设为 256K：
llm-deepseek:
defaultContextWindow: 262144
models:
- id: deepseek-v4-pro
contextWindow: 262144
maxTokens: 65536
注意：models 是模型目录配置；如果原设置中还有其他模型，编辑时要保留它们。精确模型的 contextWindow 优先于默认值，随后自动压缩按这个容量计算。
contextWindow 是输入和输出的合计预算；如果把它降到 256K，建议同时把 maxTokens 调到一个和任务相容的值，避免输出上限本身占满预算。插件不会擅自修改这两个模型设置。
生成的 preset 默认配置为：
| 设置 | 默认值 |
|---|---|
| 自动压缩阈值 | 有效上下文窗口的 75% |
| 原文保留尾部 | 有效上下文窗口的 20% |
| 摘要输出上限 | 8192 tokens |
| 上下文溢出恢复 | 最多重试 1 次 |
这些值位于用户 preset 的 agent.cordis.yml，可以按需调整。工具结果剪枝默认保留 4096 字符头部和 1024 字符尾部。
npm test
npm run check
当前包只要求 DSH 运行时提供官方 peer dependencies；不要在本项目内复制官方 compaction-basic 源码。
维护者发布新版本时：
package.json 的版本号，例如 0.3.0；docs/releases/0.3.0.md，填写本版本说明；main，等待 GitHub Actions 的 CI 通过；Actions > Create release 中运行 workflow，填写 v0.3.0 和是否为预发布版本。发布 workflow 会拒绝重复的 tag/release，并检查当前 commit 的 CI check-runs；通过后由 GitHub Actions 创建不可变 tag 和 Release。不要直接在本地手动创建 release。