dsh-test-drive 0.3.24 → 0.3.26

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 (46) hide show
  1. package/CHANGELOG.md +12 -0
  2. package/LICENSE +0 -0
  3. package/README.en.md +548 -0
  4. package/README.es.md +548 -0
  5. package/README.hi.md +548 -0
  6. package/README.md +337 -229
  7. package/README.pt.md +548 -0
  8. package/SECURITY.md +0 -0
  9. package/THIRD_PARTY_NOTICES.md +0 -0
  10. package/cordis.patch.yml +0 -0
  11. package/lib/index.js +16 -31
  12. package/lib/types/batch.d.ts +0 -0
  13. package/lib/types/batch.d.ts.map +0 -0
  14. package/lib/types/capability.d.ts +0 -0
  15. package/lib/types/capability.d.ts.map +0 -0
  16. package/lib/types/command.d.ts +0 -0
  17. package/lib/types/command.d.ts.map +0 -0
  18. package/lib/types/config.d.ts +0 -0
  19. package/lib/types/config.d.ts.map +0 -0
  20. package/lib/types/domain.d.ts +0 -0
  21. package/lib/types/domain.d.ts.map +0 -0
  22. package/lib/types/drive.d.ts +0 -0
  23. package/lib/types/drive.d.ts.map +0 -0
  24. package/lib/types/driver.d.ts +0 -0
  25. package/lib/types/driver.d.ts.map +0 -0
  26. package/lib/types/index.d.ts +0 -0
  27. package/lib/types/index.d.ts.map +0 -0
  28. package/lib/types/report.d.ts +0 -0
  29. package/lib/types/report.d.ts.map +0 -0
  30. package/lib/types/result.d.ts +0 -0
  31. package/lib/types/result.d.ts.map +0 -0
  32. package/lib/types/sanitize.d.ts +0 -0
  33. package/lib/types/sanitize.d.ts.map +0 -0
  34. package/lib/types/session-log.d.ts +0 -0
  35. package/lib/types/session-log.d.ts.map +0 -0
  36. package/lib/types/tools.d.ts +0 -0
  37. package/lib/types/tools.d.ts.map +0 -0
  38. package/lib/types/version.d.ts +1 -1
  39. package/lib/types/version.d.ts.map +0 -0
  40. package/lib/types/workspace.d.ts +0 -0
  41. package/lib/types/workspace.d.ts.map +0 -0
  42. package/package.json +64 -38
  43. package/README-es.md +0 -418
  44. package/README-hi.md +0 -418
  45. package/README-pt.md +0 -418
  46. package/README-zh.md +0 -417
