dsh-observe 0.2.26 → 0.2.28

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 (96) hide show
  1. package/CHANGELOG.md +10 -0
  2. package/LICENSE +0 -0
  3. package/README.en.md +446 -0
  4. package/README.es.md +446 -0
  5. package/README.hi.md +446 -0
  6. package/README.md +292 -196
  7. package/README.pt.md +446 -0
  8. package/THIRD_PARTY_NOTICES.md +0 -0
  9. package/cordis.patch.yml +6 -1
  10. package/lib/index.js +86 -38
  11. package/lib/typert.host.js +2 -4
  12. package/lib/types/backoff.d.ts +0 -0
  13. package/lib/types/backoff.d.ts.map +0 -0
  14. package/lib/types/backoff.js +0 -0
  15. package/lib/types/backoff.js.map +0 -0
  16. package/lib/types/collector.d.ts +0 -0
  17. package/lib/types/collector.d.ts.map +1 -1
  18. package/lib/types/collector.js +22 -2
  19. package/lib/types/collector.js.map +1 -1
  20. package/lib/types/config.d.ts +9 -0
  21. package/lib/types/config.d.ts.map +1 -1
  22. package/lib/types/config.js +3 -1
  23. package/lib/types/config.js.map +1 -1
  24. package/lib/types/ids.d.ts +0 -0
  25. package/lib/types/ids.d.ts.map +0 -0
  26. package/lib/types/ids.js +0 -0
  27. package/lib/types/ids.js.map +0 -0
  28. package/lib/types/index.d.ts +0 -0
  29. package/lib/types/index.d.ts.map +0 -0
  30. package/lib/types/index.js +0 -0
  31. package/lib/types/index.js.map +0 -0
  32. package/lib/types/model.d.ts +6 -0
  33. package/lib/types/model.d.ts.map +1 -1
  34. package/lib/types/model.js +0 -0
  35. package/lib/types/model.js.map +1 -1
  36. package/lib/types/pipeline.d.ts +0 -0
  37. package/lib/types/pipeline.d.ts.map +0 -0
  38. package/lib/types/pipeline.js +0 -0
  39. package/lib/types/pipeline.js.map +0 -0
  40. package/lib/types/pricing.d.ts +0 -0
  41. package/lib/types/pricing.d.ts.map +0 -0
  42. package/lib/types/pricing.js +0 -0
  43. package/lib/types/pricing.js.map +0 -0
  44. package/lib/types/project.d.ts +22 -0
  45. package/lib/types/project.d.ts.map +1 -1
  46. package/lib/types/project.js +57 -0
  47. package/lib/types/project.js.map +1 -1
  48. package/lib/types/remote.d.ts +0 -0
  49. package/lib/types/remote.d.ts.map +0 -0
  50. package/lib/types/remote.js +0 -0
  51. package/lib/types/remote.js.map +0 -0
  52. package/lib/types/sanitize.d.ts +0 -0
  53. package/lib/types/sanitize.d.ts.map +0 -0
  54. package/lib/types/sanitize.js +0 -0
  55. package/lib/types/sanitize.js.map +0 -0
  56. package/lib/types/sinks.d.ts +0 -0
  57. package/lib/types/sinks.d.ts.map +1 -1
  58. package/lib/types/sinks.js +22 -3
  59. package/lib/types/sinks.js.map +1 -1
  60. package/lib/types/spool.d.ts +0 -0
  61. package/lib/types/spool.d.ts.map +0 -0
  62. package/lib/types/spool.js +0 -0
  63. package/lib/types/spool.js.map +0 -0
  64. package/lib/types/typert.host.d.ts +0 -0
  65. package/lib/types/typert.host.d.ts.map +0 -0
  66. package/lib/types/typert.host.js +0 -0
  67. package/lib/types/typert.host.js.map +0 -0
  68. package/lib/types/version.d.ts +1 -1
  69. package/lib/types/version.d.ts.map +0 -0
  70. package/lib/types/version.js +1 -1
  71. package/lib/types/version.js.map +0 -0
  72. package/lib/types/wire.d.ts +0 -0
  73. package/lib/types/wire.d.ts.map +0 -0
  74. package/lib/types/wire.js +0 -0
  75. package/lib/types/wire.js.map +0 -0
  76. package/package.json +49 -29
  77. package/src/backoff.ts +0 -0
  78. package/src/collector.ts +26 -2
  79. package/src/config.ts +12 -1
  80. package/src/ids.ts +0 -0
  81. package/src/index.ts +0 -0
  82. package/src/model.ts +6 -0
  83. package/src/pipeline.ts +0 -0
  84. package/src/pricing.ts +0 -0
  85. package/src/project.ts +58 -0
  86. package/src/remote.ts +0 -0
  87. package/src/sanitize.ts +0 -0
  88. package/src/sinks.ts +22 -3
  89. package/src/spool.ts +0 -0
  90. package/src/typert.host.ts +0 -0
  91. package/src/version.ts +1 -1
  92. package/src/wire.ts +0 -0
  93. package/README-es.md +0 -354
  94. package/README-hi.md +0 -354
  95. package/README-pt.md +0 -354
  96. package/README-zh.md +0 -354
