dsh-plugin-guide 0.4.4 → 0.4.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (10) hide show
  1. package/README.en.md +370 -0
  2. package/README.es.md +370 -0
  3. package/README.hi.md +370 -0
  4. package/README.md +334 -52
  5. package/README.pt.md +370 -0
  6. package/docs/assets/dsh-plugin-guide-flow-dark.svg +35 -0
  7. package/docs/assets/dsh-plugin-guide-flow-light.svg +35 -0
  8. package/docs/rules.md +2 -2
  9. package/package.json +1 -1
  10. package/README-zh.md +0 -82
package/README.hi.md ADDED
@@ -0,0 +1,370 @@
1
+ <div align="center">
2
+
3
+ <picture>
4
+ <source media="(prefers-color-scheme: dark)" srcset="docs/assets/dsh-plugin-guide-flow-dark.svg">
5
+ <img src="docs/assets/dsh-plugin-guide-flow-light.svg" width="100%" alt="dsh-plugin-guide, असेंबली और रूटिंग: cordis.patch.yml एक पंक्ति जोड़ता है → index.js ctx.skills.register से स्किल दर्ज करता है → SKILL.md का बॉडी → तीन परतों के लिए docs/levels.md → निर्णय के लिए dsh-standards का dsh-levels">
6
+ </picture>
7
+
8
+ # dsh-plugin-guide
9
+
10
+ **बनाने से पहले सही सवाल पूछें: किसी DSH प्लगइन की ENTRY / FLOW / BOOST परतें साफ़ करें, और निर्णय उसी टूल को दें जो वास्तव में जाँच चलाता है।**
11
+
12
+ DSH प्लगइनों के लिए गाइड परत — बताती है क्या जाँचना है, क्यों मायने रखता है, और निर्णय किस टूल का है; यह खुद प्रमाणन, स्कोरिंग या रैंकिंग नहीं करती, बस जाँचें `dsh-standards` तक पहुँचाती है।
13
+
14
+ [इंस्टॉल](#तीन-चरणों-में-शुरुआत) · [कॉन्फ़िगरेशन](#कॉन्फ़िगरेशन) · [FAQ](#faq) · [简体中文](README.md) · [English](README.en.md) · [Español](README.es.md) · [Português](README.pt.md) · [हिन्दी](README.hi.md)
15
+
16
+ [![License](https://img.shields.io/badge/license-Apache--2.0-3366CC?style=flat-square&labelColor=2B3245)](LICENSE)
17
+ [![DSH](https://img.shields.io/badge/DSH-%E2%89%A50.2.2%20%3C0.3.0-4B67B4?style=flat-square&labelColor=2B3245)](#संगतता)
18
+ [![npm](https://img.shields.io/npm/v/dsh-plugin-guide?style=flat-square&labelColor=2B3245&color=CB3837)](https://www.npmjs.com/package/dsh-plugin-guide)
19
+ [![CI](https://img.shields.io/github/actions/workflow/status/PerryLink/dsh-plugin-guide/verify.yml?branch=main&label=CI&style=flat-square&labelColor=2B3245)](https://github.com/PerryLink/dsh-plugin-guide/actions/workflows/verify.yml)
20
+ [![Node](https://img.shields.io/badge/node-%3E%3D24.9-339933?style=flat-square&labelColor=2B3245)](#संगतता)
21
+
22
+ [![Stars](https://img.shields.io/github/stars/PerryLink/dsh-plugin-guide?style=flat-square&labelColor=2B3245)](https://github.com/PerryLink/dsh-plugin-guide/stargazers)
23
+ [![npm downloads](https://img.shields.io/npm/dm/dsh-plugin-guide?style=flat-square&labelColor=2B3245&color=CB3837)](https://www.npmjs.com/package/dsh-plugin-guide)
24
+ [![Gitee](https://img.shields.io/badge/Gitee-mirror-C71D23?style=flat-square&labelColor=2B3245&logo=gitee)](https://gitee.com/perrylink/dsh-plugin-guide)
25
+
26
+ ```sh
27
+ dsh plugin --profile web add dsh-plugin-guide
28
+ ```
29
+
30
+ </div>
31
+
32
+ <sub>समुदाय गाइड, DeepSeek से संबद्ध नहीं; यह प्रमाणन, रैंकिंग या सुरक्षा ऑडिट नहीं है। मुख्य रेपो: <https://github.com/PerryLink/dsh-plugin-guide> (Gitee केवल-पढ़ने वाला स्नैपशॉट है)।</sub>
33
+
34
+ ## यह क्या है
35
+
36
+ `dsh-plugin-guide` DSH प्लगइनों की **गाइड परत** है: यह बताती है क्या जाँचना है, क्यों मायने रखता है, और निर्णय किस टूल का है। इंस्टॉल होने पर यह माँगने पर लोड होने वाली एक एजेंट स्किल दर्ज करती है जिसका बॉडी `SKILL.md` है; उस बॉडी के सापेक्ष संदर्भ (`./docs/...`) डायरेक्टरी `resourceBase` के ज़रिए इसी पैकेज के अंदर हल होते हैं। यह प्रमाणन नहीं करती, स्कोर नहीं देती और रैंक नहीं करती: जाँचें `dsh-standards` में हैं, नियम-पाठ `dsh-plugin-spec` में, और बिल्ड/स्कैफ़ोल्ड `dsh-primer` का काम है।
37
+
38
+ | पैकेज | भूमिका |
39
+ |---|---|
40
+ | **`dsh-plugin-guide`** | यह पैकेज: गद्य गाइड, तीन-परत नक्शा और एजेंट स्किल |
41
+ | **`dsh-standards`** | निष्पादन छत्र: ENTRY/FLOW जाँचें, `dsh-levels` ऑडिट और स्पेक फ़ाइलें |
42
+ | **`dsh-plugin-spec`** | निम्न-स्तरीय नियम-पाठ और धारा स्रोत |
43
+ | **`dsh-primer`** | पुरानी बिल्ड/स्कैफ़ोल्ड स्किल और CLI (पूर्व `dsh-plugin-guide` 0.3.x) |
44
+
45
+ ## तीन चरणों में शुरुआत
46
+
47
+ 1. **इंस्टॉल करें** (कोई एक चैनल चुनें):
48
+
49
+ ```sh
50
+ # git चैनल (नवीनतम main)
51
+ dsh plugin --profile web add github:PerryLink/dsh-plugin-guide
52
+ # npm चैनल (प्रकाशित संस्करण)
53
+ dsh plugin --profile web add dsh-plugin-guide
54
+ # tarball चैनल: इस रेपो में npm pack के बाद
55
+ dsh plugin --profile web add ./dsh-plugin-guide-<version>.tgz
56
+ ```
57
+
58
+ कोई बिल्ड चरण नहीं: `index.js` ही प्रकाशित आर्टिफ़ैक्ट है, और `SKILL.md` तथा `docs/` ही स्किल बॉडी हैं।
59
+
60
+ 2. **एक बार स्किल माँगें** (स्किलें माँगने पर लोड होती हैं, कभी स्थायी प्रॉम्प्ट नहीं):
61
+
62
+ ```text
63
+ > dsh-plugin-guide से ./my-plugin की समीक्षा करें: पहले ENTRY निर्णय, फिर बताएँ कौन-सी परतें not-run हैं।
64
+ ```
65
+
66
+ 3. **प्रभावी हुआ सत्यापित करें**:
67
+
68
+ ```sh
69
+ dsh --profile web --dump-config | grep -A2 'id: dsh-plugin-guide'
70
+ ```
71
+
72
+ सेशन स्किल कैटलॉग में `dsh-plugin-guide` दिखना चाहिए, और लोड हुआ बॉडी `docs/levels.md` की ओर इशारा करना चाहिए (`package.json#dshWorkshop.capability.expected` में दर्ज स्वीकृति रूप)।
73
+
74
+ **अनइंस्टॉल**: `dsh plugin --profile web remove dsh-plugin-guide` (या प्रोफ़ाइल पैच से वह पंक्ति हटा दें)। रजिस्ट्रेशन Cordis effect है, इसलिए अनलोड करते ही हट जाता है और कुछ शेष नहीं छोड़ता।
75
+
76
+ ## मुख्य क्षमताएँ
77
+
78
+ - **तीन-परत नक्शा** — ENTRY पूछती है «क्या इसे पहचाना, इंस्टॉल और शुरू किया जा सकता है?», FLOW पूछती है «क्या उपयोगकर्ता इसे इंस्टॉल, कॉन्फ़िगर, उपयोग, अपग्रेड और हटा सकता है?», और BOOST पूछती है «क्या यह Cordis का अच्छा उपयोग करता है?»। तीन पटरियाँ, तीन श्रेणियाँ नहीं; ये मिलकर स्कोर या प्रमाणपत्र नहीं बनतीं।
79
+ - **जाँच रूटिंग** — यह पैकेज केवल समझाता और भेजता है: अनुरूपता जाँचें `dsh-standards` को जाती हैं, नियम-पाठ `dsh-plugin-spec` में है, और प्लगइन बनाना `dsh-primer` का काम है (पुरानी `dsh-plugin-dev` CLI वहीं है, यहाँ नहीं)।
80
+ - **साक्ष्य नियम** — `static` ≠ `runtime`, `recognized` ≠ `pass`, `not-run` ≠ `pass`; PASS के लिए कमांड, आर्टिफ़ैक्ट, वातावरण और तारीख चाहिए; कुछ भी छूटे तो `not-run`, `not-measured` या `incomplete` लिखें।
81
+ - **माँगने पर स्किल** — `index.js` `SKILL.md` पढ़ता है, YAML frontmatter हटाता है, और `source: bundled` तथा डायरेक्टरी `resourceBase` के साथ दर्ज करता है; स्किल केवल माँगने पर संदर्भ में आती है, इसलिए कोई स्थायी प्रॉम्प्ट उपसर्ग नहीं जोड़ती।
82
+ - **उधार का अधिकार नहीं** — कोई निर्णय, कोई मार्केट गेट और कोई आधिकारिक दावा नहीं; शब्द-अनुशासन `SKILL.md` और `STANDARDS.md` में लिखा है और पंक्ति-दर-पंक्ति जाँचा जा सकता है।
83
+
84
+ ### तीन परतें
85
+
86
+ | परत | सवाल | निर्णय दे सकती है? |
87
+ |---|---|---|
88
+ | **ENTRY** | क्या इसे पहचाना, इंस्टॉल और शुरू किया जा सकता है? | हाँ: recognized / runtime / failed / incomplete / unavailable |
89
+ | **FLOW** | क्या उपयोगकर्ता इसे इंस्टॉल, कॉन्फ़िगर, उपयोग, अपग्रेड और हटा सकता है? | हाँ, केवल जहाँ runtime साक्ष्य हो; अन्यथा `not-run` |
90
+ | **BOOST** | क्या यह Cordis का अच्छा उपयोग करता है? | प्लगइन-स्तर का निर्णय नहीं; साक्ष्य प्रति-प्रैक्टिस दर्ज होता है |
91
+
92
+ पहले एक-पृष्ठ का नक्शा पढ़ें: [docs/levels.md](docs/levels.md)।
93
+
94
+ ### जाँच चलाना
95
+
96
+ ```sh
97
+ # केवल ENTRY पहचान (runtime का दावा नहीं)
98
+ npx dsh-standards ./my-plugin --scope entry --entry-claim static
99
+
100
+ # तीन-परत ऑडिट; न चली परतें not-run / not-measured रहती हैं
101
+ npx -p dsh-standards dsh-levels ./my-plugin --format json
102
+ ```
103
+
104
+ `recognized` उत्तीर्ण नहीं है, `static` उत्तीर्ण नहीं है, और `not-run` भी नहीं। एक्ज़िट कोड: `0` पूर्ण, `1` आरोपणीय FAIL, `2` अपूर्ण/not-run, `3` उपयोग त्रुटि; `not-run` या `incomplete` परिणाम को कभी उत्तीर्ण नहीं लिखना चाहिए (देखें [docs/entry.md](docs/entry.md))।
105
+
106
+ ### 0.4.0 में क्या बदला
107
+
108
+ - पिछली एजेंट स्किल और `dsh-plugin-dev` CLI [`dsh-primer`](https://github.com/PerryLink/dsh-primer) में चले गए।
109
+ - यह पैकेज अब **गाइड** परत है: तीन-परत नक्शा, जाँच रूटिंग और साक्ष्य नियम।
110
+ - पुराने 0.3.x npm संस्करण obsoleted हैं और मौजूदा इंस्टॉल के लिए उपलब्ध हैं। 0.4.0 लाइन उत्पाद-परिवर्तन है; `^0.3` पर पिन किए उपयोगकर्ता अपने आप अपग्रेड नहीं होंगे।
111
+ - जाँचें [`dsh-standards`](https://github.com/PerryLink/dsh-standards) में हैं, इस पैकेज में नहीं।
112
+
113
+ ## कॉन्फ़िगरेशन
114
+
115
+ इस पैकेज में Schemastery `Config` नहीं है: `cordis.patch.yml` केवल एक पंक्ति `insert` करता है और प्लगइन कोई `config.*` कुंजी नहीं पढ़ता। समायोज्य केवल वह पंक्ति और वह प्रोफ़ाइल है जिसमें वह रहती है।
116
+
117
+ | कुंजी | डिफ़ॉल्ट | अर्थ |
118
+ |---|---|---|
119
+ | `id` | `dsh-plugin-guide` | पंक्ति पहचानकर्ता; बाद की patch परत इस पंक्ति को `id` से बदल देती है (पूरी पंक्ति प्रतिस्थापन) |
120
+ | `name` | `dsh-plugin-guide` | वह मॉड्यूल जिसे loader import करता है (`package.json#main` → `index.js`) |
121
+ | `config` | स्वीकार नहीं | यह पैकेज कोई कॉन्फ़िगरेशन कुंजी नहीं पढ़ता; यहाँ लिखा कुछ प्रभाव नहीं डालेगा |
122
+
123
+ <details>
124
+ <summary>पूरी पैच फ़ाइल (cordis.patch.yml, 9 पंक्तियाँ)</summary>
125
+
126
+ ```yaml
127
+ # dsh-plugin-guide bundle layer: register the packaged knowledge base as an agent skill.
128
+ # This file is the `dsh.bundle.patch` layer (see package.json#dsh.bundle.patch).
129
+ # Layer semantics: a YAML array of row verbs; `insert` adds plugin rows to the
130
+ # composed config. Later layers override a row by `id` (whole-config replacement).
131
+ - insert:
132
+ # `id`: stable row identifier used by later layers to override this row.
133
+ - id: dsh-plugin-guide
134
+ # `name`: the module the loader imports; resolves to this package's entry (package.json#main → index.js).
135
+ name: dsh-plugin-guide
136
+ ```
137
+
138
+ </details>
139
+
140
+ बंद करना हो तो: प्रोफ़ाइल पैच से वह पंक्ति हटाएँ, या `dsh plugin --profile web remove dsh-plugin-guide` चलाएँ।
141
+
142
+ ## FAQ
143
+
144
+ <details>
145
+ <summary>क्या यह तय करेगा कि मेरा प्लगइन पर्याप्त अच्छा है?</summary>
146
+
147
+ नहीं। यह पैकेज गाइड परत है, न्यायाधीश नहीं: यह तीन परतें समझाता है, जाँचें `dsh-standards` तक भेजता है और साक्ष्य नियम बताता है। BOOST का भी प्लगइन-स्तर पर उत्तीर्ण/अनुत्तीर्ण नहीं है: किसी प्रैक्टिस के साथ साक्ष्य हो सकता है, पर प्लगइन को कभी «BOOST स्तर» नहीं मिलता।
148
+
149
+ </details>
150
+
151
+ <details>
152
+ <summary>क्या `recognized` या `static` परिणाम उत्तीर्ण माना जाता है?</summary>
153
+
154
+ नहीं। `recognized` का अर्थ केवल यह है कि पैकेज का रूप पहचाना जा सकता है और `static` का अर्थ केवल यह कि स्थिर पूर्व-जाँच हुई; `static` ≠ `runtime` और `not-run` ≠ `pass`। जब FLOW में केवल कुछ journeys चले हों तो स्थिति `not-run` होती है, कभी नरम उत्तीर्ण नहीं; FLOW की उत्तीर्ण-दर या श्रेणी भी प्रकाशित नहीं करनी चाहिए।
155
+
156
+ </details>
157
+
158
+ <details>
159
+ <summary>क्या इसे इंस्टॉल करने से मेरी प्रोफ़ाइल या दूसरे प्लगइन बदलेंगे?</summary>
160
+
161
+ नहीं। यह `skills` सेवा में ठीक एक स्किल दर्ज करता है (नाम `dsh-plugin-guide`, `source: bundled`), जो `ctx.effect()` में लिपटी है ताकि अनलोड या हॉट-रीलोड पर हट जाए; यह कोई टूल, कमांड, क्लाइंट slot या `webServer` उपसर्ग दर्ज नहीं करता, कोई नेटवर्क अनुरोध नहीं करता, और केवल `filesystem:read` अनुमति घोषित करता है।
162
+
163
+ </details>
164
+
165
+ <details>
166
+ <summary>0.3.x उपयोगकर्ताओं का क्या?</summary>
167
+
168
+ 0.3.x obsolete है पर अभी भी इंस्टॉल हो सकता है; 0.4.0 उत्पाद-परिवर्तन है, इसलिए `^0.3` पर पिन प्रोफ़ाइल अपने आप अपग्रेड नहीं होगी। पुरानी बिल्ड/स्कैफ़ोल्ड स्किल और `dsh-plugin-dev` CLI अब [`dsh-primer`](https://github.com/PerryLink/dsh-primer) की हैं; यह पैकेज केवल गाइड और रूटिंग रखता है।
169
+
170
+ </details>
171
+
172
+ <details>
173
+ <summary>चेकर और नियम-पाठ वास्तव में कहाँ हैं?</summary>
174
+
175
+ चेकर और तीन-परत ऑडिट [`dsh-standards`](https://www.npmjs.com/package/dsh-standards) में हैं (`npx dsh-standards`, `npx -p dsh-standards dsh-levels`); नियम-पाठ [`dsh-plugin-spec`](https://github.com/PerryLink/dsh-plugin-spec) में है। इस पैकेज के `package.json` में `dsh.standards` प्लेसहोल्डर अब भी entry/flow = `not-run`, boost = `not-measured`, `evidence: null` है — इसका अर्थ «मापा नहीं गया» है, «उत्तीर्ण» नहीं।
176
+
177
+ </details>
178
+
179
+ ## सुरक्षा सीमाएँ
180
+
181
+ - कोई आधिकारिक अनुमोदन, प्रमाणन, मान्यता या सुरक्षा ऑडिट नहीं।
182
+ - कोई स्कोर, रैंकिंग या मार्केट गेट नहीं।
183
+ - कोई गढ़ा हुआ runtime साक्ष्य नहीं: `static` ≠ `runtime`, `not-run` ≠ `pass`।
184
+ - BOOST सलाह और साक्ष्य है, कभी प्लगइन श्रेणी नहीं।
185
+ - **पाठ ही सीमा है।** गाइड केवल वही कहती है जिसके लिए वह किसी स्रोत दस्तावेज़ की ओर इशारा कर सके; जो प्रैक्टिस मापी नहीं जा सकती (डेवलपर घंटे, रखरखाव लागत) वह WARN या टिप्पणी के रूप में दर्ज होती है, गढ़े हुए आँकड़े के रूप में नहीं (देखें [docs/boost.md](docs/boost.md))।
186
+ - **रचना से ही गैर-आधिकारिक।** कोई प्रमाणन, मान्यता, सुरक्षा ऑडिट, रैंकिंग या मार्केट गेट नहीं; बाहरी शब्दावली official / certified / secure / recommended / ranked जैसे दावों से बचती है (देखें [STANDARDS.md](STANDARDS.md))।
187
+
188
+ ## अनुमतियाँ और डेटा
189
+
190
+ - **अनुमतियाँ**: `package.json#dshWorkshop.permissions` केवल `filesystem:read` घोषित करता है। `apply()` के समय प्लगइन पैकेज के अंदर का `SKILL.md` पढ़ता है, और बॉडी के सापेक्ष संदर्भ डायरेक्टरी `resourceBase` के ज़रिए पैकेज के `docs/` में हल होते हैं।
191
+ - **डेटा**: workspace में या प्रोफ़ाइल के बाहर कुछ नहीं लिखा जाता; कोई टेलीमेट्री, एनालिटिक्स, विज्ञापन या होस्टेड खाता नहीं जोड़ा जाता, और PerryLink को कोई डेटा नहीं भेजा जाता (देखें [PRIVACY.md](PRIVACY.md))। होस्ट का सेशन/लॉग भंडारण और उसकी अवधि होस्ट नियंत्रित करता है।
192
+ - **अनइंस्टॉल**: पैकेज हटाने से केवल उसका कोड हटता है, होस्ट लॉग, workspace फ़ाइलें या आपके बनाए दस्तावेज़ नहीं।
193
+
194
+ ## ज्ञात सीमाएँ
195
+
196
+ - **गाइड कोई निर्णय नहीं देती।** इसमें न्यायाधीश क्षमता नहीं है: यह किसी प्लगइन को न उत्तीर्ण बता सकती है न अनुत्तीर्ण; निर्णय केवल उस परिणाम से आता है जो `dsh-standards` ने वास्तव में चलाया हो।
197
+ - **FLOW का runtime अभी मसौदा है।** J1/J2/J4/J6 के पास fixtures पर runtime साक्ष्य है; J3/J7 केवल fixture-स्तर runtime तक पहुँचते हैं; J5/J8 के पास केवल स्थिर पूर्व-जाँच है; ब्राउज़र रेंडरिंग अभी शामिल नहीं है — इसलिए «केवल कुछ journeys चले» को `not-run` लिखना चाहिए (देखें [docs/flow.md](docs/flow.md))।
198
+ - **BOOST के मापे गए उदाहरण fixtures या सिंथेटिक कैप्चर हैं।** वे उत्पादन बेसलाइन नहीं हैं; LEV-3, LEV-6 और LEV-7 के पास सबसे मज़बूत साक्ष्य है, बाकी के पास केवल loader/context-स्तर fixtures; साक्ष्य न हो तो स्थिति `not-measured` है (देखें [docs/boost.md](docs/boost.md))।
199
+ - **नियम होस्ट के साथ चलते हैं।** बेसलाइन 2026-11-04 तक DSH `0.2.2-alpha.3` / Cordis `4.0.6-alpha.2` है; Node को `0.2.2-alpha.2` से `>=24.9.0` चाहिए; `ctx.menus` `0.2.2-alpha.3` में हट चुका है; और `0.2.1-alpha.4` से घोषित `engines.dsh` अकेले संस्करण कॉरिडोर तय करता है (देखें [docs/levels.md](docs/levels.md))।
200
+ - **`dsh.standards` प्लेसहोल्डर स्कोर नहीं है।** `package.json` में entry/flow = `not-run`, boost = `not-measured`, `evidence: null` — केवल एक प्लेसहोल्डर।
201
+ - **0.3.x पुराने रूप पर रुका है।** 0.3.x एक obsolete उत्पाद-लाइन है; बिल्ड/स्कैफ़ोल्ड क्षमता अब `dsh-primer` में है और यह पैकेज कोई CLI नहीं देता।
202
+
203
+ ## अन्य DSH प्लगइनों के साथ इंटरऑपरेबिलिटी
204
+
205
+ यह प्लगइन अन्य प्लगइनों में **हस्तक्षेप नहीं** करता:
206
+
207
+ - **कोई टूल, कमांड या सेवा-कुंजी टकराव नहीं।** यह कोई टूल, कमांड या सेवा-कुंजी दर्ज नहीं करता, इसलिए कोई नंगा नाम नहीं रखता और सेवा-कुंजी पर टकरा नहीं सकता।
208
+ - **कोई slot या HTTP रूट टकराव नहीं।** यह कोई क्लाइंट slot कुंजी और कोई `webServer` उपसर्ग दर्ज नहीं करता।
209
+ - **एकमात्र निर्भरता `skills` सेवा है।** `export const inject = ['skills']`, जो होस्ट देता है; यह होस्ट कार्यान्वयन import नहीं करता, केवल उस सेवा का उपभोग करता है।
210
+ - **कोई साझा इवेंट listener नहीं।** यह `agent/pre-step` या `tools/post-execute` जैसे क्रम-संवेदी इवेंट नहीं सुनता, इसलिए waterfall श्रृंखला शॉर्ट-सर्किट होने का प्रश्न ही नहीं।
211
+ - **कोई patch-परत टकराव नहीं।** bundle patch केवल अपनी पंक्ति `insert` करता है; किसी अंतर्निहित पंक्ति का `config` कभी नहीं बदलता।
212
+ - **कोई वैश्विक परिवर्तन नहीं।** प्रोटोटाइप पैच नहीं करता, `process.env` नहीं लिखता, वैश्विक fetch dispatcher नहीं बदलता।
213
+ - **रजिस्ट्रेशन effect है।** `ctx.effect(() => ctx.skills.register(...))`: रोकने या हॉट-रीलोड पर योगदान हट जाता है।
214
+
215
+ बेसलाइन: DSH `0.2.2-alpha.3` / Cordis `4.0.6-alpha.2` ([docs/levels.md](docs/levels.md) के अनुसार, 2026-11-04)।
216
+
217
+ ## संगतता
218
+
219
+ | सतह | स्थिति |
220
+ |---|---|
221
+ | Harness | `engines.dsh` = `>=0.2.2-0 <0.3.0` (`0.2.1-alpha.4` से `engines.dsh` अकेले तय करता है; npm के डिफ़ॉल्ट semver को स्पष्ट `^0.2.2-alpha.3` यूनियन आर्म चाहिए)। बेसलाइन DSH `0.2.2-alpha.3` (npm `alpha`), Cordis `4.0.6-alpha.2`। |
222
+ | Node | `>=24.9.0` (0.2.2 लाइन की आवश्यकता, `0.2.2-alpha.2` से) |
223
+ | प्लेटफ़ॉर्म | जहाँ DSH चले (सादा-पाठ स्किल; कोई ब्राउज़र आधा नहीं, कोई नेटिव एक्सटेंशन नहीं) |
224
+ | मॉडल | कोई मॉडल कॉल नहीं: होस्ट स्किल पाठ को संदर्भ में डालता है, इसलिए अतिरिक्त मॉडल क्षमता नहीं चाहिए |
225
+
226
+ ## इकोसिस्टम और गुणवत्ता
227
+
228
+ - [npm पैकेज पेज](https://www.npmjs.com/package/dsh-plugin-guide) (प्रकाशित संस्करण, `0.4.3`)
229
+ - [Gitee मिरर](https://gitee.com/perrylink/dsh-plugin-guide) (केवल-पढ़ने वाला स्नैपशॉट; मुख्य स्रोत GitHub है)
230
+ - [dsh-standards](https://www.npmjs.com/package/dsh-standards) (चेकर और `dsh-levels` तीन-परत ऑडिट)
231
+ - [dsh-plugin-spec](https://github.com/PerryLink/dsh-plugin-spec) (निम्न-स्तरीय नियम-पाठ और धारा स्रोत)
232
+ - [dsh-primer](https://github.com/PerryLink/dsh-primer) (पुरानी बिल्ड/स्कैफ़ोल्ड स्किल और CLI)
233
+ - रेपो दस्तावेज़: [तीन परतें](docs/levels.md) · [ENTRY](docs/entry.md) · [FLOW](docs/flow.md) · [BOOST](docs/boost.md)
234
+ - रेपो गवर्नेंस: [CHANGELOG](CHANGELOG.md) · [STANDARDS.md](STANDARDS.md) · [CONTRIBUTING](CONTRIBUTING.md)
235
+
236
+ ## डेवलपमेंट
237
+
238
+ ```sh
239
+ npm test # node --test tests/*.test.mjs
240
+ npm run test:pack # npm pack --dry-run
241
+ python scripts/gen-readme-assets.py # docs/assets में हल्के/गहरे hero SVG फिर बनाएँ (Python + Pillow)
242
+ ```
243
+
244
+ कोई बिल्ड चरण नहीं: `index.js` ही प्रकाशित आर्टिफ़ैक्ट है। CI है [.github/workflows/verify.yml](.github/workflows/verify.yml) (Node 22 और 24 मैट्रिक्स, यूनिट टेस्ट और `npm pack --dry-run`)। README की छवियाँ [scripts/gen-readme-assets.py](scripts/gen-readme-assets.py) से प्रोग्रामेटिक रूप से बनती हैं; दोबारा चलाना idempotent है और जगह पर ही अधिलेखित करता है।
245
+
246
+ | पथ | उद्देश्य |
247
+ |---|---|
248
+ | `index.js` | एकमात्र होस्ट फलक: `SKILL.md` पढ़ता है, frontmatter हटाता है, `ctx.effect` से स्किल दर्ज करता है |
249
+ | `SKILL.md` | स्किल बॉडी और उसका `description` (YAML frontmatter) |
250
+ | `docs/` | तीन-परत नक्शा और ENTRY/FLOW/BOOST गाइड, जिन्हें स्किल बॉडी संदर्भित करता है |
251
+ | `locale/` | स्किल का zh/en प्रदर्शन मेटाडेटा (`meta.title`, `meta.description`) |
252
+ | `cordis.patch.yml` | bundle पैच परत; केवल अपनी पंक्ति `insert` करती है |
253
+ | `tests/` | `node --test`: स्किल frontmatter पार्सिंग और रजिस्ट्रेशन |
254
+ | `scripts/gen-readme-assets.py` | प्रोग्रामेटिक छवि निर्माण (Python + Pillow) |
255
+ | `STANDARDS.md` · `NOTICE.md` · `PRIVACY.md` | मानक स्थिति, NOTICE और गोपनीयता कथन |
256
+
257
+ ## परिवार और आभार
258
+
259
+ यह परियोजना [PerryLink](https://github.com/PerryLink) के DeepSeek Harness प्लगइन परिवार का हिस्सा है (सभी Apache-2.0)। अगर यह गाइड उपयोगी लगे तो **एक स्टार अगले व्यक्ति को इसे खोजने में मदद करता है** — इसके पीछे कुछ भी बंद नहीं है।
260
+
261
+ - [@PerryLink](https://github.com/PerryLink) — निर्माता और अनुरक्षक: तीन-परत नक्शा और ENTRY/FLOW/BOOST गाइड पाठ, `SKILL.md` स्किल, bundle पैच परत और पाँच-भाषा दस्तावेज़।
262
+
263
+ <details>
264
+ <summary>सभी प्लगइन खोलें</summary>
265
+
266
+ | प्लगइन | स्थिति |
267
+ |---|---|
268
+ | **[dsh-aqua-input-check](https://github.com/PerryLink/dsh-aqua-input-check)** | |
269
+ | **[dsh-archive-check](https://github.com/PerryLink/dsh-archive-check)** | |
270
+ | **[dsh-auto-review](https://github.com/PerryLink/dsh-auto-review)** | |
271
+ | **[dsh-autotier](https://github.com/PerryLink/dsh-autotier)** | 🧊 फ़्रोज़न — रेपो README देखें |
272
+ | **[dsh-bid-ca-precheck](https://github.com/PerryLink/dsh-bid-ca-precheck)** | |
273
+ | **[dsh-bid-qual-check](https://github.com/PerryLink/dsh-bid-qual-check)** | |
274
+ | **[dsh-cert-mcp](https://github.com/PerryLink/dsh-cert-mcp)** | 🧊 फ़्रोज़न — रेपो README देखें |
275
+ | **[dsh-checkpoint-rewind](https://github.com/PerryLink/dsh-checkpoint-rewind)** | |
276
+ | **[dsh-click](https://github.com/PerryLink/dsh-click)** | |
277
+ | **[dsh-composer-history](https://github.com/PerryLink/dsh-composer-history)** | |
278
+ | **[dsh-contract-stance](https://github.com/PerryLink/dsh-contract-stance)** | |
279
+ | **[dsh-customs-doc-check](https://github.com/PerryLink/dsh-customs-doc-check)** | |
280
+ | **[dsh-data-quality](https://github.com/PerryLink/dsh-data-quality)** | 🧊 फ़्रोज़न — रेपो README देखें |
281
+ | **[dsh-demurrage-ledger](https://github.com/PerryLink/dsh-demurrage-ledger)** | |
282
+ | **[dsh-doublecheck](https://github.com/PerryLink/dsh-doublecheck)** | |
283
+ | **[dsh-drill-script-check](https://github.com/PerryLink/dsh-drill-script-check)** | |
284
+ | **[dsh-eia-guide-check](https://github.com/PerryLink/dsh-eia-guide-check)** | |
285
+ | **[dsh-emergency-plan](https://github.com/PerryLink/dsh-emergency-plan)** | |
286
+ | **[dsh-essay-rubric-check](https://github.com/PerryLink/dsh-essay-rubric-check)** | |
287
+ | **[dsh-evidence-check](https://github.com/PerryLink/dsh-evidence-check)** | |
288
+ | **[dsh-export-ctl-check](https://github.com/PerryLink/dsh-export-ctl-check)** | |
289
+ | **[dsh-fast](https://github.com/PerryLink/dsh-fast)** | |
290
+ | **[dsh-fmea-table-check](https://github.com/PerryLink/dsh-fmea-table-check)** | |
291
+ | **[dsh-forecast-penalty](https://github.com/PerryLink/dsh-forecast-penalty)** | |
292
+ | **[dsh-fund-research](https://github.com/PerryLink/dsh-fund-research)** | |
293
+ | **[dsh-github](https://github.com/PerryLink/dsh-github)** | |
294
+ | **[dsh-gongwen-flow-check](https://github.com/PerryLink/dsh-gongwen-flow-check)** | |
295
+ | **[dsh-gongwen-word-check](https://github.com/PerryLink/dsh-gongwen-word-check)** | |
296
+ | **[dsh-guard-plan-qc](https://github.com/PerryLink/dsh-guard-plan-qc)** | |
297
+ | **[dsh-hazchem-check](https://github.com/PerryLink/dsh-hazchem-check)** | |
298
+ | **[dsh-hazplan-check](https://github.com/PerryLink/dsh-hazplan-check)** | |
299
+ | **[dsh-hidden-risk-map](https://github.com/PerryLink/dsh-hidden-risk-map)** | |
300
+ | **[dsh-hs-classify](https://github.com/PerryLink/dsh-hs-classify)** | |
301
+ | **[dsh-icd-rule-check](https://github.com/PerryLink/dsh-icd-rule-check)** | |
302
+ | **[dsh-industry-research](https://github.com/PerryLink/dsh-industry-research)** | |
303
+ | **[dsh-lawcite-adapter](https://github.com/PerryLink/dsh-lawcite-adapter)** | |
304
+ | **[dsh-laya](https://github.com/PerryLink/dsh-laya)** | |
305
+ | **[dsh-lc-doc-check](https://github.com/PerryLink/dsh-lc-doc-check)** | |
306
+ | **[dsh-learning-gap-check](https://github.com/PerryLink/dsh-learning-gap-check)** | |
307
+ | **[dsh-library](https://github.com/PerryLink/dsh-library)** | |
308
+ | **[dsh-local-ai](https://github.com/PerryLink/dsh-local-ai)** | |
309
+ | **[dsh-lsp-actions](https://github.com/PerryLink/dsh-lsp-actions)** | |
310
+ | **[dsh-mask](https://github.com/PerryLink/dsh-mask)** | |
311
+ | **[dsh-mcp-panel](https://github.com/PerryLink/dsh-mcp-panel)** | |
312
+ | **[dsh-medrec-qc](https://github.com/PerryLink/dsh-medrec-qc)** | |
313
+ | **[dsh-memento](https://github.com/PerryLink/dsh-memento)** | 🧊 फ़्रोज़न — रेपो README देखें |
314
+ | **[dsh-nsfc-form-check](https://github.com/PerryLink/dsh-nsfc-form-check)** | |
315
+ | **[dsh-nurse-record-check](https://github.com/PerryLink/dsh-nurse-record-check)** | |
316
+ | **[dsh-observe](https://github.com/PerryLink/dsh-observe)** | |
317
+ | **[dsh-origin-rvc-check](https://github.com/PerryLink/dsh-origin-rvc-check)** | |
318
+ | **[dsh-ota-review-check](https://github.com/PerryLink/dsh-ota-review-check)** | |
319
+ | **[dsh-output-styles](https://github.com/PerryLink/dsh-output-styles)** | |
320
+ | **[dsh-paper-doc-adapter](https://github.com/PerryLink/dsh-paper-doc-adapter)** | |
321
+ | **[dsh-permission-rules](https://github.com/PerryLink/dsh-permission-rules)** | |
322
+ | **[dsh-permit-report-check](https://github.com/PerryLink/dsh-permit-report-check)** | |
323
+ | **[dsh-pipeline-check](https://github.com/PerryLink/dsh-pipeline-check)** | |
324
+ | **[dsh-pleading-draft](https://github.com/PerryLink/dsh-pleading-draft)** | |
325
+ | **[dsh-plugin-doctor](https://github.com/PerryLink/dsh-plugin-doctor)** | 🚫 रिटायर्ड (रेपो संग्रहीत) |
326
+ | **[dsh-plugin-guide](https://github.com/PerryLink/dsh-plugin-guide)** | |
327
+ | **[dsh-plugin-kit](https://github.com/PerryLink/dsh-plugin-kit)** | 🚫 रिटायर्ड (रेपो संग्रहीत) |
328
+ | **[dsh-plugin-upgrade](https://github.com/PerryLink/dsh-plugin-upgrade)** | 🚫 रिटायर्ड (रेपो संग्रहीत) |
329
+ | **[dsh-policy-brief-draft](https://github.com/PerryLink/dsh-policy-brief-draft)** | |
330
+ | **[dsh-power-loss-split](https://github.com/PerryLink/dsh-power-loss-split)** | |
331
+ | **[dsh-power-ticket-check](https://github.com/PerryLink/dsh-power-ticket-check)** | |
332
+ | **[dsh-ppap-check](https://github.com/PerryLink/dsh-ppap-check)** | |
333
+ | **[dsh-protest-deadline](https://github.com/PerryLink/dsh-protest-deadline)** | |
334
+ | **[dsh-railway-window](https://github.com/PerryLink/dsh-railway-window)** | |
335
+ | **[dsh-repair-order-qc](https://github.com/PerryLink/dsh-repair-order-qc)** | |
336
+ | **[dsh-research-report](https://github.com/PerryLink/dsh-research-report)** | |
337
+ | **[dsh-review-reply-check](https://github.com/PerryLink/dsh-review-reply-check)** | |
338
+ | **[dsh-rulefile-check](https://github.com/PerryLink/dsh-rulefile-check)** | |
339
+ | **[dsh-safety-brief-check](https://github.com/PerryLink/dsh-safety-brief-check)** | |
340
+ | **[dsh-score](https://github.com/PerryLink/dsh-score)** | 🧊 फ़्रोज़न — रेपो README देखें |
341
+ | **[dsh-session-sync](https://github.com/PerryLink/dsh-session-sync)** | |
342
+ | **[dsh-site-log-check](https://github.com/PerryLink/dsh-site-log-check)** | |
343
+ | **[dsh-skill-pack-security](https://github.com/PerryLink/dsh-skill-pack-security)** | |
344
+ | **[dsh-soe-decision-check](https://github.com/PerryLink/dsh-soe-decision-check)** | |
345
+ | **[dsh-soilwater-check](https://github.com/PerryLink/dsh-soilwater-check)** | |
346
+ | **[dsh-sop-sync-check](https://github.com/PerryLink/dsh-sop-sync-check)** | |
347
+ | **[dsh-spc-gbt-adapter](https://github.com/PerryLink/dsh-spc-gbt-adapter)** | |
348
+ | **[dsh-talk](https://github.com/PerryLink/dsh-talk)** | |
349
+ | **[dsh-tender-extract](https://github.com/PerryLink/dsh-tender-extract)** | |
350
+ | **[dsh-tender-matrix](https://github.com/PerryLink/dsh-tender-matrix)** | |
351
+ | **[dsh-test-drive](https://github.com/PerryLink/dsh-test-drive)** | |
352
+ | **[dsh-ticktick](https://github.com/PerryLink/dsh-ticktick)** | 🚫 रिटायर्ड (रेपो संग्रहीत) |
353
+ | **[dsh-translate](https://github.com/PerryLink/dsh-translate)** | |
354
+ | **[dsh-warranty-calc](https://github.com/PerryLink/dsh-warranty-calc)** | |
355
+ | **[dsh-budget](https://github.com/PerryLink/dsh-budget)** | 🧊 फ़्रोज़न — रेपो README देखें |
356
+ | **[dsh-claude-move](https://github.com/PerryLink/dsh-claude-move)** | 🧊 फ़्रोज़न — रेपो README देखें |
357
+ | **[dsh-defend](https://github.com/PerryLink/dsh-defend)** | 🧊 फ़्रोज़न — रेपो README देखें |
358
+ | **[dsh-draw](https://github.com/PerryLink/dsh-draw)** | 🧊 फ़्रोज़न — रेपो README देखें |
359
+ | **[dsh-reach](https://github.com/PerryLink/dsh-reach)** | 🧊 फ़्रोज़न — रेपो README देखें |
360
+ | **[dsh-background-agents](https://github.com/PerryLink/dsh-background-agents)** | 🚫 रिटायर्ड (रेपो संग्रहीत) |
361
+ | **[dsh-session-pin](https://github.com/PerryLink/dsh-session-pin)** | 🚫 रिटायर्ड (रेपो संग्रहीत) |
362
+ | **[dsh-team-rooms](https://github.com/PerryLink/dsh-team-rooms)** | 🚫 रिटायर्ड (रेपो संग्रहीत) |
363
+
364
+ </details>
365
+
366
+ ## लाइसेंस
367
+
368
+ [LICENSE](LICENSE) (Apache License 2.0) © 2026 dsh-plugin-guide contributors
369
+
370
+ <p align="center"><sub>Apache-2.0 · समुदाय गाइड, DeepSeek से संबद्ध नहीं।</sub></p>