Back to directory

billion-context-dsh

Curated pickMaintenance: Active

tyan66666/billion-context-dsh

Model-driven context management (Active Context Pruning / ACP) for the DeepSeek Harness — the model decides when and what to compress. Ported from billion-context-pi (ranxianglei); acp-kernel reused verbatim. CompactionEngine backend with compress/decompress/search_context/acp_status tools.

View on GitHubHomepage
$ dsh plugin --profile web add billion-context-dsh

118

stars

20

forks

TypeScript

Language

MIT

License

2026-08-13

Created

2026-09-28

Last push

MIT-licensed native DSH plugin providing model-driven Active Context Pruning (ACP): the model writes high-fidelity summaries, reclaims context space, and keeps compressed blocks recoverable and searchable.

DSH integration

Native runtime

Author-claimed

Safety audit

Unaudited

Last verified

2026-08-30

License

MIT

01What can it help you accomplish?

  • Keep long DeepSeek Harness conversations from exhausting context by letting the model decide when and what to compress

    High-fidelity, model-written summaries (file paths, decisions, errors preserved) that reclaim context space; compressed blocks stay recoverable via `decompress` and searchable via `search_context`

    Developers and agent workflows running long or very-large-context tasks on DeepSeek Harness

  • Carry very long agent tasks to completion with conclusions compounding across turns

    Each step builds on prior results; key conclusions stay available and keep compounding while context stays lean

    Engineering and agent workflows that span many turns and very large contexts

02How to install into DeepSeek Harness

Prerequisites

  • DeepSeek Harness (dsh) installed and running — this plugin is a DSH CompactionEngine backend
  • Config lives under `~/.dsh`; first install needs a one-time file-write permission approval (stated in README)

Installation steps

  1. 01

    Install from the DSH plugin store or run `dsh plugin --profile web add billion-context-dsh`

    $ dsh plugin --profile web add billion-context-dsh

  2. 02

    Restart `dsh` (the bundle layer composes at startup), then open a new session

    $ dsh

Verify the integration

  • In a new session, have the model call `acp_status` or run `/acp status` to prove the mount

03DSH integration and capability boundaries

DSH integrationNative runtime

Native CompactionEngine backend for DeepSeek Harness — install via `dsh plugin`, the ACP bundle patch auto-mounts on the host plane and registers the compress / decompress / search_context / acp_status model tools plus the `/acp` command for every mode.

  • Model-driven `compress` tool

    a seq range of the session context→a high-fidelity, model-written summary that becomes a checkpoint node; originals stay in the append-only log

    compress range is persisted to the append-only session log (surfaceOp: replace)originals are shadowed but retained and recoverable via `decompress`
  • `acp_status` context ledger

    optional scope / view / tool / sort / limit drill-down params→CONTEXT BREAKDOWN + compressed-block ledger + nudge decision lines + Checkpoint seqs

  • `decompress` recovery and `search_context` retrieval

    `bN` or compaction id from `acp_status` (decompress); a keyword (search_context)→`decompress` restores a compressed block's originals read-only; `search_context` returns matching block summaries and originals

    `decompress` is a read-only restore that does not modify the log

04Who is it for? When not to use it?

Good for

  • Developers and agent workflows running long or very-large-context tasks on DeepSeek Harness
  • Engineering and agent workflows that span many turns and very large contexts

Not for

  • Declares a peer dependency on `@deepseek-ai/dsh-compaction` (`^0.1.0-rc.6 || ^0.1.1-rc.1`); it must match a supported DSH version. Older published packages fail to install on DSH 0.1.1-rc.x and need the fixed release.
  • Two `ctx.compaction` backends must not coexist in the same realm — you must disable host `compaction-basic` or the two backends conflict; keep exactly one context manager per agent.
  • Both this plugin (v0.2.13) and DeepSeek Harness are in public beta; the README explicitly warns against production use and expects breaking changes.

05Compatibility, maintenance and safety notes

  • Declares a peer dependency on `@deepseek-ai/dsh-compaction` (`^0.1.0-rc.6 || ^0.1.1-rc.1`); it must match a supported DSH version. Older published packages fail to install on DSH 0.1.1-rc.x and need the fixed release.
  • Two `ctx.compaction` backends must not coexist in the same realm — you must disable host `compaction-basic` or the two backends conflict; keep exactly one context manager per agent.
  • Both this plugin (v0.2.13) and DeepSeek Harness are in public beta; the README explicitly warns against production use and expects breaking changes.
2026-08-132026-08-26v0.2.13

MIT · actively maintained (latest release v0.2.13, 2026-08-25)

06Frequently asked questions

How do I install billion-context-dsh into DeepSeek Harness?

Install from the DSH plugin store or run `dsh plugin --profile web add billion-context-dsh`, then restart `dsh` (the bundle layer composes at startup) and open a new session. The ACP bundle patch auto-mounts. Verify by having the model call `acp_status` or run `/acp status`.

Does it replace DSH's built-in auto-compaction?

No. It adds a model-driven ACP backend alongside DSH's built-in `compaction-basic`. You must disable host `compaction-basic` to avoid two `ctx.compaction` backends conflicting in the same realm; keep exactly one context manager per agent.

What model tools does it expose?

Four tools — `compress`, `decompress`, `search_context`, `acp_status` — plus the `/acp` slash command, all mounted on the host plane for every mode (standard / code / minimal / cordis / custom presets).

Is it production-ready?

No. Both this plugin (v0.2.13) and DeepSeek Harness are in public beta; the README explicitly warns against production use and expects breaking changes.

Can compressed context be recovered?

Yes. Compressed ranges become checkpoint nodes and originals stay in the append-only session log, so `decompress` restores them read-only and `search_context` searches block summaries and originals.

08Data and sources

  • Author-claimedgithub.com7dad1181bd5f…

    DSH 商店 / `dsh plugin` 一键装(bundle)——装完即全局生效,零配置。

  • Author-claimedgithub.com7dad1181bd5f…

    dsh plugin --profile web add billion-context-dsh

This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-08-30. Found an error? Submit a correction.

🏆

Best DeepSeek Harness Plugins

Twelve plugins worth installing first — picked from the whole catalog, across every category.

DSH Plugins is an independent community directory of DeepSeek Harness plugins. Not affiliated with or endorsed by DeepSeek. Third-party plugins are not security-audited — review the source before installing.

New DeepSeek Harness plugins, weekly. No spam.