dsh-observe 0.2.27 → 0.2.29

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.
package/README.hi.md ADDED
@@ -0,0 +1,446 @@
1
+ <div align="center">
2
+
3
+ <picture>
4
+ <source media="(prefers-color-scheme: dark)" srcset="docs/assets/dsh-observe-hero-en-dark.webp">
5
+ <img src="docs/assets/dsh-observe-hero-en-light.webp" width="100%" alt="dsh-observe: बाईं ओर प्लगइन का नाम, मूल्य-पंक्तियाँ और इंस्टॉल कमांड; दाईं ओर एक turn की trace वॉटरफ़ॉल — समय-अक्ष पर turn, step, टूल-कॉल और LLM स्पैन, LLM बार पर टोकन संख्या, नीचे spans, tokens, USD लागत और context दबाव के मेट्रिक्स; कार्ड बताता है कि सैनिटाइज़ेशन कतार से पहले होता है और गंतव्य OTLP और Langfuse हैं">
6
+ </picture>
7
+
8
+ # dsh-observe
9
+
10
+ **हर सत्र को मानक OTLP ट्रेस और Langfuse अवलोकन में बदलें—बाहर जाने से पहले सैनिटाइज़, डिफ़ॉल्ट रूप से कुछ भी नहीं भेजा जाता।**
11
+
12
+ DeepSeek Harness के लिए अवलोकनीयता एक्सपोर्टर: turn/step/टूल-कॉल/LLM स्पैन, टोकन और USD लागत मेट्रिक्स, असिंक्रोनस बैचिंग, सीमित ऑफ़लाइन बफ़र और एक्सपोनेंशियल बैकऑफ़ पुनःप्रयास; OTLP, Langfuse या दोनों इस्तेमाल करें।
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-observe?style=flat-square&labelColor=2B3245&color=CB3837)](https://www.npmjs.com/package/dsh-observe)
19
+ [![CI](https://img.shields.io/github/actions/workflow/status/PerryLink/dsh-observe/ci.yml?branch=main&label=CI&style=flat-square&labelColor=2B3245)](https://github.com/PerryLink/dsh-observe/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-observe?style=flat-square&labelColor=2B3245)](https://github.com/PerryLink/dsh-observe/stargazers)
23
+ [![npm downloads](https://img.shields.io/npm/dm/dsh-observe?style=flat-square&labelColor=2B3245&color=CB3837)](https://www.npmjs.com/package/dsh-observe)
24
+ [![dshfind](https://dshfind.com/api/badge/PerryLink/dsh-observe?metric=downloads)](https://dshfind.com/plugins/PerryLink/dsh-observe?ref=badge)
25
+ [![OpenSSF Scorecard](https://api.securityscorecards.dev/projects/github.com/PerryLink/dsh-observe/badge)](https://securityscorecards.dev/viewer/?uri=github.com/PerryLink/dsh-observe)
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-observe)
28
+
29
+ ```sh
30
+ dsh plugin --profile <name> add dsh-observe
31
+ ```
32
+
33
+ </div>
34
+
35
+ <sub>सामुदायिक प्लगइन, DeepSeek से संबद्ध नहीं। एकमात्र रेपो: <https://github.com/PerryLink/dsh-observe> (Gitee एक मिरर है)।</sub>
36
+
37
+ ## यह क्या है
38
+
39
+ `dsh-observe` हार्नेस की `session/event` धारा को मानक अवलोकनीयता प्रोटोकॉल में अनुवादित करता है: प्रति turn एक ट्रेस, step, टूल-कॉल और LLM जनरेशन के लिए अलग स्पैन, टोकन और लागत के संचयी मेट्रिक्स, और prompt/completion का मुख्य भाग जो कतार में आने से पहले सैनिटाइज़ और छोटा किया जाता है। यह केवल एक्सपोर्ट करता है: कोई मॉडल टूल या उपयोगकर्ता-दृश्य कमांड पंजीकृत नहीं करता, और सारा व्यवहार कॉन्फ़िगरेशन से तय होता है। OTLP या Langfuse कॉन्फ़िगर करें, पुनः आरंभ करें, और डेटा स्वयं बहने लगता है; बिना कॉन्फ़िगरेशन कुछ भी एकत्र नहीं होता।
40
+
41
+ <picture>
42
+ <source media="(prefers-color-scheme: dark)" srcset="docs/assets/dsh-observe-flow-v5-dark.svg">
43
+ <img src="docs/assets/dsh-observe-flow-v5-light.svg" width="100%" alt="dsh-observe संरचना (एक सीमित spool के इर्द-गिर्द दो पाइपलाइनों में फोर्क): session/event कलेक्टर को feed करता है (turn/step/tool/llm स्पैन तथा observe.tokens, observe.cost, observe.context_tokens मेट्रिक्स, नियतात्मक sha256 id), फिर sanitize (कुंजी-नाम redaction, अंतर्निहित सीक्रेट पैटर्न, prompt/completion 4000 और tool 2000/2000 अक्षर बजट) किसी भी कतार से पहले हर रिकॉर्ड साफ़ करता है; रिकॉर्ड दो स्वतंत्र पाइपलाइनों otlp और langfuse में बँटता है, हर एक कतार (256 रिकॉर्ड या 5000ms, maxQueueRecords 2000) → flush/retry (5 प्रयास, 1000ms × 2 बैकऑफ़, सीमा 60000ms) → अपने endpoint तक; पुनःप्रयास समाप्त होने और कतार भर जाने पर रिकॉर्ड दोनों पटरियों के बीच के सीमित storage-domain spool में जाते हैं (10000 रिकॉर्ड, सबसे पुराना पहले निकलता है, पढ़ते समय zod पुनः सत्यापन, पुनः आरंभ के बाद भी रहता है), और दाईं ओर की बिंदुदार रेल से हर 30000ms में दोनों endpoints को वापस भरे जाते हैं; नीचे बाईं ओर वैकल्पिक remote सतह observe/status और observe/setEnabled है, और नीचे की पट्टी डिफ़ॉल्ट-बंद अनुबंध तथा तीन सुने जाने वाले इवेंट बताती है">
44
+ </picture>
45
+
46
+ ## तीन चरणों में शुरुआत
47
+
48
+ 1. **इंस्टॉल** (एक चुनें):
49
+
50
+ ```sh
51
+ # git चैनल (नवीनतम main; prepare स्क्रिप्ट केवल प्रोडक्शन निर्भरताओं से बिल्ड करती है)
52
+ dsh plugin --profile web add github:PerryLink/dsh-observe
53
+ # npm चैनल (प्रकाशित वर्शन)
54
+ dsh plugin --profile web add dsh-observe
55
+ # tarball चैनल: इस रेपो में pnpm pack के बाद
56
+ dsh plugin --profile web add ./dsh-observe-<version>.tgz
57
+ ```
58
+
59
+ > यदि pnpm इस पैकेज के लिए `ERR_PNPM_IGNORED_BUILDS` दिखाए (esbuild के प्लेटफ़ॉर्म-बाइनरी का हानिरहित सत्यापन), तो अपने `pnpm-workspace.yaml` में `allowBuilds: { esbuild: true }` जोड़ें; `dsh` CLI ठीक वही स्निपेट छापती है।
60
+
61
+ 2. **न्यूनतम कॉन्फ़िगरेशन** (profile patch में `enabled` चालू करें और कम से कम एक बैकएंड कॉन्फ़िगर करें; `cordis.patch.yml` में यह पंक्ति बंद हालत में आती है):
62
+
63
+ ```yaml
64
+ - insert:
65
+ - id: dsh-observe
66
+ name: dsh-observe
67
+ config:
68
+ enabled: true
69
+ otlp:
70
+ endpoint: http://localhost:4318
71
+ ```
72
+
73
+ Langfuse भी इसी तरह: `langfuse.baseUrl` + `langfuse.publicKey` + `langfuse.secretKey`। दोनों बैकएंड एक साथ चालू रह सकते हैं।
74
+
75
+ 3. **जाँचें कि यह चालू है**:
76
+
77
+ ```sh
78
+ dsh --profile web --dump-config | grep -A2 'id: dsh-observe'
79
+ ```
80
+
81
+ कोई उपयोगकर्ता-दृश्य कमांड पंजीकृत नहीं है, इसलिए `/observe` जैसा कोई मैन्युअल ट्रिगर नहीं है। `remote.enabled: true` के साथ कोई सेटिंग्स पेज `observe/status` से कॉन्फ़िगर किए गए बैकएंड, कतार की गहराई और बफ़र का उपयोग पढ़ सकता है।
82
+
83
+ **अनइंस्टॉल**: `dsh plugin --profile web remove dsh-observe` (या profile patch से वह पंक्ति हटा दें)।
84
+
85
+ <details>
86
+ <summary>DSH Desktop मार्केट से इंस्टॉल करें</summary>
87
+
88
+ सभी PerryLink प्लगइन DSH Desktop के अंतर्निहित मार्केट में देखे जा सकते हैं: **मार्केट → स्रोत → स्रोत जोड़ें → चिपकाएँ** `https://perrylink-dsh-catalog.perrylink.workers.dev/catalog-source.json` **→ चुनें**। इंस्टॉल अब भी मार्केट के npm पहचान सत्यापन और आपकी पुष्टि से होता है।
89
+
90
+ </details>
91
+
92
+ ## मुख्य क्षमताएँ
93
+
94
+ `dsh-observe` सत्र घटना-धारा को मानक अवलोकनीयता प्रोटोकॉल में बदलता है:
95
+
96
+ - **Spans** — turn, step, टूल-कॉल (अवधि, स्थिति, पुनःप्रयास व्युत्पत्ति) और LLM जनरेशन स्पैन, नियतात्मक ids के साथ प्रति-turn ट्रेस में जुड़े हुए।
97
+ - **Metrics** — प्रति provider/model टोकन काउंटर, USD लागत काउंटर (कॉन्फ़िगर करने योग्य मूल्य तालिका), और `ctx.tokenMeter` से वैकल्पिक संदर्भ-दबाव gauge।
98
+ - **सैनिटाइज़्ड कैप्चर** — prompt और completion का मुख्य भाग संरचनात्मक कुंजी-नाम रिडैक्शन, अंतर्निहित सीक्रेट पैटर्न, आपके पैटर्न और अक्षर बजट से गुज़रने के बाद ही कतार में आता है या भेजा जाता है।
99
+ - **विश्वसनीयता** — असिंक्रोनस बैचिंग (आकार और टाइमर दोनों से), सीमित टिकाऊ ऑफ़लाइन बफ़र (storage-domain, सबसे पुराना पहले निकलता है) और नियतात्मक एक्सपोनेंशियल बैकऑफ़ पुनःप्रयास; न पहुँचे बैच पुनः आरंभ के बाद भी बचे रहते हैं।
100
+ - **रनटाइम किल स्विच** — वैकल्पिक Typert remote (`observe/status`, `observe/setEnabled`) से सेटिंग्स पेज प्लगइन हटाए बिना एक्सपोर्ट रोक और फिर शुरू कर सकता है।
101
+ - **डिफ़ॉल्ट रूप से बंद** — `enabled: true` और कम से कम एक बैकएंड ही स्पष्ट ऑप्ट-इन है; अन्यथा कुछ भी एकत्र या एक्सपोर्ट नहीं होता।
102
+
103
+ ```text
104
+ session/event धारा
105
+ │ collector (turn/step/tool/llm स्पैन, मेट्रिक्स)
106
+ │ sanitize (कुंजियाँ, सीक्रेट, बजट)
107
+ ├──▶ pipeline "otlp" ── कतार ── flush ──▶ OTLP /v1/traces + /v1/metrics
108
+ │ └─ पुनःप्रयास/बैकऑफ़ ─┐
109
+ ├──▶ pipeline "langfuse" ── कतार ── flush ──▶ Langfuse ingestion
110
+ │ └─ पुनःप्रयास/बैकऑफ़ ─┤
111
+ └────────── टिकाऊ spool (ऑफ़लाइन बफ़र, सीमित) ◀┘
112
+ ```
113
+
114
+ ### सतहें
115
+
116
+ यह प्लगइन **कोई मॉडल टूल पंजीकृत नहीं करता** और कोई उपयोगकर्ता-दृश्य कमांड भी नहीं — यह पृष्ठभूमि एक्सपोर्टर है। इसकी पूरी सतह तीन चीज़ें हैं:
117
+
118
+ - **उपभोग** `session/event` (स्पैन/मेट्रिक संग्रह), `session/flush` (सर्वोत्तम-प्रयास एक्सपोर्ट किक — टिकाऊता चेकपॉइंट रिमोट बैकएंड की प्रतीक्षा कभी नहीं करता) और `session/disposed`।
119
+ - **वैकल्पिक remote सेवा** `observe` (`remote.enabled`, डिफ़ॉल्ट रूप से बंद) — `observe/status` किल-स्विच स्थिति, कॉन्फ़िगर किए गए बैकएंड, कतार की गहराई और बफ़र उपयोग लौटाता है; `observe/setEnabled` रनटाइम पर एक्सपोर्ट रोकता और शुरू करता है।
120
+ - **एकमात्र इंजेक्ट की गई सेवा कुंजी** `storageDomain`, जो ऑफ़लाइन बफ़र की टिकाऊ तालिका के लिए है।
121
+
122
+ ### उदाहरण
123
+
124
+ कोई मैन्युअल ट्रिगर नहीं है: इंस्टॉल के बाद ऊपर दिए न्यूनतम कॉन्फ़िगरेशन से `enabled` चालू करें और पुनः आरंभ करें; ट्रेस और मेट्रिक्स OTLP बैकएंड में दिखने लगते हैं और अवलोकन Langfuse में। यह पुष्टि करने के लिए कि संग्रह हो रहा है, बैकएंड को मिला पहला ट्रेस देखें; यह पुष्टि करने के लिए कि भेजा जा रहा है, देखें कि `observe/status` की कतार-गहराई सत्र बढ़ने के साथ घटती है।
125
+
126
+ ## कॉन्फ़िगरेशन
127
+
128
+ सभी ट्यूनेबल Schemastery `Config` फ़ील्ड हैं (cordis.yml या profile patch से बदले जा सकते हैं)। id-लक्षित ओवरराइड पूरी पंक्ति बदल देता है — ज़रूरत की हर कुंजी दोबारा लिखें। [`cordis.patch.yml`](cordis.patch.yml) हर कुंजी को इनलाइन समझाता है।
129
+
130
+ सबसे अधिक इस्तेमाल होने वाली कुंजियाँ:
131
+
132
+ | कुंजी | डिफ़ॉल्ट | अर्थ |
133
+ |---|---|---|
134
+ | `enabled` | `false` | मुख्य स्विच; `true` और कम से कम एक बैकएंड ही स्पष्ट ऑप्ट-इन है |
135
+ | `otlp.endpoint` | *(आवश्यक)* | OTLP आधार URL; प्लगइन `/v1/traces` और `/v1/metrics` जोड़ता है |
136
+ | `otlp.serviceName` | `deepseek-harness` | `service.name` संसाधन विशेषता |
137
+ | `langfuse.baseUrl` | `https://cloud.langfuse.com` | Langfuse आधार URL |
138
+ | `langfuse.traceName` | `session {session} turn {turn}` | ट्रेस-नाम टेम्पलेट; `{session}`/`{turn}` प्रति ट्रेस प्रतिस्थापित होते हैं |
139
+ | `capture.llm` | `true` | LLM जनरेशन स्पैन |
140
+ | `llm.prompt` | `true` | सैनिटाइज़ किया गया अनुरोध prompt कैप्चर करें (`false` = केवल आकार) |
141
+ | `llm.reasoning` | `true` | reasoning को अलग से `gen_ai.completion.reasoning` में कैप्चर करें (`false` = केवल उत्तर) |
142
+ | `batch.maxBufferRecords` | `10000` | टिकाऊ ऑफ़लाइन बफ़र की सीमा; सबसे पुराने रिकॉर्ड पहले गिरते हैं |
143
+ | `remote.enabled` | `false` | `observe` Typert remote माउंट करें (रनटाइम किल स्विच) |
144
+
145
+ <details>
146
+ <summary>पूरी कॉन्फ़िगरेशन तालिका (48 कुंजियाँ)</summary>
147
+
148
+ | कुंजी | डिफ़ॉल्ट | अर्थ |
149
+ |---|---|---|
150
+ | `enabled` | `false` | मुख्य स्विच; `true` और कम से कम एक बैकएंड ही स्पष्ट ऑप्ट-इन है |
151
+ | `otlp` | `null` | OTLP बैकएंड कॉन्फ़िगरेशन; `null` इसे बंद करता है |
152
+ | `otlp.endpoint` | *(आवश्यक)* | OTLP आधार URL; प्लगइन `/v1/traces` और `/v1/metrics` जोड़ता है |
153
+ | `otlp.serviceName` | `deepseek-harness` | `service.name` संसाधन विशेषता |
154
+ | `otlp.serviceVersion` | *(कोई नहीं)* | `service.version` संसाधन विशेषता |
155
+ | `otlp.headers` | `{}` | हर एक्सपोर्ट अनुरोध में जुड़ने वाले अतिरिक्त हेडर |
156
+ | `otlp.timeoutMs` | `10000` | प्रति अनुरोध टाइमआउट |
157
+ | `langfuse` | `null` | Langfuse बैकएंड कॉन्फ़िगरेशन; `null` इसे बंद करता है |
158
+ | `langfuse.baseUrl` | `https://cloud.langfuse.com` | Langfuse आधार URL |
159
+ | `langfuse.publicKey` | *(आवश्यक)* | प्रोजेक्ट सार्वजनिक कुंजी |
160
+ | `langfuse.secretKey` | *(आवश्यक)* | प्रोजेक्ट गुप्त कुंजी |
161
+ | `langfuse.release` | *(कोई नहीं)* | ट्रेस पर लगने वाला रिलीज़ टैग |
162
+ | `langfuse.traceName` | `session {session} turn {turn}` | ट्रेस-नाम टेम्पलेट; `{session}`/`{turn}` प्रति ट्रेस प्रतिस्थापित होते हैं |
163
+ | `langfuse.tags` | `[]` | हर ट्रेस पर लगने वाले स्थिर टैग |
164
+ | `langfuse.timeoutMs` | `10000` | प्रति अनुरोध टाइमआउट |
165
+ | `capture.turns` | `true` | turn जीवनचक्र स्पैन |
166
+ | `capture.steps` | `true` | step जीवनचक्र स्पैन |
167
+ | `capture.tools` | `true` | सैनिटाइज़ किए गए आर्ग्युमेंट/परिणाम के साथ टूल-कॉल स्पैन |
168
+ | `capture.llm` | `true` | LLM जनरेशन स्पैन |
169
+ | `llm.prompt` | `true` | सैनिटाइज़ किया गया अनुरोध prompt कैप्चर करें (`false` = केवल आकार) |
170
+ | `llm.completion` | `true` | सैनिटाइज़ की गई completion कैप्चर करें (`false` = केवल आकार) |
171
+ | `llm.reasoning` | `true` | reasoning को अलग से `gen_ai.completion.reasoning` में कैप्चर करें (`false` = केवल उत्तर) |
172
+ | `metadata.sessionId` | `true` | सत्र id विशेषता |
173
+ | `metadata.cwd` | `false` | सत्र कार्य निर्देशिका (एक स्थानीय पथ — डिफ़ॉल्ट रूप से बंद) |
174
+ | `metadata.agentPreset` | `true` | agent preset id विशेषता |
175
+ | `metadata.model` | `true` | provider/model विशेषताएँ |
176
+ | `metrics.tokens` | `true` | प्रति provider/model टोकन काउंटर |
177
+ | `metrics.cost` | `true` | USD लागत काउंटर (मेल खाते `pricing` नियम चाहिए) |
178
+ | `metrics.contextTokens` | `true` | संदर्भ-दबाव gauge (`ctx.tokenMeter` चाहिए) |
179
+ | `pricing` | `[]` | मूल्य तालिका, पहला मेल जीतता है: `{ provider?, model, inputPerToken, outputPerToken, cacheReadPerToken?, cacheWritePerToken? }` |
180
+ | `sanitize.enabled` | `true` | रिडैक्शन मुख्य स्विच (`false` रिडैक्शन बंद करता है, ट्रंकेशन कभी नहीं) |
181
+ | `sanitize.redactKeys` | `[]` | अतिरिक्त कुंजी-नाम उपस्ट्रिंग (key/token/secret/password/authorization/credential/apiKey सदैव शामिल) |
182
+ | `sanitize.redactPatterns` | `[]` | अतिरिक्त सीक्रेट रेगुलर एक्सप्रेशन |
183
+ | `sanitize.truncatePromptChars` | `4000` | prompt अक्षर बजट |
184
+ | `sanitize.truncateCompletionChars` | `4000` | completion अक्षर बजट |
185
+ | `sanitize.truncateToolInputChars` | `2000` | टूल आर्ग्युमेंट अक्षर बजट |
186
+ | `sanitize.truncateToolOutputChars` | `2000` | टूल परिणाम अक्षर बजट |
187
+ | `sanitize.truncateAttributeChars` | `512` | स्पैन विशेषता स्ट्रिंग बजट |
188
+ | `batch.maxRecords` | `256` | कतार में इतने रिकॉर्ड होते ही flush |
189
+ | `batch.flushIntervalMs` | `5000` | टाइमर flush अंतराल |
190
+ | `batch.maxQueueRecords` | `2000` | मेमोरी कतार की सीमा; अधिक बफ़र में बह जाता है |
191
+ | `batch.maxBufferRecords` | `10000` | टिकाऊ ऑफ़लाइन बफ़र की सीमा; सबसे पुराने रिकॉर्ड पहले गिरते हैं |
192
+ | `batch.bufferRetryIntervalMs` | `30000` | ऑफ़लाइन बफ़र पुनःप्रयास अंतराल |
193
+ | `retry.maxAttempts` | `5` | प्रति बैच प्रयास, पहला भी शामिल |
194
+ | `retry.baseDelayMs` | `1000` | पहला बैकऑफ़ विलंब |
195
+ | `retry.factor` | `2` | प्रति लगातार विफलता बैकऑफ़ गुणक |
196
+ | `retry.maxDelayMs` | `60000` | बैकऑफ़ की ऊपरी सीमा |
197
+ | `remote.enabled` | `false` | `observe` Typert remote माउंट करें (रनटाइम किल स्विच) |
198
+
199
+ </details>
200
+
201
+ > ⚠️ **reasoning अनुपालन सूचना** — `llm.reasoning` डिफ़ॉल्ट रूप से चालू है और reasoning अलग से `gen_ai.completion.reasoning` के रूप में भेजा जाता है (कभी `gen_ai.completion` के अंदर नहीं; Langfuse में यह generation के metadata में जाता है)। चिंतन-श्रृंखला में उपयोगकर्ता का मूल पाठ या मॉडल द्वारा शब्दशः उद्धृत संदर्भ हो सकता है, इसलिए **भेजने से पहले अनुपालन प्रभाव का आकलन करें**। छोड़ने के लिए `llm.reasoning: false` सेट करें; `llm.completion: false` उत्तर और reasoning दोनों हटा देता है।
202
+
203
+ id-लक्षित ओवरराइड का उदाहरण (पूरी पंक्ति बदलती है, इसलिए ज़रूरत की कुंजियाँ दोबारा लिखें):
204
+
205
+ ```yaml
206
+ - insert:
207
+ - id: dsh-observe
208
+ name: dsh-observe
209
+ config:
210
+ enabled: true
211
+ otlp:
212
+ endpoint: http://localhost:4318
213
+ capture:
214
+ tools: false
215
+ sanitize:
216
+ truncatePromptChars: 2000
217
+ batch:
218
+ maxBufferRecords: 20000
219
+ ```
220
+
221
+ ## FAQ
222
+
223
+ <details>
224
+ <summary>क्या prompt या टूल आर्ग्युमेंट कच्चे रूप में बैकएंड तक पहुँचते हैं?</summary>
225
+
226
+ कच्चे रूप में नहीं। हर रिकॉर्ड कतार में आने से पहले तीन परतों में सैनिटाइज़ होता है: संरचनात्मक कुंजी-नाम (key/token/secret/password/authorization/credential/apiKey सदैव सूची में हैं और `sanitize.redactKeys` उपस्ट्रिंग जोड़ता है), अंतर्निहित सीक्रेट पैटर्न (API कुंजियाँ, GitHub टोकन, AWS कुंजियाँ, bearer क्रेडेंशियल, निजी कुंजियाँ) और आपके `sanitize.redactPatterns`, तथा अक्षर-बजट ट्रंकेशन (prompt/completion प्रत्येक 4000, टूल आर्ग्युमेंट और परिणाम प्रत्येक 2000, स्पैन विशेषता 512)। यदि केवल आकार चाहिए, मुख्य भाग नहीं, तो `llm.prompt` और `llm.completion` को `false` कर दें — रिकॉर्ड में केवल आकार और गणना रहेगी।
227
+
228
+ </details>
229
+
230
+ <details>
231
+ <summary>बैकएंड बंद हो या नेटवर्क टूटे तो डेटा खोएगा?</summary>
232
+
233
+ स्पैन और मेट्रिक्स "पुनःप्रयास → बहाव" श्रृंखला से चलते हैं: विफल बैच को नियतात्मक एक्सपोनेंशियल बैकऑफ़ से दोहराया जाता है (`retry.maxAttempts` डिफ़ॉल्ट 5, `retry.baseDelayMs × retry.factor`), और प्रयास समाप्त होने या मेमोरी कतार `batch.maxQueueRecords` पार करने पर वह सीमित टिकाऊ spool में बह जाता है (`batch.maxBufferRecords` डिफ़ॉल्ट 10000, सबसे पुराना पहले), जो `batch.bufferRetryIntervalMs` पर समय-समय पर खाली होता है — इसलिए न पहुँचे बैच पुनः आरंभ के बाद भी रहते हैं। OTLP मेट्रिक्स अपवाद हैं: वे संचयी रूप से एकत्र होते हैं और खोया हुआ एक flush अगले में स्वयं भर जाता है।
234
+
235
+ </details>
236
+
237
+ <details>
238
+ <summary>प्लगइन स्वयं क्या रखता है और क्रेडेंशियल कहाँ रहते हैं?</summary>
239
+
240
+ ऑफ़लाइन बफ़र में केवल सैनिटाइज़ किए गए रिकॉर्ड रहते हैं, और स्टोरेज से पढ़े गए रिकॉर्ड sink तक पहुँचने से पहले फिर से सत्यापित होते हैं। प्लगइन स्वयं कोई क्रेडेंशियल नहीं रखता: Langfuse की सार्वजनिक/गुप्त कुंजियाँ केवल आपके कॉन्फ़िगर किए Langfuse एंडपॉइंट के अनुरोधों में जाती हैं, और OTLP हेडर केवल आपके OTLP एंडपॉइंट पर — इन्हें क्रेडेंशियल संदर्भ या एनवायरनमेंट-इंजेक्टेड मानों में रखें, कभी कमिट किए गए profile patch में नहीं। यह केवल लाइव घटना-धारा पढ़ता है और सत्र लॉग फ़ाइलें कभी नहीं पढ़ता या बदलता।
241
+
242
+ </details>
243
+
244
+ <details>
245
+ <summary>क्या यह सत्र धीमा करता है?</summary>
246
+
247
+ संग्रह और सैनिटाइज़ेशन घटना हैंडलर में सिंक्रोनस रूप से चलते हैं, पर भेजना पूरी तरह असिंक्रोनस है: कतार आकार या टाइमर पर खाली होती है, और `session/flush` केवल एक सर्वोत्तम-प्रयास किक है — टिकाऊता चेकपॉइंट रिमोट बैकएंड की प्रतीक्षा कभी नहीं करता। एक्सपोर्ट विफलताएँ चेतावनी देती हैं, गिनी जाती हैं (`observe.export_failures`), दोहराई जाती हैं और अंत में spool में जाती हैं; `session/event` हैंडलर की विफलता पकड़ी और लॉग की जाती है, इसलिए अवलोकनीयता हार्नेस के हॉट पाथ को कभी नहीं तोड़ सकती।
248
+
249
+ </details>
250
+
251
+ <details>
252
+ <summary>क्या यह दूसरे प्लगइनों से सेवा, घटना या slot के लिए टकराता है?</summary>
253
+
254
+ यह एक सेवा कुंजी (`storageDomain`) इंजेक्ट करता है, तीन `session/*` घटनाएँ सुनता है, और कोई मॉडल टूल, कमांड, client slot, waterfall listener या वैश्विक रीराइट पंजीकृत नहीं करता। नाम की एकमात्र सतह वैकल्पिक remote सेवा `observe` है (`remote.enabled` डिफ़ॉल्ट रूप से बंद): यदि उसी profile में कोई दूसरा प्लगइन यह नाम ले ले, तो दोनों में से केवल एक चालू रखें।
255
+
256
+ </details>
257
+
258
+ ## सुरक्षा सीमाएँ
259
+
260
+ - **डिफ़ॉल्ट रूप से बंद** — जब तक आप स्पष्ट रूप से चालू न करें (`enabled: true` और कम से कम एक बैकएंड), कुछ भी एकत्र या एक्सपोर्ट नहीं होता।
261
+ - **भेजने से पहले सैनिटाइज़** — संरचनात्मक कुंजी रिडैक्शन, अंतर्निहित सीक्रेट पैटर्न (API कुंजियाँ, GitHub टोकन, AWS कुंजियाँ, bearer क्रेडेंशियल, निजी कुंजियाँ), आपके पैटर्न और अक्षर बजट — सब कुछ किसी भी रिकॉर्ड के मेमोरी छोड़ने से पहले लागू होता है।
262
+ - **टिकाऊ सीमा पर पुनःसत्यापन** — स्टोरेज से पढ़े गए रिकॉर्ड sink तक पहुँचने से पहले फिर जाँचे जाते हैं।
263
+ - **विफलता मुखर, विफलता सीमित** — एक्सपोर्ट विफलताएँ चेतावनी देती हैं, गिनी जाती हैं, दोहराई जाती हैं और अंत में spool में जाती हैं; सत्र हैंडलर की विफलता पकड़ी और लॉग की जाती है ताकि अवलोकनीयता हार्नेस का हॉट पाथ कभी न तोड़े।
264
+ - **मॉडल को दृश्य ⟺ लॉग में दर्ज** — prompt/completion एक्सपोर्ट केवल सत्र सतह (जिसका नोड 0 system prompt है) और लॉग किया गया header (कॉल कॉन्फ़िगरेशन और टूल) प्रक्षेपित करते हैं; एक्सपोर्टर कोई सामग्री नहीं गढ़ता।
265
+
266
+ ## अनुमतियाँ और डेटा
267
+
268
+ - **अनुमतियाँ**: आपके कॉन्फ़िगर किए एंडपॉइंट तक `network:outbound`, घटना-धारा के लिए `session:read`, ऑफ़लाइन बफ़र के लिए `storage:write`; कोई नेटिव कोड नहीं, कोई फ़ाइलसिस्टम पहुँच नहीं।
269
+ - **डेटा**: भेजी जाने वाली हर चीज़ सत्र लॉग से व्युत्पन्न है और कतार, बफ़र या प्रसारण से पहले सैनिटाइज़ (रिडैक्शन + ट्रंकेशन) होती है। ऑफ़लाइन बफ़र केवल सैनिटाइज़ किए गए रिकॉर्ड रखता है, जो पढ़ते समय फिर सत्यापित होते हैं।
270
+ - **क्रेडेंशियल**: Langfuse की सार्वजनिक/गुप्त कुंजियाँ केवल कॉन्फ़िगर किए Langfuse एंडपॉइंट तक जाती हैं; OTLP हेडर केवल कॉन्फ़िगर किए OTLP एंडपॉइंट तक। प्लगइन स्वयं कोई क्रेडेंशियल संग्रहीत नहीं करता — क्रेडेंशियल संदर्भ या एनवायरनमेंट-इंजेक्टेड मान इस्तेमाल करें।
271
+
272
+ ## ज्ञात सीमाएँ
273
+
274
+ - **आधार `0.2.2-rc.1`** — प्लगइन `@deepseek-ai/dsh@0.2.2-rc.1` के विरुद्ध विकसित और परीक्षित है (devDependencies और CI की मुख्य पैमाना); `engines.dsh` (`>=0.2.1-0 <0.3.0 || >=0.2.2-0 <0.3.0`) और समग्र peer श्रेणी हर प्रकाशित लाइन को इंस्टॉल-योग्य रखती है, और पुराने आधार दूसरे पैमाने (`typecheck:ci`) तथा compat वर्कफ़्लो से कवर होते हैं।
275
+ - **ऑडिट घटनाएँ स्थायी नहीं होतीं** — एक्सपोर्टर के अपने `observe/*` रिकॉर्ड केवल ऑडिट हैं: मौजूदा होस्ट लाइन पर सत्र append गेट केवल सरफ़ेस घटनाएँ स्वीकार करता है, इसलिए कोई `observe/*` घटना सत्र लॉग में नहीं लिखी जाती, और प्लगइन बिना-चिह्न append से नकली घटना नहीं बनाता (इससे सत्र अपठनीय हो जाते)। ऑडिट सतह के लिए `observe/status` आउटपुट (जिसके लिए `remote.enabled: true` चाहिए) और OTLP/Langfuse बैकएंड देखें।
276
+ - **मेट्रिक्स पुनःप्रयास/spool पथ से बाहर हैं** — OTLP मेट्रिक्स संचयी रूप से एकत्र होते हैं, इसलिए खोया हुआ flush अगले में स्वयं भर जाता है (यह डिज़ाइन है, बग नहीं)।
277
+ - **कोई सैंपलिंग नहीं** — हर सक्षम स्पैन परिवार एक्सपोर्ट होता है; अधिक भार वाले सत्रों के लिए `capture.*` स्विच और `batch.maxBufferRecords` समायोजित करें।
278
+
279
+ ## अन्य DSH प्लगइनों के साथ इंटरऑपरेबिलिटी
280
+
281
+ प्लगइन की पंजीकरण सतह जानबूझकर संकीर्ण है, इसलिए टकराव संरचनात्मक रूप से असंभाव्य हैं:
282
+
283
+ - **कोई टूल-नाम टकराव नहीं** — कोई मॉडल टूल पंजीकृत नहीं करता (न README में न `src/index.ts` में टूल पंजीकरण है)।
284
+ - **कोई कमांड-नाम टकराव नहीं** — कोई उपयोगकर्ता-दृश्य कमांड पंजीकृत नहीं करता, इसलिए स्लैश-कमांड नेमस्पेस को कभी नहीं छूता।
285
+ - **कोई client slot टकराव नहीं** — पैकेज में ब्राउज़र-आधा नहीं है (कोई `client/` निर्देशिका नहीं), इसलिए कोई client slot पंजीकृत नहीं होता।
286
+ - **कोई waterfall शॉर्ट-सर्किट नहीं** — केवल `session/event`, `session/flush` और `session/disposed` पढ़ता है; किसी allow/passthrough waterfall को नहीं सुनता, इसलिए किसी का निर्णय नहीं रोक सकता।
287
+ - **इसकी एकमात्र सेवा कुंजी** — `storageDomain` (इंजेक्ट, प्रदान नहीं); साथ में एक **वैकल्पिक** remote सेवा `observe`, जो केवल `remote.enabled: true` पर पंजीकृत होती है।
288
+ - **बाहरी ट्रैफ़िक केवल आपके एंडपॉइंट तक** — OTLP और Langfuse स्वतंत्र हैं; एक बंद करने से दूसरा प्रभावित नहीं होता।
289
+
290
+ यदि उसी profile में कोई दूसरा अवलोकनीयता प्लगइन है, तो दो बातें ध्यान में रखें: दोनों `session/event` उपभोग करते हैं (Cordis प्रसारण करता है, इसलिए कोई किसी को भूखा नहीं मारता) पर आपको दो ट्रेस सेट मिलेंगे, और `observe` remote सेवा नाम दो बार पंजीकृत न करें।
291
+
292
+ ## संगतता
293
+
294
+ | आयाम | स्थिति |
295
+ |---|---|
296
+ | Harness | DeepSeek Harness `dsh-v0.2.2-rc.4` (2026-11-18 को अनुकूलित): सत्र प्रारूप V4 टूल परिणाम को प्रथम-श्रेणी `role: 'tool'` संदेश के रूप में दर्शाता है जिसमें शीर्ष स्तर पर `toolCallId` + `content` + वैकल्पिक `isError` होता है — V3 का `tool-result` कंटेंट ब्लॉक होस्ट के `ContentBlockMap` से हट चुका है, और यह प्लगइन केवल V4 आकार पढ़ता है (अपग्रेड-पूर्व V3 लॉग अब भी केवल-पढ़ने योग्य संगतता पथ से प्रक्षेपित होता है)। V3 प्रारूप के बाकी लक्षण जारी हैं: असिस्टेंट स्ट्रीम `assistant/message` / `assistant/attempt` में अंतर्निहित है, और system prompt सतह का नोड 0 (`system/message`) है; प्लगइन केवल लाइव घटना-धारा उपभोग करता है और सत्र लॉग फ़ाइलें कभी नहीं पढ़ता। `engines.dsh` है `>=0.2.1-0 <0.3.0 \|\| >=0.2.2-0 <0.3.0`; profile इंस्टॉल स्मोक compat वर्कफ़्लो से कवर है। |
297
+ | Node | `^22.19.0 \|\| >=24.9.0`, शुद्ध ESM (`"type": "module"`) |
298
+ | बैकएंड | OpenTelemetry OTLP/HTTP (ट्रेस + मेट्रिक्स, JSON एन्कोडिंग) और Langfuse (LLM अवलोकनीयता) — एक या दोनों |
299
+ | मॉडल | मॉडल-निरपेक्ष: यह session/event धारा एक्सपोर्ट करता है; कोई मॉडल कॉल नहीं करता |
300
+
301
+ peer निर्भरताएँ: `@deepseek-ai/cordis ^4.0.5-alpha.1`, `@deepseek-ai/schemastery ^3.18.5`, और `@deepseek-ai/dsh-llm`, `@deepseek-ai/dsh-session`, `@deepseek-ai/dsh-storage`, `@deepseek-ai/dsh-storage-domain`, `@deepseek-ai/dsh-storage-json`, `@deepseek-ai/dsh-typert-protocol` (`>=0.1.2-rc.1 <0.2.0 || >=0.1.5-alpha.1 <0.2.0 || >=0.1.6-0 <0.2.0 || >=0.1.7-0 <0.2.0 || >=0.2.0-0 <0.3.0 || >=0.2.1-0 <0.3.0 || >=0.2.2-0 <0.3.0`; devDependencies `0.2.2-rc.1` पर पिन)। `zod` एकमात्र रनटाइम निर्भरता है, जो ऑफ़लाइन बफ़र की टिकाऊ-सीमा सत्यापन के लिए है।
302
+
303
+ ## इकोसिस्टम और गुणवत्ता
304
+
305
+ - [Gitee मिरर](https://gitee.com/perrylink/dsh-observe) (समन्वित मिरर; GitHub आधिकारिक स्रोत है)
306
+ - [dshfind प्लगइन पेज](https://dshfind.com/plugins/PerryLink/dsh-observe) (इंस्टॉल और रैंकिंग)
307
+ - [OpenSSF Scorecard रिपोर्ट](https://securityscorecards.dev/viewer/?uri=github.com/PerryLink/dsh-observe) ([.github/workflows/scorecard.yml](.github/workflows/scorecard.yml) द्वारा संचालित)
308
+ - [dsh-plugin-doctor सत्यापन रिपोर्ट](https://github.com/PerryLink/dsh-plugin-doctor#verified-徽章)
309
+ - [DSH Market](https://dsh.market/) (सूचीबद्ध)
310
+ - **1024 स्टोर चैनल**: एक बार `npm i -g dsh1024`, फिर `dsh1024 plugin --profile web add dsh-observe` ([deepseek1024.com](https://deepseek1024.com) इंस्टॉल रैंकिंग में गिना जाता है)
311
+ - [इकोसिस्टम नॉलेज बेस](https://perrylink.github.io/dsh-plugin-guide/): प्लगइन डेवलपमेंट गाइड · चयन डेटा · रखरखाव मानदंड
312
+
313
+ ## डेवलपमेंट
314
+
315
+ ```sh
316
+ pnpm install # node ^22.19 || >=24.9
317
+ pnpm run typecheck # tsc: src + tests, 0.2.2-rc.1 devDeps के विरुद्ध (कोई tsconfig paths नहीं)
318
+ pnpm run typecheck:ci # tsc: प्रकाशित लाइन के विरुद्ध (कोई paths नहीं)
319
+ pnpm run check:ruler-live # canary: कंपाइल विफल होना चाहिए, जो साबित करता है कि पैमाना जीवित है (checkout फ़ेस चाहिए)
320
+ pnpm test # vitest: 126 टेस्ट, 18 सुइट (असली Context/Session/storage सीम)
321
+ pnpm run test:coverage # कवरेज गेट (90/80/90/90)
322
+ pnpm run build # tsdown बंडल + tsc डिक्लेरेशन (lib/)
323
+ pnpm run verify:self-contained # निर्भरता स्पेक registry से हल होते हैं
324
+ pnpm run verify:artifacts # बिल्ट ESM फ़ेस + बंडल पैच मौजूद
325
+ node scripts/check-readme-sync.mjs # पाँच-भाषा README सिंक गेट
326
+ pnpm pack # प्रकाशित tarball
327
+ ```
328
+
329
+ README की छवियाँ [`scripts/gen-readme-assets.py`](scripts/gen-readme-assets.py) से बनती हैं (Pillow चार 1440×576 hero बनाता है; 1100×660 संरचना आरेख हाथ से लिखा SVG है), जो `docs/assets/dsh-observe-hero-{zh,en}-{light,dark}.webp` और `docs/assets/dsh-observe-flow-v5-{light,dark}.svg` जोड़ी लिखता है; दोबारा चलाना idempotent है। पुराने `docs/assets/dsh-observe-flow-{light,dark}.svg`, `dsh-observe-flow.svg`, `dsh-observe-hero.png` और `dsh-observe-demo.{png,gif}` बाहरी लिंक के 404 से बचने के लिए वहीं रखे गए हैं; README अब उन्हें संदर्भित नहीं करते।
330
+
331
+ Topics: `dsh`, `dsh-plugin`, `deepseek-harness`, `deepseek`, `cordis`, `observability`, `opentelemetry`, `otlp`, `langfuse`, `tracing`
332
+
333
+ ## परिवार और आभार
334
+
335
+ यह प्रोजेक्ट [PerryLink](https://github.com/PerryLink) द्वारा अनुरक्षित DeepSeek Harness प्लगइन परिवार का हिस्सा है (सभी Apache-2.0)। अगर यह प्लगइन उपयोगी लगे, तो **एक स्टार दें** — इससे कोई सुविधा अनलॉक नहीं होती, पर अगला व्यक्ति इसे जल्दी पा लेता है।
336
+
337
+ - [@PerryLink](https://github.com/PerryLink) — निर्माता और अनुरक्षक: collector, pipelines, spool, OTLP/Langfuse sinks, सैनिटाइज़ेशन तथा पाँच-भाषा दस्तावेज़।
338
+
339
+ <details>
340
+ <summary>सभी प्लगइन खोलें</summary>
341
+
342
+ | प्लगइन | स्थिति |
343
+ |---|---|
344
+ | **[dsh-aqua-input-check](https://github.com/PerryLink/dsh-aqua-input-check)** | |
345
+ | **[dsh-archive-check](https://github.com/PerryLink/dsh-archive-check)** | |
346
+ | **[dsh-auto-review](https://github.com/PerryLink/dsh-auto-review)** | |
347
+ | **[dsh-autotier](https://github.com/PerryLink/dsh-autotier)** | 🧊 फ़्रोज़न — रेपो README देखें |
348
+ | **[dsh-bid-ca-precheck](https://github.com/PerryLink/dsh-bid-ca-precheck)** | |
349
+ | **[dsh-bid-qual-check](https://github.com/PerryLink/dsh-bid-qual-check)** | |
350
+ | **[dsh-cert-mcp](https://github.com/PerryLink/dsh-cert-mcp)** | 🧊 फ़्रोज़न — रेपो README देखें |
351
+ | **[dsh-checkpoint-rewind](https://github.com/PerryLink/dsh-checkpoint-rewind)** | |
352
+ | **[dsh-click](https://github.com/PerryLink/dsh-click)** | |
353
+ | **[dsh-composer-history](https://github.com/PerryLink/dsh-composer-history)** | |
354
+ | **[dsh-contract-stance](https://github.com/PerryLink/dsh-contract-stance)** | |
355
+ | **[dsh-customs-doc-check](https://github.com/PerryLink/dsh-customs-doc-check)** | |
356
+ | **[dsh-data-quality](https://github.com/PerryLink/dsh-data-quality)** | 🧊 फ़्रोज़न — रेपो README देखें |
357
+ | **[dsh-demurrage-ledger](https://github.com/PerryLink/dsh-demurrage-ledger)** | |
358
+ | **[dsh-doublecheck](https://github.com/PerryLink/dsh-doublecheck)** | |
359
+ | **[dsh-drill-script-check](https://github.com/PerryLink/dsh-drill-script-check)** | |
360
+ | **[dsh-eia-guide-check](https://github.com/PerryLink/dsh-eia-guide-check)** | |
361
+ | **[dsh-emergency-plan](https://github.com/PerryLink/dsh-emergency-plan)** | |
362
+ | **[dsh-essay-rubric-check](https://github.com/PerryLink/dsh-essay-rubric-check)** | |
363
+ | **[dsh-evidence-check](https://github.com/PerryLink/dsh-evidence-check)** | |
364
+ | **[dsh-export-ctl-check](https://github.com/PerryLink/dsh-export-ctl-check)** | |
365
+ | **[dsh-fast](https://github.com/PerryLink/dsh-fast)** | |
366
+ | **[dsh-fmea-table-check](https://github.com/PerryLink/dsh-fmea-table-check)** | |
367
+ | **[dsh-forecast-penalty](https://github.com/PerryLink/dsh-forecast-penalty)** | |
368
+ | **[dsh-fund-research](https://github.com/PerryLink/dsh-fund-research)** | |
369
+ | **[dsh-github](https://github.com/PerryLink/dsh-github)** | |
370
+ | **[dsh-gongwen-flow-check](https://github.com/PerryLink/dsh-gongwen-flow-check)** | |
371
+ | **[dsh-gongwen-word-check](https://github.com/PerryLink/dsh-gongwen-word-check)** | |
372
+ | **[dsh-guard-plan-qc](https://github.com/PerryLink/dsh-guard-plan-qc)** | |
373
+ | **[dsh-hazchem-check](https://github.com/PerryLink/dsh-hazchem-check)** | |
374
+ | **[dsh-hazplan-check](https://github.com/PerryLink/dsh-hazplan-check)** | |
375
+ | **[dsh-hidden-risk-map](https://github.com/PerryLink/dsh-hidden-risk-map)** | |
376
+ | **[dsh-hs-classify](https://github.com/PerryLink/dsh-hs-classify)** | |
377
+ | **[dsh-icd-rule-check](https://github.com/PerryLink/dsh-icd-rule-check)** | |
378
+ | **[dsh-industry-research](https://github.com/PerryLink/dsh-industry-research)** | |
379
+ | **[dsh-lawcite-adapter](https://github.com/PerryLink/dsh-lawcite-adapter)** | |
380
+ | **[dsh-laya](https://github.com/PerryLink/dsh-laya)** | |
381
+ | **[dsh-lc-doc-check](https://github.com/PerryLink/dsh-lc-doc-check)** | |
382
+ | **[dsh-learning-gap-check](https://github.com/PerryLink/dsh-learning-gap-check)** | |
383
+ | **[dsh-library](https://github.com/PerryLink/dsh-library)** | |
384
+ | **[dsh-local-ai](https://github.com/PerryLink/dsh-local-ai)** | |
385
+ | **[dsh-lsp-actions](https://github.com/PerryLink/dsh-lsp-actions)** | |
386
+ | **[dsh-mask](https://github.com/PerryLink/dsh-mask)** | |
387
+ | **[dsh-mcp-panel](https://github.com/PerryLink/dsh-mcp-panel)** | |
388
+ | **[dsh-medrec-qc](https://github.com/PerryLink/dsh-medrec-qc)** | |
389
+ | **[dsh-memento](https://github.com/PerryLink/dsh-memento)** | 🧊 फ़्रोज़न — रेपो README देखें |
390
+ | **[dsh-nsfc-form-check](https://github.com/PerryLink/dsh-nsfc-form-check)** | |
391
+ | **[dsh-nurse-record-check](https://github.com/PerryLink/dsh-nurse-record-check)** | |
392
+ | **[dsh-observe](https://github.com/PerryLink/dsh-observe)** | |
393
+ | **[dsh-origin-rvc-check](https://github.com/PerryLink/dsh-origin-rvc-check)** | |
394
+ | **[dsh-ota-review-check](https://github.com/PerryLink/dsh-ota-review-check)** | |
395
+ | **[dsh-output-styles](https://github.com/PerryLink/dsh-output-styles)** | |
396
+ | **[dsh-paper-doc-adapter](https://github.com/PerryLink/dsh-paper-doc-adapter)** | |
397
+ | **[dsh-permission-rules](https://github.com/PerryLink/dsh-permission-rules)** | |
398
+ | **[dsh-permit-report-check](https://github.com/PerryLink/dsh-permit-report-check)** | |
399
+ | **[dsh-pipeline-check](https://github.com/PerryLink/dsh-pipeline-check)** | |
400
+ | **[dsh-pleading-draft](https://github.com/PerryLink/dsh-pleading-draft)** | |
401
+ | **[dsh-plugin-doctor](https://github.com/PerryLink/dsh-plugin-doctor)** | 🚫 रिटायर्ड (रेपो संग्रहीत) |
402
+ | **[dsh-plugin-guide](https://github.com/PerryLink/dsh-plugin-guide)** | |
403
+ | **[dsh-plugin-kit](https://github.com/PerryLink/dsh-plugin-kit)** | 🚫 रिटायर्ड (रेपो संग्रहीत) |
404
+ | **[dsh-plugin-upgrade](https://github.com/PerryLink/dsh-plugin-upgrade)** | 🚫 रिटायर्ड (रेपो संग्रहीत) |
405
+ | **[dsh-policy-brief-draft](https://github.com/PerryLink/dsh-policy-brief-draft)** | |
406
+ | **[dsh-power-loss-split](https://github.com/PerryLink/dsh-power-loss-split)** | |
407
+ | **[dsh-power-ticket-check](https://github.com/PerryLink/dsh-power-ticket-check)** | |
408
+ | **[dsh-ppap-check](https://github.com/PerryLink/dsh-ppap-check)** | |
409
+ | **[dsh-protest-deadline](https://github.com/PerryLink/dsh-protest-deadline)** | |
410
+ | **[dsh-railway-window](https://github.com/PerryLink/dsh-railway-window)** | |
411
+ | **[dsh-repair-order-qc](https://github.com/PerryLink/dsh-repair-order-qc)** | |
412
+ | **[dsh-research-report](https://github.com/PerryLink/dsh-research-report)** | |
413
+ | **[dsh-review-reply-check](https://github.com/PerryLink/dsh-review-reply-check)** | |
414
+ | **[dsh-rulefile-check](https://github.com/PerryLink/dsh-rulefile-check)** | |
415
+ | **[dsh-safety-brief-check](https://github.com/PerryLink/dsh-safety-brief-check)** | |
416
+ | **[dsh-score](https://github.com/PerryLink/dsh-score)** | 🧊 फ़्रोज़न — रेपो README देखें |
417
+ | **[dsh-session-sync](https://github.com/PerryLink/dsh-session-sync)** | |
418
+ | **[dsh-site-log-check](https://github.com/PerryLink/dsh-site-log-check)** | |
419
+ | **[dsh-skill-pack-security](https://github.com/PerryLink/dsh-skill-pack-security)** | |
420
+ | **[dsh-soe-decision-check](https://github.com/PerryLink/dsh-soe-decision-check)** | |
421
+ | **[dsh-soilwater-check](https://github.com/PerryLink/dsh-soilwater-check)** | |
422
+ | **[dsh-sop-sync-check](https://github.com/PerryLink/dsh-sop-sync-check)** | |
423
+ | **[dsh-spc-gbt-adapter](https://github.com/PerryLink/dsh-spc-gbt-adapter)** | |
424
+ | **[dsh-talk](https://github.com/PerryLink/dsh-talk)** | |
425
+ | **[dsh-tender-extract](https://github.com/PerryLink/dsh-tender-extract)** | |
426
+ | **[dsh-tender-matrix](https://github.com/PerryLink/dsh-tender-matrix)** | |
427
+ | **[dsh-test-drive](https://github.com/PerryLink/dsh-test-drive)** | |
428
+ | **[dsh-ticktick](https://github.com/PerryLink/dsh-ticktick)** | 🚫 रिटायर्ड (रेपो संग्रहीत) |
429
+ | **[dsh-translate](https://github.com/PerryLink/dsh-translate)** | |
430
+ | **[dsh-warranty-calc](https://github.com/PerryLink/dsh-warranty-calc)** | |
431
+ | **[dsh-budget](https://github.com/PerryLink/dsh-budget)** | 🧊 फ़्रोज़न — रेपो README देखें |
432
+ | **[dsh-claude-move](https://github.com/PerryLink/dsh-claude-move)** | 🧊 फ़्रोज़न — रेपो README देखें |
433
+ | **[dsh-defend](https://github.com/PerryLink/dsh-defend)** | 🧊 फ़्रोज़न — रेपो README देखें |
434
+ | **[dsh-draw](https://github.com/PerryLink/dsh-draw)** | 🧊 फ़्रोज़न — रेपो README देखें |
435
+ | **[dsh-reach](https://github.com/PerryLink/dsh-reach)** | 🧊 फ़्रोज़न — रेपो README देखें |
436
+ | **[dsh-background-agents](https://github.com/PerryLink/dsh-background-agents)** | 🚫 रिटायर्ड (रेपो संग्रहीत) |
437
+ | **[dsh-session-pin](https://github.com/PerryLink/dsh-session-pin)** | 🚫 रिटायर्ड (रेपो संग्रहीत) |
438
+ | **[dsh-team-rooms](https://github.com/PerryLink/dsh-team-rooms)** | 🚫 रिटायर्ड (रेपो संग्रहीत) |
439
+
440
+ </details>
441
+
442
+ ## लाइसेंस
443
+
444
+ [LICENSE](LICENSE) (Apache License 2.0) © 2026 dsh-observe contributors
445
+
446
+ <p align="center"><sub>Apache-2.0 · सामुदायिक प्लगइन, DeepSeek से संबद्ध नहीं।</sub></p>