package/README-hi.md DELETED
@@ -1,354 +0,0 @@
1
- <div align="center">
2
-
3
- # 📊 dsh-observe
4
- - **1024 स्टोर चैनल**: एक बार `npm i -g dsh1024`, फिर `dsh1024 plugin --profile web add dsh-observe` ([deepseek1024.com](https://deepseek1024.com) इंस्टॉल रैंकिंग में गिना जाता है)।
5
-
6
- **DeepSeek Harness के लिए OpenTelemetry और Langfuse ऑब्ज़र्वेबिलिटी एक्सपोर्टर।**
7
-
8
- *सेशन इवेंट्स को OTLP traces और Langfuse observations में बदलें — सैनिटाइज़्ड, बफ़र्ड, डिफ़ॉल्ट रूप से बंद।*
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-observe)
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-observe.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-observe/ci.yml?branch=main&label=CI)](https://github.com/PerryLink/dsh-observe/actions)
17
- [![Version](https://img.shields.io/github/v/tag/PerryLink/dsh-observe?label=version)](https://github.com/PerryLink/dsh-observe/releases)
18
- [![npm version](https://img.shields.io/npm/v/dsh-observe)](https://www.npmjs.com/package/dsh-observe)
19
- [![npm downloads](https://img.shields.io/npm/dm/dsh-observe)](https://www.npmjs.com/package/dsh-observe)
20
- [![dshfind](https://dshfind.com/api/badge/PerryLink/dsh-observe?metric=downloads&lang=hi)](https://dshfind.com/hi/plugins/PerryLink/dsh-observe?ref=badge)
21
-
22
- [English](README.md) · [简体中文](README-zh.md) · [Español](README-es.md) · [Português](README-pt.md) · [हिन्दी](README-hi.md)
23
-
24
- ```sh
25
- dsh plugin --profile <name> add dsh-observe
26
- ```
27
-
28
-
29
- </div>
30
-
31
- ---
32
-
33
-
34
- **📖 इकोसिस्टम नॉलेज बेस** — मापे गए आँकड़े, मार्केटिंग नहीं: [डेवलपमेंट गाइड · चयन डेटा · रखरखाव मानदंड](https://perrylink.github.io/dsh-plugin-guide/)।
35
-
36
- <!-- star-cta -->
37
- ## Install & uninstall
38
-
39
- - **git चैनल** (नवीनतम `main`): `dsh plugin --profile web add github:PerryLink/dsh-observe` — `prepare` स्क्रिप्ट केवल प्रोडक्शन निर्भरताओं से बिल्ड करती है।
40
- - **npm चैनल** (प्रकाशित रिलीज़): `dsh plugin --profile web add dsh-observe`।
41
- - **tarball चैनल**: इस रेपो में `pnpm pack`, फिर `dsh plugin --profile web add ./dsh-observe-<version>.tgz`।
42
- - **अनइंस्टॉल**: `dsh plugin --profile web remove dsh-observe` (या प्रोफ़ाइल पैच से पंक्ति हटाएँ)।
43
-
44
- > यदि pnpm इस पैकेज के लिए `ERR_PNPM_IGNORED_BUILDS` दिखाता है (esbuild का हानिरहित प्लेटफ़ॉर्म-बाइनरी सत्यापन), तो अपने `pnpm-workspace.yaml` में `allowBuilds: { esbuild: true }` जोड़ें — `dsh` CLI सटीक स्निपेट प्रिंट करता है।
45
-
46
- ## ⭐ 如果它帮到了你
47
-
48
- यह प्लगइन [DSH प्लगइन परिवार](https://github.com/PerryLink) का हिस्सा है (95 प्लगइन, सभी Apache-2.0)। अगर यह उपयोगी लगे, तो **एक स्टार दें** — इससे कोई सुविधा अनलॉक नहीं होती, पर अगला व्यक्ति इसे खोज में आसानी से पा लेता है।
49
-
50
- *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.
51
-
52
- ## What is dsh-observe?
53
-
54
- DeepSeek Harness के लिए OpenTelemetry और Langfuse ऑब्ज़र्वेबिलिटी एक्सपोर्टर।
55
-
56
- सेशन इवेंट्स को OTLP traces और Langfuse observations में बदलें — सैनिटाइज़्ड, बफ़र्ड, डिफ़ॉल्ट रूप से बंद।
57
-
58
- ![dsh-observe कार्यप्रवाह आरेख: इंस्टॉल → पैनल खोलें → कार्य।](docs/assets/dsh-observe-flow.svg)
59
-
60
- *कार्यप्रवाह: इंस्टॉल → पैनल खोलें → कार्य। नीचे के उदाहरण वास्तविक कमांड सतह का उपयोग करते हैं।*
61
-
62
-
63
- *वही रन, एनिमेटेड।*
64
-
65
- ## Compatibility
66
-
67
- | सतह | स्थिति |
68
- |---|---|
69
- | Harness | DeepSeek Harness `dsh-v0.2.1-alpha.1` (2026-10-04 को अनुकूलित): सत्र प्रारूप V4 टूल परिणाम को प्रथम-श्रेणी `role: 'tool'` संदेश के रूप में रखता है जिसमें शीर्ष-स्तर पर `toolCallId` + `content` + वैकल्पिक `isError` होता है — V3 का `tool-result` कंटेंट ब्लॉक होस्ट के `ContentBlockMap` से हट चुका है, और यह प्लगइन केवल V4 आकार पढ़ता है (अपग्रेड-पूर्व V3 लॉग अभी भी केवल-पठन संगतता पथ से प्रोजेक्ट होता है)। सत्र प्रारूप V3 के शेष लक्षण जारी हैं: सहायक स्ट्रीम `assistant/message` / `assistant/attempt` में एम्बेड होती है और सिस्टम प्रॉम्प्ट सरफ़ेस नोड 0 (`system/message`) है; प्लगइन केवल लाइव इवेंट स्ट्रीम पढ़ता है और कभी सत्र लॉग फ़ाइलें नहीं पढ़ता। peer रेंज `>=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` हर प्रकाशित लाइन को इंस्टॉल-योग्य रखती है (स्थानीय पूर्ण गेट श्रृंखला; प्रोफ़ाइल इंस्टॉल स्मोक compat वर्कफ़्लो कवर करता है)। |
70
- | Node | `^22.19.0 \|\| >=24.0.0` |
71
- | बैकएंड | OpenTelemetry OTLP/HTTP (traces + metrics, JSON एन्कोडिंग) और Langfuse (LLM ऑब्ज़र्वेबिलिटी) — एक या दोनों |
72
- | मॉडल | मॉडल-स्वतंत्र: यह `session/event` स्ट्रीम निर्यात करता है; कोई मॉडल कॉल नहीं करता |
73
-
74
- ## What you get
75
-
76
- `dsh-observe` हार्नेस की `session/event` स्ट्रीम को मानक ऑब्ज़र्वेबिलिटी प्रोटोकॉल में बदलता है:
77
-
78
- - **Spans** — turn, step, टूल-कॉल (अवधि, स्थिति, पुनर्प्रयास व्युत्पत्ति) और LLM जनरेशन span, प्रति turn traces में जुड़े, नियतात्मक ids के साथ।
79
- - **Metrics** — प्रति provider/model टोकन काउंटर, USD लागत काउंटर (कॉन्फ़िगर करने योग्य मूल्य तालिका) और `ctx.tokenMeter` से वैकल्पिक कॉन्टेक्स्ट-प्रेशर gauge।
80
- - **सैनिटाइज़्ड कैप्चर** — prompt और completion बॉडी किसी भी कतार या भेजने से पहले रिडैक्ट (संरचनात्मक कुंजी नाम + अंतर्निहित गुप्त पैटर्न + आपके पैटर्न) और ट्रंकेट होते हैं।
81
- - **विश्वसनीयता** — असिंक्रोनस बैचिंग (आकार- और टाइमर-ट्रिगर), एक सीमित टिकाऊ ऑफ़लाइन बफ़र (storage-domain) जिसमें सबसे पुराना पहले हटता है, और नियतात्मक एक्सपोनेंशियल-बैकऑफ पुनर्प्रयास; न पहुँचे बैच रीस्टार्ट के बाद भी बचे रहते हैं।
82
- - **रनटाइम किल स्विच** — वैकल्पिक Typert remote (`observe/status`, `observe/setEnabled`) किसी सेटिंग पृष्ठ को बिना अनमाउंट किए निर्यात रोकने/फिर शुरू करने देता है।
83
- - **डिफ़ॉल्ट रूप से बंद** — `enabled: true` और कम से कम एक बैकएंड ही स्पष्ट ऑप्ट-इन है; अन्यथा कुछ भी कैप्चर या निर्यात नहीं होता।
84
-
85
- ```text
86
- session/event स्ट्रीम
87
- │ collector (turn/step/tool/llm spans, मेट्रिक्स)
88
- │ sanitize (कुंजियाँ, रहस्य, बजट)
89
- ├──▶ pipeline "otlp" ── कतार ── flush ──▶ OTLP /v1/traces + /v1/metrics
90
- │ └─ पुनर्प्रयास/बैकऑफ ─┐
91
- ├──▶ pipeline "langfuse" ── कतार ── flush ──▶ Langfuse ingestion
92
- │ └─ पुनर्प्रयास/बैकऑफ ─┤
93
- └────────── टिकाऊ spool (ऑफ़लाइन बफ़र, सीमित) ◀┘
94
- ```
95
-
96
- ## Quick start
97
-
98
- ```sh
99
- dsh plugin --profile web add github:PerryLink/dsh-observe
100
- ```
101
-
102
- ```sh
103
- # 1. बंडल को अपने प्रोफ़ाइल में इंस्टॉल करें
104
- dsh plugin --profile web add github:PerryLink/dsh-observe
105
-
106
- # या npm से (प्रकाशित रिलीज़)
107
- dsh plugin --profile web add dsh-observe
108
-
109
- # 2. अपने प्रोफ़ाइल पैच (cordis.yml) में एक बैकएंड कॉन्फ़िगर करें और पुनः आरंभ करें
110
- dsh --profile web
111
- ```
112
-
113
- न्यूनतम OTLP कॉन्फ़िगरेशन (`cordis.patch.yml` में पंक्ति कमेंट की हुई आती है):
114
-
115
- ```yaml
116
- - insert:
117
- - id: dsh-observe
118
- name: dsh-observe
119
- config:
120
- enabled: true
121
- otlp:
122
- endpoint: http://localhost:4318
123
- ```
124
-
125
- फिर सत्यापित करें कि पंक्ति माउंट हुई:
126
-
127
- ```sh
128
- dsh --profile web --dump-config | grep -A2 'id: dsh-observe'
129
- ```
130
-
131
- ### उदाहरण
132
-
133
- यह प्लगइन कोई उपयोगकर्ता-दृश्य कमांड पंजीकृत नहीं करता; यह पृष्ठभूमि निर्यातक के रूप में चलता है और सेटिंग्स से कॉन्फ़िगर होता है।
134
-
135
- ## Configuration
136
-
137
- सभी समायोजन Schemastery `Config` फ़ील्ड हैं (cordis.yml से बदले जा सकते हैं)। id-लक्षित ओवरराइड पूरी पंक्ति बदल देता है — ज़रूरत की हर कुंजी फिर से लिखें। `cordis.patch.yml` हर कुंजी को इनलाइन समझाता है।
138
-
139
- | Key | Default | Meaning |
140
- |---|---|---|
141
- | `enabled` | `false` | मास्टर स्विच; `true` और कम से कम एक बैकएंड ही स्पष्ट ऑप्ट-इन है |
142
- | `otlp` | `null` | OTLP बैकएंड कॉन्फ़िग, या इसे बंद करने के लिए `null` |
143
- | `otlp.endpoint` | *(आवश्यक)* | OTLP आधार URL; `/v1/traces` और `/v1/metrics` जोड़े जाते हैं |
144
- | `otlp.serviceName` | `deepseek-harness` | `service.name` रिसोर्स एट्रिब्यूट |
145
- | `otlp.serviceVersion` | *(कोई नहीं)* | `service.version` रिसोर्स एट्रिब्यूट |
146
- | `otlp.headers` | `{}` | हर निर्यात अनुरोध में मर्ज किए गए अतिरिक्त हेडर |
147
- | `otlp.timeoutMs` | `10000` | प्रति-अनुरोध टाइमआउट |
148
- | `langfuse` | `null` | Langfuse बैकएंड कॉन्फ़िग, या इसे बंद करने के लिए `null` |
149
- | `langfuse.baseUrl` | `https://cloud.langfuse.com` | Langfuse आधार URL |
150
- | `langfuse.publicKey` | *(आवश्यक)* | प्रोजेक्ट सार्वजनिक कुंजी |
151
- | `langfuse.secretKey` | *(आवश्यक)* | प्रोजेक्ट गुप्त कुंजी |
152
- | `langfuse.release` | *(कोई नहीं)* | traces पर मुहर लगा release टैग |
153
- | `langfuse.traceName` | `session {session} turn {turn}` | trace नाम टेम्पलेट; `{session}`/`{turn}` हर trace पर इंटरपोलेट होते हैं |
154
- | `langfuse.tags` | `[]` | हर trace पर मुहर लगे स्थिर टैग |
155
- | `langfuse.timeoutMs` | `10000` | प्रति-अनुरोध टाइमआउट |
156
- | `capture.turns` | `true` | turn जीवनचक्र spans |
157
- | `capture.steps` | `true` | step जीवनचक्र spans |
158
- | `capture.tools` | `true` | सैनिटाइज़्ड तर्कों/परिणामों के साथ टूल-कॉल spans |
159
- | `capture.llm` | `true` | LLM जनरेशन spans |
160
- | `llm.prompt` | `true` | सैनिटाइज़्ड अनुरोध prompt कैप्चर करें (`false` = केवल आकार) |
161
- | `llm.completion` | `true` | सैनिटाइज़्ड completion कैप्चर करें (`false` = केवल आकार) |
162
- | `metadata.sessionId` | `true` | सत्र id एट्रिब्यूट |
163
- | `metadata.cwd` | `false` | सत्र कार्य निर्देशिका (स्थानीय पथ — डिफ़ॉल्ट रूप से बंद) |
164
- | `metadata.agentPreset` | `true` | agent preset id एट्रिब्यूट |
165
- | `metadata.model` | `true` | provider/model एट्रिब्यूट |
166
- | `metrics.tokens` | `true` | प्रति provider/model टोकन काउंटर |
167
- | `metrics.cost` | `true` | USD लागत काउंटर (मिलान के लिए `pricing` नियम चाहिए) |
168
- | `metrics.contextTokens` | `true` | कॉन्टेक्स्ट-प्रेशर gauge (`ctx.tokenMeter` चाहिए) |
169
- | `pricing` | `[]` | मूल्य तालिका, पहला मिलान जीतता है: `{ provider?, model, inputPerToken, outputPerToken, cacheReadPerToken?, cacheWritePerToken? }` |
170
- | `sanitize.enabled` | `true` | रिडैक्शन मास्टर स्विच (`false` केवल रिडैक्शन बंद करता है, ट्रंकेशन कभी नहीं) |
171
- | `sanitize.redactKeys` | `[]` | अतिरिक्त कुंजी-नाम सबस्ट्रिंग (key/token/secret/password/authorization/credential/apiKey हमेशा शामिल) |
172
- | `sanitize.redactPatterns` | `[]` | अतिरिक्त गुप्त नियमित अभिव्यक्तियाँ |
173
- | `sanitize.truncatePromptChars` | `4000` | prompt वर्ण बजट |
174
- | `sanitize.truncateCompletionChars` | `4000` | completion वर्ण बजट |
175
- | `sanitize.truncateToolInputChars` | `2000` | टूल तर्क वर्ण बजट |
176
- | `sanitize.truncateToolOutputChars` | `2000` | टूल परिणाम वर्ण बजट |
177
- | `sanitize.truncateAttributeChars` | `512` | span एट्रिब्यूट स्ट्रिंग बजट |
178
- | `batch.maxRecords` | `256` | कतार में इतने रिकॉर्ड होते ही flush |
179
- | `batch.flushIntervalMs` | `5000` | टाइमर flush अंतराल |
180
- | `batch.maxQueueRecords` | `2000` | इन-मेमोरी कतार सीमा; अतिरिक्त बफ़र में जाता है |
181
- | `batch.maxBufferRecords` | `10000` | टिकाऊ ऑफ़लाइन बफ़र सीमा; सबसे पुराने रिकॉर्ड पहले गिरते हैं |
182
- | `batch.bufferRetryIntervalMs` | `30000` | ऑफ़लाइन बफ़र पुनर्प्रयास अंतराल |
183
- | `retry.maxAttempts` | `5` | प्रति बैच प्रयास, पहली कोशिश सहित |
184
- | `retry.baseDelayMs` | `1000` | पहला बैकऑफ विलंब |
185
- | `retry.factor` | `2` | प्रति लगातार विफलता बैकऑफ गुणक |
186
- | `retry.maxDelayMs` | `60000` | बैकऑफ सीमा |
187
- | `remote.enabled` | `false` | `observe` Typert remote माउंट करें (किल स्विच) |
188
-
189
- ## Tools & surfaces
190
-
191
- यह प्लगइन **कोई मॉडल टूल पंजीकृत नहीं करता** — यह एक पृष्ठभूमि निर्यातक है। इसकी सतहें:
192
-
193
- - **उपभोग करता है** `session/event` (span/metric संग्रह), `session/flush` (बेस्ट-एफ़र्ट निर्यात किक — टिकाऊपन चेकपॉइंट कभी दूरस्थ बैकएंड का इंतज़ार नहीं करता) और `session/disposed`।
194
- - **वैकल्पिक remote सेवा** `observe` — `observe/status` किल-स्विच स्थिति, कॉन्फ़िगर किए बैकएंड, कतार गहराई और बफ़र अधिभोग लौटाता है; `observe/setEnabled` रनटाइम पर निर्यात रोकता/फिर शुरू करता है।
195
-
196
- ## Permissions & data
197
-
198
- - **अनुमतियाँ**: आपके कॉन्फ़िगर किए एंडपॉइंट तक `network:outbound`, इवेंट स्ट्रीम के लिए `session:read`, ऑफ़लाइन बफ़र के लिए `storage:write`; कोई नेटिव कोड नहीं, कोई फ़ाइल-सिस्टम पहुँच नहीं।
199
- - **डेटा**: भेजी गई हर चीज़ सत्र लॉग से निकलती है और कतारबद्ध, बफ़र या प्रेषित होने से पहले सैनिटाइज़ होती है (रिडैक्शन + ट्रंकेशन)। ऑफ़लाइन बफ़र केवल सैनिटाइज़्ड रिकॉर्ड रखता है, जो पढ़े जाने पर फिर से सत्यापित होते हैं।
200
- - **क्रेडेंशियल**: Langfuse सार्वजनिक/गुप्त कुंजियाँ केवल कॉन्फ़िगर किए Langfuse एंडपॉइंट तक जाती हैं; OTLP हेडर केवल कॉन्फ़िगर किए OTLP एंडपॉइंट तक। प्लगइन स्वयं कोई क्रेडेंशियल नहीं रखता — उन्हें क्रेडेंशियल संदर्भों या पर्यावरण-इंजेक्ट मानों में रखें।
201
-
202
- ## Security boundaries
203
-
204
- - **डिफ़ॉल्ट रूप से बंद** — स्पष्ट ऑप्ट-इन के बिना कुछ भी कैप्चर या निर्यात नहीं होता।
205
- - **भेजने से पहले सैनिटाइज़** — संरचनात्मक कुंजी रिडैक्शन, अंतर्निहित गुप्त पैटर्न (API कुंजियाँ, GitHub टोकन, AWS कुंजियाँ, bearer क्रेडेंशियल, निजी कुंजियाँ), आपके पैटर्न और वर्ण बजट सभी किसी भी रिकॉर्ड के मेमोरी छोड़ने से पहले लागू होते हैं।
206
- - **टिकाऊ सीमा पर पुनः सत्यापन** — स्टोरेज से पढ़े रिकॉर्ड किसी sink के देखने से पहले फिर जाँचे जाते हैं।
207
- - **विफलता ज़ोर से, विफलता सीमित** — निर्यात विफलताएँ चेतावनी देती हैं, गिनती करती हैं, पुनर्प्रयास करती हैं और अंत में spool में जाती हैं; विफल सत्र हैंडलर पकड़ा और लॉग होता है, इसलिए ऑब्ज़र्वेबिलिटी कभी हार्नेस का हॉट पाथ नहीं तोड़ सकती।
208
- - **Model-visible ⟺ logged** — prompt/completion निर्यात केवल सत्र सरफ़ेस (जिसका नोड 0 सिस्टम प्रॉम्प्ट है) और लॉग किए हेडर (कॉल कॉन्फ़िग और टूल्स) को प्रोजेक्ट करते हैं; निर्यातक कोई सामग्री नहीं गढ़ता।
209
-
210
- ## Known limitations
211
-
212
- - **npm 0.1.7-rc.2** — प्लगइन `@deepseek-ai/dsh@0.1.7-rc.2` के विरुद्ध विकसित और परीक्षित है (devDeps और CI की मुख्य रूलर); peer रेंज `>=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` हर प्रकाशित लाइन को इंस्टॉल-योग्य रखती है, और दूसरी रूलर (`typecheck:ci`) तथा compat वर्कफ़्लो पुराने बेसलाइन कवर करते हैं।
213
- - **ऑडिट इवेंट्स संग्रहीत नहीं होते** — एक्सपोर्टर के स्वयं के `observe/*` रिकॉर्ड केवल ऑडिट के लिए हैं: वर्तमान होस्ट लाइन पर सत्र append गेट केवल सरफ़ेस इवेंट स्वीकार करता है, इसलिए कोई `observe/*` इवेंट सत्र लॉग में नहीं लिखा जाता, और प्लगइन बिना मार्क के append से इसे नकली नहीं बनाता (इससे सत्र अपठनीय हो जाते)। ऑडिट सतह के लिए `/observe` स्टेटस आउटपुट और OTLP/Langfuse बैकएंड देखें।
214
- - **मेट्रिक्स पुनर्प्रयास/spool पथ से बचती हैं** — OTLP मेट्रिक्स संचयी रूप से एकत्र होती हैं, इसलिए खोया flush अगले में स्वयं-सुधर जाता है (डिज़ाइन से, बग नहीं)।
215
- - **कोई सैंपलिंग नहीं** — हर सक्षम span परिवार निर्यात होता है; उच्च-मात्रा सत्रों के लिए `capture.*` स्विच और `batch.maxBufferRecords` समायोजित करें।
216
-
217
- ## Development
218
-
219
- ```sh
220
- pnpm install # node ^22.19 || >=24
221
- pnpm run typecheck # tsc: src + tests 0.1.7-rc.2 devDeps के विरुद्ध (कोई tsconfig paths नहीं)
222
- pnpm run typecheck:ci # tsc प्रकाशित लाइन के विरुद्ध (बिना paths)
223
- pnpm run check:ruler-live # कैनरी: कंपाइल विफल होना चाहिए, यह सिद्ध करते हुए कि रूलर जीवित है
224
- pnpm test # vitest: 126 टेस्ट, 18 सुइट (वास्तविक Context/Session/storage seam)
225
- pnpm run test:coverage # कवरेज द्वार (90/80/90/90)
226
- pnpm run build # tsdown बंडल + tsc घोषणाएँ (lib/)
227
- pnpm run verify:self-contained # निर्भरता स्पेक registry से हल होती हैं
228
- pnpm run verify:artifacts # निर्मित ESM फ़ेस + बंडल पैच मौजूद
229
- node scripts/check-readme-sync.mjs # पाँच-भाषा README समन्वय द्वार
230
- pnpm pack # प्रकाशित tarball
231
- ```
232
-
233
- ## Topics
234
-
235
- `dsh`, `dsh-plugin`, `deepseek-harness`, `deepseek`, `cordis`, `observability`, `opentelemetry`, `otlp`, `langfuse`, `tracing`
236
-
237
- ## Contributors
238
-
239
- - [@PerryLink](https://github.com/PerryLink) — निर्माता और मेंटेनर: collector, pipelines, spool, OTLP/Langfuse sinks, सैनिटाइज़ेशन और पाँच-भाषा दस्तावेज़।
240
-
241
- ## PerryLink DSH Plugin Family
242
-
243
- यह प्रोजेक्ट [PerryLink](https://github.com/PerryLink) के DeepSeek Harness प्लगइन परिवार का हिस्सा है। पूरी सूची नीचे संक्षिप्त रखी गई है ताकि हर README की पहली स्क्रीन छोटी रहे; हर पंक्ति और उसकी स्थिति देखने के लिए इसे खोलें।
244
-
245
- <details>
246
- <summary>सभी प्लगइन खोलें</summary>
247
-
248
- | प्लगइन | स्थिति |
249
- |---|---|
250
- | **[dsh-aqua-input-check](https://github.com/PerryLink/dsh-aqua-input-check)** | |
251
- | **[dsh-archive-check](https://github.com/PerryLink/dsh-archive-check)** | |
252
- | **[dsh-auto-review](https://github.com/PerryLink/dsh-auto-review)** | |
253
- | **[dsh-autotier](https://github.com/PerryLink/dsh-autotier)** | |
254
- | **[dsh-bid-ca-precheck](https://github.com/PerryLink/dsh-bid-ca-precheck)** | |
255
- | **[dsh-bid-qual-check](https://github.com/PerryLink/dsh-bid-qual-check)** | |
256
- | **[dsh-cert-mcp](https://github.com/PerryLink/dsh-cert-mcp)** | |
257
- | **[dsh-checkpoint-rewind](https://github.com/PerryLink/dsh-checkpoint-rewind)** | |
258
- | **[dsh-click](https://github.com/PerryLink/dsh-click)** | |
259
- | **[dsh-composer-history](https://github.com/PerryLink/dsh-composer-history)** | |
260
- | **[dsh-contract-stance](https://github.com/PerryLink/dsh-contract-stance)** | |
261
- | **[dsh-customs-doc-check](https://github.com/PerryLink/dsh-customs-doc-check)** | |
262
- | **[dsh-data-quality](https://github.com/PerryLink/dsh-data-quality)** | |
263
- | **[dsh-demurrage-ledger](https://github.com/PerryLink/dsh-demurrage-ledger)** | |
264
- | **[dsh-doublecheck](https://github.com/PerryLink/dsh-doublecheck)** | |
265
- | **[dsh-drill-script-check](https://github.com/PerryLink/dsh-drill-script-check)** | |
266
- | **[dsh-eia-guide-check](https://github.com/PerryLink/dsh-eia-guide-check)** | |
267
- | **[dsh-emergency-plan](https://github.com/PerryLink/dsh-emergency-plan)** | |
268
- | **[dsh-essay-rubric-check](https://github.com/PerryLink/dsh-essay-rubric-check)** | |
269
- | **[dsh-evidence-check](https://github.com/PerryLink/dsh-evidence-check)** | |
270
- | **[dsh-export-ctl-check](https://github.com/PerryLink/dsh-export-ctl-check)** | |
271
- | **[dsh-fast](https://github.com/PerryLink/dsh-fast)** | |
272
- | **[dsh-fmea-table-check](https://github.com/PerryLink/dsh-fmea-table-check)** | |
273
- | **[dsh-forecast-penalty](https://github.com/PerryLink/dsh-forecast-penalty)** | |
274
- | **[dsh-fund-research](https://github.com/PerryLink/dsh-fund-research)** | |
275
- | **[dsh-github](https://github.com/PerryLink/dsh-github)** | |
276
- | **[dsh-gongwen-flow-check](https://github.com/PerryLink/dsh-gongwen-flow-check)** | |
277
- | **[dsh-gongwen-word-check](https://github.com/PerryLink/dsh-gongwen-word-check)** | |
278
- | **[dsh-guard-plan-qc](https://github.com/PerryLink/dsh-guard-plan-qc)** | |
279
- | **[dsh-hazchem-check](https://github.com/PerryLink/dsh-hazchem-check)** | |
280
- | **[dsh-hazplan-check](https://github.com/PerryLink/dsh-hazplan-check)** | |
281
- | **[dsh-hidden-risk-map](https://github.com/PerryLink/dsh-hidden-risk-map)** | |
282
- | **[dsh-hs-classify](https://github.com/PerryLink/dsh-hs-classify)** | |
283
- | **[dsh-icd-rule-check](https://github.com/PerryLink/dsh-icd-rule-check)** | |
284
- | **[dsh-industry-research](https://github.com/PerryLink/dsh-industry-research)** | |
285
- | **[dsh-lawcite-adapter](https://github.com/PerryLink/dsh-lawcite-adapter)** | |
286
- | **[dsh-laya](https://github.com/PerryLink/dsh-laya)** | |
287
- | **[dsh-lc-doc-check](https://github.com/PerryLink/dsh-lc-doc-check)** | |
288
- | **[dsh-learning-gap-check](https://github.com/PerryLink/dsh-learning-gap-check)** | |
289
- | **[dsh-library](https://github.com/PerryLink/dsh-library)** | |
290
- | **[dsh-local-ai](https://github.com/PerryLink/dsh-local-ai)** | |
291
- | **[dsh-lsp-actions](https://github.com/PerryLink/dsh-lsp-actions)** | |
292
- | **[dsh-mask](https://github.com/PerryLink/dsh-mask)** | |
293
- | **[dsh-mcp-panel](https://github.com/PerryLink/dsh-mcp-panel)** | |
294
- | **[dsh-medrec-qc](https://github.com/PerryLink/dsh-medrec-qc)** | |
295
- | **[dsh-memento](https://github.com/PerryLink/dsh-memento)** | |
296
- | **[dsh-nsfc-form-check](https://github.com/PerryLink/dsh-nsfc-form-check)** | |
297
- | **[dsh-nurse-record-check](https://github.com/PerryLink/dsh-nurse-record-check)** | |
298
- | **[dsh-observe](https://github.com/PerryLink/dsh-observe)** | |
299
- | **[dsh-origin-rvc-check](https://github.com/PerryLink/dsh-origin-rvc-check)** | |
300
- | **[dsh-ota-review-check](https://github.com/PerryLink/dsh-ota-review-check)** | |
301
- | **[dsh-output-styles](https://github.com/PerryLink/dsh-output-styles)** | |
302
- | **[dsh-paper-doc-adapter](https://github.com/PerryLink/dsh-paper-doc-adapter)** | |
303
- | **[dsh-permission-rules](https://github.com/PerryLink/dsh-permission-rules)** | |
304
- | **[dsh-permit-report-check](https://github.com/PerryLink/dsh-permit-report-check)** | |
305
- | **[dsh-pipeline-check](https://github.com/PerryLink/dsh-pipeline-check)** | |
306
- | **[dsh-pleading-draft](https://github.com/PerryLink/dsh-pleading-draft)** | |
307
- | **[dsh-plugin-doctor](https://github.com/PerryLink/dsh-plugin-doctor)** | |
308
- | **[dsh-plugin-guide](https://github.com/PerryLink/dsh-plugin-guide)** | |
309
- | **[dsh-plugin-kit](https://github.com/PerryLink/dsh-plugin-kit)** | |
310
- | **[dsh-plugin-upgrade](https://github.com/PerryLink/dsh-plugin-upgrade)** | |
311
- | **[dsh-policy-brief-draft](https://github.com/PerryLink/dsh-policy-brief-draft)** | |
312
- | **[dsh-power-loss-split](https://github.com/PerryLink/dsh-power-loss-split)** | |
313
- | **[dsh-power-ticket-check](https://github.com/PerryLink/dsh-power-ticket-check)** | |
314
- | **[dsh-ppap-check](https://github.com/PerryLink/dsh-ppap-check)** | |
315
- | **[dsh-protest-deadline](https://github.com/PerryLink/dsh-protest-deadline)** | |
316
- | **[dsh-railway-window](https://github.com/PerryLink/dsh-railway-window)** | |
317
- | **[dsh-repair-order-qc](https://github.com/PerryLink/dsh-repair-order-qc)** | |
318
- | **[dsh-research-report](https://github.com/PerryLink/dsh-research-report)** | |
319
- | **[dsh-review-reply-check](https://github.com/PerryLink/dsh-review-reply-check)** | |
320
- | **[dsh-rulefile-check](https://github.com/PerryLink/dsh-rulefile-check)** | |
321
- | **[dsh-safety-brief-check](https://github.com/PerryLink/dsh-safety-brief-check)** | |
322
- | **[dsh-score](https://github.com/PerryLink/dsh-score)** | |
323
- | **[dsh-session-sync](https://github.com/PerryLink/dsh-session-sync)** | |
324
- | **[dsh-site-log-check](https://github.com/PerryLink/dsh-site-log-check)** | |
325
- | **[dsh-skill-pack-security](https://github.com/PerryLink/dsh-skill-pack-security)** | |
326
- | **[dsh-soe-decision-check](https://github.com/PerryLink/dsh-soe-decision-check)** | |
327
- | **[dsh-soilwater-check](https://github.com/PerryLink/dsh-soilwater-check)** | |
328
- | **[dsh-sop-sync-check](https://github.com/PerryLink/dsh-sop-sync-check)** | |
329
- | **[dsh-spc-gbt-adapter](https://github.com/PerryLink/dsh-spc-gbt-adapter)** | |
330
- | **[dsh-talk](https://github.com/PerryLink/dsh-talk)** | |
331
- | **[dsh-tender-extract](https://github.com/PerryLink/dsh-tender-extract)** | |
332
- | **[dsh-tender-matrix](https://github.com/PerryLink/dsh-tender-matrix)** | |
333
- | **[dsh-test-drive](https://github.com/PerryLink/dsh-test-drive)** | |
334
- | **[dsh-ticktick](https://github.com/PerryLink/dsh-ticktick)** | |
335
- | **[dsh-translate](https://github.com/PerryLink/dsh-translate)** | |
336
- | **[dsh-warranty-calc](https://github.com/PerryLink/dsh-warranty-calc)** | |
337
- | **[dsh-budget](https://github.com/PerryLink/dsh-budget)** | 🧊 फ़्रोज़न — रिपॉज़िटरी README देखें |
338
- | **[dsh-claude-move](https://github.com/PerryLink/dsh-claude-move)** | 🧊 फ़्रोज़न — रिपॉज़िटरी README देखें |
339
- | **[dsh-defend](https://github.com/PerryLink/dsh-defend)** | 🧊 फ़्रोज़न — रिपॉज़िटरी README देखें |
340
- | **[dsh-draw](https://github.com/PerryLink/dsh-draw)** | 🧊 फ़्रोज़न — रिपॉज़िटरी README देखें |
341
- | **[dsh-reach](https://github.com/PerryLink/dsh-reach)** | 🧊 फ़्रोज़न — रिपॉज़िटरी README देखें |
342
- | **[dsh-background-agents](https://github.com/PerryLink/dsh-background-agents)** | 🚫 सेवानिवृत्त — रिपॉज़िटरी README देखें |
343
- | **[dsh-session-pin](https://github.com/PerryLink/dsh-session-pin)** | 🚫 सेवानिवृत्त — रिपॉज़िटरी README देखें |
344
- | **[dsh-team-rooms](https://github.com/PerryLink/dsh-team-rooms)** | 🚫 सेवानिवृत्त — रिपॉज़िटरी README देखें |
345
-
346
- </details>
347
-
348
- ## License
349
-
350
- [Apache License 2.0](LICENSE) © 2026 dsh-observe contributors
351
-
352
- ### DSH Desktop मार्केट से इंस्टॉल करें
353
-
354
- सभी PerryLink प्लगइन DSH Desktop के बिल्ट-इन मार्केट में देखे जा सकते हैं: **Market → Sources → add source → पेस्ट करें** `https://perrylink-dsh-catalog.perrylink.workers.dev/catalog-source.json` **→ चुनें**। इंस्टॉलेशन मार्केट के npm-identity सत्यापन और आपकी पुष्टि से ही होता है।