dsh-lsp-actions 0.5.19 → 0.5.21

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 (143) hide show
  1. package/CHANGELOG.md +9 -0
  2. package/LICENSE +0 -0
  3. package/PRIVACY.md +0 -0
  4. package/README.en.md +520 -0
  5. package/README.es.md +520 -0
  6. package/README.hi.md +520 -0
  7. package/README.md +313 -235
  8. package/README.pt.md +520 -0
  9. package/cordis.patch.yml +0 -0
  10. package/docs/assets/dsh-lsp-actions-demo.gif +0 -0
  11. package/docs/assets/dsh-lsp-actions-demo.png +0 -0
  12. package/docs/assets/dsh-lsp-actions-flow-dark.svg +35 -0
  13. package/docs/assets/dsh-lsp-actions-flow-light.svg +35 -0
  14. package/docs/assets/dsh-lsp-actions-flow-v5-dark.svg +136 -0
  15. package/docs/assets/dsh-lsp-actions-flow-v5-light.svg +136 -0
  16. package/docs/assets/dsh-lsp-actions-flow.svg +0 -0
  17. package/docs/assets/dsh-lsp-actions-hero-en-dark.webp +0 -0
  18. package/docs/assets/dsh-lsp-actions-hero-en-light.webp +0 -0
  19. package/docs/assets/dsh-lsp-actions-hero-zh-dark.webp +0 -0
  20. package/docs/assets/dsh-lsp-actions-hero-zh-light.webp +0 -0
  21. package/docs/assets/dsh-lsp-actions-hero.png +0 -0
  22. package/docs/editor-protocol.md +0 -0
  23. package/docs/editor-protocol.zh-CN.md +0 -0
  24. package/docs/seam-extension-notes.md +0 -0
  25. package/examples/vscode/README.md +0 -0
  26. package/examples/vscode/README.zh-CN.md +0 -0
  27. package/examples/vscode/backend/bin.mjs +0 -0
  28. package/examples/vscode/backend/cordis.yml +0 -0
  29. package/examples/vscode/backend/package.json +0 -0
  30. package/examples/vscode/extension/package.json +0 -0
  31. package/examples/vscode/extension/src/client.js +0 -0
  32. package/examples/vscode/extension/src/extension.js +0 -0
  33. package/examples/vscode/extension/src/views.js +0 -0
  34. package/icon.svg +0 -0
  35. package/lib/abort.d.ts +0 -0
  36. package/lib/abort.d.ts.map +0 -0
  37. package/lib/abort.js +0 -0
  38. package/lib/abort.js.map +0 -0
  39. package/lib/call-id.d.ts +0 -0
  40. package/lib/call-id.d.ts.map +0 -0
  41. package/lib/call-id.js +0 -0
  42. package/lib/call-id.js.map +0 -0
  43. package/lib/client.d.ts +0 -0
  44. package/lib/client.d.ts.map +0 -0
  45. package/lib/client.js +0 -0
  46. package/lib/client.js.map +0 -0
  47. package/lib/connection.d.ts +0 -0
  48. package/lib/connection.d.ts.map +0 -0
  49. package/lib/connection.js +0 -0
  50. package/lib/connection.js.map +0 -0
  51. package/lib/editor/actions.d.ts +0 -0
  52. package/lib/editor/actions.d.ts.map +0 -0
  53. package/lib/editor/actions.js +0 -0
  54. package/lib/editor/actions.js.map +0 -0
  55. package/lib/editor/cache.d.ts +0 -0
  56. package/lib/editor/cache.d.ts.map +0 -0
  57. package/lib/editor/cache.js +0 -0
  58. package/lib/editor/cache.js.map +0 -0
  59. package/lib/editor/server.d.ts +0 -0
  60. package/lib/editor/server.d.ts.map +0 -0
  61. package/lib/editor/server.js +0 -0
  62. package/lib/editor/server.js.map +0 -0
  63. package/lib/editor/service.d.ts +0 -0
  64. package/lib/editor/service.d.ts.map +0 -0
  65. package/lib/editor/service.js +0 -0
  66. package/lib/editor/service.js.map +0 -0
  67. package/lib/editor/transport.d.ts +0 -0
  68. package/lib/editor/transport.d.ts.map +0 -0
  69. package/lib/editor/transport.js +0 -0
  70. package/lib/editor/transport.js.map +0 -0
  71. package/lib/editor/types.d.ts +0 -0
  72. package/lib/editor/types.d.ts.map +0 -0
  73. package/lib/editor/types.js +0 -0
  74. package/lib/editor/types.js.map +0 -0
  75. package/lib/edits.d.ts +0 -0
  76. package/lib/edits.d.ts.map +0 -0
  77. package/lib/edits.js +0 -0
  78. package/lib/edits.js.map +0 -0
  79. package/lib/extension.d.ts +0 -0
  80. package/lib/extension.d.ts.map +0 -0
  81. package/lib/extension.js +0 -0
  82. package/lib/extension.js.map +0 -0
  83. package/lib/extra-tools.d.ts +0 -0
  84. package/lib/extra-tools.d.ts.map +0 -0
  85. package/lib/extra-tools.js +0 -0
  86. package/lib/extra-tools.js.map +0 -0
  87. package/lib/framing.d.ts +0 -0
  88. package/lib/framing.d.ts.map +0 -0
  89. package/lib/framing.js +0 -0
  90. package/lib/framing.js.map +0 -0
  91. package/lib/host.d.ts +0 -0
  92. package/lib/host.d.ts.map +0 -0
  93. package/lib/host.js +0 -0
  94. package/lib/host.js.map +0 -0
  95. package/lib/index.d.ts +0 -0
  96. package/lib/index.d.ts.map +0 -0
  97. package/lib/index.js +0 -0
  98. package/lib/index.js.map +0 -0
  99. package/lib/project.d.ts +0 -0
  100. package/lib/project.d.ts.map +0 -0
  101. package/lib/project.js +0 -0
  102. package/lib/project.js.map +0 -0
  103. package/lib/render.d.ts +0 -0
  104. package/lib/render.d.ts.map +0 -0
  105. package/lib/render.js +0 -0
  106. package/lib/render.js.map +0 -0
  107. package/lib/runner.d.ts +0 -0
  108. package/lib/runner.d.ts.map +0 -0
  109. package/lib/runner.js +0 -0
  110. package/lib/runner.js.map +0 -0
  111. package/lib/sandbox.d.ts +0 -0
  112. package/lib/sandbox.d.ts.map +0 -0
  113. package/lib/sandbox.js +0 -0
  114. package/lib/sandbox.js.map +0 -0
  115. package/lib/seam.d.ts +0 -0
  116. package/lib/seam.d.ts.map +0 -0
  117. package/lib/seam.js +0 -0
  118. package/lib/seam.js.map +0 -0
  119. package/lib/servers.d.ts +0 -0
  120. package/lib/servers.d.ts.map +0 -0
  121. package/lib/servers.js +0 -0
  122. package/lib/servers.js.map +0 -0
  123. package/lib/session-cwd.d.ts +0 -0
  124. package/lib/session-cwd.d.ts.map +0 -0
  125. package/lib/session-cwd.js +0 -0
  126. package/lib/session-cwd.js.map +0 -0
  127. package/lib/tools.d.ts +0 -0
  128. package/lib/tools.d.ts.map +0 -0
  129. package/lib/tools.js +0 -0
  130. package/lib/tools.js.map +0 -0
  131. package/lib/translate.d.ts +0 -0
  132. package/lib/translate.d.ts.map +0 -0
  133. package/lib/translate.js +0 -0
  134. package/lib/translate.js.map +0 -0
  135. package/lib/vocabulary.d.ts +0 -0
  136. package/lib/vocabulary.d.ts.map +0 -0
  137. package/lib/vocabulary.js +0 -0
  138. package/lib/vocabulary.js.map +0 -0
  139. package/package.json +35 -20
  140. package/README-es.md +0 -445
  141. package/README-hi.md +0 -445
  142. package/README-pt.md +0 -445
  143. package/README-zh.md +0 -445
