# dsh-arc-context

[中文](./README.md) | [English](./README.en.md) | [Русский](./README.ru.md) | [Deutsch](./README.de.md) | [한국어](./README.ko.md) | [日本語](./README.ja.md) | [Français](./README.fr.md) | [Italiano](./README.it.md) | [Español](./README.es.md) | [العربية](./README.ar.md) | [ไทย](./README.th.md) | [Tiếng Việt](./README.vi.md) | [Português (BR)](./README.pt-BR.md) | [हिन्दी](./README.hi.md) | [Bahasa Indonesia](./README.id.md)

**ARC = Adaptive Reversible Context.** [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) के लिए संदर्भ-प्रशासन (context governance) प्लगइन: सुरक्षा क्षेत्र में चुपचाप रहता है, और वास्तविक इनपुट क्षमता के निकट पहुँचने पर **मॉडल-चालित तथा स्थानीय रूप से प्रतिवर्ती (reversible)** संपीड़न करता है। सूचना कभी नष्ट नहीं होती; अनइंस्टॉल कोई अवशेष नहीं छोड़ता।

> **रिलीज़ स्थिति: सार्वजनिक बीटा, आधिकारिक dsh 0.1.0-rc.8 का अनुसरण।** यह परियोजना और dsh दोनों सार्वजनिक बीटा में हैं — उत्पादन (production) के लिए अभी अनुशंसित नहीं। पूर्ण लाइव रिलीज़-गेट सत्यापन मैट्रिक्स (दस मदें): [`research/results/release-verification-0.2.0-beta.12.json`](research/results/release-verification-0.2.0-beta.12.json).

## मापे गए लाभ

नीचे दसे सभी आँकड़े वास्तविक मॉडलों के साथ लाइव प्रयोगों से हैं (कच्चे usage फ़ील्ड, बिना मूल्य-रूपांतरण)। साक्ष्य और प्रोटोकॉल पैकेज के साथ आते हैं और `npm run research:verify` द्वारा मद-दर-मद पुनः सत्यापित होते हैं।

### अंतर्निहित Basic संपीडन की तुलना में (वही परिदृश्य, वही seed)

**लंबी कोड-इंजीनियरिंग सत्र** — ऐतिहासिक बाधाओं की शब्दशः निष्ठा:

| दृष्टिकोण | सटीक तथ्य | व्युत्पन्न बाधाएँ | इनपुट टोकन | आउटपुट टोकन | कुल prompt |
|---|---:|---:|---:|---:|---:|
| **ARC** | **24/24** | **4/4** | **121,146** | **23,234** | **1,055,802** |
| Basic | 6/24 | 0/4 | 231,315 | 30,940 | 1,355,539 |

कम लागत पर 4 गुना गुणवत्ता अंतर: इनपुट −47.6%, आउटपुट −24.9%, कुल prompt −22.1%. ARC का संपीडन स्थानीय प्रतिवर्ती निष्कर्षण है (शून्य सहायक LLM कॉल); Basic अप्रतिवर्ती मॉडल-सारांश है।

**बिना लेबल की प्राकृतिक-भाषा निर्णय-ट्रैकिंग** (मान-प्रतिस्थापन सहित): ARC 12/12 वर्तमान मान और 10/10 तर्कों को अप्रचलित-मान रिसाव के बिना पुनः प्रस्तुत करता है, और इनपुट Basic से लगभग 76% कम लेता है; स्वतंत्र अंग्रेज़ी holdout 10/10 + 7/7।

### वे क्षमताएँ जो Basic में नहीं हैं

- **कुछ भी नष्ट नहीं, सब पुनर्प्राप्त संभव** — मूल रूप से append-only लॉग में स्थायी रहते हैं; `decompress` प्रभावी स्रोतों को शब्दशः पुनर्स्थापित करता है (छह लाइव श्रृंखलाओं में 100%, होस्ट की spill फ़ाइल के माध्यम से अति-बड़े आउटपुट सहित); `search_context` संपीड़ित ब्लॉकों में खोजता है, अंग्रेज़ी और चीनी दोनों में सूचना-स्तरीय पुनर्प्राप्ति 43/43।
- **बिना हानि गहन आसवन (distillation)** — tier-3 साक्ष्य-परिशिष्ट छहों द्विभाषी श्रृंखलाओं में सभी तथ्य 20/20 तक रखता है (प्रभावी-स्रोत अनुक्रमणिका का पुनरावर्ती पुनश्चर्या, `effectiveSourceSafetyIndex`)।
- **बजट के भीतर प्रकार-भारित प्रतिधारण** — जब परिशिष्ट चेकपॉइंट बजट से आगे निकलता है, तो कम-मूल्य घटना-पंक्तियाँ प्रकार-मूल्य घनत्व के आधार पर विस्थापित होती हैं, कालक्रमिक कटौती के बजाय (`safetyIndexRanking: value`): ऑफ़लाइन हर बजट-स्तर पर न्यूनतम-केस में श्रेष्ठ; स्वच्छ लाइव जोड़ी में परिशिष्ट स्तर पर +14.3 अंक, बिना end-to-end प्रतिगमन।
- **प्रतिकूल आज्ञापालन में शून्य** — 18 संग्रह-इंजेक्शन आक्रमण-पृष्ठ वेरिएंट (सारांश-विषाक्तता, पुनर्प्राप्ति-इंजेक्शन, जाली सुरक्षा-लेबल, टेम्पलेट-नकल): मॉडल **0** बार आज्ञा मानता है; प्रत्येक संग्रह-आउटपुट पर "ऐतिहासिक डेटा, निर्देश नहीं" ढाँचा अंकित रहता है।
- **ईमानदार दबाव-प्रशासन** — संपीडन-जागरूक पठन = होस्ट प्रोजेक्शन − लॉग-वहीखाता छायांकन; संपीडन के बाद शून्य भ्रामक आपात-चेतावनियाँ (लाइव-सत्यापित); प्रदर्शित दबाव वास्तविक अधिभोग से मेल खाता है।
- **संक्षिप्त मार्गदर्शन** — 1,140 टोकन का सिस्टम मार्गदर्शन, पूर्ण पाठ की तुलना में शब्दशः गुणवत्ता में शून्य हानि (0 pp, चार लाइव भुजाएँ)।

