@wlv-zedd/dsh-btw-plugin 1.0.3 → 1.0.5
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/LICENSE +21 -21
- package/README.md +108 -108
- package/cordis.patch.yml +4 -4
- package/lib/client.js +646 -646
- package/lib/index.js +675 -675
- package/package.json +64 -63
- package/README.zh-CN.md +0 -108
package/LICENSE
CHANGED
|
@@ -1,21 +1,21 @@
|
|
|
1
|
-
MIT License
|
|
2
|
-
|
|
3
|
-
Copyright (c) 2026 WLV-ZEDD
|
|
4
|
-
|
|
5
|
-
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
-
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
-
in the Software without restriction, including without limitation the rights
|
|
8
|
-
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
-
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
-
furnished to do so, subject to the following conditions:
|
|
11
|
-
|
|
12
|
-
The above copyright notice and this permission notice shall be included in all
|
|
13
|
-
copies or substantial portions of the Software.
|
|
14
|
-
|
|
15
|
-
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
-
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
-
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
-
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
-
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
-
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
-
SOFTWARE.
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 WLV-ZEDD
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,108 +1,108 @@
|
|
|
1
|
-
# dsh-btw-plugin
|
|
2
|
-
|
|
3
|
-
[English](
|
|
4
|
-
|
|
5
|
-
[](https://www.npmjs.com/package/@wlv-zedd/dsh-btw-plugin)
|
|
6
|
-
[](https://dshmarket.com/p/WLV-ZEDD/dsh-btw/)
|
|
7
|
-
[](https://github.com/WLV-ZEDD/dsh-btw/blob/main/LICENSE)
|
|
8
|
-
|
|
9
|
-
> **DeepSeek Harness Side-Assistant Dock**
|
|
10
|
-
> Ask quick side questions without interrupting or polluting the active agent loop.
|
|
11
|
-
|
|
12
|
-
<p align="center">
|
|
13
|
-
<img src="https://raw.githubusercontent.com/WLV-ZEDD/dsh-btw/main/assets/promo-dshmarket-official.png?v=1.0.3" alt="dsh-btw on DSH Market" width="100%">
|
|
14
|
-
</p>
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
---
|
|
19
|
-
|
|
20
|
-
## Features
|
|
21
|
-
|
|
22
|
-
- **Instant Non-Blocking /btw Command:**
|
|
23
|
-
Type `/btw <question>` in the chat bar. The input clears instantly (0ms) and executes in the background without disturbing the main agent run.
|
|
24
|
-
|
|
25
|
-
- **Docked Floating Banner Above Composer:**
|
|
26
|
-
Appears right above the message input with a live Quantum Equalizer animation, Markdown rendering, pagination (`< 1/5 >`), and collapse/expand toggle.
|
|
27
|
-
|
|
28
|
-
- **Quantum Equalizer Visualizer:**
|
|
29
|
-
Five animated pill bars pulse in theme blue while your answer is being generated. During an automatic retry, all bars and the status badge switch to amber so you can always see the current state at a glance.
|
|
30
|
-
|
|
31
|
-
- **Smart Auto-Retry (5 Steps):**
|
|
32
|
-
On transient model errors the plugin retries up to 5 times with fast bursts (1 s → 1.5 s → 2 s → 2.5 s → 3 s, ~10 s total). The status badge shows `Retrying (X/5)...` in amber so you are never left wondering.
|
|
33
|
-
|
|
34
|
-
- **Active Session & Loop Context Awareness:**
|
|
35
|
-
Inherits the active session model dynamically and extracts recent turn history (`session.deriveMessages()`, active workspace) so `/btw` knows exactly what you and the main agent are working on without interrupting execution.
|
|
36
|
-
|
|
37
|
-
- **Accuracy-First System Prompt:**
|
|
38
|
-
Six concise positive instructions guide the model to preserve exact nouns, synthesize session history faithfully, and answer directly — no defensive over-constraints that cause hallucinations.
|
|
39
|
-
|
|
40
|
-
- **Rich Markdown Rendering:**
|
|
41
|
-
Bold, italic, inline code, numbered lists (rendered as real `1.` `2.` numbers in theme blue), and bullet points — all without markdown tables cluttering the compact card.
|
|
42
|
-
|
|
43
|
-
- **Isolated JSON Storage:**
|
|
44
|
-
Persists session Q&A history in `~/.dsh/storages/btw-history.json` without modifying or polluting other plugins.
|
|
45
|
-
|
|
46
|
-
---
|
|
47
|
-
|
|
48
|
-
## Installation
|
|
49
|
-
|
|
50
|
-
### Option 1: Via DSH Plugin Market (Recommended)
|
|
51
|
-
Install directly in the DSH Web UI via **Settings → Plugin Market** (search for `dsh-btw`), or run:
|
|
52
|
-
|
|
53
|
-
```bash
|
|
54
|
-
pnpm dsh plugin add @wlv-zedd/dsh-btw-plugin
|
|
55
|
-
```
|
|
56
|
-
|
|
57
|
-
### Option 2: Manual npm & Cordis Config
|
|
58
|
-
Install dsh-btw-plugin into your DeepSeek Harness environment:
|
|
59
|
-
|
|
60
|
-
```bash
|
|
61
|
-
pnpm add @wlv-zedd/dsh-btw-plugin
|
|
62
|
-
```
|
|
63
|
-
|
|
64
|
-
Enable the plugin in your `cordis.yml` (or via `cordis.patch.yml`):
|
|
65
|
-
|
|
66
|
-
```yaml
|
|
67
|
-
# cordis.yml
|
|
68
|
-
plugins:
|
|
69
|
-
@wlv-zedd/dsh-btw-plugin:
|
|
70
|
-
# Optional: specify a dedicated model, or omit to auto-inherit active session model
|
|
71
|
-
# model: deepseek:deepseek-chat
|
|
72
|
-
```
|
|
73
|
-
|
|
74
|
-
---
|
|
75
|
-
|
|
76
|
-
## Usage
|
|
77
|
-
|
|
78
|
-
### In the Web Chat Interface
|
|
79
|
-
Type `/btw` followed by your question:
|
|
80
|
-
|
|
81
|
-
```text
|
|
82
|
-
/btw What is the port number of PostgreSQL?
|
|
83
|
-
/btw What is the difference between TCP and UDP?
|
|
84
|
-
```
|
|
85
|
-
|
|
86
|
-
- **Floating Banner:** The question immediately displays above the composer with the Quantum Equalizer pulsing. Once resolved, the rich Markdown answer appears.
|
|
87
|
-
- **Pagination (`< 1/5 >`):** Cycle through previous side questions in the active session using `<` and `>`.
|
|
88
|
-
- **Action Controls:**
|
|
89
|
-
- **Copy:** Copies the answer to clipboard.
|
|
90
|
-
- **Delete:** Removes the question from session history.
|
|
91
|
-
- **Collapse / Expand:** Toggles the answer view to keep your workspace tidy.
|
|
92
|
-
- **Dismiss [X]:** Closes the floating banner.
|
|
93
|
-
|
|
94
|
-
---
|
|
95
|
-
|
|
96
|
-
## Support & Community Perks
|
|
97
|
-
|
|
98
|
-
[](https://paypal.me/wlvzedd) If you find this plugin helpful, consider sending a small tip.
|
|
99
|
-
|
|
100
|
-
[](https://agentrouter.org/register?aff=bIJf) Sign up on AgentRouter with GitHub to get up to **$200 in free API credits** for LLM workflows.
|
|
101
|
-
|
|
102
|
-
[](https://vyceai.com/signup?ref=VYCE_BL6YAG) Sign up on Vyce AI to get **$50 in free API credits** for high-speed LLM workflows.
|
|
103
|
-
|
|
104
|
-
---
|
|
105
|
-
|
|
106
|
-
## License
|
|
107
|
-
|
|
108
|
-
MIT © [WLV-ZEDD](https://github.com/WLV-ZEDD)
|
|
1
|
+
# dsh-btw-plugin
|
|
2
|
+
|
|
3
|
+
[English](https://github.com/WLV-ZEDD/dsh-btw#readme) | [中文](https://github.com/WLV-ZEDD/dsh-btw/blob/main/docs/README.zh-CN.md)
|
|
4
|
+
|
|
5
|
+
[](https://www.npmjs.com/package/@wlv-zedd/dsh-btw-plugin)
|
|
6
|
+
[](https://dshmarket.com/p/WLV-ZEDD/dsh-btw/)
|
|
7
|
+
[](https://github.com/WLV-ZEDD/dsh-btw/blob/main/LICENSE)
|
|
8
|
+
|
|
9
|
+
> **DeepSeek Harness Side-Assistant Dock**
|
|
10
|
+
> Ask quick side questions without interrupting or polluting the active agent loop.
|
|
11
|
+
|
|
12
|
+
<p align="center">
|
|
13
|
+
<img src="https://raw.githubusercontent.com/WLV-ZEDD/dsh-btw/main/assets/promo-dshmarket-official.png?v=1.0.3" alt="dsh-btw on DSH Market" width="100%">
|
|
14
|
+
</p>
|
|
15
|
+
|
|
16
|
+
|
|
17
|
+
|
|
18
|
+
---
|
|
19
|
+
|
|
20
|
+
## Features
|
|
21
|
+
|
|
22
|
+
- **Instant Non-Blocking /btw Command:**
|
|
23
|
+
Type `/btw <question>` in the chat bar. The input clears instantly (0ms) and executes in the background without disturbing the main agent run.
|
|
24
|
+
|
|
25
|
+
- **Docked Floating Banner Above Composer:**
|
|
26
|
+
Appears right above the message input with a live Quantum Equalizer animation, Markdown rendering, pagination (`< 1/5 >`), and collapse/expand toggle.
|
|
27
|
+
|
|
28
|
+
- **Quantum Equalizer Visualizer:**
|
|
29
|
+
Five animated pill bars pulse in theme blue while your answer is being generated. During an automatic retry, all bars and the status badge switch to amber so you can always see the current state at a glance.
|
|
30
|
+
|
|
31
|
+
- **Smart Auto-Retry (5 Steps):**
|
|
32
|
+
On transient model errors the plugin retries up to 5 times with fast bursts (1 s → 1.5 s → 2 s → 2.5 s → 3 s, ~10 s total). The status badge shows `Retrying (X/5)...` in amber so you are never left wondering.
|
|
33
|
+
|
|
34
|
+
- **Active Session & Loop Context Awareness:**
|
|
35
|
+
Inherits the active session model dynamically and extracts recent turn history (`session.deriveMessages()`, active workspace) so `/btw` knows exactly what you and the main agent are working on without interrupting execution.
|
|
36
|
+
|
|
37
|
+
- **Accuracy-First System Prompt:**
|
|
38
|
+
Six concise positive instructions guide the model to preserve exact nouns, synthesize session history faithfully, and answer directly — no defensive over-constraints that cause hallucinations.
|
|
39
|
+
|
|
40
|
+
- **Rich Markdown Rendering:**
|
|
41
|
+
Bold, italic, inline code, numbered lists (rendered as real `1.` `2.` numbers in theme blue), and bullet points — all without markdown tables cluttering the compact card.
|
|
42
|
+
|
|
43
|
+
- **Isolated JSON Storage:**
|
|
44
|
+
Persists session Q&A history in `~/.dsh/storages/btw-history.json` without modifying or polluting other plugins.
|
|
45
|
+
|
|
46
|
+
---
|
|
47
|
+
|
|
48
|
+
## Installation
|
|
49
|
+
|
|
50
|
+
### Option 1: Via DSH Plugin Market (Recommended)
|
|
51
|
+
Install directly in the DSH Web UI via **Settings → Plugin Market** (search for `dsh-btw`), or run:
|
|
52
|
+
|
|
53
|
+
```bash
|
|
54
|
+
pnpm dsh plugin add @wlv-zedd/dsh-btw-plugin
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
### Option 2: Manual npm & Cordis Config
|
|
58
|
+
Install dsh-btw-plugin into your DeepSeek Harness environment:
|
|
59
|
+
|
|
60
|
+
```bash
|
|
61
|
+
pnpm add @wlv-zedd/dsh-btw-plugin
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
Enable the plugin in your `cordis.yml` (or via `cordis.patch.yml`):
|
|
65
|
+
|
|
66
|
+
```yaml
|
|
67
|
+
# cordis.yml
|
|
68
|
+
plugins:
|
|
69
|
+
@wlv-zedd/dsh-btw-plugin:
|
|
70
|
+
# Optional: specify a dedicated model, or omit to auto-inherit active session model
|
|
71
|
+
# model: deepseek:deepseek-chat
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
---
|
|
75
|
+
|
|
76
|
+
## Usage
|
|
77
|
+
|
|
78
|
+
### In the Web Chat Interface
|
|
79
|
+
Type `/btw` followed by your question:
|
|
80
|
+
|
|
81
|
+
```text
|
|
82
|
+
/btw What is the port number of PostgreSQL?
|
|
83
|
+
/btw What is the difference between TCP and UDP?
|
|
84
|
+
```
|
|
85
|
+
|
|
86
|
+
- **Floating Banner:** The question immediately displays above the composer with the Quantum Equalizer pulsing. Once resolved, the rich Markdown answer appears.
|
|
87
|
+
- **Pagination (`< 1/5 >`):** Cycle through previous side questions in the active session using `<` and `>`.
|
|
88
|
+
- **Action Controls:**
|
|
89
|
+
- **Copy:** Copies the answer to clipboard.
|
|
90
|
+
- **Delete:** Removes the question from session history.
|
|
91
|
+
- **Collapse / Expand:** Toggles the answer view to keep your workspace tidy.
|
|
92
|
+
- **Dismiss [X]:** Closes the floating banner.
|
|
93
|
+
|
|
94
|
+
---
|
|
95
|
+
|
|
96
|
+
## Support & Community Perks
|
|
97
|
+
|
|
98
|
+
[](https://paypal.me/wlvzedd) If you find this plugin helpful, consider sending a small tip.
|
|
99
|
+
|
|
100
|
+
[](https://agentrouter.org/register?aff=bIJf) Sign up on AgentRouter with GitHub to get up to **$200 in free API credits** for LLM workflows.
|
|
101
|
+
|
|
102
|
+
[](https://vyceai.com/signup?ref=VYCE_BL6YAG) Sign up on Vyce AI to get **$50 in free API credits** for high-speed LLM workflows.
|
|
103
|
+
|
|
104
|
+
---
|
|
105
|
+
|
|
106
|
+
## License
|
|
107
|
+
|
|
108
|
+
MIT © [WLV-ZEDD](https://github.com/WLV-ZEDD)
|
package/cordis.patch.yml
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# dsh-btw-plugin bundle patch: inserts the plugin into a profile's layer stack.
|
|
2
|
-
- insert:
|
|
3
|
-
- id: dsh-btw-plugin
|
|
4
|
-
name: '@wlv-zedd/dsh-btw-plugin'
|
|
1
|
+
# dsh-btw-plugin bundle patch: inserts the plugin into a profile's layer stack.
|
|
2
|
+
- insert:
|
|
3
|
+
- id: dsh-btw-plugin
|
|
4
|
+
name: '@wlv-zedd/dsh-btw-plugin'
|