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 DELETED
@@ -1,418 +0,0 @@
1
- <div align="center">
2
-
3
- # 🧪 dsh-test-drive
4
- - **1024 स्टोर चैनल**: एक बार `npm i -g dsh1024`, फिर `dsh1024 plugin --profile web add dsh-test-drive` ([deepseek1024.com](https://deepseek1024.com) इंस्टॉल रैंकिंग में गिना जाता है)।
5
-
6
- **DeepSeek Harness प्लगइन के लिए पृथक इंस्टॉल-और-स्मोक परीक्षण।**
7
-
8
- *एक डिस्पोज़ेबल प्रोफ़ाइल में इंस्टॉल, स्मोक, सत्यापन और सफ़ाई करें — आपका असली `~/.dsh` अछूता रहता है।*
9
-
10
- [![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
11
- [![Gitee](https://img.shields.io/badge/Gitee-mirror-c71d23?logo=gitee)](https://gitee.com/perrylink/dsh-test-drive)
12
- [![DSH plugin](https://img.shields.io/badge/dsh--plugin-✅-green)](https://github.com/topics/dsh-plugin)
13
- [![dsh-doctor](https://raw.githubusercontent.com/PerryLink/dsh-plugin-doctor/main/badges/PerryLink__dsh-test-drive.svg)](https://github.com/PerryLink/dsh-plugin-doctor#verified-徽章)
14
- [![DSH Market](https://raw.githubusercontent.com/2BingLing/dsh-market/master/assets/readme/badge-listed-en.svg)](https://dsh.market/)
15
- [![Node](https://img.shields.io/badge/node-%5E22.19%20%7C%7C%20%3E%3D24-brightgreen.svg)](#)
16
- [![CI](https://img.shields.io/github/actions/workflow/status/PerryLink/dsh-test-drive/ci.yml?branch=main&label=CI)](https://github.com/PerryLink/dsh-test-drive/actions)
17
- [![Version](https://img.shields.io/github/v/tag/PerryLink/dsh-test-drive?label=version)](https://github.com/PerryLink/dsh-test-drive/releases)
18
- [![npm version](https://img.shields.io/npm/v/dsh-test-drive)](https://www.npmjs.com/package/dsh-test-drive)
19
- [![npm downloads](https://img.shields.io/npm/dm/dsh-test-drive)](https://www.npmjs.com/package/dsh-test-drive)
20
-
21
- [English](README.md) · [简体中文](README-zh.md) · [Español](README-es.md) · [Português](README-pt.md) · [हिन्दी](README-hi.md)
22
-
23
- ```sh
24
- dsh plugin --profile <name> add dsh-test-drive
25
- ```
26
-
27
-
28
- </div>
29
-
30
- ---
31
-
32
-
33
- **📖 इकोसिस्टम नॉलेज बेस** — मापे गए आँकड़े, मार्केटिंग नहीं: [डेवलपमेंट गाइड · चयन डेटा · रखरखाव मानदंड](https://perrylink.github.io/dsh-plugin-guide/)।
34
-
35
- <!-- star-cta -->
36
- ## Install & uninstall (इंस्टॉल और अनइंस्टॉल)
37
-
38
- ```sh
39
- dsh plugin --profile web add dsh-test-drive # इंस्टॉल (npm) — या ऊपर वाला git रूप
40
- dsh plugin --profile web remove dsh-test-drive # अनइंस्टॉल
41
- ```
42
-
43
- ## ⭐ 如果它帮到了你
44
-
45
- यह प्लगइन [DSH प्लगइन परिवार](https://github.com/PerryLink) का हिस्सा है (95 प्लगइन, सभी Apache-2.0)। अगर यह उपयोगी लगे, तो **एक स्टार दें** — इससे कोई सुविधा अनलॉक नहीं होती, पर अगला व्यक्ति इसे खोज में आसानी से पा लेता है।
46
-
47
- *English:* part of a 95 plugin family for DeepSeek Harness. If it is useful, **a star helps the next person find it** — nothing is gated behind it.
48
-
49
- ## What is dsh-test-drive?
50
-
51
- DeepSeek Harness प्लगइन के लिए पृथक इंस्टॉल-और-स्मोक परीक्षण।
52
-
53
- एक डिस्पोज़ेबल प्रोफ़ाइल में इंस्टॉल, स्मोक, सत्यापन और सफ़ाई करें — आपका असली `~/.dsh` अछूता रहता है।
54
-
55
- ![dsh-test-drive कार्यप्रवाह आरेख: प्रश्न → सीलबंद स्रोत → रिपोर्ट।](docs/assets/dsh-test-drive-flow.svg)
56
-
57
- *कार्यप्रवाह: प्रश्न → सीलबंद स्रोत → रिपोर्ट। नीचे के उदाहरण वास्तविक कमांड सतह का उपयोग करते हैं।*
58
-
59
-
60
- *वही रन, एनिमेटेड।*
61
-
62
- ## Compatibility (संगतता)
63
-
64
- | घटक | संस्करण |
65
- |---|---|
66
- | DeepSeek Harness | **`dsh-v0.2.1-alpha.1`** (GitHub tag, 2026-09-11 को सत्यापित: पूर्ण गेट श्रृंखला + प्रोफ़ाइल इंस्टॉल स्मोक)। npm निर्भरता लाइन `0.1.2-rc.1` और `0.1.7-rc.2` (peer निर्भरताएँ `>=0.1.2-rc.1 <0.2.0 || >=0.1.5-alpha.1 <0.2.0`)。 |
67
- | Node.js | `^22.19.0 \|\| >=24.0.0` |
68
- | पैकेज प्रबंधक | `pnpm@11.7.0` |
69
- | प्लेटफ़ॉर्म | Windows / macOS / Linux (केवल host प्लगइन) |
70
- | बाहरी उपकरण | PATH पर `dsh` CLI (स्वतः-पहचान, npm shim पार्स किए जाते हैं), PATH पर `pnpm` |
71
-
72
- ## What you get (आपको क्या मिलता है)
73
-
74
- - `test_drive` उपकरण — एक लक्ष्य को पूरी पाइपलाइन से गुज़ारता है: `dsh plugin add` → `--dump-config` पैच जाँच → हेडलेस बूट स्मोक (FAILED मार्कर स्कैन + वैकल्पिक एक-वाक्य कार्य) → वैकल्पिक क्षमता-पुष्टि → `dsh plugin remove` → क्वारंटीन सफ़ाई। संरचित रिकॉर्ड समकालिक रूप से लौटाता है, या `background: true` पर `{ kind: 'background', jobId }`।
75
- - `/testdrive` कमांड — स्पेस/कॉमा से अलग किए गए लक्ष्यों की सूची को `ctx.jobs` पर `drive-batch` पृष्ठभूमि कार्य के रूप में चलाकर मैट्रिक्स रिपोर्ट (JSON + Markdown) बनाता है।
76
- - `drive_report` उपकरण — किसी भी रन (`tdr_...`), मैट्रिक्स (`tdm_...`) या नवीनतम मैट्रिक्स को लाता है; Markdown में प्रस्तुत होता है।
77
- - क्षमता-पुष्टि — “बूट हुआ और बाहर निकला” से आगे: वैकल्पिक `capability` चरण एजेंट से नामित उपकरण को बुलवाता है (या `/command` चलवाता है) और टिकाऊ सत्र लॉग में आह्वान तथा `expect` वाला प्रेक्षित आउटपुट सत्यापित करता है। साफ़ बूट केवल स्मोक टेस्ट है; `observed` सिद्ध करता है कि नामित क्षमता सचमुच काम करती है।
78
- - संरचित परिणाम — हर रिकॉर्ड में विभेदक `schema: "dsh-test-drive/v1"` और प्रथम-श्रेणी फ़ील्ड होते हैं: `stages.install.status` (`pass`/`fail`), `stages.smoke.status` (`pass`/`fail`/`boot-ok`/`skipped`), प्रति-चरण `durationMs`, सैनिटाइज़ किए गए `summary`/`outputTail`, और समग्र `verdict` (`pass`/`fail`/`partial`/`unknown`)। यही मशीन-पठनीय अनुबंध है जिसे स्कोरिंग पाइपलाइनें (dsh-score) उपभोग करती हैं।
79
- - निर्माण से सुरक्षा — हर अस्थायी निर्देशिका इस प्लगइन द्वारा समर्पित उपसर्ग `dsh-test-drive-` के तहत बनाई जाती है, एक सक्रिय स्वामित्व रजिस्ट्री में दर्ज होती है, और केवल dry-run → क्वारंटीन-नामांतरण → हटाने की सीढ़ी से हटाई जाती है। होस्ट प्रोफ़ाइल कभी पढ़ी या लिखी नहीं जाती।
80
-
81
- ## Quick start (त्वरित शुरुआत)
82
-
83
- ### git चैनल
84
-
85
- ```sh
86
- dsh plugin --profile web add github:PerryLink/dsh-test-drive#<commit-sha>
87
- ```
88
-
89
- पहला `add` विफल होता है क्योंकि pnpm पैकेज की `prepare` बिल्ड रोकता है; pnpm द्वारा छापी गई सटीक कुंजी को प्रोफ़ाइल के `pnpm-workspace.yaml` में कॉपी करें और फिर चलाएँ:
90
-
91
- ```yaml
92
- allowBuilds:
93
- 'dsh-test-drive': true
94
- ```
95
-
96
- ### npm चैनल
97
-
98
- ```sh
99
- dsh plugin --profile web add dsh-test-drive
100
- ```
101
-
102
- पहले से बने पैकेजों को बिल्ड अनुमति की आवश्यकता नहीं होती। प्रोफ़ाइल पुनः आरंभ करें, फिर सत्र से `test_drive` / `/testdrive` उपयोग करें।
103
-
104
- ## DSH Desktop समर्थित परीक्षण होस्ट नहीं है
105
-
106
- `test_drive` को ऐसा `dsh` CLI चाहिए जो **दूसरा** headless DSH प्रोसेस शुरू कर सके।
107
- DSH Desktop का `dsh.CMD` launcher केवल `dsh plugin …`, `--dump-config` और `--version`
108
- की अनुमति देता है; नीति के कारण वह दूसरा headless boot अस्वीकार करता है।
109
- `config.dshBin` को npm/pnpm से स्थापित `dsh` CLI (या सामान्य Node + dsh JS entry) पर
110
- सेट करें। अब त्रुटि “cannot parse npm shim” के बजाय यह स्पष्ट कारण बताती है।
111
-
112
- ## Configuration (विन्यास)
113
-
114
- सभी कुंजियाँ वैकल्पिक हैं (डिफ़ॉल्ट दिखाए गए); अमान्य मान लोड के समय ज़ोर से विफल होते हैं।
115
-
116
- | कुंजी | डिफ़ॉल्ट | विवरण |
117
- |---|---|---|
118
- | `profileName` | `headless` | हर डिस्पोज़ेबल DSH_HOME में आरंभ किया जाने वाला प्रोफ़ाइल टेम्पलेट (base + headless बंडल)। |
119
- | `dshBin` | `""` | dsh निष्पादनयोग्य के लिए निरपेक्ष पथ ओवरराइड; खाली = PATH पर `dsh` स्वतः-पहचान। |
120
- | `headlessTask` | `"Reply with exactly: ok"` | बूट-स्मोक चरण का एक-वाक्य कार्य; खाली = चरण छोड़ें। |
121
- | `forwardEnv` | `[]` | परीक्षण-प्रोफ़ाइल उप-प्रक्रियाओं में भेजे जाने वाले पर्यावरण चरों के **नाम** (मान कभी नहीं)। |
122
- | `allowBuilds` | `true` | परीक्षण प्रोफ़ाइल में अवरुद्ध git `prepare` बिल्ड को अनुमति दें और इंस्टॉल एक बार पुनः प्रयास करें। |
123
- | `installTimeoutMs` | `600000` | `dsh plugin add` चरण की समय-सीमा। |
124
- | `configTimeoutMs` | `60000` | `--dump-config` चरण की समय-सीमा। |
125
- | `smokeTimeoutMs` | `300000` | हेडलेस बूट-स्मोक चरण की समय-सीमा। |
126
- | `capabilityTimeoutMs` | `300000` | क्षमता-पुष्टि कार्य की समय-सीमा।
127
- | `capability.enabled` | `false` | क्षमता-पुष्टि चरण चलाएँ (पंजीकृत → आहूत → प्रेक्षित)।
128
- | `capability.kind` | `tool` | क्या जाँचें: `tool` या `command`।
129
- | `capability.name` | `""` | उपकरण या कमांड नाम (आगे `/` के बिना)।
130
- | `capability.args` | `""` | आह्वान पाठ: उपकरण तर्क (JSON-शैली) या कमांड शब्द।
131
- | `capability.expect` | `""` | प्रेक्षित आउटपुट में अपेक्षित अक्षर (केस-असंवेदी उप-स्ट्रिंग)।
132
- | `uninstallTimeoutMs` | `120000` | `dsh plugin remove` चरण की समय-सीमा। |
133
- | `outputTailBytes` | `8000` | प्रति चरण दर्ज सैनिटाइज़्ड आउटपुट टेल की सीमा। |
134
- | `keepTempDirs` | `false` | विफलता पर फ़ॉरेंसिक हेतु अस्थायी निर्देशिकाएँ रखें (स्वामित्व छोड़ा जाता है; आप साफ़ करें)। |
135
- | `maxBatchTargets` | `20` | `/testdrive` बैच सीमा। |
136
- | `batchConcurrency` | `1` | बैच समानांतरता (क्रमिक pnpm-स्टोर विवाद से बचाता है)। |
137
-
138
- ## Tools & surfaces (उपकरण और सतहें)
139
-
140
- ### `test_drive`
141
-
142
- ```
143
- test_drive(target: string, headlessTask?: string, background?: boolean,
144
- capability?: { kind: 'tool' | 'command', name: string,
145
- args: string, expect: string })
146
- ```
147
-
148
- - `target` — git स्पेक (`github:owner/repo#sha`, `git+https://...`), npm नाम, स्थानीय पथ या `.tgz` टारबॉल।
149
- - `capability` — स्मोक के बाद की पुष्टि: एजेंट `args` के साथ `name` (उपकरण) बुलाता है या `/name` (कमांड) चलाता है; चरण टिकाऊ सत्र लॉग पढ़कर `expect` वाला प्रेक्षित आउटपुट माँगता है। `DEEPSEEK_API_KEY` चाहिए (होस्ट परिवेश या `forwardEnv`); बिना उसके चरण `skipped` रहता है, कभी विफल नहीं होता।
150
- - पूरा संरचित रिकॉर्ड लौटाता है; नमूना नीचे।
151
- - `background: true` एक `drive-batch` कार्य आरंभ कर उसका id लौटाता है।
152
-
153
- ### `/testdrive <लक्ष्य...>`
154
-
155
- एक पृष्ठभूमि बैच कार्य आरंभ करता है; प्रगति कार्य आउटपुट से प्रवाहित होती है, और अंतिम पंक्ति `drive_report` के लिए मैट्रिक्स id बताती है।
156
-
157
- ### `drive_report(id?)`
158
-
159
- एक रन रिकॉर्ड (`tdr_...`), मैट्रिक्स (`tdm_...`), या — बिना id — नवीनतम मैट्रिक्स लौटाता है।
160
-
161
- ### संरचित परिणाम नमूना
162
-
163
- ```json
164
- {
165
- "schema": "dsh-test-drive/v1",
166
- "run": { "runId": "tdr_9f2c...", "startedAt": "2026-08-16T00:00:00.000Z",
167
- "finishedAt": "2026-08-16T00:00:45.120Z", "durationMs": 45120,
168
- "harnessVersion": "0.1.7-rc.2", "pluginVersion": "0.3.10",
169
- "platform": "win32", "node": "v22.22.3" },
170
- "target": { "kind": "repo", "spec": "github:owner/dsh-click#abc123",
171
- "resolved": { "packageName": "dsh-click", "packageVersion": "0.1.0",
172
- "hasBundleManifest": true } },
173
- "isolation": { "tempDshHome": true, "tempWorkspace": true, "tempStore": true,
174
- "hostHomeTouched": false },
175
- "stages": {
176
- "install": { "status": "pass", "exitCode": 0, "durationMs": 30412, "attempts": 2,
177
- "summary": "install ok after allowBuilds allowance", "outputTail": "",
178
- "allowBuildsNeeded": true },
179
- "config": { "status": "pass", "exitCode": 0, "durationMs": 2310, "attempts": 1,
180
- "summary": "dump ok (exit 0)", "outputTail": "",
181
- "patchEffective": true, "layers": ["dsh-click"] },
182
- "smoke": { "status": "boot-ok", "exitCode": 1, "durationMs": 4123, "attempts": 1,
183
- "summary": "booted without loader failures; headless task did not complete (credentials/model unreachable)",
184
- "outputTail": "", "bootFailed": false, "taskCompleted": false },
185
- "capability": { "status": "observed", "exitCode": 0, "durationMs": 8123, "attempts": 1,
186
- "summary": "tool \"plugin_vet\" called and its result contains the expectation",
187
- "outputTail": "", "capabilityKind": "tool", "name": "plugin_vet",
188
- "expectMatched": true,
189
- "detail": "tool \"plugin_vet\" called and its result contains the expectation" },
190
- "uninstall": { "status": "pass", "exitCode": 0, "durationMs": 5123, "attempts": 1,
191
- "summary": "remove ok (exit 0)", "outputTail": "" },
192
- "cleanup": { "status": "pass", "quarantined": true, "removed": true,
193
- "summary": "owned temp root quarantined and removed" }
194
- },
195
- "verdict": "pass",
196
- "verdictReason": "install, patch, boot, and uninstall verified; headless task inconclusive (see smoke.summary)"
197
- }
198
- ```
199
-
200
- निर्णय नियम: इंस्टॉल विफलता, बूट विफलता (`smoke.fail`) या `not-registered`/`failed` तक पहुँचा क्षमता चरण ⇒ `fail`; इंस्टॉल पास + पैच प्रभावी + साफ़ बूट (`pass`/`boot-ok`) + अनइंस्टॉल पास ⇒ `pass` (`observed` पर क्षमता नोट के साथ); इंस्टॉल हुआ पर बाद की कोई पुष्टि अधूरी ⇒ `partial`; अन्यथा ⇒ `unknown`।
201
-
202
- ## CI (GitHub Actions)
203
-
204
- रिपॉज़िटरी में एक composite [`action.yml`](action.yml) शामिल है जिसे किसी भी प्लगइन रिपॉ में `uses:` से दोबारा इस्तेमाल किया जा सकता है: यह लक्ष्य को एक अलग-थलग throwaway profile में चलाता है और CI द्वारा उपभोग किया जाने वाला रिपोर्ट जोड़ा — Markdown (PR कमेंट) और JUnit XML (स्टेटस चेक) — उत्सर्जित करता है। इनपुट `target` (आवश्यक)/`headless-task`/`dsh-version`; आउटपुट `markdown`/`junit`/`verdict`। ड्राइव को कुंजी की आवश्यकता नहीं है; केवल capability assertion को `DEEPSEEK_API_KEY` चाहिए और इसके बिना वह `skipped` (कभी असफल नहीं) रहती है।
205
-
206
- ## Permissions & data (अनुमतियाँ और डेटा)
207
-
208
- - केवल सार्वजनिक सेवाएँ उपभोग होती हैं: `ctx.subprocess`, `ctx.jobs`, `ctx.storageDomain`, `ctx.tools`, `ctx.commands`।
209
- - रिपोर्टें `test_drive` स्टोरेज-डोमेन (तालिकाएँ `runs`, `matrices`; नवीनतम-मैट्रिक्स संकेतक) में रहती हैं। जब संरचना में `storageDomain` नहीं है (जैसे आधिकारिक हेडलेस प्रोफ़ाइल), उपकरण चलते रहते हैं और रिपोर्ट स्थायित्व कारण सहित अक्षम होता है।
210
- - उप-प्रक्रियाओं को **क्रेडेंशियल-रहित** वातावरण मिलता है: होस्ट रहस्य तब तक परीक्षित प्रोफ़ाइल में नहीं पहुँचते जब तक आप उन्हें `forwardEnv` में नाम न दें। मान कभी लॉग नहीं होते।
211
- - सभी रिपोर्ट/लॉग स्ट्रिंग शुद्ध सैनिटाइज़र से गुज़रती हैं: टोकन अक्षर, URL क्रेडेंशियल और bearer हेडर रिडैक्ट होते हैं, अस्थायी रूट पथ `<testdrive-temp>` से बदले जाते हैं, टेल बाइट-सीमित होती हैं।
212
-
213
- ## Security boundaries (सुरक्षा सीमाएँ)
214
-
215
- - **पृथक्करण।** हर परीक्षण OS अस्थायी निर्देशिका के अंदर नई `mkdtemp` रूट में चलता है: डिस्पोज़ेबल `DSH_HOME`, डिस्पोज़ेबल कार्य निर्देशिका, और पुनर्निर्देशित pnpm स्टोर। परीक्षित प्लगइन का कोड केवल उसी प्रोफ़ाइल में चलता है; आपकी होस्ट प्रोफ़ाइल अछूती रहती है।
216
- - **स्वामित्व।** एक सक्रिय रजिस्ट्री इस इंस्टेंस की बनाई हर रूट को दर्ज करती है। सफ़ाई किसी भी ऐसे पथ को अस्वीकार करती है जो `dsh-test-drive-` उपसर्ग के साथ OS अस्थायी निर्देशिका का पंजीकृत प्रत्यक्ष उप-निर्देश न हो — कोई `%TEMP%` सफ़ाई नहीं, कोई पराया उपसर्ग नहीं, कोई असली होम पथ नहीं।
217
- - **सफ़ाई की सीढ़ी।** किसी भी परिवर्तन से पहले पूरी dry-run योजना लॉग होती है (निरपेक्ष पथ)। हटाना पहले रूट को `dsh-test-drive-quarantine-<ts>` नाम से क्वारंटीन करता है, सत्यापन करता है, फिर हटाता है; विफलता पर निर्देशिका क्वारंटीन रहती है और सूचित होती है — कभी चुपचाप नहीं छोड़ी जाती। सफ़ाई सफलता, विफलता, समय-समाप्ति और रद्दीकरण के हर रास्ते में `finally` में चलती है, और प्लगइन हटने पर फिर चलती है।
218
- - **`allowBuilds` एक वास्तविक अनुमति है।** git पैकेज की `prepare` बिल्ड की अनुमति इंस्टॉल के समय उस पैकेज का कोड चलाना है। अनुमति केवल डिस्पोज़ेबल प्रोफ़ाइल तक सीमित है, फिर भी केवल भरोसेमंद लक्ष्यों का परीक्षण करें और commit पिन करें।
219
- - **हेडलेस स्मोक डिफ़ॉल्ट रूप से कुंजी-रहित है।** बूट जाँच को क्रेडेंशियल नहीं चाहिए; एक-वाक्य कार्य पूरा करने को चाहिए। क्रेडेंशियल स्पष्ट रूप से भेजें (`forwardEnv`) और उन्हें कभी लॉग न करें।
220
-
221
- ## Known limitations (ज्ञात सीमाएँ)
222
-
223
- - रजिस्ट्री/git लक्ष्य इंस्टॉल करने के लिए उप-प्रक्रिया `dsh`/pnpm को नेटवर्क चाहिए।
224
- - स्मोक कार्य को `pass` तक पहुँचने के लिए मॉडल क्रेडेंशियल चाहिए; बिना उनके यह ईमानदार `boot-ok` दर्ज करता है।
225
- - `storageDomain` रहित संरचनाओं में रिपोर्टें स्थायी नहीं होतीं (`drive_report` ईमानदारी से विफल होता है)।
226
- - `dsh` PATH पर मिलना चाहिए (या `dshBin` सेट करें); Windows पर npm का `.cmd`/`.bat` shim स्वतः पार्स होता है, केवल `.ps1` मिलने पर `dshBin` माँगा जाता है।
227
- - बैच डिफ़ॉल्ट रूप से क्रमिक चलते हैं; `batchConcurrency` बढ़ाने से केवल pnpm-स्टोर डिस्क विवाद प्रभावित होता है, शुद्धता नहीं।
228
-
229
- ## Development (विकास)
230
-
231
- ```sh
232
- pnpm install
233
- pnpm run typecheck && pnpm run typecheck:ci && pnpm test
234
- pnpm run build && pnpm run verify:self-contained && pnpm run verify:artifacts && pnpm pack
235
- ```
236
-
237
- - `typecheck` स्थानीय harness चेकआउट से `@deepseek-ai/*` हल करता है; `typecheck:ci` प्रकाशित `0.1.7-rc.2` प्रकारों से जाँचता है।
238
- - परीक्षण वास्तविक `Context`/`Session`/`ToolRuntime`/`LocalJobRegistry`/स्टोरेज स्टैक और एक स्क्रिप्टेड subprocess प्रदाता का उपयोग करते हैं।
239
- - वास्तविक-CLI एंड-टू-एंड (नेटवर्क + PATH पर `dsh` आवश्यक): `DSH_TESTDRIVE_E2E=1 pnpm run test:e2e` — इसी पैकेज के चेकआउट को वास्तविक इंस्टॉल-स्मोक लूप से परखता है।
240
- - रिलीज़: `node scripts/release.mjs <x.y.z>` (संस्करण बढ़ाता, CHANGELOG मुहर लगाता, द्वार फिर चलाता, commit + tag; कभी push नहीं)।
241
-
242
- ## Topics
243
-
244
- `dsh`, `dsh-plugin`, `deepseek-harness`, `deepseek`, `cordis`, `plugin-testing`, `install-smoke`, `compatibility-matrix`, `ci`
245
-
246
- ## Contributors (योगदानकर्ता)
247
-
248
- [PerryLink](https://github.com/PerryLink) — डिज़ाइन और कार्यान्वयन।
249
-
250
- ## PerryLink DSH Plugin Family
251
-
252
- यह प्रोजेक्ट [PerryLink](https://github.com/PerryLink) के DeepSeek Harness प्लगइन परिवार का हिस्सा है। पूरी सूची नीचे संक्षिप्त रखी गई है ताकि हर README की पहली स्क्रीन छोटी रहे; हर पंक्ति और उसकी स्थिति देखने के लिए इसे खोलें।
253
-
254
- <details>
255
- <summary>सभी प्लगइन खोलें</summary>
256
-
257
- | प्लगइन | स्थिति |
258
- |---|---|
259
- | **[dsh-aqua-input-check](https://github.com/PerryLink/dsh-aqua-input-check)** | |
260
- | **[dsh-archive-check](https://github.com/PerryLink/dsh-archive-check)** | |
261
- | **[dsh-auto-review](https://github.com/PerryLink/dsh-auto-review)** | |
262
- | **[dsh-autotier](https://github.com/PerryLink/dsh-autotier)** | |
263
- | **[dsh-bid-ca-precheck](https://github.com/PerryLink/dsh-bid-ca-precheck)** | |
264
- | **[dsh-bid-qual-check](https://github.com/PerryLink/dsh-bid-qual-check)** | |
265
- | **[dsh-cert-mcp](https://github.com/PerryLink/dsh-cert-mcp)** | |
266
- | **[dsh-checkpoint-rewind](https://github.com/PerryLink/dsh-checkpoint-rewind)** | |
267
- | **[dsh-click](https://github.com/PerryLink/dsh-click)** | |
268
- | **[dsh-composer-history](https://github.com/PerryLink/dsh-composer-history)** | |
269
- | **[dsh-contract-stance](https://github.com/PerryLink/dsh-contract-stance)** | |
270
- | **[dsh-customs-doc-check](https://github.com/PerryLink/dsh-customs-doc-check)** | |
271
- | **[dsh-data-quality](https://github.com/PerryLink/dsh-data-quality)** | |
272
- | **[dsh-demurrage-ledger](https://github.com/PerryLink/dsh-demurrage-ledger)** | |
273
- | **[dsh-doublecheck](https://github.com/PerryLink/dsh-doublecheck)** | |
274
- | **[dsh-drill-script-check](https://github.com/PerryLink/dsh-drill-script-check)** | |
275
- | **[dsh-eia-guide-check](https://github.com/PerryLink/dsh-eia-guide-check)** | |
276
- | **[dsh-emergency-plan](https://github.com/PerryLink/dsh-emergency-plan)** | |
277
- | **[dsh-essay-rubric-check](https://github.com/PerryLink/dsh-essay-rubric-check)** | |
278
- | **[dsh-evidence-check](https://github.com/PerryLink/dsh-evidence-check)** | |
279
- | **[dsh-export-ctl-check](https://github.com/PerryLink/dsh-export-ctl-check)** | |
280
- | **[dsh-fast](https://github.com/PerryLink/dsh-fast)** | |
281
- | **[dsh-fmea-table-check](https://github.com/PerryLink/dsh-fmea-table-check)** | |
282
- | **[dsh-forecast-penalty](https://github.com/PerryLink/dsh-forecast-penalty)** | |
283
- | **[dsh-fund-research](https://github.com/PerryLink/dsh-fund-research)** | |
284
- | **[dsh-github](https://github.com/PerryLink/dsh-github)** | |
285
- | **[dsh-gongwen-flow-check](https://github.com/PerryLink/dsh-gongwen-flow-check)** | |
286
- | **[dsh-gongwen-word-check](https://github.com/PerryLink/dsh-gongwen-word-check)** | |
287
- | **[dsh-guard-plan-qc](https://github.com/PerryLink/dsh-guard-plan-qc)** | |
288
- | **[dsh-hazchem-check](https://github.com/PerryLink/dsh-hazchem-check)** | |
289
- | **[dsh-hazplan-check](https://github.com/PerryLink/dsh-hazplan-check)** | |
290
- | **[dsh-hidden-risk-map](https://github.com/PerryLink/dsh-hidden-risk-map)** | |
291
- | **[dsh-hs-classify](https://github.com/PerryLink/dsh-hs-classify)** | |
292
- | **[dsh-icd-rule-check](https://github.com/PerryLink/dsh-icd-rule-check)** | |
293
- | **[dsh-industry-research](https://github.com/PerryLink/dsh-industry-research)** | |
294
- | **[dsh-lawcite-adapter](https://github.com/PerryLink/dsh-lawcite-adapter)** | |
295
- | **[dsh-laya](https://github.com/PerryLink/dsh-laya)** | |
296
- | **[dsh-lc-doc-check](https://github.com/PerryLink/dsh-lc-doc-check)** | |
297
- | **[dsh-learning-gap-check](https://github.com/PerryLink/dsh-learning-gap-check)** | |
298
- | **[dsh-library](https://github.com/PerryLink/dsh-library)** | |
299
- | **[dsh-local-ai](https://github.com/PerryLink/dsh-local-ai)** | |
300
- | **[dsh-lsp-actions](https://github.com/PerryLink/dsh-lsp-actions)** | |
301
- | **[dsh-mask](https://github.com/PerryLink/dsh-mask)** | |
302
- | **[dsh-mcp-panel](https://github.com/PerryLink/dsh-mcp-panel)** | |
303
- | **[dsh-medrec-qc](https://github.com/PerryLink/dsh-medrec-qc)** | |
304
- | **[dsh-memento](https://github.com/PerryLink/dsh-memento)** | |
305
- | **[dsh-nsfc-form-check](https://github.com/PerryLink/dsh-nsfc-form-check)** | |
306
- | **[dsh-nurse-record-check](https://github.com/PerryLink/dsh-nurse-record-check)** | |
307
- | **[dsh-observe](https://github.com/PerryLink/dsh-observe)** | |
308
- | **[dsh-origin-rvc-check](https://github.com/PerryLink/dsh-origin-rvc-check)** | |
309
- | **[dsh-ota-review-check](https://github.com/PerryLink/dsh-ota-review-check)** | |
310
- | **[dsh-output-styles](https://github.com/PerryLink/dsh-output-styles)** | |
311
- | **[dsh-paper-doc-adapter](https://github.com/PerryLink/dsh-paper-doc-adapter)** | |
312
- | **[dsh-permission-rules](https://github.com/PerryLink/dsh-permission-rules)** | |
313
- | **[dsh-permit-report-check](https://github.com/PerryLink/dsh-permit-report-check)** | |
314
- | **[dsh-pipeline-check](https://github.com/PerryLink/dsh-pipeline-check)** | |
315
- | **[dsh-pleading-draft](https://github.com/PerryLink/dsh-pleading-draft)** | |
316
- | **[dsh-plugin-doctor](https://github.com/PerryLink/dsh-plugin-doctor)** | |
317
- | **[dsh-plugin-guide](https://github.com/PerryLink/dsh-plugin-guide)** | |
318
- | **[dsh-plugin-kit](https://github.com/PerryLink/dsh-plugin-kit)** | |
319
- | **[dsh-plugin-upgrade](https://github.com/PerryLink/dsh-plugin-upgrade)** | |
320
- | **[dsh-policy-brief-draft](https://github.com/PerryLink/dsh-policy-brief-draft)** | |
321
- | **[dsh-power-loss-split](https://github.com/PerryLink/dsh-power-loss-split)** | |
322
- | **[dsh-power-ticket-check](https://github.com/PerryLink/dsh-power-ticket-check)** | |
323
- | **[dsh-ppap-check](https://github.com/PerryLink/dsh-ppap-check)** | |
324
- | **[dsh-protest-deadline](https://github.com/PerryLink/dsh-protest-deadline)** | |
325
- | **[dsh-railway-window](https://github.com/PerryLink/dsh-railway-window)** | |
326
- | **[dsh-repair-order-qc](https://github.com/PerryLink/dsh-repair-order-qc)** | |
327
- | **[dsh-research-report](https://github.com/PerryLink/dsh-research-report)** | |
328
- | **[dsh-review-reply-check](https://github.com/PerryLink/dsh-review-reply-check)** | |
329
- | **[dsh-rulefile-check](https://github.com/PerryLink/dsh-rulefile-check)** | |
330
- | **[dsh-safety-brief-check](https://github.com/PerryLink/dsh-safety-brief-check)** | |
331
- | **[dsh-score](https://github.com/PerryLink/dsh-score)** | |
332
- | **[dsh-session-sync](https://github.com/PerryLink/dsh-session-sync)** | |
333
- | **[dsh-site-log-check](https://github.com/PerryLink/dsh-site-log-check)** | |
334
- | **[dsh-skill-pack-security](https://github.com/PerryLink/dsh-skill-pack-security)** | |
335
- | **[dsh-soe-decision-check](https://github.com/PerryLink/dsh-soe-decision-check)** | |
336
- | **[dsh-soilwater-check](https://github.com/PerryLink/dsh-soilwater-check)** | |
337
- | **[dsh-sop-sync-check](https://github.com/PerryLink/dsh-sop-sync-check)** | |
338
- | **[dsh-spc-gbt-adapter](https://github.com/PerryLink/dsh-spc-gbt-adapter)** | |
339
- | **[dsh-talk](https://github.com/PerryLink/dsh-talk)** | |
340
- | **[dsh-tender-extract](https://github.com/PerryLink/dsh-tender-extract)** | |
341
- | **[dsh-tender-matrix](https://github.com/PerryLink/dsh-tender-matrix)** | |
342
- | **[dsh-test-drive](https://github.com/PerryLink/dsh-test-drive)** | |
343
- | **[dsh-ticktick](https://github.com/PerryLink/dsh-ticktick)** | |
344
- | **[dsh-translate](https://github.com/PerryLink/dsh-translate)** | |
345
- | **[dsh-warranty-calc](https://github.com/PerryLink/dsh-warranty-calc)** | |
346
- | **[dsh-budget](https://github.com/PerryLink/dsh-budget)** | 🧊 फ़्रोज़न — रिपॉज़िटरी README देखें |
347
- | **[dsh-claude-move](https://github.com/PerryLink/dsh-claude-move)** | 🧊 फ़्रोज़न — रिपॉज़िटरी README देखें |
348
- | **[dsh-defend](https://github.com/PerryLink/dsh-defend)** | 🧊 फ़्रोज़न — रिपॉज़िटरी README देखें |
349
- | **[dsh-draw](https://github.com/PerryLink/dsh-draw)** | 🧊 फ़्रोज़न — रिपॉज़िटरी README देखें |
350
- | **[dsh-reach](https://github.com/PerryLink/dsh-reach)** | 🧊 फ़्रोज़न — रिपॉज़िटरी README देखें |
351
- | **[dsh-background-agents](https://github.com/PerryLink/dsh-background-agents)** | 🚫 सेवानिवृत्त — रिपॉज़िटरी README देखें |
352
- | **[dsh-session-pin](https://github.com/PerryLink/dsh-session-pin)** | 🚫 सेवानिवृत्त — रिपॉज़िटरी README देखें |
353
- | **[dsh-team-rooms](https://github.com/PerryLink/dsh-team-rooms)** | 🚫 सेवानिवृत्त — रिपॉज़िटरी README देखें |
354
-
355
- </details>
356
-
357
- ## License (लाइसेंस)
358
-
359
- [Apache-2.0](LICENSE)
360
-
361
- ### DSH Desktop मार्केट से इंस्टॉल करें
362
-
363
- सभी PerryLink प्लगइन DSH Desktop के बिल्ट-इन मार्केट में देखे जा सकते हैं: **Market → Sources → add source → पेस्ट करें** `https://perrylink-dsh-catalog.perrylink.workers.dev/catalog-source.json` **→ चुनें**। इंस्टॉलेशन मार्केट के npm-identity सत्यापन और आपकी पुष्टि से ही होता है।
364
-
365
- ### उदाहरण
366
-
367
- ये वास्तविक प्रवेश बिंदु हैं; इंस्टॉल के बाद एक चलाएँ।
368
-
369
- #### विस्तृत उदाहरण
370
-
371
- **कमांड**
372
-
373
- ~~~sh
374
- test_drive({ target: "dsh-click" })
375
- ~~~
376
-
377
- **आउटपुट**
378
-
379
- ~~~text
380
- # Test drive tdr_0b9b6e6a61e3e80cc4620f2e
381
-
382
- - Target: `dsh-click` (npm)
383
- - Verdict: ✅ pass — install, patch, boot, task, and uninstall all verified
384
- - Installed: dsh-click@0.2.0
385
- - Isolation: throwaway DSH_HOME + workspace + pnpm store; host profile untouched
386
-
387
- | Stage | Result | Exit | Duration | Summary |
388
- |---|---|---|---|---|
389
- | install | ✅ pass | 0 | 1 ms | install ok (exit 0) |
390
- | config (--dump-config) | ✅ pass | 0 | 0 ms | patch effective: dsh-click |
391
- | smoke (headless boot) | ✅ pass | 0 | 0 ms | booted cleanly and the headless task completed |
392
- | capability | ⏭️ skipped | null | 0 ms | capability assertion disabled (config.capability.enabled is false and no per-drive capability given) |
393
- | uninstall | ✅ pass | 0 | 0 ms | remove ok (exit 0) |
394
- | cleanup | ✅ pass | — | — | owned temp root quarantined and removed |
395
- ~~~
396
-
397
- *स्रोत `README.md:153-163,174-211; tests/drive.spec.ts:73-101; src/report.ts:34-55`*
398
-
399
- #### विफलता शाखा
400
-
401
- **इनपुट**
402
-
403
- ~~~text
404
- {"target":" "}
405
- ~~~
406
-
407
- **आउटपुट**
408
-
409
- ~~~text
410
- isError=true; error.message=dsh-test-drive: target must be a non-empty string
411
- ~~~
412
-
413
- *स्रोत `plugins/dsh-test-drive/src/tools.ts:297-299 (blank target check); exercised through plugins/dsh-test-drive/tests/harness.ts`*
414
-
415
- #### संक्षिप्त उदाहरण
416
-
417
-
418
-