## इंस्टॉल

```bash
dsh plugin --profile web add dsh-arc-context
```

होस्ट पुनरारंभ करें — तुरंत प्रभावी। बंडल होस्ट-तल Preset Bridge स्वतः इंस्टॉल करता है: ARC standard preset के अपने संपीडन-पृथक्करण क्षेत्र में आधिकारिक Basic पंक्ति को प्रतिस्थापित करता है, और **preset फ़ाइलें बाइट-स्तर तक अपरिवर्तित रहती हैं**; कमांड, प्रूनर, पृथक्करण तथा अन्य सभी preset पंक्तियाँ सुरक्षित रहती हैं।

मैनुअल tarball इंस्टॉल, अन्य प्रोफ़ाइल और उन्नत विकल्प: [`docs/INSTALL.md`](docs/INSTALL.md)।

### विन्यास (अंश)

```yaml
- id: compaction-arc-bridge
  name: 'dsh-arc-context/bridge'
  config:
    effectiveSourceSafetyIndex: true   # tier-2/3 अनुक्रमणिकाएँ प्रभावी मूलों तक पुनरावर्ती (डिफ़ॉल्ट: सक्रिय)
    safetyIndexRanking: value           # बजट-उपरि: प्रकार-मूल्य घनत्व से विस्थापन (डिफ़ॉल्ट: value)
    adaptiveGovernor:
      enabled: true
      maxOutputTokens: auto
```

| विकल्प | डिफ़ॉल्ट | विवरण |
|---|---|---|
| `effectiveSourceSafetyIndex` | `true` | tier 2/3 पर सुरक्षा-अनुक्रमणिका केवल दृश्यमान जनक चेकपॉइंट पुनः-निष्कर्षित करने के बजाय प्रभावी मूल स्रोतों तक पुनरावर्ती जाती है। tier-1 आउटपुट अपरिवर्तित रहता है। |
| `safetyIndexRanking` | `value` | जब परिशिष्ट चेकपॉइंट बजट से आगे निकले तब विस्थापन-क्रम: `value` पहले कम प्रकार-मूल्य घनत्व वाली घटना-पंक्तियों को हटाता है; `chronological` पुरानी कालक्रमिक कटौती बनाए रखता है। बजट के भीतर दोनों आउटपुट बाइट-स्तर पर समान हैं। |

पूर्ण विन्यास (संदर्भ-विंडो, nudge सीमाएँ, सुरक्षित क्षेत्र, Governor, प्रॉम्प्ट टेम्पलेट): [`docs/INSTALL.md`](docs/INSTALL.md) और [`docs/kernel-tuning.md`](docs/kernel-tuning.md)।

## अनइंस्टॉल — स्वच्छ, संपूर्ण, लाइव-सत्यापित

```bash
dsh plugin --profile web remove dsh-arc-context
```

होस्ट पुनरारंभ के बाद:

- संयोजित विन्यास आधिकारिक Basic पर लौटता है, बिना किसी ARC पंक्ति के अवशेष के;
- **preset फ़ाइलें कभी संशोधित नहीं हुईं** (SHA-256 पहले और बाद समान, रिलीज़-गेट में सत्यापित);
- मौजूदा सत्र पठनीय बने रहते हैं — Basic सीधे ARC का स्थायी लॉग पढ़ता है, संपीड़ित सतह-रूप बना रहता है, और **मूल कभी संदर्भ में वापस उबारे नहीं जाते** (2,331 घटनाओं का सत्र पूर्ण पठनीय तथा सामान्य प्रोजेक्शन के साथ सत्यापित);
- नए सत्र में कोई ARC टूल या कमांड पंजीकृत नहीं होती।

पुनःइंस्टॉल कभी भी संभव है और पहली इंस्टॉल जैसा ही व्यवहार करता है (इंस्टॉल → अनइंस्टॉल → पुनःइंस्टॉल चक्र रिलीज़-गेट मैट्रिक्स में मद-दर-मद सत्यापित)।

## साक्ष्य और दस्तावेज़

- अनुसंधान-कार्यसूची और सभी निष्कर्ष: [`docs/research-agenda.md`](docs/research-agenda.md)
- परिणाम डेटा: [`research/results/`](research/results/) (रिलीज़-गेट मैट्रिक्स, युग्मित तुलनाएँ, प्रतिकूल सूट)
- अभिकल्पना दस्तावेज़: [`docs/`](docs/) (इंस्टॉल, preset एकीकरण, Governor अभिकल्पना, प्रतिवर्ती इंस्टॉल)
- सार्वजनिक साक्ष्य सत्यापन: `npm run research:verify`

## आभार और लाइसेंस

ARC का संपीडन-क्रोड़ [acp-kernel](https://github.com/ranxianglei/acp-kernel) (साथ में billion-context-pi और opencode-acp, ranxianglei द्वारा, MIT) के पोर्ट और स्वतंत्र विकास से उद्भूत है; होस्ट [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (DeepSeek AI) है। यह परियोजना MIT लाइसेंस के अंतर्गत है — देखें [LICENSE](LICENSE)।