package/README.hi.md ADDED
@@ -0,0 +1,520 @@
1
+ <div align="center">
2
+
3
+ <picture>
4
+ <source media="(prefers-color-scheme: dark)" srcset="docs/assets/dsh-lsp-actions-hero-en-dark.webp">
5
+ <img src="docs/assets/dsh-lsp-actions-hero-en-light.webp" width="100%" alt="dsh-lsp-actions: आठ टूल और एडिटर प्रोटोकॉल एक ही ActionRunner साझा करते हैं; हर क्रिया वास्तविक भाषा-सर्वर विधि से जुड़ी है, छह केवल-पढ़ने और दो लिखने वाली">
6
+ </picture>
7
+
8
+ # dsh-lsp-actions
9
+
10
+ **अपने एजेंट को असली लैंग्वेज सर्वर पर कोड लिखने और ठीक करने दें — डायग्नोस्टिक्स, फ़ॉर्मेटिंग, कम्प्लीशन, कोड एक्शन, सिंबल, सिग्नेचर हेल्प, इनले हिंट और रीनेम, सब एक ही एक्शन सतह पर।**
11
+
12
+ DeepSeek Harness के लिए LSP एक्शन सतह: आधिकारिक `ctx.lsp` seam नेविगेशन संभालता है, यह प्लगइन एक्शन लूप पूरा करता है, और स्थिर एडिटर एक्शन प्रोटोकॉल (`lsp.actions.*`) की बदौलत VS Code जैसे एडिटर इसे सीधे अपना IDE बैकएंड बना सकते हैं।
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-lsp-actions?style=flat-square&labelColor=2B3245&color=CB3837)](https://www.npmjs.com/package/dsh-lsp-actions)
19
+ [![CI](https://img.shields.io/github/actions/workflow/status/PerryLink/dsh-lsp-actions/ci.yml?branch=main&label=CI&style=flat-square&labelColor=2B3245)](https://github.com/PerryLink/dsh-lsp-actions/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-lsp-actions?style=flat-square&labelColor=2B3245)](https://github.com/PerryLink/dsh-lsp-actions/stargazers)
23
+ [![npm downloads](https://img.shields.io/npm/dm/dsh-lsp-actions?style=flat-square&labelColor=2B3245&color=CB3837)](https://www.npmjs.com/package/dsh-lsp-actions)
24
+ [![dshfind](https://dshfind.com/api/badge/PerryLink/dsh-lsp-actions?metric=downloads)](https://dshfind.com/plugins/PerryLink/dsh-lsp-actions?ref=badge)
25
+ [![OpenSSF Scorecard](https://api.securityscorecards.dev/projects/github.com/PerryLink/dsh-lsp-actions/badge)](https://securityscorecards.dev/viewer/?uri=github.com/PerryLink/dsh-lsp-actions)
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-lsp-actions)
28
+
29
+ ```sh
30
+ dsh plugin --profile <name> add dsh-lsp-actions
31
+ ```
32
+
33
+ </div>
34
+
35
+ <sub>समुदाय प्लगइन, DeepSeek से संबद्ध नहीं। आधिकारिक रेपो: <https://github.com/PerryLink/dsh-lsp-actions> (Gitee एक मिरर है)।</sub>
36
+
37
+ ## यह क्या है
38
+
39
+ `dsh-lsp-actions` उस फ़ीडबैक लूप को असली लैंग्वेज सर्वर से जोड़ता है जो एजेंट को कोड लिखते और सुधारते समय चाहिए: डायग्नोस्टिक्स, फ़ॉर्मेटिंग, कम्प्लीशन, कोड एक्शन, सिंबल, सिग्नेचर हेल्प, इनले हिंट और रीनेम — सब वही सर्वर उत्तर देते हैं जो आपका IDE इस्तेमाल करता है (`typescript-language-server`, gopls, pyright, rust-analyzer…)। आधिकारिक `ctx.lsp` seam केवल नेविगेशन (go-to-definition, references, implementation, hover) कवर करता है; यह प्लगइन एक्शन सतह पूरी करता है और उसे स्थिर एडिटर एक्शन प्रोटोकॉल (`lsp.actions.*`) के रूप में पैक करता है, ताकि VS Code जैसे एडिटर बिना खुद LSP लागू किए इन क्षमताओं का उपभोग कर सकें। यह एक ही host पंक्ति के रूप में माउंट होता है (`id: lsp-actions`, `inject: [tools, fs, subprocess]`), सर्वर प्रोसेस को ज़रूरत पर लेज़ी तरीके से शुरू करता है, और हर लेखन को आधिकारिक `fs/write-intent` waterfall तथा sandbox स्वीकृति से गुज़ारता है।
40
+
41
+ <picture>
42
+ <source media="(prefers-color-scheme: dark)" srcset="docs/assets/dsh-lsp-actions-flow-v5-dark.svg">
43
+ <img src="docs/assets/dsh-lsp-actions-flow-v5-light.svg" width="100%" alt="dsh-lsp-actions संरचना: अनुरोध-उत्तर का चक्र; टूल और एडिटर प्रोटोकॉल ActionRunner में मिलते हैं, जो पहले ctx.lsp seam चुनता है और उपलब्ध न होने पर servers रूट व अंतर्निहित stdio क्लाइंट पर लौटता है; उत्तर सामान्यीकृत और सीमित होकर लौटता है, और केवल फ़ॉर्मैटिंग व रीनेम लेखन वाल्व से गुजरते हैं">
44
+ </picture>
45
+
46
+ ## तीन चरणों में शुरुआत
47
+
48
+ 1. **इंस्टॉल करें** (तीन में से एक चैनल):
49
+
50
+ ```sh
51
+ # git चैनल (नवीनतम main; prepare स्क्रिप्ट tsc से lib/ बनाती है)
52
+ dsh plugin --profile web add github:PerryLink/dsh-lsp-actions
53
+ # npm चैनल (प्रकाशित संस्करण)
54
+ dsh plugin --profile web add dsh-lsp-actions
55
+ # tarball चैनल: इस रेपो में pnpm pack के बाद
56
+ dsh plugin --profile web add ./dsh-lsp-actions-<version>.tgz
57
+ ```
58
+
59
+ 2. **न्यूनतम कॉन्फ़िग** (डिफ़ॉल्ट `servers: {}` कोई सर्वर सक्रिय नहीं करता; कम से कम एक एंट्री जोड़ें):
60
+
61
+ ```yaml
62
+ - insert:
63
+ - id: lsp-actions
64
+ name: dsh-lsp-actions
65
+ config:
66
+ servers:
67
+ typescript:
68
+ command: typescript-language-server
69
+ args: ["--stdio"]
70
+ extensionToLanguage: { ".ts": typescript, ".tsx": typescriptreact }
71
+ projectMarkers: ["package.json", "tsconfig.json"]
72
+ ```
73
+
74
+ 3. **जाँचें कि माउंट हुआ**:
75
+
76
+ ```sh
77
+ dsh --profile web --dump-config | grep -A3 'id: lsp-actions'
78
+ ```
79
+
80
+ ```text
81
+ > lsp_diagnostics a.ts
82
+ a.ts:1:3 [Error] boom [ts 2304]
83
+ ```
84
+
85
+ **अनइंस्टॉल**: `dsh plugin --profile web remove dsh-lsp-actions` (या profile patch से वह पंक्ति हटा दें)।
86
+
87
+ <details>
88
+ <summary>DSH Desktop मार्केट से इंस्टॉल करें</summary>
89
+
90
+ हर PerryLink प्लगइन DSH Desktop के अंतर्निहित मार्केट में सूचीबद्ध है: **Market → Sources → Add source → चिपकाएँ** `https://perrylink-dsh-catalog.perrylink.workers.dev/catalog-source.json` **→ चुनें**। इंस्टॉल के लिए अब भी मार्केट की npm पहचान जाँच और आपकी पुष्टि ज़रूरी है।
91
+
92
+ </details>
93
+
94
+ ## मुख्य क्षमताएँ
95
+
96
+ यह प्लगइन **केवल एक्शन सतह** पूरी करता है: नेविगेशन अब भी आधिकारिक `ctx.lsp` seam से आता है, और जब seam अनुपस्थित हो, पुराने संस्करण का हो, या उस फ़ाइल के लिए कोई provider न हो, तो एक्शन प्लगइन के अपने न्यूनतम stdio क्लाइंट पर गिर जाते हैं।
97
+
98
+ - **आठ `lsp_*` टूल** — डायग्नोस्टिक्स, फ़ॉर्मेटिंग, कम्प्लीशन, कोड एक्शन, सिंबल, सिग्नेचर हेल्प, इनले हिंट और रीनेम, सब असली लैंग्वेज सर्वर उत्तर देते हैं, mock नहीं।
99
+ - **एडिटर एक्शन प्रोटोकॉल v1** — स्थिर JSON-RPC सतह (`lsp.actions.list` / `lsp.actions.run` / `lsp.events`) जो किसी भी एडिटर (पहले VS Code) को ये क्षमताएँ सीधे उपभोग करने देती है।
100
+ - **असली सर्वर से सत्यापन** — टेस्ट सूट में असली `typescript-language-server` रन और एडिटर प्रोटोकॉल का e2e शामिल है; CI इसे Node 22/24 पर Linux, Windows और macOS में चलाती है।
101
+ - **लेखन आधिकारिक रास्ते से** — `lsp_format` / `lsp_rename` `fs/write-intent` waterfall और प्रति-कॉल sandbox नीति से गुज़रते हैं; read-only सेशन किसी भी सर्वर राउंड-ट्रिप से पहले अस्वीकार हो जाता है।
102
+ - **डिफ़ॉल्ट रूप से केवल पढ़ें** — आठ में से छह टूल केवल संदर्भ के लिए हैं; केवल फ़ॉर्मेटिंग और रीनेम बदलाव करते हैं।
103
+ - **सीमित** — परिणाम संख्या, अक्षर, दस्तावेज़ बाइट और प्रति-कॉल समय की सीमा है; डायग्नोस्टिक्स कैश सीमित LRU है।
104
+
105
+ ```text
106
+ lsp_diagnostics / lsp_format / lsp_completion / lsp_code_action /
107
+ lsp_symbols / lsp_signature / lsp_inlay_hints / lsp_rename
108
+ │
109
+ ▼
110
+ ctx.lsp seam (विस्तारित: diagnostics / formatDocument / completion)
111
+ │ अनुपस्थित · पुराना संस्करण · इस फ़ाइल के लिए कोई provider नहीं
112
+ ▼
113
+ अंतर्निहित stdio क्लाइंट ← servers तालिका (ctx.subprocess.spawn + JSON-RPC)
114
+ ```
115
+
116
+ ### कमांड और टूल सतह
117
+
118
+ | सतह | प्रकार | टिप्पणी |
119
+ |---|---|---|
120
+ | `lsp_diagnostics` | tool | `<file>` — कम्पाइलर/विश्लेषक की त्रुटियाँ, चेतावनियाँ और संकेत, गंभीरता, रेंज, संदेश और स्रोत सर्वर के साथ (केवल पढ़ें) |
121
+ | `lsp_format` | tool | `<file> [range?]` — लैंग्वेज सर्वर से फ़ाइल/चयन को फ़ॉर्मेट कर लागू करता है और diff लौटाता है (`fs/write-intent` से लिखता है) |
122
+ | `lsp_completion` | tool | `<file> <line> <character>` — कर्सर स्थिति पर कम्प्लीशन सुझाव, इन्सर्शन टेक्स्ट सहित (केवल पढ़ें) |
123
+ | `lsp_code_action` | tool | `<file> [range?] [only?]` — सर्वर-सत्यापित quickfix/refactoring उनके edits सहित, किसी रेंज या पहले डायग्नोस्टिक के लिए (केवल संदर्भ) |
124
+ | `lsp_symbols` | tool | `<query?> <file_path?>` — नाम से पूरे workspace में सिंबल खोज, या किसी एक फ़ाइल की रूपरेखा (केवल पढ़ें) |
125
+ | `lsp_signature` | tool | `<file> <line> <character>` — किसी कॉल के भीतर सिग्नेचर हेल्प (पैरामीटर और दस्तावेज़) (केवल पढ़ें) |
126
+ | `lsp_inlay_hints` | tool | `<file> [range?]` — सर्वर से टाइप एनोटेशन और पैरामीटर-नाम संकेत (केवल पढ़ें) |
127
+ | `lsp_rename` | tool | `<file> <line> <character> <new_name>` — सर्वर-सत्यापित रीनेम, पूरे workspace में लागू और प्रति-फ़ाइल diff के साथ (`fs/write-intent` से लिखता है) |
128
+ | `lsp.actions.*` | protocol | एडिटर एक्शन प्रोटोकॉल v1: JSON-RPC पर `lsp.actions.list` / `lsp.actions.run` / `lsp.events` |
129
+ | `examples/vscode/` | extension | केवल-UI VS Code एक्सटेंशन और वह headless बैकएंड कम्पोज़िशन जिससे यह जुड़ता है |
130
+
131
+ ### उदाहरण
132
+
133
+ ये प्लगइन के असली प्रवेश-बिंदु हैं; एक बार इंस्टॉल करें, फिर कोई एक कॉल करें।
134
+
135
+ **विस्तृत उदाहरण** — कमांड `lsp_diagnostics`, इनपुट:
136
+
137
+ ```json
138
+ {
139
+ "file_path": "a.ts"
140
+ }
141
+ ```
142
+
143
+ आउटपुट:
144
+
145
+ ```text
146
+ a.ts:1:3 [Error] boom [ts 2304]
147
+ a.ts:3:1 [Hint] hint
148
+ ```
149
+
150
+ *Observed from `plugins/dsh-lsp-actions/tests/render.spec.ts:32-37 (exact toBe); tool-level no-result render at plugins/dsh-lsp-actions/tests/tools.spec.ts:150-156`*
151
+
152
+ **विफलता शाखा** — इनपुट:
153
+
154
+ ```text
155
+ {"action":"format","requestId":"f1","params":{"filePath":"a.ts","workspaceRoot":"<session-workspace>"}} under a read-only permission preset
156
+ ```
157
+
158
+ आउटपुट:
159
+
160
+ ```text
161
+ {
162
+ "requestId": "f1",
163
+ "action": "format",
164
+ "status": "failed",
165
+ "error": {
166
+ "code": "LSP_ACTION_READ_ONLY",
167
+ "message": "[sandbox: file access denied under read-only mode]\n[sandbox: escalation available — retry this exact operation once with sandbox_permissions (the narrowest wider mode that suffices) + justification; the approval prompt asks the user]"
168
+ }
169
+ }
170
+ ```
171
+
172
+ *Observed from `plugins/dsh-lsp-actions/src/tools.ts:213-223; plugins/dsh-lsp-actions/src/editor/actions.ts:320-330; plugins/dsh-lsp-actions/tests/editor-protocol.spec.ts:305-325`*
173
+
174
+ **संक्षिप्त उदाहरण**: `lsp_format` · `lsp_completion`
175
+
176
+ ### एडिटर एक्शन प्रोटोकॉल v1
177
+
178
+ किसी समर्पित headless कम्पोज़िशन में `editor.enabled: true` सेट करने पर `dsh-lsp-actions` न्यूलाइन-डिलिमिटेड JSON-RPC 2.0 (आधिकारिक SDK/ACP ट्रांसपोर्ट जैसा ही wire framing) पर स्थिर एडिटर प्रोटोकॉल परोसता है:
179
+
180
+ | मेथड | क्या करता है |
181
+ |---|---|
182
+ | `lsp.actions.list` | `lsp-actions/v1` प्रोटोकॉल संस्करण, एक्शन कैटलॉग (`diagnostics.get`, `completion.get`, `quickfix.apply`, `format`, हर एक `writes` फ़्लैग सहित) और पता योग्य DSH सेशन लौटाता है |
183
+ | `lsp.actions.run` | एक एक्शन चलाता है और संरचित `{ requestId, action, status, result \| error }` envelope लौटाता है; त्रुटियाँ स्थिर `LSP_ACTION_*` कोड लेकर आती हैं |
184
+ | `lsp.events` | स्ट्रीमिंग `lsp.event` सूचनाओं की सदस्यता लेता है: `diagnostics.updated`, `action.status`, `file.changed`, `sessions.changed` |
185
+
186
+ सभी लेखन एक्शन (`quickfix.apply`, `format`) **आधिकारिक अनुमति presets और स्वीकृति** से गुज़रते हैं: `read-only` सेशन किसी भी सर्वर राउंड-ट्रिप से पहले `LSP_ACTION_READ_ONLY` के साथ अस्वीकार होता है, edits `fs/write-intent` waterfall से जाते हैं, और `sandbox_permissions` + `justification` एस्केलेशन जोड़ी आधिकारिक `approveEscalation` ask से तय होती है (कोई उत्तरदाता निर्णय न ले सके तो fail-closed)। पूरा wire स्पेक, द्विभाषी: [`docs/editor-protocol.md`](docs/editor-protocol.md) · [`docs/editor-protocol.zh-CN.md`](docs/editor-protocol.zh-CN.md)।
187
+
188
+ **संस्करण और पिछड़ी-संगतता का वादा**
189
+
190
+ - प्रोटोकॉल संस्करणित है — `lsp.actions.list` `protocol: "lsp-actions/v1"`, `version: 1` लौटाता है। **v1 फ़्रोज़न है:** फ़ील्ड नाम, एक्शन id, इवेंट प्रकार और त्रुटि कोड हमेशा स्थिर रहते हैं।
191
+ - विकास **केवल योगात्मक** है: नए एक्शन, फ़ील्ड और इवेंट प्रकार बिना संस्करण बढ़ाए आते हैं; मौजूदा अर्थ कभी जगह पर नहीं बदलते; असंगत बदलाव नए `protocol` संस्करण के अंतर्गत आता है, जिसे सर्वर साथ-साथ परोस सकते हैं।
192
+ - क्लाइंट को अज्ञात फ़ील्ड, अज्ञात इवेंट प्रकार और अज्ञात एक्शन अनदेखा करने चाहिए, और स्थिर त्रुटि `code` पर रूट करना चाहिए, संदेश टेक्स्ट पर कभी नहीं।
193
+
194
+ **त्रुटि कोड**
195
+
196
+ हर विफलता एक स्थिर `code` लेकर आती है; मॉडल और कॉलर कोड पर रूट करते हैं, संदेश टेक्स्ट पर कभी नहीं।
197
+
198
+ | कोड | अर्थ |
199
+ |---|---|
200
+ | `LSP_ACTION_UNAVAILABLE` | इस फ़ाइल के लिए न कोई सर्वर एंट्री है न seam provider |
201
+ | `LSP_ACTION_UNSUPPORTED` | सर्वर (या seam provider) यह ऑपरेशन विज्ञापित नहीं करता |
202
+ | `LSP_ACTION_SERVER_FAILED` | सर्वर विफल हुआ (stderr की पूँछ सहित); स्टार्टअप विफलता एक बार पुनः प्रयास करती है |
203
+ | `LSP_ACTION_MALFORMED_RESPONSE` | सर्वर ने संरचनात्मक रूप से अमान्य payload भेजा |
204
+ | `LSP_ACTION_CONFLICT` | पढ़ने के बाद फ़ाइल बदल गई, या edits ओवरलैप / सीमा से बाहर / workspace से बाहर जाते हैं |
205
+ | `LSP_ACTION_READ_ONLY` | सेशन का sandbox मोड फ़ॉर्मेटिंग/रीनेम लेखन मना करता है |
206
+ | `LSP_ACTION_WORKSPACE_REQUIRED` | कॉल करने वाले सेशन के पास सर्वर को जड़ देने के लिए workspace cwd नहीं है |
207
+ | `LSP_ACTION_NO_SYMBOL` | सर्वर को कर्सर स्थिति पर कोई रीनेम-योग्य सिंबल नहीं मिला |
208
+ | `LSP_ACTION_UNKNOWN` | एडिटर प्रोटोकॉल: अज्ञात एक्शन id, या कोई कोड एक्शन `title`/`index` से मेल नहीं खाता |
209
+ | `LSP_ACTION_INVALID_ARGS` | एडिटर प्रोटोकॉल: एक्शन पैरामीटर अमान्य |
210
+ | `LSP_ACTION_APPROVAL_UNAVAILABLE` | एडिटर प्रोटोकॉल: स्वीकृति मार्ग व्यापक sandbox मोड नहीं दे सका (fail-closed) |
211
+ | `LSP_PROTOCOL_VERSION_UNSUPPORTED` | एडिटर प्रोटोकॉल: घोषित प्रोटोकॉल संस्करण समर्थित नहीं है |
212
+
213
+ ### VS Code एक्सटेंशन
214
+
215
+ [`examples/vscode/`](examples/vscode/) में एक **केवल-UI** एक्सटेंशन है (साइडबार: DSH सेशन, डायग्नोस्टिक्स सूची, एक क्लिक में quickfix लागू करना, रेंज पर खोलना और फ़ॉर्मेट) तथा वह headless बैकएंड कम्पोज़िशन (`backend/cordis.yml`) जिससे यह ACP-शैली JSON-RPC पर जुड़ता है। एक्सटेंशन कोई LSP लॉजिक लागू नहीं करता — हर क्षमता और लिखा गया हर बाइट प्लगइन का है। इंस्टॉल चरण, सेटिंग्स और डेमो gif रिकॉर्डिंग स्क्रिप्ट [`examples/vscode/README.md`](examples/vscode/README.md) में हैं।
216
+
217
+ ### आर्किटेक्चर
218
+
219
+ एक्शन **पहले आधिकारिक seam** पर जाते हैं और मेल न मिलने पर प्लगइन के अपने न्यूनतम stdio क्लाइंट पर गिरते हैं। seam विस्तार upstream में प्रस्तावित है ([`upstream/lsp-action-seam.patch`](upstream/lsp-action-seam.patch), PR विवरण [`upstream/PR-description.md`](upstream/PR-description.md) में); लागू होने पर प्लगइन बिना बदलाव के काम करता रहेगा — अंतर्निहित क्लाइंट का उपयोग बस बंद हो जाएगा। अंतर्निहित क्लाइंट `servers` तालिका के लिए स्वतंत्र fallback बना रहता है। **एडिटर प्रोटोकॉल** वही runner, वही लेखन पथ और वही अनुमति मशीनरी इस्तेमाल करता है।
220
+
221
+ एक्शन बैकएंड एक सार्वजनिक provider इंटरफ़ेस — `ActionRunner` (पैकेज से निर्यात) — के पीछे है, जिसे अंतर्निहित runner लागू करता है और जो तीसरे पक्ष के providers के लिए खुला है: आठ टूल केवल उसी इंटरफ़ेस का उपभोग करते हैं, किसी ठोस क्लाइंट का कभी नहीं। पूरी शोध और डिज़ाइन टिप्पणियाँ: [`docs/seam-extension-notes.md`](docs/seam-extension-notes.md)।
222
+
223
+ ## कॉन्फ़िगरेशन
224
+
225
+ सभी समायोज्य Schemastery `Config` फ़ील्ड हैं (cordis.yml से बदले जा सकते हैं)। id-लक्षित override पूरी पंक्ति बदल देता है — जो भी कुंजियाँ चाहिए, सब दोबारा लिखें। `cordis.patch.yml` हर कुंजी को इनलाइन समझाता है।
226
+
227
+ सबसे अधिक उपयोग होने वाली कुंजियाँ:
228
+
229
+ | कुंजी | डिफ़ॉल्ट | अर्थ |
230
+ |---|---|---|
231
+ | `servers` | `{}` | नामित लैंग्वेज सर्वर; खाली तालिका कोई सर्वर सक्रिय नहीं करती |
232
+ | `editor.enabled` | `false` | JSON-RPC stdio पर एडिटर एक्शन प्रोटोकॉल परोसें (केवल headless बैकएंड) |
233
+ | `maxDiagnostics` | `200` | प्रति परिणाम डायग्नोस्टिक्स सीमा |
234
+ | `maxResultChars` | `16000` | रेंडर किए गए परिणाम की सीमा (अक्षर) |
235
+ | `maxDocumentBytes` | `4000000` | दस्तावेज़ पढ़ने की सीमा (बाइट) |
236
+ | `timeoutMs` | `60000` | प्रति-कॉल समय-सीमा, आधिकारिक timeout नीति से लागू |
237
+
238
+ <details>
239
+ <summary>पूरी कॉन्फ़िगरेशन तालिका (13 कुंजियाँ)</summary>
240
+
241
+ | कुंजी | डिफ़ॉल्ट | अर्थ |
242
+ |---|---|---|
243
+ | `servers` | `{}` | नामित लैंग्वेज सर्वर; खाली तालिका कोई सर्वर सक्रिय नहीं करती |
244
+ | `editor.enabled` | `false` | JSON-RPC stdio पर एडिटर एक्शन प्रोटोकॉल परोसें (केवल headless बैकएंड) |
245
+ | `editor.requestTimeoutMs` | `60000` | एडिटर प्रोटोकॉल के प्रति-रन timeout बजट (ms) |
246
+ | `editor.diagnosticsCacheMaxFiles` | `64` | सीमित LRU डायग्नोस्टिक्स कैश आकार (फ़ाइलें) |
247
+ | `maxDiagnostics` | `200` | प्रति परिणाम डायग्नोस्टिक्स सीमा |
248
+ | `maxCompletionItems` | `20` | प्रति परिणाम कम्प्लीशन आइटम सीमा |
249
+ | `maxCodeActions` | `50` | प्रति परिणाम कोड एक्शन सीमा |
250
+ | `maxSymbols` | `100` | सिंबल परिणाम सीमा |
251
+ | `maxSignatures` | `10` | सिग्नेचर हेल्प सीमा |
252
+ | `maxInlayHints` | `200` | इनले हिंट सीमा |
253
+ | `maxResultChars` | `16000` | रेंडर किए गए परिणाम की सीमा (अक्षर) |
254
+ | `maxDocumentBytes` | `4000000` | दस्तावेज़ पढ़ने की सीमा (बाइट) |
255
+ | `timeoutMs` | `60000` | प्रति-कॉल समय-सीमा, आधिकारिक timeout नीति से लागू |
256
+
257
+ </details>
258
+
259
+ हर `servers` एंट्री एक `LspServerEntry` है: `command` (लोड पर PATH से हल किया गया executable) और `extensionToLanguage` (`".ts"` → `typescript`) अनिवार्य हैं; वैकल्पिक `fileGlobs`, `projectMarkers`, `args`, `env`, `initializationOptions`, `configuration`, `formattingOptions`, `maxMessageBytes`, `maxStderrBytes`, `killGraceMs`, `shutdownTimeoutMs`, `diagnosticsSettleMs`, `diagnosticsDebounceMs` और `idleTimeoutMs` (`0` = सर्वर प्रोसेस को जीवित रखें, जो डिफ़ॉल्ट भी है) अंतर्निहित stdio क्लाइंट को ट्यून करते हैं।
260
+
261
+ रूटिंग नियतात्मक और कॉन्फ़िगरेशन-चालित है। हर फ़ाइल पहला मेल इस क्रम से लेती है: **(1)** ऐसी सर्वर एंट्री जिसकी `fileGlobs` पथ से मेल खाती हों; **(2)** workspace रूट तक ऊपर जाते हुए निकटतम पूर्वज डायरेक्टरी जिसमें किसी एंट्री के `projectMarkers` में सूचीबद्ध प्रोजेक्ट कॉन्फ़िग फ़ाइल हो — केवल उन्हीं एंट्रियों के विरुद्ध जो फ़ाइल का एक्सटेंशन भी मैप करती हैं; **(3)** वह एंट्री जिसकी `extensionToLanguage` फ़ाइल का एक्सटेंशन मैप करती है, कॉन्फ़िग क्रम में। इसलिए `apps/node-app/{package.json,tsconfig.json,src/main.ts}` और `apps/deno-app/{deno.json,src/main.ts}` वाला workspace हर `main.ts` को उसके अपने प्रोजेक्ट के सर्वर से परोसता है — कोई पथ नियम बनाए रखने की ज़रूरत नहीं, और प्रोजेक्ट जोड़े, नाम बदले या हटे तो कुछ बदलना नहीं पड़ता:
262
+
263
+ ```yaml
264
+ servers:
265
+ typescript:
266
+ command: typescript-language-server
267
+ args: ["--stdio"]
268
+ extensionToLanguage: { ".ts": typescript, ".tsx": typescriptreact }
269
+ projectMarkers: ["package.json", "tsconfig.json"]
270
+ deno:
271
+ command: deno
272
+ args: ["lsp"]
273
+ extensionToLanguage: { ".ts": typescript, ".tsx": typescriptreact }
274
+ projectMarkers: ["deno.json", "deno.jsonc"]
275
+ ```
276
+
277
+ प्रोजेक्ट मार्कर केवल उन सर्वरों में से चुनता है जो पहले से फ़ाइल का एक्सटेंशन मैप करते हैं (यह किसी एंट्री के फ़ाइल प्रकार कभी नहीं बढ़ाता); ऊपर की खोज कभी workspace रूट से बाहर नहीं जाती, और एक डायरेक्टरी का प्रोजेक्ट कॉन्फ़िग किसी भाई डायरेक्टरी पर लागू नहीं होता। चरण **(1)** प्रोजेक्ट मार्कर से ऊपर है: जिस एंट्री की `fileGlobs` पथ से मेल खाती है वही जीतती है, इसलिए `projectMarkers` अपनाते समय प्रोजेक्ट-स्तरीय globs हटा दें — बचा हुआ `**/*.ts` उन फ़ाइलों पर दावा करता रहेगा। ये नियम अंतर्निहित stdio क्लाइंट पर लागू हैं; माउंटेड `ctx.lsp` seam provider अपनी रूटिंग खुद तय करता है।
278
+
279
+ ## FAQ
280
+
281
+ <details>
282
+ <summary>डिफ़ॉल्ट <code>servers: {}</code> के साथ क्या होता है? क्या चुपचाप विफल होता है?</summary>
283
+
284
+ कुछ भी चुपचाप नहीं होता। आठों टूल पंजीकृत रहते हैं, लेकिन जब इस फ़ाइल के लिए न कोई सर्वर एंट्री हो और न `ctx.lsp` seam provider, तो कॉल `LSP_ACTION_UNAVAILABLE` के साथ ज़ोर से विफल होती है। seam हर कॉल पर हल होता है, इसलिए इस प्लगइन के बाद माउंट किया गया seam भी बिना रीलोड परोसा जाता है। `editor.enabled: false` (डिफ़ॉल्ट) पर एडिटर प्रोटोकॉल शुरू ही नहीं होता।
285
+
286
+ </details>
287
+
288
+ <details>
289
+ <summary>क्या कोई लेखन sandbox और स्वीकृति को दरकिनार कर सकता है?</summary>
290
+
291
+ नहीं। केवल `lsp_format` और `lsp_rename` लिखते हैं, और वे आधिकारिक `write`/`edit` टूल जैसे ही रास्ते से जाते हैं: `fs/write-intent` waterfall (अवलोकन → संरक्षित लेखन → अवलोकन) और प्रति-कॉल sandbox नीति। `read-only` सेशन किसी भी सर्वर राउंड-ट्रिप से पहले `LSP_ACTION_READ_ONLY` के साथ अस्वीकार होता है; व्यापक मोड की ज़रूरत पड़ने पर `sandbox_permissions` + `justification` एस्केलेशन जोड़ी आधिकारिक `approveEscalation` ask से जाती है और कोई उत्तरदाता निर्णय न ले सके तो `LSP_ACTION_APPROVAL_UNAVAILABLE` के रूप में fail-closed होती है।
292
+
293
+ </details>
294
+
295
+ <details>
296
+ <summary>क्या यह दूसरे प्लगइनों से टूल नाम, इवेंट या slot पर टकराता है?</summary>
297
+
298
+ नहीं। हर टूल नेमस्पेस्ड है, यह कोई सर्विस कुंजी नहीं देता, कोई क्लाइंट slot या `webServer` prefix पंजीकृत नहीं करता, और कोई global नहीं बदलता; bundle patch केवल अपनी पंक्ति `insert` करता है; एकमात्र साझा इवेंट `fs/write-intent` हमेशा `next()` से सौंपा जाता है और श्रृंखला को कभी शॉर्ट-सर्किट नहीं करता। बिंदु-दर-बिंदु तर्क «अन्य DSH प्लगइनों के साथ इंटरऑपरेबिलिटी» में है।
299
+
300
+ </details>
301
+
302
+ <details>
303
+ <summary>अगर पढ़ने के बाद फ़ाइल डिस्क पर बदल जाए तो?</summary>
304
+
305
+ वह कभी अधिलिखित नहीं होती। पढ़ने के बाद फ़ाइल बदलने पर एक्शन `LSP_ACTION_CONFLICT` के साथ विफल होता है; ओवरलैपिंग, सीमा-बाहर या workspace-बाहर edits भी वैसे ही टकराव पैदा करते हैं। `lsp_rename` पहले लेखन से पहले हर प्रभावित फ़ाइल की पूर्व-जाँच करता है।
306
+
307
+ </details>
308
+
309
+ <details>
310
+ <summary>संसाधन खर्च कितना है?</summary>
311
+
312
+ सर्वर प्रोसेस ज़रूरत पर लेज़ी तरीके से शुरू होते हैं और हर इंस्टेंस अपने दस्तावेज़ तब तक निवासी रखता है जब तक प्रोसेस मुक्त न हो; `idleTimeoutMs` डिफ़ॉल्ट रूप से `0` है (जीवित रहें), और धनात्मक मान निष्क्रिय होने पर इंस्टेंस मुक्त कर देता है। परिणाम संख्या, अक्षर, दस्तावेज़ बाइट और कुल अवधि प्रति-कॉल सीमित हैं; एडिटर प्रोटोकॉल का डायग्नोस्टिक्स कैश सीमित LRU है (`editor.diagnosticsCacheMaxFiles`); प्लगइन कोई नेटवर्क अनुरोध नहीं करता।
313
+
314
+ </details>
315
+
316
+ ## सुरक्षा सीमाएँ
317
+
318
+ - **डिफ़ॉल्ट रूप से केवल पढ़ें।** आठ में से छह टूल केवल संदर्भ के लिए हैं; केवल `lsp_format` और `lsp_rename` बदलाव करते हैं, और वे असली `write`/`edit` बदलावों की तरह करते हैं।
319
+ - **आधिकारिक seams, दोबारा लागू नहीं।** हर बाइट `fs/write-intent` waterfall (अवलोकन → संरक्षित लेखन → अवलोकन) और प्रति-कॉल sandbox नीति से गुज़रती है; एस्केलेशन आधिकारिक `write`/`edit` टूल से मेल खाता है।
320
+ - **ज़ोर से, तेज़, संरचित विफलता।** खाली `servers` + कोई `ctx.lsp` seam नहीं → `LSP_ACTION_UNAVAILABLE`; read-only सेशन → किसी भी सर्वर राउंड-ट्रिप से पहले `LSP_ACTION_READ_ONLY`; कमांड रूपों की रिपोर्ट होती है, उन्हें कभी चलाया नहीं जाता।
321
+ - **टकराव कभी अधिलिखित नहीं करते।** पढ़ने के बाद डिस्क पर बदली फ़ाइल `LSP_ACTION_CONFLICT` के साथ विफल होती है; `lsp_rename` पहले लेखन से पहले हर प्रभावित फ़ाइल की पूर्व-जाँच करता है।
322
+ - **सीमित कार्य।** परिणाम सीमाएँ, बाइट सीमाएँ और प्लेटफ़ॉर्म की timeout नीति हर कॉल को सीमित करती हैं; डायग्नोस्टिक्स कैश सीमित LRU है।
323
+ - **मॉडल पथ पर कुछ भी कैश नहीं।** टूल परिणाम केवल सेशन लॉग में रहते हैं; डायग्नोस्टिक्स कैश कभी रीस्टार्ट के पार नहीं टिकता।
324
+ - **खराब सर्वर ज़ोर से विफल होते हैं।** अनुपस्थित executable लोड पर विफल होता है; स्टार्टअप पर मरने वाला सर्वर कॉल को `LSP_ACTION_SERVER_FAILED` और अपनी stderr पूँछ के साथ विफल करता है (एक नए प्रोसेस के साथ एक पुनः प्रयास के बाद)।
325
+ - **प्रॉम्प्ट स्वच्छता।** प्लगइन सेशन सिस्टम प्रॉम्प्ट में कोई persona या प्रॉम्प्ट गद्य नहीं डालता — मॉडल की ओर उसकी सतह केवल आठ टूल स्कीमा हैं।
326
+
327
+ ## अनुमतियाँ और डेटा
328
+
329
+ - **अनुमतियाँ**: फ़ॉर्मेटिंग और रीनेम आधिकारिक अनुमति presets और स्वीकृति से चलते हैं — `fs/write-intent` waterfall और `sandbox_permissions` / `justification` एस्केलेशन जोड़ी, जिसे `ctx.approval` तय करता है। प्लगइन अपने workshop manifest में `fs:read`, `fs:write`, `subprocess:spawn` और `network:none` घोषित करता है।
330
+ - **डेटा**: डिस्क पर कुछ भी संग्रहीत नहीं होता; टूल परिणाम केवल सेशन लॉग में रहते हैं (कोई क्रॉस-सेशन दृढ़ता नहीं)। एडिटर प्रोटोकॉल एक सीमित इन-मेमोरी LRU डायग्नोस्टिक्स कैश रखता है, ताज़गी-चिह्नित और रीस्टार्ट के पार कभी दृढ़ नहीं। गोपनीयता टिप्पणी [`PRIVACY.md`](PRIVACY.md) में है।
331
+ - **कोई नेटवर्क नहीं**: प्लगइन कोई नेटवर्क अनुरोध नहीं करता; यह स्थानीय सबप्रोसेस stdio पर लैंग्वेज सर्वर से बात करता है।
332
+
333
+ ## ज्ञात सीमाएँ
334
+
335
+ - **निवासी दस्तावेज़।** हर दस्तावेज़ एक बार खुलता है और सर्वर इंस्टेंस के पूरे जीवनकाल तक खुला रहता है — बदले स्रोत के साथ बाद का अनुरोध एक पूर्ण-दस्तावेज़ `didChange` भेजता है, और प्रोसेस बंद होने पर सभी दस्तावेज़ बंद हो जाते हैं। इसलिए tsls जैसे प्रोजेक्ट-आधारित सर्वर `textDocument/signatureHelp` और दस्तावेज़-मुक्त `workspace/symbol` का उत्तर देते हैं, बजाय ताज़ा बंद दस्तावेज़ पर `null` लौटाने के। निवासी सेट workspace तक सीमित है और इंस्टेंस के साथ साफ़ होता है (निष्क्रिय निष्कासन या प्लगइन डिस्पोज़ल)।
336
+ - **रेंज फ़ॉर्मेटिंग के लिए सर्वर का range provider ज़रूरी।** केवल पूर्ण-दस्तावेज़ फ़ॉर्मेटिंग विज्ञापित करने वाले सर्वर रेंज अनुरोधों को `LSP_ACTION_UNSUPPORTED` के साथ विफल करते हैं।
337
+ - **रीनेम केवल टेक्स्ट edits लागू करता है।** सर्वर के रीनेम उत्तर में resource ऑपरेशन (फ़ाइल बनाना/हटाना/नाम बदलना) `LSP_ACTION_UNSUPPORTED` के साथ अस्वीकार होते हैं, और workspace से बाहर के edits कुछ भी लिखे जाने से पहले `LSP_ACTION_CONFLICT` के रूप में विफल होते हैं।
338
+
339
+ ## अन्य DSH प्लगइनों के साथ इंटरऑपरेबिलिटी
340
+
341
+ **DSH `0.2.0-rc.2`** (यह README जिस रनटाइम के लिए है) और 2026-10-05 को सर्वे किए गए उच्च-स्टार प्लगइन सेट के विरुद्ध सत्यापित।
342
+
343
+ यह प्लगइन अन्य प्लगइनों में **हस्तक्षेप नहीं करता**, उन व्यापक रूप से इंस्टॉल उच्च-स्टार प्लगइनों में भी नहीं:
344
+
345
+ - **कोई टूल-नाम टकराव नहीं।** हर टूल नेमस्पेस्ड है; किसी शिप्ड टूल या दूसरे प्लगइन के स्वामित्व वाला कोई नंगा नाम पंजीकृत नहीं होता।
346
+ - **कोई सर्विस-कुंजी टकराव नहीं।** यह कोई सर्विस कुंजी देता ही नहीं, इसलिए उस पर टकरा नहीं सकता।
347
+ - **कोई slot टकराव नहीं।** यह कोई क्लाइंट slot कुंजी पंजीकृत नहीं करता, इसलिए `shadows-shipped-ui` सीट के लिए प्रतिस्पर्धा नहीं कर सकता।
348
+ - **कोई HTTP रूट टकराव नहीं।** यह कोई `webServer` prefix पंजीकृत नहीं करता।
349
+ - **कोई patch-लेयर टकराव नहीं।** bundle patch केवल अपनी पंक्ति `insert` करता है; किसी अंतर्निहित पंक्ति का `config` कभी अधिलिखित नहीं करता।
350
+ - **कोई global परिवर्तन नहीं।** यह prototypes को patch नहीं करता, `process.env` नहीं लिखता, और global fetch dispatcher नहीं बदलता।
351
+
352
+ **साझा इवेंट लिसनर रचना से ही अहस्तक्षेपकारी हैं।** यह क्रम-संवेदी इवेंट `fs/write-intent` को `ctx.on()` से सुनता है — Cordis का broadcast पंजीकरण, जहाँ हर लिसनर चलता है और कोई किसी को भूखा नहीं मार सकता। **यहाँ हर लिसनर `next()` से सौंपता है**, इसलिए श्रृंखला कभी शॉर्ट-सर्किट नहीं होती, और बदलाव `next()` के उत्पादित मान पर लागू होता है, उसकी जगह लौटाए जाने के बजाय।
353
+
354
+ स्थिर प्रमाण: इस रेपो पर `dsh-plugin-doctor` K10–K13 हर जाँच में `pass` रिपोर्ट करते हैं।
355
+
356
+ ## संगतता
357
+
358
+ | सतह | स्थिति |
359
+ |---|---|
360
+ | Harness | DeepSeek Harness `dsh-v0.2.1-alpha.1` (`engines.dsh`: `>=0.2.1-0 <0.3.0 \|\| >=0.2.2-0 <0.3.0`); प्लगइन स्वयं कोई सेशन इवेंट नहीं लिखता — होस्ट मानक tool/call + tool/result इवेंट दर्ज करता है। प्रकाशित seam अभी भी केवल चार legacy ऑपरेशन ले जाता है, इसलिए प्लगइन अपना क्लाइंट रखता है और पहले एक्शन कॉल पर वह vintage दर्ज करता है। 2026-09-24 को सत्यापित (दोहरी typecheck रूलर + पूरा टेस्ट सूट + self-contained/artifacts गेट)। |
361
+ | Node | `^22.19.0 \|\| >=24.9.0` |
362
+ | प्लेटफ़ॉर्म | सभी (शुद्ध host; सबप्रोसेस + फ़ाइलसिस्टम, कोई नेटवर्क नहीं) |
363
+ | मॉडल | कोई भी (टूल मॉडल-अज्ञेय हैं; प्लगइन कभी मॉडल नहीं बुलाता) |
364
+
365
+ ## इकोसिस्टम और गुणवत्ता
366
+
367
+ - [Gitee मिरर](https://gitee.com/perrylink/dsh-lsp-actions) (सिंक मिरर; GitHub आधिकारिक है)
368
+ - [dshfind प्लगइन पेज](https://dshfind.com/plugins/PerryLink/dsh-lsp-actions) (इंस्टॉल और रैंकिंग)
369
+ - [OpenSSF Scorecard रिपोर्ट](https://securityscorecards.dev/viewer/?uri=github.com/PerryLink/dsh-lsp-actions) ([.github/workflows/scorecard.yml](.github/workflows/scorecard.yml) से संचालित)
370
+ - [dsh-plugin-doctor सत्यापन रिपोर्ट](https://github.com/PerryLink/dsh-plugin-doctor#verified-徽章) (K10–K13 सभी `pass`)
371
+ - [DSH Market](https://dsh.market/) (सूचीबद्ध)
372
+ - **1024 स्टोर चैनल**: एक बार `npm i -g dsh1024`, फिर `dsh1024 plugin --profile web add dsh-lsp-actions` ([deepseek1024.com](https://deepseek1024.com) की इंस्टॉल रैंकिंग में गिना जाता है)
373
+ - [इकोसिस्टम ज्ञानकोश](https://perrylink.github.io/dsh-plugin-guide/): मापा गया डेटा, मार्केटिंग नहीं: प्लगइन डेवलपमेंट गाइड · प्लगइन-चयन डेटा · रखरखाव मानदंड
374
+
375
+ ## डेवलपमेंट
376
+
377
+ ```sh
378
+ pnpm install # node ^22.19 || >=24.9
379
+ pnpm run lint # src/ और tests/ पर oxlint
380
+ pnpm test # vitest: यूनिट + fixture-server इंटीग्रेशन + एडिटर प्रोटोकॉल e2e + असली tsls e2e
381
+ pnpm run test:coverage # कवरेज गेट
382
+ pnpm build # tsc --noEmitOnError && node scripts/fix-dts.mjs → lib/
383
+ pnpm run prepare # build (इंस्टॉल पर चलता है)
384
+ pnpm run prepublishOnly # build (प्रकाशन से पहले चलता है)
385
+ pnpm run check:readmes # पाँच-भाषा README संगति गेट
386
+ pnpm run verify:self-contained # डिपेंडेंसी spec registry से हल होते हैं
387
+ pnpm run verify:artifacts # प्रकाशित फ़ाइलें मौजूद + artifacts import योग्य
388
+ pnpm run check:lockfile # lockfile ड्रिफ्ट जाँच
389
+ ```
390
+
391
+ रेपो लेआउट:
392
+
393
+ ```text
394
+ src/ प्लगइन का मुख्य भाग: servers / client / runner / tools / editor / seam
395
+ tests/ vitest: यूनिट + fixture सर्वर + एडिटर प्रोटोकॉल e2e + असली tsls e2e
396
+ examples/vscode केवल-UI VS Code एक्सटेंशन + वह headless बैकएंड जिससे यह जुड़ता है
397
+ docs/ एडिटर प्रोटोकॉल (द्विभाषी) + seam विस्तार शोध + assets/
398
+ scripts/ artifact सुधार और यांत्रिक गेट (readme sync / self-contained / artifacts)
399
+ upstream/ seam विस्तार का upstream प्रस्ताव (patch + PR विवरण)
400
+ verify/ एडिटर बैकएंड स्मोक स्क्रिप्ट और scratch कम्पोज़िशन
401
+ ```
402
+
403
+ README की छवियाँ [`scripts/gen-readme-assets.py`](scripts/gen-readme-assets.py) से प्रोग्रामेटिक रूप से बनती हैं (Pillow से 1440×576 हीरो WebP चार रूपों में — हल्का/गहरा × zh/en — और हाथ से लिखा 1100×660 का अनुरोध-उत्तर चक्र SVG) और बिना जोखिम दोबारा चलाई जा सकती हैं।
404
+
405
+ Topics: `dsh`, `dsh-plugin`, `deepseek-harness`, `lsp`, `language-server`, `diagnostics`, `formatting`, `completion`, `code-action`, `symbols`, `signature-help`, `inlay-hints`, `rename`, `refactor`, `ide`, `editor`, `vscode`, `acp`, `json-rpc`
406
+
407
+ ## परिवार और आभार
408
+
409
+ यह परियोजना [PerryLink](https://github.com/PerryLink) के DeepSeek Harness प्लगइन परिवार का हिस्सा है (सभी Apache-2.0)। अगर यह उपयोगी है, तो **एक स्टार अगले व्यक्ति को इसे खोजने में मदद करता है** — इसके पीछे कोई सुविधा नहीं है।
410
+
411
+ - [@PerryLink](https://github.com/PerryLink) — निर्माता और अनुरक्षक: LSP एक्शन क्लाइंट और सर्वर जीवनचक्र, आठों टूल, एडिटर एक्शन प्रोटोकॉल, टेस्ट, CI और पाँच-भाषा दस्तावेज़।
412
+
413
+ <details>
414
+ <summary>सभी प्लगइन विस्तृत करें</summary>
415
+
416
+ | प्लगइन | स्थिति |
417
+ |---|---|
418
+ | **[dsh-aqua-input-check](https://github.com/PerryLink/dsh-aqua-input-check)** | |
419
+ | **[dsh-archive-check](https://github.com/PerryLink/dsh-archive-check)** | |
420
+ | **[dsh-auto-review](https://github.com/PerryLink/dsh-auto-review)** | |
421
+ | **[dsh-autotier](https://github.com/PerryLink/dsh-autotier)** | 🧊 फ़्रोज़न — रेपो README देखें |
422
+ | **[dsh-bid-ca-precheck](https://github.com/PerryLink/dsh-bid-ca-precheck)** | |
423
+ | **[dsh-bid-qual-check](https://github.com/PerryLink/dsh-bid-qual-check)** | |
424
+ | **[dsh-cert-mcp](https://github.com/PerryLink/dsh-cert-mcp)** | 🧊 फ़्रोज़न — रेपो README देखें |
425
+ | **[dsh-checkpoint-rewind](https://github.com/PerryLink/dsh-checkpoint-rewind)** | |
426
+ | **[dsh-click](https://github.com/PerryLink/dsh-click)** | |
427
+ | **[dsh-composer-history](https://github.com/PerryLink/dsh-composer-history)** | |
428
+ | **[dsh-contract-stance](https://github.com/PerryLink/dsh-contract-stance)** | |
429
+ | **[dsh-customs-doc-check](https://github.com/PerryLink/dsh-customs-doc-check)** | |
430
+ | **[dsh-data-quality](https://github.com/PerryLink/dsh-data-quality)** | 🧊 फ़्रोज़न — रेपो README देखें |
431
+ | **[dsh-demurrage-ledger](https://github.com/PerryLink/dsh-demurrage-ledger)** | |
432
+ | **[dsh-doublecheck](https://github.com/PerryLink/dsh-doublecheck)** | |
433
+ | **[dsh-drill-script-check](https://github.com/PerryLink/dsh-drill-script-check)** | |
434
+ | **[dsh-eia-guide-check](https://github.com/PerryLink/dsh-eia-guide-check)** | |
435
+ | **[dsh-emergency-plan](https://github.com/PerryLink/dsh-emergency-plan)** | |
436
+ | **[dsh-essay-rubric-check](https://github.com/PerryLink/dsh-essay-rubric-check)** | |
437
+ | **[dsh-evidence-check](https://github.com/PerryLink/dsh-evidence-check)** | |
438
+ | **[dsh-export-ctl-check](https://github.com/PerryLink/dsh-export-ctl-check)** | |
439
+ | **[dsh-fast](https://github.com/PerryLink/dsh-fast)** | |
440
+ | **[dsh-fmea-table-check](https://github.com/PerryLink/dsh-fmea-table-check)** | |
441
+ | **[dsh-forecast-penalty](https://github.com/PerryLink/dsh-forecast-penalty)** | |
442
+ | **[dsh-fund-research](https://github.com/PerryLink/dsh-fund-research)** | |
443
+ | **[dsh-github](https://github.com/PerryLink/dsh-github)** | |
444
+ | **[dsh-gongwen-flow-check](https://github.com/PerryLink/dsh-gongwen-flow-check)** | |
445
+ | **[dsh-gongwen-word-check](https://github.com/PerryLink/dsh-gongwen-word-check)** | |
446
+ | **[dsh-guard-plan-qc](https://github.com/PerryLink/dsh-guard-plan-qc)** | |
447
+ | **[dsh-hazchem-check](https://github.com/PerryLink/dsh-hazchem-check)** | |
448
+ | **[dsh-hazplan-check](https://github.com/PerryLink/dsh-hazplan-check)** | |
449
+ | **[dsh-hidden-risk-map](https://github.com/PerryLink/dsh-hidden-risk-map)** | |
450
+ | **[dsh-hs-classify](https://github.com/PerryLink/dsh-hs-classify)** | |
451
+ | **[dsh-icd-rule-check](https://github.com/PerryLink/dsh-icd-rule-check)** | |
452
+ | **[dsh-industry-research](https://github.com/PerryLink/dsh-industry-research)** | |
453
+ | **[dsh-lawcite-adapter](https://github.com/PerryLink/dsh-lawcite-adapter)** | |
454
+ | **[dsh-laya](https://github.com/PerryLink/dsh-laya)** | |
455
+ | **[dsh-lc-doc-check](https://github.com/PerryLink/dsh-lc-doc-check)** | |
456
+ | **[dsh-learning-gap-check](https://github.com/PerryLink/dsh-learning-gap-check)** | |
457
+ | **[dsh-library](https://github.com/PerryLink/dsh-library)** | |
458
+ | **[dsh-local-ai](https://github.com/PerryLink/dsh-local-ai)** | |
459
+ | **[dsh-lsp-actions](https://github.com/PerryLink/dsh-lsp-actions)** | |
460
+ | **[dsh-mask](https://github.com/PerryLink/dsh-mask)** | |
461
+ | **[dsh-mcp-panel](https://github.com/PerryLink/dsh-mcp-panel)** | |
462
+ | **[dsh-medrec-qc](https://github.com/PerryLink/dsh-medrec-qc)** | |
463
+ | **[dsh-memento](https://github.com/PerryLink/dsh-memento)** | 🧊 फ़्रोज़न — रेपो README देखें |
464
+ | **[dsh-nsfc-form-check](https://github.com/PerryLink/dsh-nsfc-form-check)** | |
465
+ | **[dsh-nurse-record-check](https://github.com/PerryLink/dsh-nurse-record-check)** | |
466
+ | **[dsh-observe](https://github.com/PerryLink/dsh-observe)** | |
467
+ | **[dsh-origin-rvc-check](https://github.com/PerryLink/dsh-origin-rvc-check)** | |
468
+ | **[dsh-ota-review-check](https://github.com/PerryLink/dsh-ota-review-check)** | |
469
+ | **[dsh-output-styles](https://github.com/PerryLink/dsh-output-styles)** | |
470
+ | **[dsh-paper-doc-adapter](https://github.com/PerryLink/dsh-paper-doc-adapter)** | |
471
+ | **[dsh-permission-rules](https://github.com/PerryLink/dsh-permission-rules)** | |
472
+ | **[dsh-permit-report-check](https://github.com/PerryLink/dsh-permit-report-check)** | |
473
+ | **[dsh-pipeline-check](https://github.com/PerryLink/dsh-pipeline-check)** | |
474
+ | **[dsh-pleading-draft](https://github.com/PerryLink/dsh-pleading-draft)** | |
475
+ | **[dsh-plugin-doctor](https://github.com/PerryLink/dsh-plugin-doctor)** | 🚫 रिटायर्ड (रेपो संग्रहीत) |
476
+ | **[dsh-plugin-guide](https://github.com/PerryLink/dsh-plugin-guide)** | |
477
+ | **[dsh-plugin-kit](https://github.com/PerryLink/dsh-plugin-kit)** | 🚫 रिटायर्ड (रेपो संग्रहीत) |
478
+ | **[dsh-plugin-upgrade](https://github.com/PerryLink/dsh-plugin-upgrade)** | 🚫 रिटायर्ड (रेपो संग्रहीत) |
479
+ | **[dsh-policy-brief-draft](https://github.com/PerryLink/dsh-policy-brief-draft)** | |
480
+ | **[dsh-power-loss-split](https://github.com/PerryLink/dsh-power-loss-split)** | |
481
+ | **[dsh-power-ticket-check](https://github.com/PerryLink/dsh-power-ticket-check)** | |
482
+ | **[dsh-ppap-check](https://github.com/PerryLink/dsh-ppap-check)** | |
483
+ | **[dsh-protest-deadline](https://github.com/PerryLink/dsh-protest-deadline)** | |
484
+ | **[dsh-railway-window](https://github.com/PerryLink/dsh-railway-window)** | |
485
+ | **[dsh-repair-order-qc](https://github.com/PerryLink/dsh-repair-order-qc)** | |
486
+ | **[dsh-research-report](https://github.com/PerryLink/dsh-research-report)** | |
487
+ | **[dsh-review-reply-check](https://github.com/PerryLink/dsh-review-reply-check)** | |
488
+ | **[dsh-rulefile-check](https://github.com/PerryLink/dsh-rulefile-check)** | |
489
+ | **[dsh-safety-brief-check](https://github.com/PerryLink/dsh-safety-brief-check)** | |
490
+ | **[dsh-score](https://github.com/PerryLink/dsh-score)** | 🧊 फ़्रोज़न — रेपो README देखें |
491
+ | **[dsh-session-sync](https://github.com/PerryLink/dsh-session-sync)** | |
492
+ | **[dsh-site-log-check](https://github.com/PerryLink/dsh-site-log-check)** | |
493
+ | **[dsh-skill-pack-security](https://github.com/PerryLink/dsh-skill-pack-security)** | |
494
+ | **[dsh-soe-decision-check](https://github.com/PerryLink/dsh-soe-decision-check)** | |
495
+ | **[dsh-soilwater-check](https://github.com/PerryLink/dsh-soilwater-check)** | |
496
+ | **[dsh-sop-sync-check](https://github.com/PerryLink/dsh-sop-sync-check)** | |
497
+ | **[dsh-spc-gbt-adapter](https://github.com/PerryLink/dsh-spc-gbt-adapter)** | |
498
+ | **[dsh-talk](https://github.com/PerryLink/dsh-talk)** | |
499
+ | **[dsh-tender-extract](https://github.com/PerryLink/dsh-tender-extract)** | |
500
+ | **[dsh-tender-matrix](https://github.com/PerryLink/dsh-tender-matrix)** | |
501
+ | **[dsh-test-drive](https://github.com/PerryLink/dsh-test-drive)** | |
502
+ | **[dsh-ticktick](https://github.com/PerryLink/dsh-ticktick)** | 🚫 रिटायर्ड (रेपो संग्रहीत) |
503
+ | **[dsh-translate](https://github.com/PerryLink/dsh-translate)** | |
504
+ | **[dsh-warranty-calc](https://github.com/PerryLink/dsh-warranty-calc)** | |
505
+ | **[dsh-budget](https://github.com/PerryLink/dsh-budget)** | 🧊 फ़्रोज़न — रेपो README देखें |
506
+ | **[dsh-claude-move](https://github.com/PerryLink/dsh-claude-move)** | 🧊 फ़्रोज़न — रेपो README देखें |
507
+ | **[dsh-defend](https://github.com/PerryLink/dsh-defend)** | 🧊 फ़्रोज़न — रेपो README देखें |
508
+ | **[dsh-draw](https://github.com/PerryLink/dsh-draw)** | 🧊 फ़्रोज़न — रेपो README देखें |
509
+ | **[dsh-reach](https://github.com/PerryLink/dsh-reach)** | 🧊 फ़्रोज़न — रेपो README देखें |
510
+ | **[dsh-background-agents](https://github.com/PerryLink/dsh-background-agents)** | 🚫 रिटायर्ड (रेपो संग्रहीत) |
511
+ | **[dsh-session-pin](https://github.com/PerryLink/dsh-session-pin)** | 🚫 रिटायर्ड (रेपो संग्रहीत) |
512
+ | **[dsh-team-rooms](https://github.com/PerryLink/dsh-team-rooms)** | 🚫 रिटायर्ड (रेपो संग्रहीत) |
513
+
514
+ </details>
515
+
516
+ ## लाइसेंस
517
+
518
+ [LICENSE](LICENSE) (Apache License 2.0) © 2026 dsh-lsp-actions contributors
519
+
520
+ <p align="center"><sub>Apache-2.0 · समुदाय प्लगइन, DeepSeek से संबद्ध नहीं।</sub></p>