dsh-plugin-guide 0.3.42 → 0.4.1

package/README-hi.md

@@ -1,455 +0,0 @@
-> **स्थानांतरित:** यह पैकेज अब **[dsh-primer](https://www.npmjs.com/package/dsh-primer)** है। पुराना पैकेज `dsh-plugin-guide` अप्रचलित है; `dsh-primer` इंस्टॉल करें।
-
-<div align="center">
-
-# 🐳 dsh-plugin-guide
-
-**[DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) प्लगइन बनाने के लिए आपकी ज़रूरत की हर चीज़।**
-
-*आधिकारिक दस्तावेज़ संग्रह · Cordis प्राइमर · सामुदायिक गहन-विश्लेषण · युद्ध-परीक्षित नुकसान · agent skill · CLI टूलचेन*
-
-
-```sh
-dsh plugin --profile web add dsh-plugin-guide
-```
-[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
-[![Gitee](https://img.shields.io/badge/Gitee-mirror-c71d23?logo=gitee)](https://gitee.com/perrylink/dsh-plugin-guide)
-[![DSH plugin](https://img.shields.io/badge/dsh--plugin-✅-green)](https://github.com/topics/dsh-plugin)
-[![dsh-doctor](https://raw.githubusercontent.com/PerryLink/dsh-plugin-doctor/main/badges/PerryLink__dsh-plugin-guide.svg)](https://github.com/PerryLink/dsh-plugin-doctor#verified-徽章)
-[![DSH Market](https://raw.githubusercontent.com/2BingLing/dsh-market/master/assets/readme/badge-top-rated.svg)](https://dsh.market/)
-[![Node](https://img.shields.io/badge/node-%5E22.19%20%7C%7C%20%3E%3D24-brightgreen.svg)](#)
-[![CI](https://img.shields.io/github/actions/workflow/status/PerryLink/dsh-plugin-guide/verify.yml?branch=main&label=CI)](https://github.com/PerryLink/dsh-plugin-guide/actions)
-[![Version](https://img.shields.io/github/v/tag/PerryLink/dsh-plugin-guide?label=version)](https://github.com/PerryLink/dsh-plugin-guide/releases)
-[![npm version](https://img.shields.io/npm/v/dsh-plugin-guide)](https://www.npmjs.com/package/dsh-plugin-guide)
-[![npm downloads](https://img.shields.io/npm/dm/dsh-plugin-guide)](https://www.npmjs.com/package/dsh-plugin-guide)
-[![dshfind](https://dshfind.com/api/badge/PerryLink/dsh-plugin-guide?metric=downloads&lang=hi)](https://dshfind.com/hi/plugins/PerryLink/dsh-plugin-guide?ref=badge)
-
-[English](README.md) · [简体中文](README-zh.md) · [Español](README-es.md) · [Português](README-pt.md) · [हिन्दी](README-hi.md)
-
-```sh
-dsh plugin --profile <name> add dsh-plugin-guide
-```
-
-
-</div>
-
----
-
-**📖 इसे वेबसाइट के रूप में पढ़ना चाहें?** [perrylink.github.io/dsh-plugin-guide](https://perrylink.github.io/dsh-plugin-guide/) — हर अध्याय अपने पृष्ठ पर, साथ ही असिस्टेंट के लिए मशीन-पठनीय [llms.txt](https://perrylink.github.io/dsh-plugin-guide/llms.txt)।
-
-## Install & uninstall
-
-- **git चैनल** (नवीनतम `main`): `dsh plugin --profile web add github:PerryLink/dsh-plugin-guide#<sha>` — पुनरुत्पादन के लिए एक कमिट पिन करें; प्रवेश बिंदु सादा ESM JS है, कोई बिल्ड चरण नहीं।
-- **npm चैनल** (प्रकाशित रिलीज़): `dsh plugin --profile web add dsh-plugin-guide`.
-- **tarball चैनल**: इस रेपो में `pnpm pack`, फिर `dsh plugin --profile web add ./dsh-plugin-guide-<version>.tgz`.
-- **uninstall**: `dsh plugin --profile web remove dsh-plugin-guide`.
-
-## Why not just read the official docs?
-
-क्योंकि वे उसके लिए लिखे गए हैं जिसे पहले से पता है कौन-सा पृष्ठ खोलना है, और DSH **हर 1.7–2.8 दिन में एक प्रीरिलीज़** जारी करता है जिसमें संगतता तोड़ने वाले बदलाव होते हैं। यह प्लगइन वही तीन अंतराल भरता है जो सबसे अधिक समय लेते हैं:
-
-| अंतराल | यह प्लगइन क्या जोड़ता है |
-|---|---|
-| **"मैं किस संस्करण के लिए विकसित कर रहा हूँ?"** | एक [संस्करण मैट्रिक्स](guide/version-matrix.md): चार भिन्न मान जो स्वयं को "latest" कहते हैं, उप-पैकेजों के जमे हुए `latest` टैग, संगतता-भंग बिंदु, और `peerDependencies` रेंज कैसे चुनें। **कोई स्थिर पंक्ति नहीं है** — हर प्रकाशित संस्करण प्रीरिलीज़ है। |
-| **"यह संस्करण क्या तोड़ता है?"** | एक [माइग्रेशन गाइड](guide/migration-0.2.md) जो `0.1.6-alpha.2` → `0.2.1-alpha.2` को **उद्धरण-योग्य seams** के रूप में देता है, प्रत्येक में लक्षण *और* समाधान तथा आधिकारिक स्रोत — जिसमें एक डेटा-हानि जोखिम भी शामिल है। |
-| **"मेरा प्लगइन वास्तव में सही है?"** | एक [शून्य-निर्भरता CLI](SKILL.md) (`dsh-plugin-dev new / check / verify`) और आधिकारिक दस्तावेज़ों का [शब्दशः ऑफ़लाइन प्रतिबिंब](references/official-docs/), ताकि एजेंट अनुमान के बजाय सटीक पृष्ठ उद्धृत करे। |
-
-**60 सेकंड में सत्यापित करें:**
-
-```sh
-dsh plugin --profile web add dsh-plugin-guide
-```
-
-<!-- star-cta -->
-## ⭐ 如果它帮到了你
-
-यह प्लगइन [DSH प्लगइन परिवार](https://github.com/PerryLink) का हिस्सा है (95 प्लगइन, सभी Apache-2.0)। अगर यह उपयोगी लगे, तो **एक स्टार दें** — इससे कोई सुविधा अनलॉक नहीं होती, पर अगला व्यक्ति इसे खोज में आसानी से पा लेता है।
-
-*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.
-
-## What is dsh-plugin-guide?
-
-[DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) प्लगइन बनाने के लिए आपकी ज़रूरत की हर चीज़।
-
-आधिकारिक दस्तावेज़ संग्रह · Cordis प्राइमर · सामुदायिक गहन-विश्लेषण · युद्ध-परीक्षित नुकसान · agent skill · CLI टूलचेन
-
-![dsh-plugin-guide कार्यप्रवाह आरेख: अनुरोध → नीति/समीक्षा → निर्णय।](docs/assets/dsh-plugin-guide-flow.svg)
-
-*कार्यप्रवाह: अनुरोध → नीति/समीक्षा → निर्णय। नीचे के उदाहरण वास्तविक कमांड सतह का उपयोग करते हैं।*
-
-
-*वही रन, एनिमेटेड।*
-
-## Comparison
-
-![dsh-plugin-guide का मापा गया तुलना चार्ट](https://raw.githubusercontent.com/PerryLink/dsh-plugin-guide/main/docs/assets/dsh-plugin-guide-evidence.png)
-
-content counts as stated in the README (What you get)
-
-## Compatibility
-
-| Surface | Status |
-|---|---|
-| Harness | DeepSeek Harness `dsh-v0.2.1-alpha.2` (`d743267388641bc76f17c45ce8b4c231aed1d32c`, master का सबसे नया tag **और** HEAD, 2026-10-09); npm `latest` = `0.2.0-rc.2`, `alpha` = `0.2.1-alpha.2`। 2026-10-06 को उसी checkout के विरुद्ध पुनः सत्यापित (gate chain + profile install smoke)। नॉलेज बेस, आधिकारिक-docs मिरर और [guide/migration-0.2.md](guide/migration-0.2.md) इसी बेसलाइन पर हैं। |
-| Node | `^22.19.0 || >=24.0.0` (DeepSeek Harness रनटाइम) |
-| Platforms | सभी (सादा ESM बंडल; कोई नेटिव कोड नहीं, कोई नेटवर्क नहीं) |
-| Model | कोई भी (कोई मॉडल अंतःक्रिया नहीं) |
-
-## What you get
-
-`dsh-plugin-guide` DSH प्लगइन-विकास ज्ञान-आधार है, जो एक इंस्टॉल-योग्य बंडल के रूप में पैक किया गया है और पूरी सामग्री को `dsh-plugin-guide` agent skill के रूप में पंजीकृत करता है। यह skill हर सत्र कैटलॉग में दृश्य रहती है और अपने वर्कफ़्लो चरण, आधिकारिक दस्तावेज़ और सामुदायिक गहन-विश्लेषण माँग पर लोड करती है।
-
-- **प्लगइन अनुबंध और कठोर नियम** — effects/disposers, waterfall `next()`, मॉडल-दृश्य ⟺ लॉग किया गया, Schemastery विन्यास।
-- **आधिकारिक दस्तावेज़ संग्रह** — आधिकारिक रेपो दस्तावेज़ों की शब्दशः प्रति (EN + ZH), अंतिम सत्यापित स्नैपशॉट पर अपस्ट्रीम से बाइट-समान।
-- **Cordis प्राइमर** — पाँच अवधारणाएँ और तंत्र समयरेखा (repository-plugin 0809 को जोड़ा, 0811 को हटाया; दो इंस्टॉल चैनल)।
-- **20+ वास्तविक-दुनिया नुकसान** मूल कारण + समाधान सहित (cordis दोहरी प्रतियाँ, tsconfig त्रयी, बहु-फ़्रेम zstd सत्र, Windows junction, पुराना npm `latest`, …)।
-- **सामुदायिक गहन-विश्लेषण** — 114 सामुदायिक रिपॉज़िटरी संग्रहीत (15 गहन-विश्लेषित), साथ ही पूर्ण स्रोत सूची जहाँ हर तथ्य अपने मूल से जुड़ा है।
-- **CLI टूलचेन** — `dsh-plugin-dev new / check / verify`: DSH प्लगइन स्कैफ़ोल्ड करना, स्थैतिक जाँच और पैक-सत्यापन; हर जाँच उस skill अनुभाग से जुड़ती है जिसे वह लागू करती है।
-
-- **संस्करण अनुकूलनशीलता** — [guide/version-matrix.md](guide/version-matrix.md): चार "latest" मान, जमे हुए उप-पैकेज टैग, संगतता-भंग बिंदु, peer रेंज का चयन और `0.2.1-alpha.2` के 19 बदलाव।
-- **टूलचेन राउटर** — [guide/family-toolchain.md](guide/family-toolchain.md): कौन-सा प्रश्न किस टूल का है, `dsh-plugin-doctor` की पूरी 33-जाँच सूची, और इस रिपॉज़िटरी की 16 जाँचों से तुलना।
-- **मिरर स्कोप निर्णय** — [references/mirror-scope-decision.md](references/mirror-scope-decision.md): "संदर्भ-रहित सामग्री हटाकर 80% बचाने" का सुझाव दोबारा मापने पर **टिकता नहीं**।
-- **आधिकारिक skill का सार** — [references/official-plugin-dev-skill.md](references/official-plugin-dev-skill.md): आधिकारिक `cordis-plugin-development` skill के निषेध, प्रदर्शन मेटाडेटा और UI/प्रदर्शन नियम।
-- **अपनाने के स्तर (अनौपचारिक)** — [guide/standards.md](guide/standards.md): DSH-ENTRY / DSH-FLOW / DSH-BOOST मॉडल, दो-अक्षीय (गहराई × प्रमाण) तालिका, हर स्तर क्या दावा **नहीं** करता, और ऊपर कैसे जाएँ। GB / GB-T / GB-Z केवल एक उपमा है; प्रमाणन ग्रेड A–D इन स्तरों से स्वतंत्र हैं।
-## Knowledge base
-
-| Path | यह क्या है |
-|---|---|
-| `SKILL.md` | `dsh-plugin-guide` agent skill: कठोर नियम + कार्य-आधारित विकास पथ |
-| `package.json` · `cordis.patch.yml` · `index.js` | इंस्टॉल-योग्य DSH बंडल: `dsh.bundle.patch` मैनिफ़ेस्ट + skill पंजीकृत करने वाला प्रवेश बिंदु |
-| `guide/plugin-dev-guide.md` | पूर्ण विकास मार्गदर्शिका (10 अध्याय) |
-| `guide/quick-reference.md` | एक-पृष्ठ चीट शीट (5 भाषाएँ) |
-| `guide/links.md` | संकलित URL सूची: आधिकारिक विकास दस्तावेज़ (साइट ↔ स्थानीय प्रतियाँ) + सामुदायिक दस्तावेज़ लिंक |
-| `guide/when-to-retire-a-plugin.md` | प्लगइन रिटायर और फ़्रीज़ करना: पोर्टफ़ोलियो ऑडिट के मानदंड और मापे गए आँकड़े (EN + ZH) |
-| `guide/choosing-a-plugin.md` | प्लगइन चुनना: हर क्षमता में कौन आगे है, मापे गए आँकड़ों और सत्यापन चेतावनियों के साथ (EN + ZH) |
-| `references/official-docs/` | आधिकारिक रेपो दस्तावेज़ों की शब्दशः प्रति (EN + ZH) |
-| `references/*.md` | शोध रिपोर्ट: रेपो दस्तावेज़, वेबसाइट, Cordis, पेपर, सामुदायिक पारिस्थितिकी, 114-रेपो संग्रह (15 गहन-विश्लेषित) |
-| `scripts/` | इडेम्पोटेंट डाउनलोड स्क्रिप्ट + अखंडता जाँचकर्ता + विषय स्नैपशॉट जनरेटर |
-| `bin/` · `src/cli/` · `dist/` | `dsh-plugin-dev` CLI: स्कैफ़ोल्डर, जाँचकर्ता, सत्यापक (TypeScript, tsdown-बंडल) |
-| `templates/` | TS + JS स्कैफ़ोल्ड कंकाल: अनुबंध टेम्प्लेट, Config, टेस्ट, cordis.patch.yml, पाँच-भाषा README |
-| `downloads/` | कच्चे स्नैपशॉट — `scripts/` से उत्पन्न, कमिट नहीं |
-| `guide/version-matrix.md` | **संस्करण अनुकूलनशीलता मैट्रिक्स**: चार "latest" मान, जमे हुए टैग, संगतता-भंग बिंदु, peer रेंज चयन, सत्र-प्रारूप वंशावली और `0.2.1-alpha.2` के 19 बदलाव |
-| `guide/family-toolchain.md` | **टूलचेन राउटर**: प्रश्न → स्वामी → उद्धरण-योग्य कलाकृति; `dsh-plugin-doctor` की 33-जाँच सूची और इस रिपॉज़िटरी की 16 जाँचों से तुलना |
-| `guide/migration-0.2.md` | 0.2 पीढ़ी के संगतता-भंग बदलावों की माइग्रेशन गाइड (§0–§12 `0.2.1-alpha.1` तक; **§13 `0.2.1-alpha.2` के 19 seams**) |
-| `references/mirror-scope-decision.md` | मिरर स्कोप निर्णय रिकॉर्ड: "शून्य संदर्भ" के आधार पर कटौती क्यों नहीं, साथ में पुनरुत्पाद्य मापन स्क्रिप्ट |
-
-## CLI toolchain
-
-बंडल शून्य-रनटाइम-निर्भरता `dsh-plugin-dev` CLI लेकर आता है (`bin/` → tsdown-बंडल `dist/dsh-plugin-dev.js`). हर जाँच उस skill अनुभाग को उद्धृत करती है जिसे वह लागू करती है, ताकि एजेंट मैन्युअल ऑडिट जारी रख सके।
-
-```sh
-dsh-plugin-dev new <name> [--lang ts|js] [--dir <path>] [--force] [--git]
-dsh-plugin-dev check [--cwd <dir>] [--json] [--strict]
-dsh-plugin-dev verify [--cwd <dir>] [--dsh <bin>] [--pnpm <bin>]
-dsh-plugin-dev seams <query> | --since <version>   # क्या यह API मेरे लक्ष्य होस्ट में है?
-```
-
-| उप-कमांड | क्या करता है |
-|---|---|
-| `new <name>` | TS या JS प्लगइन रेपो स्कैफ़ोल्ड करता है: `src/index.ts` अनुबंध टेम्प्लेट, Schemastery Config, टेस्ट, tsdown/vitest, टिप्पणी-युक्त `cordis.patch.yml`, पाँच-भाषा README। इडेम्पोटेंट; `--force` के बिना गैर-खाली लक्ष्य को अस्वीकार करता है। |
-| `check` | स्थैतिक जाँच: `cordis.patch.yml` वैधता, `package.json` मेटाडेटा (`dsh.bundle.patch` पॉइंटर, peer deps, engines, files श्वेतसूची), पाँच-भाषा README संगति, इंजीनियरिंग रेड-लाइन पैटर्न। CI-उपभोज्य JSON उत्सर्जित करता है। |
-| `verify` | `pnpm pack`, फिर साफ़ mkdtemp `DSH_HOME` प्रोफ़ाइल में बंडल को इंस्टॉल/स्टार्ट/अनइंस्टॉल स्मोक (आधिकारिक `verify:self-contained` से संरेखित)। विफलता लॉग टेल + सुझाव देती है। |
-
-### CLI configuration
-
-CLI में कोई हार्डकोडेड ट्यूनेबल नहीं — हर एक flag या पर्यावरण चर है।
-
-| ट्यूनेबल | Flag | Env | डिफ़ॉल्ट |
-|---|---|---|---|
-| टेम्प्लेट निर्देशिका | — | `DSH_PLUGIN_DEV_TEMPLATES` | `<package>/templates` |
-| dsh बाइनरी | `--dsh` | `DSH_PLUGIN_DEV_DSH` | `dsh` |
-| pnpm बाइनरी | `--pnpm` | `DSH_PLUGIN_DEV_PNPM` | `pnpm` |
-| इंस्टॉल/पैक टाइमआउट | `--timeout` | `DSH_PLUGIN_DEV_TIMEOUT` | `300000` ms |
-| हेडलेस स्मोक टाइमआउट | `--smoke-timeout` | `DSH_PLUGIN_DEV_SMOKE_TIMEOUT` | `120000` ms |
-
-### Upstream roadmap
-
-`dsh-plugin-dev` आधिकारिक प्लगइन-विकास CLI (नियोजित आइटम C12) का अपस्ट्रीम उम्मीदवार है: स्कैफ़ोल्डर/जाँचकर्ता/सत्यापक यांत्रिक परतें हैं, जबकि `SKILL.md` + `guide/` संज्ञानात्मक परत बने रहते हैं।
-
-## Quick start
-
-```sh
-# 1. install the bundle into your profile
-dsh plugin --profile web add github:PerryLink/dsh-plugin-guide
-
-# or from npm (published releases)
-dsh plugin --profile web add dsh-plugin-guide
-
-# 2. restart and verify the row
-dsh --profile web --dump-config | grep -A3 'id: dsh-plugin-guide'
-```
-
-फिर बस अपने एजेंट से पूछें: *"मुझे … प्लगइन बनाने के लिए dsh-plugin-guide skill का उपयोग करो।"*
-
-या सीधे CLI चलाएँ:
-
-```sh
-npx dsh-plugin-guide new hello-plugin            # TS प्लगइन रेपो स्कैफ़ोल्ड करें
-npx dsh-plugin-guide check --json                # स्थैतिक जाँच
-npx dsh-plugin-guide verify                      # पैक + साफ़ प्रोफ़ाइल स्मोक
-```
-
-## Copy as a plain agent skill
-
-आप पूरे फ़ोल्डर को अपने एजेंट की skill निर्देशिका में भी कॉपी कर सकते हैं (सापेक्ष पथ बरकरार रहते हैं):
-
-```powershell
-# Windows (PowerShell)
-pwsh -File scripts/install-skill.ps1 `
-  -Target "$env:USERPROFILE\.deepseek\skills\dsh-plugin-guide"   # या <project>\.agents\skills\dsh-plugin-guide
-```
-
-```bash
-# macOS / Linux
-pwsh -File scripts/install-skill.ps1 -Target ~/.deepseek/skills/dsh-plugin-guide   # या <project>/.agents/skills/dsh-plugin-guide
-```
-
-इंस्टॉलर `downloads/` (उत्पन्न) और `.github/` को छोड़ता है, फिर हर कॉपी की गई फ़ाइल को बाइट-दर-बाइट सत्यापित करता है। पूरे फ़ोल्डर की मैन्युअल `Copy-Item -Recurse` भी काम करती है।
-
-### उदाहरण
-
-ये वास्तविक प्रवेश बिंदु हैं; इंस्टॉल के बाद एक चलाएँ।
-
-#### विस्तृत उदाहरण
-
-**कमांड**
-
-~~~sh
-dsh-plugin-dev seams L3
-~~~
-
-**आउटपुट**
-
-~~~text
-1 seam(s):
-
-L3  webRuntime service replaced by webStartup
-    kind        service-renamed
-    lands in    0.2.1-alpha.2
-    confidence  documented
-    official    docs/upgrade-guide/v0.2.1-alpha.1/web-listener-trust-config/guide.md
-    removed     service webRuntime; row web-runtime; ctx.webRuntime.lanAddresses; wildcard --host
-    instead     webStartup (row web-startup), concrete host literals
-    detectable  yes — inspect: src/**/*.ts, cordis.patch.yml
-~~~
-
-*स्रोत `README.md:152 (CLI toolchain); src/cli/commands/seams.ts:54; data/seams/index.json:44`*
-
-#### विफलता शाखा
-
-**इनपुट**
-
-~~~text
-node bin/dsh-plugin-dev.js seams no-such-seam-xyz
-~~~
-
-**आउटपुट**
-
-~~~text
-no seam or capability matches "no-such-seam-xyz". This is an absence of evidence in the knowledge base, not evidence that the API is absent from your target host — check references/official-docs/ before concluding either way.
-~~~
-
-*स्रोत `plugins/dsh-plugin-guide/src/cli/lib/seams.ts:122-130; plugins/dsh-plugin-guide/src/cli/commands/seams.ts:87-92; plugins/dsh-plugin-guide/tests/seams.test.ts:88-90`*
-
-#### संक्षिप्त उदाहरण
-
-
-
-## Configuration
-
-skill बंडल कोई Schemastery `Config` उजागर नहीं करता — यह ज्ञान-आधार को बिना किसी ट्यूनेबल कुंजी के एक agent skill के रूप में पंजीकृत करता है। `dsh-plugin-dev` CLI अपने ट्यूनेबल flags और `DSH_PLUGIN_DEV_*` पर्यावरण चरों से पढ़ता है ([CLI toolchain](#cli-toolchain) देखें)।
-
-## Tools & surfaces
-
-| Surface | Kind | Notes |
-|---|---|---|
-| `dsh-plugin-guide` | skill | `ctx.skills` से पंजीकृत; माँग पर `SKILL.md` + `./guide/` + `./references/` लोड करता है |
-| `dsh-plugin-dev` | bin (CLI) | `new` / `check` / `verify` उप-कमांड; DSH प्लगइन पंक्ति नहीं |
-
-## Permissions & data
-
-- **Permissions**: workshop मैनिफ़ेस्ट में `filesystem:read` घोषित करता है।
-- **Data**: केवल-पठन — अपनी पैक की गई `guide/` और `references/` फ़ाइलें पढ़ता है। कोई नेटवर्क अनुरोध नहीं, कोई लेखन नहीं, कोई मॉडल कॉल नहीं।
-
-## Security boundaries
-
-- **केवल-पठन ज्ञान-आधार।** बंडल केवल अपनी फ़ाइलें पढ़ता है; कभी लिखता नहीं, कभी नेटवर्क उपयोग नहीं करता, और कभी मॉडल नहीं बुलाता।
-- **आधिकारिक दस्तावेज़ शब्दशः प्रतियाँ हैं।** `references/official-docs/` यहाँ कभी संपादित नहीं होता; समस्याएँ अपस्ट्रीम को रिपोर्ट करें और केवल `scripts/sync-official-docs.ps1` से पुनः-सिंक करें।
-- **वितरण सीमाएँ।** पैक की गई तृतीय-पक्ष सामग्री अपना अपस्ट्रीम लाइसेंस रखती है; [NOTICE.md](NOTICE.md) देखें (जैसे `downloads/` केवल स्थानीय; `awesome-dsh-plugins` पुनर्वितरित नहीं होना चाहिए)।
-
-## Known limitations
-
-- **आधिकारिक दस्तावेज़ एक स्नैपशॉट है।** अपस्ट्रीम बदलने पर `scripts/sync-official-docs.ps1` से पुनः-सिंक करें; ताज़गी मुहर और कमिट हैश `references/official-docs/SNAPSHOT.md` को संदर्भित करते हैं।
-- **`downloads/` उत्पन्न है, कमिट नहीं।** कच्चे स्नैपशॉट (सामुदायिक रेपो संग्रह, Discussions, लेख) उपयोग से पहले स्क्रिप्ट से उत्पन्न करने चाहिए।
-- **`awesome-dsh-plugins` सामग्री केवल स्थानीय है।** इसका अपस्ट्रीम आंतरिक-उपयोग प्रतिबंध घोषित करता है, इसलिए इसे रेपो के साथ पुनर्वितरित नहीं किया जाता।
-
-## Release channels
-
-हर channel इस repo या npm से resolve होता है, इसलिए **एक tag सब जगह पहुँच जाता है**; केवल Gitee mirror एक शेड्यूल्ड कॉपी है:
-
-| Channel | सत्य-स्रोत | कैसे अपडेट होता है |
-|---|---|---|
-| npm (`dsh-plugin-guide`) | इस repo का `package.json` | `v*` tag पर `.github/workflows/release.yml`: `verify-kit` गेट → CHANGELOG में उस संस्करण का section जाँच → `npm publish --provenance` (संस्करण पहले से हो तो छोड़ देता है) |
-| GitHub Release | वही tag | वही workflow इसे idempotent तरीके से बनाता है |
-| Discovery बैज (npm version, GitHub tag, DSH Market, dsh-doctor) | लाइव lookup | प्रकाशित करने को कुछ नहीं — हर render पर npm/registry पढ़ते हैं |
-| Gitee mirror | यह repo | **read-only शेड्यूल्ड mirror**, प्रकाशन लक्ष्य नहीं: परिवार का `gitee-sync` workflow इसे `--force-with-lease` से GitHub tip पर align करता है, इसलिए `main` सामान्यतः एक शेड्यूल्ड रन पीछे रहता है। **यहाँ से Gitee पर tag कभी push नहीं होता**; mirror को पुराना बताने से पहले `git ls-remote` से तुलना करें |
-| DSH Desktop Market / dsh1024 | npm | market npm पैकेज इंस्टॉल करता है, इसलिए प्रकाशित संस्करण तुरंत इंस्टॉल-योग्य है; प्रति-संस्करण सबमिशन नहीं |
-## Keeping it fresh
-
-```sh
-pwsh -File scripts/sync-official-docs.ps1                     # स्थानीय checkout से शब्दशः दस्तावेज़ प्रति
-pwsh -File scripts/download-sources.ps1                       # आधिकारिक साइट/दस्तावेज़, Cordis, पेपर
-pwsh -File scripts/download-community-repos.ps1               # सामुदायिक रिपॉज़िटरी (codeload tarballs)
-pwsh -File scripts/download-community-articles.ps1            # zh/en/HN सामुदायिक लेख
-pwsh -File scripts/archive-discussions.ps1                    # आधिकारिक Discussions ($env:GH_TOKEN चाहिए)
-pwsh -File scripts/gen-topic-snapshot.ps1 -OutDir <dir>       # dsh-plugin विषय जनगणना
-pwsh -File scripts/verify-kit.ps1 -Checkout <checkout>        # महत्वपूर्ण पथ + लिंक स्कैन + दस्तावेज़ विचलन
-```
-
-## Development
-
-skill बंडल (`index.js`) सादा ESM है, कोई बिल्ड चरण नहीं; `dsh-plugin-dev` CLI TypeScript है, tsdown से बिल्ट। द्वार:
-
-```sh
-pnpm install --frozen-lockfile
-pnpm run typecheck && pnpm run typecheck:ci
-pnpm test
-pnpm run build
-pnpm run verify:artifacts        # आत्म-जाँच + स्कैफ़ोल्ड स्मोक (कोई नेटवर्क नहीं)
-pnpm run verify:self-contained   # पैक + साफ़ प्रोफ़ाइल इंस्टॉल/स्टार्ट/अनइंस्टॉल स्मोक
-pnpm run check:readmes           # five READMEs share section structure
-pnpm run check:parity            # translations have identical block counts
-pnpm run check:facts             # self-stated numbers match data/facts.json
-pnpm run check:ps1-bom           # PowerShell scripts keep their UTF-8 BOM
-pnpm pack
-pwsh -File scripts/verify-kit.ps1   # महत्वपूर्ण पथ + लिंक स्कैन (-Checkout <checkout> से दस्तावेज़ विचलन)
-```
-
-## Topics
-
-`dsh`, `deepseek-harness`, `dsh-plugin`, `cordis`, `agent-skill`, `plugin-development`, `knowledge-base`, `cli`, `scaffold`, `checker`
-
-## Contributors
-
-- [PerryLink](https://github.com/PerryLink) — निर्माता और अनुरक्षक: ज्ञान-आधार सामग्री, इंस्टॉल-योग्य बंडल रूपांतरण, पारिस्थितिकी योगदान और सामुदायिक अभियांत्रिकी।
-- [@Yisa-yi](https://github.com/Yisa-yi) — **product manager** (उत्पाद प्रबंधक)। शुरुआती रूपरेखा से लेकर प्रकाशित bundle तक पूरी डिज़ाइन यात्रा में शामिल रहे, और कोड के बजाय उत्पाद का स्वरूप संभाला: यह तय करना कि यह इंस्टॉल-योग्य bundle के रूप में आए जो माँग पर agent skill रजिस्टर करे (दस्तावेज़-साइट उन्हीं स्रोतों को प्रस्तुत करती है, अलग सामग्री नहीं); 10 अध्यायों वाली गाइड की सूचना-संरचना; “हर तथ्य अपने स्रोत से जुड़ा हो” का नियम; और संज्ञानात्मक परत (`SKILL.md` + `guide/`) तथा यांत्रिक परत (`dsh-plugin-dev new / check / verify`) का अलगाव। `guide/unfixed-issues.md` का प्रमाण-मानक तय किया — नामित host commit के सामने `path:line`, design-vs-bug तालिका, और स्पष्ट “पुनरुत्पादन-असंभव” अनुभाग — तथा `guide/when-to-retire-a-plugin.md` के फ़्रीज़/सेवानिवृत्ति मानदंड। दायरे की सीमा (केवल-पठन, कोई नेटवर्क नहीं, कोई मॉडल कॉल नहीं, कोई कॉन्फ़िगर करने योग्य विकल्प नहीं) और पाँच-भाषा README समानता की शर्त बनाए रखी।
-- दैनिक अनुरक्षण में DeepSeek Harness एजेंट सहायता करते हैं (उनका कोई GitHub खाता नहीं है और वे पारदर्शिता हेतु यहाँ सूचीबद्ध हैं, योगदानकर्ता के रूप में नहीं)।
-
-## PerryLink DSH Plugin Family
-
-यह प्रोजेक्ट [PerryLink](https://github.com/PerryLink) के DeepSeek Harness प्लगइन परिवार का हिस्सा है। पूरी सूची नीचे संक्षिप्त रखी गई है ताकि हर README की पहली स्क्रीन छोटी रहे; हर पंक्ति और उसकी स्थिति देखने के लिए इसे खोलें।
-
-<details>
-<summary>सभी प्लगइन खोलें</summary>
-
-| प्लगइन | स्थिति |
-|---|---|
-| **[dsh-aqua-input-check](https://github.com/PerryLink/dsh-aqua-input-check)** |  |
-| **[dsh-archive-check](https://github.com/PerryLink/dsh-archive-check)** |  |
-| **[dsh-auto-review](https://github.com/PerryLink/dsh-auto-review)** |  |
-| **[dsh-autotier](https://github.com/PerryLink/dsh-autotier)** |  |
-| **[dsh-bid-ca-precheck](https://github.com/PerryLink/dsh-bid-ca-precheck)** |  |
-| **[dsh-bid-qual-check](https://github.com/PerryLink/dsh-bid-qual-check)** |  |
-| **[dsh-cert-mcp](https://github.com/PerryLink/dsh-cert-mcp)** |  |
-| **[dsh-checkpoint-rewind](https://github.com/PerryLink/dsh-checkpoint-rewind)** |  |
-| **[dsh-click](https://github.com/PerryLink/dsh-click)** |  |
-| **[dsh-composer-history](https://github.com/PerryLink/dsh-composer-history)** |  |
-| **[dsh-contract-stance](https://github.com/PerryLink/dsh-contract-stance)** |  |
-| **[dsh-customs-doc-check](https://github.com/PerryLink/dsh-customs-doc-check)** |  |
-| **[dsh-data-quality](https://github.com/PerryLink/dsh-data-quality)** |  |
-| **[dsh-demurrage-ledger](https://github.com/PerryLink/dsh-demurrage-ledger)** |  |
-| **[dsh-doublecheck](https://github.com/PerryLink/dsh-doublecheck)** |  |
-| **[dsh-drill-script-check](https://github.com/PerryLink/dsh-drill-script-check)** |  |
-| **[dsh-eia-guide-check](https://github.com/PerryLink/dsh-eia-guide-check)** |  |
-| **[dsh-emergency-plan](https://github.com/PerryLink/dsh-emergency-plan)** |  |
-| **[dsh-essay-rubric-check](https://github.com/PerryLink/dsh-essay-rubric-check)** |  |
-| **[dsh-evidence-check](https://github.com/PerryLink/dsh-evidence-check)** |  |
-| **[dsh-export-ctl-check](https://github.com/PerryLink/dsh-export-ctl-check)** |  |
-| **[dsh-fast](https://github.com/PerryLink/dsh-fast)** |  |
-| **[dsh-fmea-table-check](https://github.com/PerryLink/dsh-fmea-table-check)** |  |
-| **[dsh-forecast-penalty](https://github.com/PerryLink/dsh-forecast-penalty)** |  |
-| **[dsh-fund-research](https://github.com/PerryLink/dsh-fund-research)** |  |
-| **[dsh-github](https://github.com/PerryLink/dsh-github)** |  |
-| **[dsh-gongwen-flow-check](https://github.com/PerryLink/dsh-gongwen-flow-check)** |  |
-| **[dsh-gongwen-word-check](https://github.com/PerryLink/dsh-gongwen-word-check)** |  |
-| **[dsh-guard-plan-qc](https://github.com/PerryLink/dsh-guard-plan-qc)** |  |
-| **[dsh-hazchem-check](https://github.com/PerryLink/dsh-hazchem-check)** |  |
-| **[dsh-hazplan-check](https://github.com/PerryLink/dsh-hazplan-check)** |  |
-| **[dsh-hidden-risk-map](https://github.com/PerryLink/dsh-hidden-risk-map)** |  |
-| **[dsh-hs-classify](https://github.com/PerryLink/dsh-hs-classify)** |  |
-| **[dsh-icd-rule-check](https://github.com/PerryLink/dsh-icd-rule-check)** |  |
-| **[dsh-industry-research](https://github.com/PerryLink/dsh-industry-research)** |  |
-| **[dsh-lawcite-adapter](https://github.com/PerryLink/dsh-lawcite-adapter)** |  |
-| **[dsh-laya](https://github.com/PerryLink/dsh-laya)** |  |
-| **[dsh-lc-doc-check](https://github.com/PerryLink/dsh-lc-doc-check)** |  |
-| **[dsh-learning-gap-check](https://github.com/PerryLink/dsh-learning-gap-check)** |  |
-| **[dsh-library](https://github.com/PerryLink/dsh-library)** |  |
-| **[dsh-local-ai](https://github.com/PerryLink/dsh-local-ai)** |  |
-| **[dsh-lsp-actions](https://github.com/PerryLink/dsh-lsp-actions)** |  |
-| **[dsh-mask](https://github.com/PerryLink/dsh-mask)** |  |
-| **[dsh-mcp-panel](https://github.com/PerryLink/dsh-mcp-panel)** |  |
-| **[dsh-medrec-qc](https://github.com/PerryLink/dsh-medrec-qc)** |  |
-| **[dsh-memento](https://github.com/PerryLink/dsh-memento)** |  |
-| **[dsh-nsfc-form-check](https://github.com/PerryLink/dsh-nsfc-form-check)** |  |
-| **[dsh-nurse-record-check](https://github.com/PerryLink/dsh-nurse-record-check)** |  |
-| **[dsh-observe](https://github.com/PerryLink/dsh-observe)** |  |
-| **[dsh-origin-rvc-check](https://github.com/PerryLink/dsh-origin-rvc-check)** |  |
-| **[dsh-ota-review-check](https://github.com/PerryLink/dsh-ota-review-check)** |  |
-| **[dsh-output-styles](https://github.com/PerryLink/dsh-output-styles)** |  |
-| **[dsh-paper-doc-adapter](https://github.com/PerryLink/dsh-paper-doc-adapter)** |  |
-| **[dsh-permission-rules](https://github.com/PerryLink/dsh-permission-rules)** |  |
-| **[dsh-permit-report-check](https://github.com/PerryLink/dsh-permit-report-check)** |  |
-| **[dsh-pipeline-check](https://github.com/PerryLink/dsh-pipeline-check)** |  |
-| **[dsh-pleading-draft](https://github.com/PerryLink/dsh-pleading-draft)** |  |
-| **[dsh-plugin-doctor](https://github.com/PerryLink/dsh-plugin-doctor)** |  |
-| **[dsh-plugin-guide](https://github.com/PerryLink/dsh-plugin-guide)** |  |
-| **[dsh-plugin-kit](https://github.com/PerryLink/dsh-plugin-kit)** |  |
-| **[dsh-plugin-upgrade](https://github.com/PerryLink/dsh-plugin-upgrade)** |  |
-| **[dsh-policy-brief-draft](https://github.com/PerryLink/dsh-policy-brief-draft)** |  |
-| **[dsh-power-loss-split](https://github.com/PerryLink/dsh-power-loss-split)** |  |
-| **[dsh-power-ticket-check](https://github.com/PerryLink/dsh-power-ticket-check)** |  |
-| **[dsh-ppap-check](https://github.com/PerryLink/dsh-ppap-check)** |  |
-| **[dsh-protest-deadline](https://github.com/PerryLink/dsh-protest-deadline)** |  |
-| **[dsh-railway-window](https://github.com/PerryLink/dsh-railway-window)** |  |
-| **[dsh-repair-order-qc](https://github.com/PerryLink/dsh-repair-order-qc)** |  |
-| **[dsh-research-report](https://github.com/PerryLink/dsh-research-report)** |  |
-| **[dsh-review-reply-check](https://github.com/PerryLink/dsh-review-reply-check)** |  |
-| **[dsh-rulefile-check](https://github.com/PerryLink/dsh-rulefile-check)** |  |
-| **[dsh-safety-brief-check](https://github.com/PerryLink/dsh-safety-brief-check)** |  |
-| **[dsh-score](https://github.com/PerryLink/dsh-score)** |  |
-| **[dsh-session-sync](https://github.com/PerryLink/dsh-session-sync)** |  |
-| **[dsh-site-log-check](https://github.com/PerryLink/dsh-site-log-check)** |  |
-| **[dsh-skill-pack-security](https://github.com/PerryLink/dsh-skill-pack-security)** |  |
-| **[dsh-soe-decision-check](https://github.com/PerryLink/dsh-soe-decision-check)** |  |
-| **[dsh-soilwater-check](https://github.com/PerryLink/dsh-soilwater-check)** |  |
-| **[dsh-sop-sync-check](https://github.com/PerryLink/dsh-sop-sync-check)** |  |
-| **[dsh-spc-gbt-adapter](https://github.com/PerryLink/dsh-spc-gbt-adapter)** |  |
-| **[dsh-talk](https://github.com/PerryLink/dsh-talk)** |  |
-| **[dsh-tender-extract](https://github.com/PerryLink/dsh-tender-extract)** |  |
-| **[dsh-tender-matrix](https://github.com/PerryLink/dsh-tender-matrix)** |  |
-| **[dsh-test-drive](https://github.com/PerryLink/dsh-test-drive)** |  |
-| **[dsh-ticktick](https://github.com/PerryLink/dsh-ticktick)** |  |
-| **[dsh-translate](https://github.com/PerryLink/dsh-translate)** |  |
-| **[dsh-warranty-calc](https://github.com/PerryLink/dsh-warranty-calc)** |  |
-| **[dsh-budget](https://github.com/PerryLink/dsh-budget)** | 🧊 फ़्रोज़न — रिपॉज़िटरी README देखें |
-| **[dsh-claude-move](https://github.com/PerryLink/dsh-claude-move)** | 🧊 फ़्रोज़न — रिपॉज़िटरी README देखें |
-| **[dsh-defend](https://github.com/PerryLink/dsh-defend)** | 🧊 फ़्रोज़न — रिपॉज़िटरी README देखें |
-| **[dsh-draw](https://github.com/PerryLink/dsh-draw)** | 🧊 फ़्रोज़न — रिपॉज़िटरी README देखें |
-| **[dsh-reach](https://github.com/PerryLink/dsh-reach)** | 🧊 फ़्रोज़न — रिपॉज़िटरी README देखें |
-| **[dsh-background-agents](https://github.com/PerryLink/dsh-background-agents)** | 🚫 सेवानिवृत्त — रिपॉज़िटरी README देखें |
-| **[dsh-session-pin](https://github.com/PerryLink/dsh-session-pin)** | 🚫 सेवानिवृत्त — रिपॉज़िटरी README देखें |
-| **[dsh-team-rooms](https://github.com/PerryLink/dsh-team-rooms)** | 🚫 सेवानिवृत्त — रिपॉज़िटरी README देखें |
-
-</details>
-
-## Disclaimer
-
-सामुदायिक-अनुरक्षित, **नहीं** एक आधिकारिक DeepSeek उत्पाद। DeepSeek Harness डेवलपर पूर्वावलोकन में है और ब्रेकिंग बदलाव प्रकाशित करता है; संदेह होने पर `references/official-docs/` में आधिकारिक दस्तावेज़ सत्य का स्रोत हैं।
-
-## License
-
-[Apache License 2.0](LICENSE) © 2026 dsh-plugin-guide contributors — हमारा अपना पाठ (`SKILL.md`, `guide/`, `references/`, `scripts/`, यह README) Apache-2.0 है; पैक की गई तृतीय-पक्ष सामग्री [NOTICE.md](NOTICE.md) में दस्तावेज़ित है।
-
-### DSH Desktop मार्केट से इंस्टॉल करें
-
-सभी PerryLink प्लगइन DSH Desktop के बिल्ट-इन मार्केट में देखे जा सकते हैं: **Market → Sources → add source → पेस्ट करें** `https://perrylink-dsh-catalog.perrylink.workers.dev/catalog-source.json` **→ चुनें**। इंस्टॉलेशन मार्केट के npm-identity सत्यापन और आपकी पुष्टि से ही होता है।