package/README.hi.md ADDED
@@ -0,0 +1,548 @@
1
+ <div align="center">
2
+
3
+ <picture>
4
+ <source media="(prefers-color-scheme: dark)" srcset="docs/assets/dsh-test-drive-hero-en-dark.webp">
5
+ <img src="docs/assets/dsh-test-drive-hero-en-light.webp" width="100%" alt="dsh-test-drive: बाईं ओर प्लगइन का नाम और दो मूल्य-पंक्तियाँ; दाईं ओर एक वास्तविक ड्राइव की रसीद — लक्ष्य dsh-click, रन आईडी tdr_0b9b…, छह चरणों की स्थिति और अवधि, आइसोलेशन पट्टी (थ्रोअवे DSH_HOME, कार्य निर्देशिका, pnpm store; होस्ट प्रोफ़ाइल पर 0 पढ़ना / 0 लिखना) और वर्डिक्ट पंक्ति तथा dsh-test-drive/v1 रिकॉर्ड">
6
+ </picture>
7
+
8
+ # dsh-test-drive
9
+
10
+ **एक डिस्पोज़ेबल प्रोफ़ाइल में इंस्टॉल, बूट, दावा, अनइंस्टॉल और सफ़ाई — «यह चलता भी है क्या?» को दोहराने योग्य पाइपलाइन बना दें।**
11
+
12
+ DeepSeek Harness प्लगइनों के लिए आइसोलेटेड इंस्टॉल-और-स्मोक परीक्षण: हर लक्ष्य को अपनी `mkdtemp` जड़ मिलती है (थ्रोअवे `DSH_HOME`, थ्रोअवे कार्यशील निर्देशिका और रीडायरेक्ट किया गया pnpm store), आपका असली `~/.dsh` शुरू से अंत तक न पढ़ा जाता है न लिखा जाता है, और परिणाम एक संरचित रिकॉर्ड बनता है जिसे आगे की टूलिंग सीधे खपत कर सकती है।
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.1%20%3C0.3.0-4B67B4?style=flat-square&labelColor=2B3245)](#संगतता)
18
+ [![npm](https://img.shields.io/npm/v/dsh-test-drive?style=flat-square&labelColor=2B3245&color=CB3837)](https://www.npmjs.com/package/dsh-test-drive)
19
+ [![CI](https://img.shields.io/github/actions/workflow/status/PerryLink/dsh-test-drive/ci.yml?branch=main&label=CI&style=flat-square&labelColor=2B3245)](https://github.com/PerryLink/dsh-test-drive/actions/workflows/ci.yml)
20
+ [![Node](https://img.shields.io/badge/node-%5E22.19%20%7C%7C%20%3E%3D24.9-339933?style=flat-square&labelColor=2B3245)](#संगतता)
21
+
22
+ [![Stars](https://img.shields.io/github/stars/PerryLink/dsh-test-drive?style=flat-square&labelColor=2B3245)](https://github.com/PerryLink/dsh-test-drive/stargazers)
23
+ [![npm downloads](https://img.shields.io/npm/dm/dsh-test-drive?style=flat-square&labelColor=2B3245&color=CB3837)](https://www.npmjs.com/package/dsh-test-drive)
24
+ [![dshfind](https://dshfind.com/api/badge/PerryLink/dsh-test-drive?metric=downloads)](https://dshfind.com/plugins/PerryLink/dsh-test-drive?ref=badge)
25
+ [![OpenSSF Scorecard](https://api.securityscorecards.dev/projects/github.com/PerryLink/dsh-test-drive/badge)](https://securityscorecards.dev/viewer/?uri=github.com/PerryLink/dsh-test-drive)
26
+ [![DSH Market](https://img.shields.io/badge/DSH_Market-listed-4B67B4?style=flat-square&labelColor=2B3245)](https://dsh.market/)
27
+ [![Gitee](https://img.shields.io/badge/Gitee-mirror-C71D23?style=flat-square&labelColor=2B3245&logo=gitee)](https://gitee.com/perrylink/dsh-test-drive)
28
+
29
+ ```sh
30
+ dsh plugin --profile <name> add dsh-test-drive
31
+ ```
32
+
33
+ </div>
34
+
35
+ <sub>सामुदायिक प्लगइन, DeepSeek से असंबद्ध। कैनोनिकल रिपॉज़िटरी: <https://github.com/PerryLink/dsh-test-drive> (Gitee एक मिरर है)।</sub>
36
+
37
+ ## यह क्या है
38
+
39
+ `dsh-test-drive` «यह प्लगइन इंस्टॉल होता भी है और बूट होता है क्या?» को छह चरणों की पाइपलाइन बना देता है: एक थ्रोअवे `DSH_HOME` में `dsh plugin add` → `--dump-config` से सिद्ध करना कि bundle patch परत वास्तव में लागू हुई → एक headless बूट जो loader विफलता मार्कर खोजता है → वैकल्पिक क्षमता-दावा (agent से किसी नामित टूल या कमांड को कॉल कराना, फिर जाँचना कि टिकाऊ सत्र लॉग में वह कॉल दर्ज है और देखा गया आउटपुट अपेक्षित शब्दशः मान रखता है) → `dsh plugin remove` → dry-run → क्वारंटीन-नामांतरण → हटाने की सीढ़ी से इस प्लगइन की अपनी अस्थायी जड़ों की सफ़ाई। हर चरण में स्थिति, निकास कोड, अवधि और sanitized आउटपुट-पुच्छ होती है, और पूरा रन एक ही `schema: "dsh-test-drive/v1"` रिकॉर्ड होता है: एक लक्ष्य के लिए `test_drive`, बैच के लिए `/testdrive`, और परिणाम देखने के लिए `drive_report`।
40
+
41
+ <picture>
42
+ <source media="(prefers-color-scheme: dark)" srcset="docs/assets/dsh-test-drive-flow-v5-dark.svg">
43
+ <img src="docs/assets/dsh-test-drive-flow-v5-light.svg" width="100%" alt="dsh-test-drive की संरचना: एक स्वामित्व वाली अस्थायी रूट को क्लीन-रूम लिफ़ाफ़े के रूप में दिखाया गया है — भीतर तीन थ्रोअवे उप-रूट (home/, workspace/, pnpm-store/) और पाँच चरणों की ऊर्ध्वाधर रीढ़ install → config → smoke → capability → uninstall; तल पर finally ड्रेन (dry-run योजना → क्वारंटीन नाम-परिवर्तन → विलोपन पुनःप्रयास) है जिससे pass, fail, टाइमआउट और abort सब गुज़रते हैं। बाईं ओर बाहर तीन प्रवेश सतहें, लक्ष्य प्रकार और वह होस्ट प्रोफ़ाइल है जो कभी नहीं खुलती; दाईं ओर dsh-test-drive/v1 रिकॉर्ड, क्रमबद्ध वर्डिक्ट नियम और /testdrive बैच मैट्रिक्स हैं">
44
+ </picture>
45
+
46
+ ## तीन चरणों में शुरुआत
47
+
48
+ 1. **इंस्टॉल करें** (दो चैनल):
49
+
50
+ ```sh
51
+ # npm चैनल (प्रकाशित रिलीज़; पहले से बने पैकेजों को build अनुमति नहीं चाहिए)
52
+ dsh plugin --profile web add dsh-test-drive
53
+ # git चैनल (नवीनतम main; git+https://github.com/PerryLink/dsh-test-drive.git के बराबर)
54
+ dsh plugin --profile web add github:PerryLink/dsh-test-drive#<commit-sha>
55
+ ```
56
+
57
+ git चैनल पर पहला `add` विफल होता है क्योंकि pnpm पैकेज के `prepare` build को रोकता है; pnpm जो सटीक कुंजी छापता है उसे प्रोफ़ाइल के `pnpm-workspace.yaml` में कॉपी करें और दोबारा चलाएँ:
58
+
59
+ ```yaml
60
+ allowBuilds:
61
+ 'dsh-test-drive': true
62
+ ```
63
+
64
+ npm के पहले से बने पैकेजों को build अनुमति नहीं चाहिए। प्रोफ़ाइल पुनः आरंभ करें, फिर सत्र में `test_drive` / `/testdrive` इस्तेमाल करें।
65
+
66
+ 2. **न्यूनतम कॉन्फ़िग** (डिफ़ॉल्ट से ही चलता है; केवल क्षमता-दावा चलाने के लिए `capability.*` और `forwardEnv` चाहिए):
67
+
68
+ ```yaml
69
+ - insert:
70
+ - id: test-drive
71
+ name: dsh-test-drive
72
+ config:
73
+ headlessTask: "Reply with exactly: ok"
74
+ forwardEnv: [DEEPSEEK_API_KEY]
75
+ capability:
76
+ enabled: true
77
+ kind: tool
78
+ name: plugin_vet
79
+ args: '{}'
80
+ expect: pass
81
+ ```
82
+
83
+ 3. **माउंट सत्यापित करें** (पुनः आरंभ के बाद):
84
+
85
+ ```sh
86
+ dsh --profile web --dump-config | grep -A3 'id: test-drive'
87
+ ```
88
+
89
+ फिर किसी ज्ञात लक्ष्य पर पहला परीक्षण चलाएँ:
90
+
91
+ ```text
92
+ test_drive({ target: "dsh-click" })
93
+ → verdict pass · tdr_0b9b6e6a61e3e80cc4620f2e · पूरा रिकॉर्ड «उदाहरण» में
94
+ ```
95
+
96
+ **अनइंस्टॉल**: `dsh plugin --profile web remove dsh-test-drive` (या प्रोफ़ाइल पैच से वह पंक्ति हटाएँ)।
97
+
98
+ > `test_drive` को ऐसा `dsh` CLI चाहिए जो **दूसरा** headless DSH प्रोसेस चला सके। DSH Desktop का launcher (`dsh.CMD`) केवल `dsh plugin …`, `--dump-config` और `--version` की अनुमति देता है और नीति के अनुसार दूसरा headless बूट अस्वीकार करता है — अब त्रुटि यह स्पष्ट कहती है, «cannot parse npm shim» नहीं। `config.dshBin` को npm/pnpm से इंस्टॉल किए `dsh` CLI पर, या सामान्य Node + dsh JS एंट्री पर इंगित करें।
99
+
100
+ <details>
101
+ <summary>DSH Desktop मार्केट से इंस्टॉल करें</summary>
102
+
103
+ सभी PerryLink प्लगइन DSH Desktop के अंतर्निहित मार्केट में ब्राउज़ किए जा सकते हैं: **Market → Sources → Add source → पेस्ट करें** `https://perrylink-dsh-catalog.perrylink.workers.dev/catalog-source.json` **→ चुनें**। इंस्टॉलेशन के लिए मार्केट की npm पहचान जाँच और आपकी पुष्टि आवश्यक रहती है।
104
+
105
+ </details>
106
+
107
+ ## मुख्य क्षमताएँ
108
+
109
+ `dsh-test-drive` «इस इंस्टॉल को सत्यापित करो» को देखने और दोहराने योग्य चरणों में बाँटता है:
110
+
111
+ - **`test_drive` टूल** — एक लक्ष्य की पूरी पाइपलाइन चलाकर संरचित रिकॉर्ड समकालिक रूप से लौटाता है; `background: true` देने पर `drive-batch` जॉब शुरू होता है और `{ kind: 'background', jobId }` मिलता है।
112
+ - **`/testdrive <लक्ष्य...>` कमांड** — स्पेस/कॉमा से अलग लक्ष्य-सूची को एक `drive-batch` बैकग्राउंड जॉब के रूप में चलाता है, प्रगति जॉब आउटपुट से स्ट्रीम करता है, और अंत में मैट्रिक्स रिपोर्ट (JSON + Markdown) देता है जिसकी अंतिम पंक्ति मैट्रिक्स id बताती है।
113
+ - **`drive_report` टूल** — किसी भी संग्रहीत रन (`tdr_...`), मैट्रिक्स (`tdm_...`), या id न देने पर नवीनतम मैट्रिक्स को Markdown में लौटाता है।
114
+ - **क्षमता-दावा** — «बूट हुआ और निकल गया» से आगे: वैकल्पिक `capability` चरण agent से `args` के साथ नामित टूल (`kind: tool`) या `/कमांड` (`kind: command`) चलवाता है, फिर जाँचता है कि टिकाऊ सत्र लॉग में वह कॉल दर्ज है और देखे गए आउटपुट में `expect` मौजूद है। साफ़ बूट केवल स्मोक है; `observed` सिद्ध करता है कि नामित क्षमता वास्तव में काम करती है।
115
+ - **संरचित परिणाम** — हर रिकॉर्ड में विभेदक `schema: "dsh-test-drive/v1"` और प्रथम-श्रेणी फ़ील्ड होते हैं: `stages.install.status`, `stages.smoke.status`, `stages.capability.status`, प्रति-चरण `durationMs`, sanitized `summary` / `outputTail`, और समग्र `verdict` (`pass` / `fail` / `partial` / `unknown`)। यही वह मशीन-पठनीय अनुबंध है जिसे आगे के स्कोरर (dsh-score) खपत करते हैं।
116
+ - **संरचना से सुरक्षा** — हर अस्थायी निर्देशिका इसी प्लगइन द्वारा `dsh-test-drive-` उपसर्ग से बनाई जाती है, जीवंत स्वामित्व-रजिस्ट्री में दर्ज रहती है, और केवल dry-run → क्वारंटीन-नामांतरण → हटाने की सीढ़ी से हटती है। होस्ट प्रोफ़ाइल कभी पढ़ी या लिखी नहीं जाती।
117
+
118
+ ```text
119
+ लक्ष्य ──dsh plugin add──▶ थ्रोअवे DSH_HOME ──--dump-config──▶ patch परत
120
+ │ │
121
+ ├──headless boot──▶ FAILED-मार्कर स्कैन
122
+ ├──capability────▶ tool/command + सत्र लॉग
123
+ └──dsh plugin remove──▶ क्वारंटीन → हटाना
124
+ ```
125
+
126
+ ### टूल सतह
127
+
128
+ | सतह | रूप | लौटाता है / नोट्स |
129
+ |---|---|---|
130
+ | `test_drive` | टूल | पूरा संरचित रिकॉर्ड (समकालिक), या `{ kind: 'background', jobId }` |
131
+ | `/testdrive` | कमांड | एक `drive-batch` जॉब; अंतिम पंक्ति `drive_report` के लिए मैट्रिक्स id बताती है |
132
+ | `drive_report` | टूल | `tdr_...` रन / `tdm_...` मैट्रिक्स / नवीनतम मैट्रिक्स, Markdown में |
133
+
134
+ `test_drive` का `target` git स्पेक (`github:owner/repo#sha`, `git+https://...`), npm पैकेज नाम, स्थानीय पथ या `.tgz` tarball स्वीकार करता है; `capability` का रूप `{ kind: 'tool' | 'command', name, args, expect }` है और उसे `DEEPSEEK_API_KEY` चाहिए (होस्ट वातावरण या `forwardEnv`) — बिना उसके चरण `skipped` रहता है, कभी विफल नहीं।
135
+
136
+ ### संरचित परिणाम
137
+
138
+ निर्णय नियम: इंस्टॉल विफलता, बूट विफलता (`smoke.fail`), या `not-registered` / `failed` तक पहुँचा क्षमता चरण ⇒ `fail`; इंस्टॉल सफल + patch प्रभावी + साफ़ बूट (`pass` / `boot-ok`) + अनइंस्टॉल सफल ⇒ `pass` (क्षमता चरण `observed` हो तो टिप्पणी सहित); इंस्टॉल हुआ पर बाद का आश्वासन अनुपस्थित ⇒ `partial`; बाकी सब ⇒ `unknown`।
139
+
140
+ <details>
141
+ <summary>पूर्ण रिकॉर्ड नमूना (dsh-test-drive/v1)</summary>
142
+
143
+ ```json
144
+ {
145
+ "schema": "dsh-test-drive/v1",
146
+ "run": { "runId": "tdr_9f2c...", "startedAt": "2026-08-16T00:00:00.000Z",
147
+ "finishedAt": "2026-08-16T00:00:45.120Z", "durationMs": 45120,
148
+ "harnessVersion": "0.1.7-rc.2", "pluginVersion": "0.3.13",
149
+ "platform": "win32", "node": "v22.22.3" },
150
+ "target": { "kind": "repo", "spec": "github:owner/dsh-click#abc123",
151
+ "resolved": { "packageName": "dsh-click", "packageVersion": "0.1.0",
152
+ "hasBundleManifest": true } },
153
+ "isolation": { "tempDshHome": true, "tempWorkspace": true, "tempStore": true,
154
+ "hostHomeTouched": false },
155
+ "stages": {
156
+ "install": { "status": "pass", "exitCode": 0, "durationMs": 30412, "attempts": 2,
157
+ "summary": "install ok after allowBuilds allowance", "outputTail": "",
158
+ "allowBuildsNeeded": true },
159
+ "config": { "status": "pass", "exitCode": 0, "durationMs": 2310, "attempts": 1,
160
+ "summary": "dump ok (exit 0)", "outputTail": "",
161
+ "patchEffective": true, "layers": ["dsh-click"] },
162
+ "smoke": { "status": "boot-ok", "exitCode": 1, "durationMs": 4123, "attempts": 1,
163
+ "summary": "booted without loader failures; headless task did not complete (credentials/model unreachable)",
164
+ "outputTail": "", "bootFailed": false, "taskCompleted": false },
165
+ "capability": { "status": "observed", "exitCode": 0, "durationMs": 8123, "attempts": 1,
166
+ "summary": "tool \"plugin_vet\" called and its result contains the expectation",
167
+ "outputTail": "", "capabilityKind": "tool", "name": "plugin_vet",
168
+ "expectMatched": true,
169
+ "detail": "tool \"plugin_vet\" called and its result contains the expectation" },
170
+ "uninstall": { "status": "pass", "exitCode": 0, "durationMs": 5123, "attempts": 1,
171
+ "summary": "remove ok (exit 0)", "outputTail": "" },
172
+ "cleanup": { "status": "pass", "quarantined": true, "removed": true,
173
+ "summary": "owned temp root quarantined and removed" }
174
+ },
175
+ "verdict": "pass",
176
+ "verdictReason": "install, patch, boot, and uninstall verified; headless task inconclusive (see smoke.summary)"
177
+ }
178
+ ```
179
+
180
+ </details>
181
+
182
+ ### उदाहरण
183
+
184
+ ये प्लगइन के असली प्रवेश-बिंदु हैं; एक बार इंस्टॉल करके कोई एक कॉल करें।
185
+
186
+ **विस्तृत उदाहरण** — कमांड `test_drive`, इनपुट:
187
+
188
+ ```sh
189
+ test_drive({ target: "dsh-click" })
190
+ ```
191
+
192
+ आउटपुट:
193
+
194
+ ```text
195
+ # Test drive tdr_0b9b6e6a61e3e80cc4620f2e
196
+
197
+ - Target: `dsh-click` (npm)
198
+ - Verdict: ✅ pass — install, patch, boot, task, and uninstall all verified
199
+ - Installed: dsh-click@0.2.0
200
+ - Isolation: throwaway DSH_HOME + workspace + pnpm store; host profile untouched
201
+
202
+ | Stage | Result | Exit | Duration | Summary |
203
+ |---|---|---|---|---|
204
+ | install | ✅ pass | 0 | 1 ms | install ok (exit 0) |
205
+ | config (--dump-config) | ✅ pass | 0 | 0 ms | patch effective: dsh-click |
206
+ | smoke (headless boot) | ✅ pass | 0 | 0 ms | booted cleanly and the headless task completed |
207
+ | capability | ⏭️ skipped | null | 0 ms | capability assertion disabled (config.capability.enabled is false and no per-drive capability given) |
208
+ | uninstall | ✅ pass | 0 | 0 ms | remove ok (exit 0) |
209
+ | cleanup | ✅ pass | — | — | owned temp root quarantined and removed |
210
+ ```
211
+
212
+ *Observed from `README.md:153-163,174-211; tests/drive.spec.ts:73-101; src/report.ts:34-55`*
213
+
214
+ **विफलता शाखा** — इनपुट:
215
+
216
+ ```text
217
+ {"target":" "}
218
+ ```
219
+
220
+ आउटपुट:
221
+
222
+ ```text
223
+ isError=true; error.message=dsh-test-drive: target must be a non-empty string
224
+ ```
225
+
226
+ *Observed from `plugins/dsh-test-drive/src/tools.ts:297-299 (blank target check); exercised through plugins/dsh-test-drive/tests/harness.ts`*
227
+
228
+ **संक्षिप्त उदाहरण**: `test_drive` · `/testdrive` · `drive_report`
229
+
230
+ ## कॉन्फ़िगरेशन
231
+
232
+ सभी कुंजियाँ वैकल्पिक हैं (नीचे डिफ़ॉल्ट दिए हैं); अमान्य मान लोड पर ज़ोर से विफल होते हैं। `cordis.patch.yml` हर कुंजी को इनलाइन टिप्पणी से समझाता है।
233
+
234
+ सबसे अधिक इस्तेमाल होने वाली कुंजियाँ:
235
+
236
+ | कुंजी | डिफ़ॉल्ट | अर्थ |
237
+ |---|---|---|
238
+ | `profileName` | `headless` | हर थ्रोअवे DSH_HOME के भीतर आरंभ होने वाला प्रोफ़ाइल टेम्पलेट (base + headless bundles)। |
239
+ | `dshBin` | `""` | `dsh` executable का निरपेक्ष पथ; खाली छोड़ने पर PATH से स्वतः पता लगता है (Windows पर npm का `.cmd`/`.bat` shim पार्स होता है)। |
240
+ | `headlessTask` | `"Reply with exactly: ok"` | बूट-स्मोक चरण की एक-बार की टास्क; खाली हो तो चरण छूट जाता है। |
241
+ | `forwardEnv` | `[]` | टेस्ट प्रोफ़ाइल के चाइल्ड प्रोसेस में भेजे जाने वाले वातावरण चरों के **नाम** (मान कभी नहीं); मान कभी लॉग नहीं होते। |
242
+ | `allowBuilds` | `true` | टेस्ट प्रोफ़ाइल में रुके हुए git `prepare` build को अनुमति देकर इंस्टॉल एक बार दोहराता है। |
243
+ | `capability.enabled` | `false` | क्षमता-दावा चरण चलाएँ (पंजीकृत → कॉल → देखा गया)। |
244
+ | `capability.expect` | `""` | देखे गए आउटपुट में अपेक्षित शब्दशः मान (केस-असंवेदी उपस्ट्रिंग)। |
245
+ | `keepTempDirs` | `false` | विफलता पर अस्थायी निर्देशिकाएँ फ़ॉरेंसिक के लिए रख छोड़ें (स्वामित्व छोड़ दिया जाता है; सफ़ाई आपकी)। |
246
+
247
+ <details>
248
+ <summary>पूर्ण कॉन्फ़िगरेशन तालिका (19 कुंजियाँ)</summary>
249
+
250
+ | कुंजी | डिफ़ॉल्ट | अर्थ |
251
+ |---|---|---|
252
+ | `profileName` | `headless` | हर थ्रोअवे DSH_HOME के भीतर आरंभ होने वाला प्रोफ़ाइल टेम्पलेट (base + headless bundles)। |
253
+ | `dshBin` | `""` | `dsh` executable का निरपेक्ष पथ; खाली छोड़ने पर PATH से स्वतः पता लगता है (Windows पर npm का `.cmd`/`.bat` shim पार्स होता है)। |
254
+ | `headlessTask` | `"Reply with exactly: ok"` | बूट-स्मोक चरण की एक-बार की टास्क; खाली हो तो चरण छूट जाता है। |
255
+ | `forwardEnv` | `[]` | टेस्ट प्रोफ़ाइल के चाइल्ड प्रोसेस में भेजे जाने वाले वातावरण चरों के **नाम** (मान कभी नहीं); मान कभी लॉग नहीं होते। |
256
+ | `allowBuilds` | `true` | टेस्ट प्रोफ़ाइल में रुके हुए git `prepare` build को अनुमति देकर इंस्टॉल एक बार दोहराता है। |
257
+ | `installTimeoutMs` | `600000` | `dsh plugin add` चरण की समय-सीमा (मि.से.)। |
258
+ | `configTimeoutMs` | `60000` | `--dump-config` चरण की समय-सीमा (मि.से.)। |
259
+ | `smokeTimeoutMs` | `300000` | headless बूट-स्मोक चरण की समय-सीमा (मि.से.)। |
260
+ | `capabilityTimeoutMs` | `300000` | क्षमता-दावा टास्क की समय-सीमा (मि.से.)। |
261
+ | `capability.enabled` | `false` | क्षमता-दावा चरण चलाएँ (पंजीकृत → कॉल → देखा गया)। |
262
+ | `capability.kind` | `tool` | क्या दावा करना है: `tool` या `command`। |
263
+ | `capability.name` | `""` | टूल या कमांड का नाम (आगे `/` के बिना)। |
264
+ | `capability.args` | `""` | कॉल टेक्स्ट: टूल आर्ग्युमेंट (JSON-जैसे) या कमांड शब्द। |
265
+ | `capability.expect` | `""` | देखे गए आउटपुट में अपेक्षित शब्दशः मान (केस-असंवेदी उपस्ट्रिंग)। |
266
+ | `uninstallTimeoutMs` | `120000` | `dsh plugin remove` चरण की समय-सीमा (मि.से.)। |
267
+ | `outputTailBytes` | `8000` | प्रति चरण दर्ज sanitized आउटपुट-पुच्छ की सीमा (बाइट)। |
268
+ | `keepTempDirs` | `false` | विफलता पर अस्थायी निर्देशिकाएँ फ़ॉरेंसिक के लिए रख छोड़ें (स्वामित्व छोड़ दिया जाता है; सफ़ाई आपकी)। |
269
+ | `maxBatchTargets` | `20` | `/testdrive` बैच की सीमा। |
270
+ | `batchConcurrency` | `1` | बैच की समवर्तीता (सीरियल रहने से pnpm-store विवाद टलता है)। |
271
+
272
+ </details>
273
+
274
+ प्रोफ़ाइल पैच में ओवरराइड उदाहरण:
275
+
276
+ ```yaml
277
+ - insert:
278
+ - id: test-drive
279
+ name: dsh-test-drive
280
+ config:
281
+ headlessTask: "Reply with exactly: ok"
282
+ forwardEnv: [DEEPSEEK_API_KEY]
283
+ capability:
284
+ enabled: true
285
+ kind: tool
286
+ name: plugin_vet
287
+ args: '{}'
288
+ expect: pass
289
+ ```
290
+
291
+ ## FAQ
292
+
293
+ <details>
294
+ <summary>क्या यह मेरे असली <code>~/.dsh</code> को छूता है?</summary>
295
+
296
+ नहीं। हर परीक्षण OS की अस्थायी निर्देशिका के नीचे नई `mkdtemp` जड़ में चलता है: थ्रोअवे `DSH_HOME`, थ्रोअवे कार्यशील निर्देशिका और रीडायरेक्ट किया गया pnpm store। परीक्षित प्लगइन का कोड केवल उसी प्रोफ़ाइल में चलता है; होस्ट प्रोफ़ाइल न पढ़ी जाती है न लिखी जाती, और संरचित रिकॉर्ड `isolation.hostHomeTouched: false` कहता है। सफ़ाई केवल इस प्लगइन द्वारा पंजीकृत निर्देशिकाएँ स्वीकार करती है — `%TEMP%` की पूरी स्कैनिंग नहीं, पराए उपसर्ग नहीं, असली होम पथ नहीं।
297
+
298
+ </details>
299
+
300
+ <details>
301
+ <summary>यदि कंपोज़िशन में <code>storageDomain</code> न हो तो क्या होता है?</summary>
302
+
303
+ टूल काम करते रहते हैं, बस रिपोर्टें स्थायी नहीं होतीं: प्लगइन कारण लॉग करके persistence बंद कर देता है, और `drive_report` नाटक करने के बजाय ईमानदारी से विफल होता है। इसके विपरीत जिन कंपोज़िशन में `storageDomain` है वे रिकॉर्ड `test_drive` डोमेन में रखते हैं (तालिकाएँ `runs`, `matrices`, और नवीनतम-मैट्रिक्स पॉइंटर)।
304
+
305
+ </details>
306
+
307
+ <details>
308
+ <summary>क्या परीक्षित चाइल्ड प्रोसेस को मेरी क्रेडेंशियल मिलती हैं?</summary>
309
+
310
+ डिफ़ॉल्ट रूप से नहीं। चाइल्ड प्रोसेस ऐसा वातावरण पाते हैं जिससे क्रेडेंशियल हटा दिए गए हैं; जब तक आप `forwardEnv` में कोई चर स्पष्ट रूप से नामित न करें (केवल नाम), होस्ट रहस्य परीक्षित प्रोफ़ाइल तक नहीं पहुँचते, और वे मान कभी लॉग नहीं होते। इसके अलावा हर रिपोर्ट और लॉग स्ट्रिंग शुद्ध sanitizer से गुज़रती है: टोकन शब्दशः मान, URL क्रेडेंशियल और bearer हेडर लाल किए जाते हैं, अस्थायी जड़ के पथ `<testdrive-temp>` बन जाते हैं, और आउटपुट-पुच्छ बाइट-सीमित रहती है।
311
+
312
+ </details>
313
+
314
+ <details>
315
+ <summary>बूट चरण अक्सर केवल <code>boot-ok</code> पर क्यों रुक जाता है?</summary>
316
+
317
+ क्योंकि बूट जाँच को क्रेडेंशियल नहीं चाहिए, जबकि एक-बार की टास्क पूरी करने को चाहिए। क्रेडेंशियल के बिना प्लगइन ईमानदार `boot-ok` बताता है — कोई loader विफलता नहीं मिली और टास्क पूरी नहीं हुई — बजाय इसके कि असत्यापित चीज़ को `pass` लिख दे। `pass` तक पहुँचने के लिए `forwardEnv` से क्रेडेंशियल स्पष्ट रूप से भेजें (उनके मान फिर भी लॉग में नहीं जाते)।
318
+
319
+ </details>
320
+
321
+ <details>
322
+ <summary>विफलता पर अस्थायी निर्देशिकाएँ बची रह जाती हैं?</summary>
323
+
324
+ चुपचाप नहीं। सफ़ाई `finally` में चलती है — सफलता, विफलता, टाइमआउट और निरस्त — और प्लगइन टियरडाउन पर एक बार फिर; हटाने से पहले जड़ को `dsh-test-drive-quarantine-<ts>` निर्देशिका में बदला जाता है, सत्यापित किया जाता है और तभी हटाया जाता है। हटाना विफल हो तो निर्देशिका क्वारंटीन में रहती है और रिपोर्ट होती है। घटनास्थल सुरक्षित रखना हो तो `keepTempDirs: true` रखें — तब स्वामित्व छोड़ दिया जाता है और सफ़ाई आपके ज़िम्मे आती है।
325
+
326
+ </details>
327
+
328
+ ## सुरक्षा सीमाएँ
329
+
330
+ - **आइसोलेशन।** हर परीक्षण OS की अस्थायी निर्देशिका के नीचे नई `mkdtemp` जड़ में चलता है: थ्रोअवे `DSH_HOME`, थ्रोअवे कार्यशील निर्देशिका और रीडायरेक्ट किया गया pnpm store। परीक्षित प्लगइन का कोड केवल उसी प्रोफ़ाइल में चलता है; आपकी होस्ट प्रोफ़ाइल अछूती रहती है।
331
+ - **स्वामित्व।** जीवंत रजिस्ट्री इस प्लगइन इंस्टेंस द्वारा बनाई हर जड़ दर्ज करती है। सफ़ाई हर उस पथ को अस्वीकार करती है जो पंजीकृत न हो, OS अस्थायी निर्देशिका की सीधी संतान न हो, या जिसमें `dsh-test-drive-` उपसर्ग न हो — `%TEMP%` की पूरी स्कैनिंग नहीं, पराए उपसर्ग नहीं, असली होम पथ नहीं।
332
+ - **सफ़ाई की सीढ़ी।** किसी भी बदलाव से पहले पूरा dry-run प्लान (निरपेक्ष पथ) लॉग होता है। हटाने में पहले जड़ को `dsh-test-drive-quarantine-<ts>` निर्देशिका में बदला जाता है, सत्यापन होता है, फिर हटाया जाता है; विफलता पर निर्देशिका क्वारंटीन में रहती है और रिपोर्ट होती है, कभी चुपचाप नहीं गिराई जाती। सफ़ाई सफलता, विफलता, टाइमआउट और निरस्त — सब में `finally` में चलती है, और प्लगइन टियरडाउन पर फिर से।
333
+ - **`allowBuilds` एक असली अनुमति है।** किसी git पैकेज के `prepare` build को अनुमति देना इंस्टॉल के समय उस पैकेज का कोड चलाना है। अनुमति केवल थ्रोअवे प्रोफ़ाइल तक सीमित है, फिर भी केवल उन्हीं लक्ष्यों को परखें जिन पर आप भरोसा करते हैं, और commit पिन करें।
334
+ - **headless स्मोक डिफ़ॉल्ट रूप से बिना कुंजी है।** बूट जाँच को क्रेडेंशियल नहीं चाहिए; एक-बार की टास्क पूरी करने को चाहिए। क्रेडेंशियल स्पष्ट रूप से (`forwardEnv`) भेजें और उन्हें कभी लॉग न करें।
335
+
336
+ ## अनुमतियाँ और डेटा
337
+
338
+ - **सेवा सतह।** केवल सार्वजनिक सेवाएँ खपत होती हैं: `ctx.subprocess`, `ctx.jobs`, `ctx.storageDomain`, `ctx.tools`, `ctx.commands`। `storageDomain` वैकल्पिक है — उसके बिना भी बूट और परीक्षण चलते रहते हैं।
339
+ - **अनुमतियाँ।** `dshWorkshop` मैनिफ़ेस्ट `fs:read`, `fs:write`, `subprocess:spawn`, `session:append`, `network:inherit`, `native-code:none` घोषित करता है — लेखन केवल अपनी बनाई अस्थायी जड़ों और रिपोर्ट persistence तक सीमित है, और `network:inherit` केवल होस्ट से विरासत में मिलता है (लक्ष्य के registry/git इंस्टॉल को वैसे भी नेटवर्क चाहिए)।
340
+ - **डेटा।** रिपोर्टें `test_drive` storage डोमेन में रहती हैं (तालिकाएँ `runs`, `matrices`, और नवीनतम-मैट्रिक्स पॉइंटर); वह डोमेन न हो तो रिपोर्टें स्थायी नहीं होतीं और कारण लॉग होता है।
341
+ - **सत्र लॉग।** चाइल्ड प्रोसेस को क्रेडेंशियल-रहित वातावरण मिलता है और `forwardEnv` केवल नाम भेजता है; हर रिपोर्ट/लॉग स्ट्रिंग sanitize होती है — टोकन शब्दशः मान, URL क्रेडेंशियल और bearer हेडर लाल, अस्थायी जड़ के पथ `<testdrive-temp>`, आउटपुट-पुच्छ बाइट-सीमित।
342
+
343
+ ## ज्ञात सीमाएँ
344
+
345
+ - **DSH Desktop समर्थित टेस्ट होस्ट नहीं है।** `test_drive` को ऐसा `dsh` CLI चाहिए जो दूसरा headless प्रोसेस चला सके, जबकि `dsh.CMD` launcher केवल `dsh plugin …`, `--dump-config` और `--version` की अनुमति देता है; `dshBin` को npm/pnpm से इंस्टॉल किए `dsh` पर इंगित करें।
346
+ - registry/git लक्ष्य इंस्टॉल करने के लिए चाइल्ड `dsh`/pnpm प्रोसेस को नेटवर्क पहुँच चाहिए।
347
+ - स्मोक टास्क को `pass` तक पहुँचने के लिए मॉडल क्रेडेंशियल चाहिए; बिना उनके यह ईमानदार `boot-ok` बताता है।
348
+ - जिन कंपोज़िशन में `storageDomain` नहीं है वहाँ रिपोर्टें स्थायी नहीं होतीं (`drive_report` ईमानदारी से विफल होता है)।
349
+ - `dsh` का PATH पर मिलना ज़रूरी है (या `dshBin` सेट करें); Windows पर npm का `.cmd`/`.bat` shim स्वतः पार्स होता है, पर केवल `.ps1` मिलने पर `dshBin` माँगा जाता है।
350
+ - बैच डिफ़ॉल्ट रूप से सीरियल चलते हैं; `batchConcurrency` बढ़ाने से pnpm-store की डिस्क साझा होती है, शुद्धता नहीं बदलती।
351
+
352
+ ## अन्य DSH प्लगइनों के साथ इंटरऑपरेबिलिटी
353
+
354
+ `dsh-test-drive` दो टूल और एक कमांड देता है, और दूसरे प्लगइनों की seams में शामिल नहीं होता:
355
+
356
+ - **नेमस्पेस अलगाव।** केवल `test_drive` और `drive_report`, तथा `/testdrive` कमांड पंजीकृत करता है — अंतर्निहित टूल या अन्य प्लगइनों के किसी नंगे नाम पर कब्ज़ा नहीं।
357
+ - **क्लाइंट या HTTP संसाधन नहीं।** इस पैकेज का कोई `client/` आधा नहीं है: क्लाइंट slot नहीं, `webServer` उपसर्ग नहीं, `agent/pre-step` या `tools/post-execute` waterfall श्रोता नहीं (`AGENTS.md` दर्ज करता है कि यह प्लगइन आज कोई waterfall श्रोता पंजीकृत नहीं करता), और ग्लोबल ऑब्जेक्ट पर कोई बदलाव नहीं।
358
+ - **सेवा-कुंजी टकराव नहीं।** कोई सेवा कुंजी नहीं देता और केवल `subprocess`, `jobs`, `tools`, `commands` तथा वैकल्पिक `storageDomain` खपत करता है।
359
+ - **patch परत केवल अपनी पंक्ति डालती है।** bundle patch केवल अपनी एक `test-drive` पंक्ति `insert` करता है और अंतर्निहित पंक्ति का `config` कभी नहीं लिखता।
360
+ - **पंजीकरण एक effect है।** टूल, कमांड और डोमेन-क्लोज़र सब `ctx.effect` के भीतर पंजीकृत होते हैं; रोकने या हॉट-रीलोड पर केवल वही रद्द होता है जो इस प्लगइन ने पंजीकृत किया, और अस्थायी-जड़ रजिस्ट्री अपने disposer से बची चीज़ें समेट लेती है।
361
+
362
+ ## संगतता
363
+
364
+ | सतह | स्थिति |
365
+ |---|---|
366
+ | Harness | DeepSeek Harness `dsh-v0.2.1-alpha.1` (GitHub tag, 2026-09-11 को सत्यापित: पूर्ण गेट शृंखला + profile इंस्टॉल स्मोक)। npm निर्भरता पंक्तियाँ `0.1.2-rc.1` और `0.1.7-rc.2`; `engines.dsh`: `>=0.2.1-0 <0.3.0 \|\| >=0.2.2-0 <0.3.0` |
367
+ | Node | `^22.19.0 \|\| >=24.9.0` |
368
+ | पैकेज प्रबंधक | `pnpm@11.7.0` |
369
+ | प्लेटफ़ॉर्म | Windows / macOS / Linux (शुद्ध host प्लगइन, कोई UI आधा नहीं) |
370
+ | बाहरी टूल | PATH पर `dsh` CLI (स्वतः पता, npm shim पार्स), PATH पर `pnpm` |
371
+
372
+ ## इकोसिस्टम और गुणवत्ता
373
+
374
+ - [Gitee मिरर](https://gitee.com/perrylink/dsh-test-drive) (सिंक मिरर; GitHub कैनोनिकल है)
375
+ - [dshfind प्लगइन पेज](https://dshfind.com/plugins/PerryLink/dsh-test-drive) (इंस्टॉल और रैंकिंग)
376
+ - [OpenSSF Scorecard रिपोर्ट](https://securityscorecards.dev/viewer/?uri=github.com/PerryLink/dsh-test-drive) ([.github/workflows/scorecard.yml](.github/workflows/scorecard.yml) द्वारा संचालित)
377
+ - [dsh-plugin-doctor सत्यापन रिपोर्ट](https://github.com/PerryLink/dsh-plugin-doctor#verified-徽章) (इस रेपो के [.github/workflows/plugin-doctor.yml](.github/workflows/plugin-doctor.yml) द्वारा संचालित)
378
+ - [DSH Market](https://dsh.market/) (सूचीबद्ध)
379
+ - **1024 स्टोर चैनल**: एक बार `npm i -g dsh1024`, फिर `dsh1024 plugin --profile web add dsh-test-drive` ([deepseek1024.com](https://deepseek1024.com) इंस्टॉल रैंकिंग में गिना जाता है)
380
+ - [इकोसिस्टम नॉलेज बेस](https://perrylink.github.io/dsh-plugin-guide/) — मापे गए आँकड़े, मार्केटिंग नहीं: डेवलपमेंट गाइड · चयन डेटा · रखरखाव मानदंड
381
+
382
+ ## डेवलपमेंट
383
+
384
+ ```sh
385
+ pnpm install # node ^22.19 || >=24.9
386
+ pnpm run typecheck # tsc: src + tests, @deepseek-ai/* स्थानीय harness checkout से हल
387
+ pnpm run typecheck:ci # tsc: प्रकाशित host टाइप के विरुद्ध
388
+ pnpm test # vitest
389
+ pnpm run build # node scripts/prepare.mjs (tsdown bundle + declarations)
390
+ pnpm run verify:self-contained # निर्भरता स्पेक registry से हल होती हैं
391
+ pnpm run verify:artifacts # भेजी गई फ़ाइलें मौजूद + lib/index.js इम्पोर्ट योग्य
392
+ pnpm run check:readmes # पाँच-भाषा README संगति
393
+ pnpm pack # प्रकाशित tarball
394
+ ```
395
+
396
+ - `typecheck` स्थानीय harness checkout से `@deepseek-ai/*` हल करता है; `typecheck:ci` प्रकाशित host टाइप के विरुद्ध जाँचता है।
397
+ - टेस्ट असली `Context`/`Session`/`ToolRuntime`/`LocalJobRegistry`/storage स्टैक और स्क्रिप्टेड subprocess provider इस्तेमाल करते हैं।
398
+ - असली CLI के साथ एंड-टू-एंड (नेटवर्क + PATH पर `dsh` चाहिए): `DSH_TESTDRIVE_E2E=1 pnpm run test:e2e` — इस पैकेज के अपने checkout को असली इंस्टॉल-स्मोक लूप से चलाता है।
399
+ - रिलीज़: `node scripts/release.mjs <x.y.z>` (संस्करण बढ़ाता, CHANGELOG पर तिथि लगाता, गेट दोबारा चलाता, commit + tag करता; push नहीं)।
400
+
401
+ ### GitHub Action (action.yml)
402
+
403
+ रेपो में एक composite [`action.yml`](action.yml) मौजूद है जिसे किसी भी प्लगइन रेपो में `uses:` से दोबारा इस्तेमाल किया जा सकता है: यह आइसोलेटेड थ्रोअवे प्रोफ़ाइल में लक्ष्य चलाता है और CI द्वारा खपत की जाने वाली रिपोर्ट-जोड़ी देता है — Markdown (PR टिप्पणी) और JUnit XML (test reporter / स्थिति जाँच)।
404
+
405
+ ```yaml
406
+ # .github/workflows/test-drive.yml
407
+ name: test-drive
408
+ on: [pull_request, workflow_dispatch]
409
+ jobs:
410
+ smoke:
411
+ runs-on: ubuntu-latest
412
+ steps:
413
+ - uses: actions/checkout@v4
414
+ - name: Drive this plugin
415
+ id: drive
416
+ uses: PerryLink/dsh-test-drive@v0.2.4
417
+ with:
418
+ target: github:${{ github.repository }}#${{ github.sha }}
419
+ - name: Publish JUnit
420
+ uses: EnricoMi/publish-unit-test-result-action@v2
421
+ with:
422
+ files: ${{ steps.drive.outputs.junit }}
423
+ - name: Comment the report
424
+ run: cat "${{ steps.drive.outputs.markdown }}"
425
+ ```
426
+
427
+ `action.yml` इनपुट: `target` (आवश्यक), `headless-task` (वैकल्पिक स्मोक टास्क) और `dsh-version` (`dsh` CLI स्पेक); आउटपुट: `markdown`, `junit` (रिपोर्ट पथ) और `verdict` (`pass`/`fail`/`partial`/`unknown`)। चालन स्वयं बिना कुंजी रहता है (install → patch जाँच → बूट स्मोक → अनइंस्टॉल → सफ़ाई); केवल capability दावे को `DEEPSEEK_API_KEY` चाहिए, और उसके बिना वह `skipped` रहता है, विफल नहीं।
428
+
429
+ वही रिपोर्ट-जोड़ी प्रोग्रामेटिक रूप से भी मिलती है: `renderDriveResult` / `renderMatrix` (Markdown) और `renderDriveJUnitXml` / `renderMatrixJUnitXml` (JUnit) पैकेज रूट से निर्यात होते हैं और स्थिर `DriveResult` या `MatrixRecord` पर काम करते हैं।
430
+
431
+ README की छवियाँ [`scripts/gen-readme-assets.py`](scripts/gen-readme-assets.py) (Python + Pillow) से प्रोग्रामेटिक रूप में बनती हैं और सुरक्षित रूप से दोबारा चलाई जा सकती हैं: `python scripts/gen-readme-assets.py`।
432
+
433
+ Topics: `dsh`, `dsh-plugin`, `deepseek-harness`, `deepseek`, `cordis`, `plugin-testing`, `install-smoke`, `compatibility-matrix`, `ci`
434
+
435
+ ## परिवार और आभार
436
+
437
+ यह प्रोजेक्ट [PerryLink](https://github.com/PerryLink) के DeepSeek Harness प्लगइन परिवार का हिस्सा है (सभी Apache-2.0)। अगर यह उपयोगी लगे, तो **एक स्टार अगले व्यक्ति को इसे खोजने में मदद करता है** — इसके पीछे कुछ भी लॉक नहीं है।
438
+
439
+ - [@PerryLink](https://github.com/PerryLink) — निर्माता और रखरखावकर्ता: एकल-लक्ष्य पाइपलाइन, क्षमता-दावा चरण, अस्थायी-जड़ स्वामित्व और आइसोलेशन सफ़ाई सीढ़ी, संरचित परिणाम अनुबंध, और पाँच-भाषा दस्तावेज़।
440
+
441
+ <details>
442
+ <summary>सभी प्लगइन खोलें</summary>
443
+
444
+ | प्लगइन | स्थिति |
445
+ |---|---|
446
+ | **[dsh-aqua-input-check](https://github.com/PerryLink/dsh-aqua-input-check)** | |
447
+ | **[dsh-archive-check](https://github.com/PerryLink/dsh-archive-check)** | |
448
+ | **[dsh-auto-review](https://github.com/PerryLink/dsh-auto-review)** | |
449
+ | **[dsh-autotier](https://github.com/PerryLink/dsh-autotier)** | 🧊 फ़्रोज़न — रेपो README देखें |
450
+ | **[dsh-bid-ca-precheck](https://github.com/PerryLink/dsh-bid-ca-precheck)** | |
451
+ | **[dsh-bid-qual-check](https://github.com/PerryLink/dsh-bid-qual-check)** | |
452
+ | **[dsh-cert-mcp](https://github.com/PerryLink/dsh-cert-mcp)** | 🧊 फ़्रोज़न — रेपो README देखें |
453
+ | **[dsh-checkpoint-rewind](https://github.com/PerryLink/dsh-checkpoint-rewind)** | |
454
+ | **[dsh-click](https://github.com/PerryLink/dsh-click)** | |
455
+ | **[dsh-composer-history](https://github.com/PerryLink/dsh-composer-history)** | |
456
+ | **[dsh-contract-stance](https://github.com/PerryLink/dsh-contract-stance)** | |
457
+ | **[dsh-customs-doc-check](https://github.com/PerryLink/dsh-customs-doc-check)** | |
458
+ | **[dsh-data-quality](https://github.com/PerryLink/dsh-data-quality)** | 🧊 फ़्रोज़न — रेपो README देखें |
459
+ | **[dsh-demurrage-ledger](https://github.com/PerryLink/dsh-demurrage-ledger)** | |
460
+ | **[dsh-doublecheck](https://github.com/PerryLink/dsh-doublecheck)** | |
461
+ | **[dsh-drill-script-check](https://github.com/PerryLink/dsh-drill-script-check)** | |
462
+ | **[dsh-eia-guide-check](https://github.com/PerryLink/dsh-eia-guide-check)** | |
463
+ | **[dsh-emergency-plan](https://github.com/PerryLink/dsh-emergency-plan)** | |
464
+ | **[dsh-essay-rubric-check](https://github.com/PerryLink/dsh-essay-rubric-check)** | |
465
+ | **[dsh-evidence-check](https://github.com/PerryLink/dsh-evidence-check)** | |
466
+ | **[dsh-export-ctl-check](https://github.com/PerryLink/dsh-export-ctl-check)** | |
467
+ | **[dsh-fast](https://github.com/PerryLink/dsh-fast)** | |
468
+ | **[dsh-fmea-table-check](https://github.com/PerryLink/dsh-fmea-table-check)** | |
469
+ | **[dsh-forecast-penalty](https://github.com/PerryLink/dsh-forecast-penalty)** | |
470
+ | **[dsh-fund-research](https://github.com/PerryLink/dsh-fund-research)** | |
471
+ | **[dsh-github](https://github.com/PerryLink/dsh-github)** | |
472
+ | **[dsh-gongwen-flow-check](https://github.com/PerryLink/dsh-gongwen-flow-check)** | |
473
+ | **[dsh-gongwen-word-check](https://github.com/PerryLink/dsh-gongwen-word-check)** | |
474
+ | **[dsh-guard-plan-qc](https://github.com/PerryLink/dsh-guard-plan-qc)** | |
475
+ | **[dsh-hazchem-check](https://github.com/PerryLink/dsh-hazchem-check)** | |
476
+ | **[dsh-hazplan-check](https://github.com/PerryLink/dsh-hazplan-check)** | |
477
+ | **[dsh-hidden-risk-map](https://github.com/PerryLink/dsh-hidden-risk-map)** | |
478
+ | **[dsh-hs-classify](https://github.com/PerryLink/dsh-hs-classify)** | |
479
+ | **[dsh-icd-rule-check](https://github.com/PerryLink/dsh-icd-rule-check)** | |
480
+ | **[dsh-industry-research](https://github.com/PerryLink/dsh-industry-research)** | |
481
+ | **[dsh-lawcite-adapter](https://github.com/PerryLink/dsh-lawcite-adapter)** | |
482
+ | **[dsh-laya](https://github.com/PerryLink/dsh-laya)** | |
483
+ | **[dsh-lc-doc-check](https://github.com/PerryLink/dsh-lc-doc-check)** | |
484
+ | **[dsh-learning-gap-check](https://github.com/PerryLink/dsh-learning-gap-check)** | |
485
+ | **[dsh-library](https://github.com/PerryLink/dsh-library)** | |
486
+ | **[dsh-local-ai](https://github.com/PerryLink/dsh-local-ai)** | |
487
+ | **[dsh-lsp-actions](https://github.com/PerryLink/dsh-lsp-actions)** | |
488
+ | **[dsh-mask](https://github.com/PerryLink/dsh-mask)** | |
489
+ | **[dsh-mcp-panel](https://github.com/PerryLink/dsh-mcp-panel)** | |
490
+ | **[dsh-medrec-qc](https://github.com/PerryLink/dsh-medrec-qc)** | |
491
+ | **[dsh-memento](https://github.com/PerryLink/dsh-memento)** | 🧊 फ़्रोज़न — रेपो README देखें |
492
+ | **[dsh-nsfc-form-check](https://github.com/PerryLink/dsh-nsfc-form-check)** | |
493
+ | **[dsh-nurse-record-check](https://github.com/PerryLink/dsh-nurse-record-check)** | |
494
+ | **[dsh-observe](https://github.com/PerryLink/dsh-observe)** | |
495
+ | **[dsh-origin-rvc-check](https://github.com/PerryLink/dsh-origin-rvc-check)** | |
496
+ | **[dsh-ota-review-check](https://github.com/PerryLink/dsh-ota-review-check)** | |
497
+ | **[dsh-output-styles](https://github.com/PerryLink/dsh-output-styles)** | |
498
+ | **[dsh-paper-doc-adapter](https://github.com/PerryLink/dsh-paper-doc-adapter)** | |
499
+ | **[dsh-permission-rules](https://github.com/PerryLink/dsh-permission-rules)** | |
500
+ | **[dsh-permit-report-check](https://github.com/PerryLink/dsh-permit-report-check)** | |
501
+ | **[dsh-pipeline-check](https://github.com/PerryLink/dsh-pipeline-check)** | |
502
+ | **[dsh-pleading-draft](https://github.com/PerryLink/dsh-pleading-draft)** | |
503
+ | **[dsh-plugin-doctor](https://github.com/PerryLink/dsh-plugin-doctor)** | 🚫 रिटायर्ड (रेपो संग्रहीत) |
504
+ | **[dsh-plugin-guide](https://github.com/PerryLink/dsh-plugin-guide)** | |
505
+ | **[dsh-plugin-kit](https://github.com/PerryLink/dsh-plugin-kit)** | 🚫 रिटायर्ड (रेपो संग्रहीत) |
506
+ | **[dsh-plugin-upgrade](https://github.com/PerryLink/dsh-plugin-upgrade)** | 🚫 रिटायर्ड (रेपो संग्रहीत) |
507
+ | **[dsh-policy-brief-draft](https://github.com/PerryLink/dsh-policy-brief-draft)** | |
508
+ | **[dsh-power-loss-split](https://github.com/PerryLink/dsh-power-loss-split)** | |
509
+ | **[dsh-power-ticket-check](https://github.com/PerryLink/dsh-power-ticket-check)** | |
510
+ | **[dsh-ppap-check](https://github.com/PerryLink/dsh-ppap-check)** | |
511
+ | **[dsh-protest-deadline](https://github.com/PerryLink/dsh-protest-deadline)** | |
512
+ | **[dsh-railway-window](https://github.com/PerryLink/dsh-railway-window)** | |
513
+ | **[dsh-repair-order-qc](https://github.com/PerryLink/dsh-repair-order-qc)** | |
514
+ | **[dsh-research-report](https://github.com/PerryLink/dsh-research-report)** | |
515
+ | **[dsh-review-reply-check](https://github.com/PerryLink/dsh-review-reply-check)** | |
516
+ | **[dsh-rulefile-check](https://github.com/PerryLink/dsh-rulefile-check)** | |
517
+ | **[dsh-safety-brief-check](https://github.com/PerryLink/dsh-safety-brief-check)** | |
518
+ | **[dsh-score](https://github.com/PerryLink/dsh-score)** | 🧊 फ़्रोज़न — रेपो README देखें |
519
+ | **[dsh-session-sync](https://github.com/PerryLink/dsh-session-sync)** | |
520
+ | **[dsh-site-log-check](https://github.com/PerryLink/dsh-site-log-check)** | |
521
+ | **[dsh-skill-pack-security](https://github.com/PerryLink/dsh-skill-pack-security)** | |
522
+ | **[dsh-soe-decision-check](https://github.com/PerryLink/dsh-soe-decision-check)** | |
523
+ | **[dsh-soilwater-check](https://github.com/PerryLink/dsh-soilwater-check)** | |
524
+ | **[dsh-sop-sync-check](https://github.com/PerryLink/dsh-sop-sync-check)** | |
525
+ | **[dsh-spc-gbt-adapter](https://github.com/PerryLink/dsh-spc-gbt-adapter)** | |
526
+ | **[dsh-talk](https://github.com/PerryLink/dsh-talk)** | |
527
+ | **[dsh-tender-extract](https://github.com/PerryLink/dsh-tender-extract)** | |
528
+ | **[dsh-tender-matrix](https://github.com/PerryLink/dsh-tender-matrix)** | |
529
+ | **[dsh-test-drive](https://github.com/PerryLink/dsh-test-drive)** | |
530
+ | **[dsh-ticktick](https://github.com/PerryLink/dsh-ticktick)** | 🚫 रिटायर्ड (रेपो संग्रहीत) |
531
+ | **[dsh-translate](https://github.com/PerryLink/dsh-translate)** | |
532
+ | **[dsh-warranty-calc](https://github.com/PerryLink/dsh-warranty-calc)** | |
533
+ | **[dsh-budget](https://github.com/PerryLink/dsh-budget)** | 🧊 फ़्रोज़न — रेपो README देखें |
534
+ | **[dsh-claude-move](https://github.com/PerryLink/dsh-claude-move)** | 🧊 फ़्रोज़न — रेपो README देखें |
535
+ | **[dsh-defend](https://github.com/PerryLink/dsh-defend)** | 🧊 फ़्रोज़न — रेपो README देखें |
536
+ | **[dsh-draw](https://github.com/PerryLink/dsh-draw)** | 🧊 फ़्रोज़न — रेपो README देखें |
537
+ | **[dsh-reach](https://github.com/PerryLink/dsh-reach)** | 🧊 फ़्रोज़न — रेपो README देखें |
538
+ | **[dsh-background-agents](https://github.com/PerryLink/dsh-background-agents)** | 🚫 रिटायर्ड (रेपो संग्रहीत) |
539
+ | **[dsh-session-pin](https://github.com/PerryLink/dsh-session-pin)** | 🚫 रिटायर्ड (रेपो संग्रहीत) |
540
+ | **[dsh-team-rooms](https://github.com/PerryLink/dsh-team-rooms)** | 🚫 रिटायर्ड (रेपो संग्रहीत) |
541
+
542
+ </details>
543
+
544
+ ## लाइसेंस
545
+
546
+ [LICENSE](LICENSE) (Apache License 2.0) © 2026 dsh-test-drive contributors
547
+
548
+ <p align="center"><sub>Apache-2.0 · सामुदायिक प्लगइन, DeepSeek से असंबद्ध।</sub></p>