@michengai/dsh-btw 1.3.3 → 1.3.6
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/CHANGELOG.md +10 -0
- package/CHANGELOG.zh-CN.md +10 -0
- package/README.de.md +221 -0
- package/README.en.md +222 -0
- package/README.es.md +221 -0
- package/README.fr.md +221 -0
- package/README.ja.md +221 -0
- package/README.md +111 -109
- package/README.pt.md +221 -0
- package/README.ru.md +221 -0
- package/README.zh-CN.md +6 -3
- package/lib/client.js +774 -167
- package/lib/index.js +779 -138
- package/lib/types/client/SelectionAsk.d.ts +1 -4
- package/lib/types/client/trigger-source.d.ts +2 -2
- package/lib/types/locales/de.d.ts +2 -0
- package/lib/types/locales/en.d.ts +2 -0
- package/lib/types/locales/es.d.ts +2 -0
- package/lib/types/locales/fr.d.ts +2 -0
- package/lib/types/locales/ja.d.ts +2 -0
- package/lib/types/locales/pt.d.ts +2 -0
- package/lib/types/locales/ru.d.ts +2 -0
- package/lib/types/locales/zh.d.ts +97 -0
- package/lib/types/locales.d.ts +11 -99
- package/locale/de.json +7 -0
- package/locale/en.json +2 -1
- package/locale/es.json +7 -0
- package/locale/fr.json +7 -0
- package/locale/ja.json +7 -0
- package/locale/pt.json +7 -0
- package/locale/ru.json +7 -0
- package/locale/zh.json +2 -1
- package/package.json +23 -1
package/README.ja.md
ADDED
|
@@ -0,0 +1,221 @@
|
|
|
1
|
+
<p align="center">
|
|
2
|
+
<img src="https://raw.githubusercontent.com/MichengAI/dsh-btw/2d8dd7752cec1b29dd705969eaa932635ba0bf4f/assets/branding/dsh-btw-banner.png" alt="DSH BTW" width="100%">
|
|
3
|
+
</p>
|
|
4
|
+
|
|
5
|
+
<div align="center">
|
|
6
|
+
|
|
7
|
+
# DSH BTW
|
|
8
|
+
|
|
9
|
+
**DeepSeek Harness の現在のセッションで手軽にサイド質問。回答のみ行い、ツールは実行しません**
|
|
10
|
+
|
|
11
|
+
[简体中文](README.zh-CN.md) · [English](README.en.md) · [日本語](README.ja.md) · [Español](README.es.md) · [Français](README.fr.md) · [Deutsch](README.de.md) · [Русский](README.ru.md) · [Português](README.pt.md)
|
|
12
|
+
|
|
13
|
+
[画面プレビュー](#画面プレビュー) · [インストール](#インストール) · [使い方](#使い方) · [更新履歴](CHANGELOG.md) · [Apache-2.0](LICENSE)
|
|
14
|
+
|
|
15
|
+
[](LICENSE)
|
|
16
|
+
[](https://github.com/deepseek-ai/deepseek-harness)
|
|
17
|
+
[](https://nodejs.org/)
|
|
18
|
+
|
|
19
|
+
</div>
|
|
20
|
+
|
|
21
|
+
> DSH BTW はコミュニティによって保守されている DeepSeek Harness プラグインであり、DeepSeek AI 公式の製品ではありません。現在の会話で `/btw 質問` と入力することで、メインタスクを中断せずに独立したバブルでコンテキストに応じた回答を得ることができます。DSH Web および DSH Web を統合したデスクトップアプリに対応しています。`1.0.0` 以降、サポート対象外のホストはバージョンゲートによって拒否され、プラグインは実行されません(既存の設定やメインセッションの記録は保持されます)。
|
|
22
|
+
|
|
23
|
+
## 機能概要
|
|
24
|
+
|
|
25
|
+
- **コンテキストに応じたサイド質問**:現在の会話内容に基づいて概念を説明したり、結論を振り返ったり、一時的な疑問を解消します。
|
|
26
|
+
- **回答のみ・ツール実行なし**:ファイルの読み込み、Web 検索、コマンド実行、コード変更は一切行いません。
|
|
27
|
+
- **独立した回答バブル**:Markdown、数式、コピー、折りたたみ、展開、閉じる操作に対応。複数のサイド質問を同時に確認できます。
|
|
28
|
+
- **メインタスクを妨げない**:サイド質問は単独で回答され、デフォルトでメインセッションに結果が書き込まれることはありません。
|
|
29
|
+
- **必要なときだけ結果を送信**:メインの会話に結論を残したい場合は、質問内で「回答をメイン会話に送信して」と明示的に指示すると、`send_message` を使って自己完結した回答をメインセッションに返送します。指示がない限り返送しません。
|
|
30
|
+
- **いつでもキャンセル可能**:生成中の回答バブルを閉じるだけで、そのサイド質問を即座にキャンセルできます。
|
|
31
|
+
- **全言語対応とテーマ**:DSH のライト・ダークテーマに追従。ホスト 0.2.2-rc.1 以降では公式の全 8 門言語(日本語、英語、中国語、スペイン語、フランス語、ドイツ語、ロシア語、ポルトガル語)をネイティブサポートし、それ以前の 0.2.0〜0.2.1 ホストでは安全に中英 2 言語にフォールバックします。
|
|
32
|
+
|
|
33
|
+
## 画面プレビュー
|
|
34
|
+
|
|
35
|
+
### ネイティブ DSH でのサイド質問
|
|
36
|
+
|
|
37
|
+
メインセッションは元の位置に保たれ、サイド質問の回答は入力欄の上に独立して表示されます。
|
|
38
|
+
|
|
39
|
+

|
|
40
|
+
|
|
41
|
+
### コマンド入力
|
|
42
|
+
|
|
43
|
+
`/` を入力後、「コマンド」メニューから `btw` を選択するか、直接 `/btw 質問内容` を入力できます。
|
|
44
|
+
|
|
45
|
+

|
|
46
|
+
|
|
47
|
+
### 独立した回答バブル
|
|
48
|
+
|
|
49
|
+
各サイド質問は個別のバブルで表示され、右上からコピー、折りたたみ/展開、閉じる操作が可能です。
|
|
50
|
+
|
|
51
|
+

|
|
52
|
+
|
|
53
|
+
### サイド質問の設定
|
|
54
|
+
|
|
55
|
+
**プラグイン** を開き、`@michengai/dsh-btw` を選択すると、詳細ページ上に直接設定フォームが表示されます。許可ツールリストとプロンプト入力欄があり、プロンプトには組み込み文言があらかじめ入力されています。
|
|
56
|
+
|
|
57
|
+

|
|
58
|
+
|
|
59
|
+
### サイド質問で図を描画
|
|
60
|
+
|
|
61
|
+
`pele_draw` をホワイトリストに追加すると、サイド質問でも図を描画できます。図はサイド質問パネル内に表示され、メイン会話には影響しません。
|
|
62
|
+
|
|
63
|
+

|
|
64
|
+
|
|
65
|
+
## DSH プロダクトエコシステム
|
|
66
|
+
|
|
67
|
+
デスクトップワークベンチをご希望の場合は、[DSH Codex Desktop](https://github.com/MichengAI/dsh-codex-desktop/releases) をダウンロードしてください。既存の [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 環境がある場合は、各プロジェクトの README に従って個別にインストールできます。以下に 11 個の自社製プラグインを記載します。デスクトップ版の同梱範囲は対応バージョンのリリースノートおよび内蔵カタログに準じます。
|
|
68
|
+
|
|
69
|
+
| プラグイン | 用途 |
|
|
70
|
+
| --- | --- |
|
|
71
|
+
| [Codex UI](https://github.com/MichengAI/dsh-codex-ui) | プロジェクトやセッションの整理、タスク検索、会話ターンの移動 |
|
|
72
|
+
| [Agency Agents](https://github.com/MichengAI/dsh-agency-agents) | タスクに応じて専門エージェントを選択・召喚 |
|
|
73
|
+
| [Skills Manager](https://github.com/MichengAI/dsh-skills-manager) | ローカルスキルの検索、有効化・無効化、作成およびインポート |
|
|
74
|
+
| [Archive Manager](https://github.com/MichengAI/dsh-archive-manager) | アーカイブされたセッションの検索、復元、クリーンアップ |
|
|
75
|
+
| [IM Connect](https://github.com/MichengAI/dsh-im-connect) | メッセージングプラットフォームからタスクを割り当てて回答を受信 |
|
|
76
|
+
| [Automation](https://github.com/MichengAI/dsh-automation) | スケジュールに基づいてタスクを実行し、各実行結果を確認 |
|
|
77
|
+
| [BTW](https://github.com/MichengAI/dsh-btw) | メインタスクを妨げずに現在のコンテキストで手軽にサイド質問 |
|
|
78
|
+
| [Simplify](https://github.com/MichengAI/dsh-simplify) | `/simplify` を使って Git 変更範囲内のコードをクリーンアップ |
|
|
79
|
+
| [PUA](https://github.com/MichengAI/dsh-pua) | 失敗時にアプローチを変更・原因究明し、完了前に検証するようエージェントを誘導 |
|
|
80
|
+
| [Code Review](https://github.com/MichengAI/dsh-code-review) | `/review` を使って独立したコードレビューを開始し、セッション内でレポートを受信 |
|
|
81
|
+
| [Codex Pet](https://github.com/MichengAI/dsh-codex-pet) | デスクトップペットを通じてセッション通知を確認し、承認や回答を処理 |
|
|
82
|
+
|
|
83
|
+
## 前提条件
|
|
84
|
+
|
|
85
|
+
- DeepSeek Harness がインストールされていること。
|
|
86
|
+
- ホスト対応バージョン:DeepSeek Harness `0.2.x` 全系列(`>=0.2.0-rc.1 <0.3.0-0`)、`0.2.0-rc.1`、`0.2.0-rc.2`、`0.2.1-rc.1`〜`0.2.1-rc.5`、`0.2.2-rc.1` で検証済み。同代ホストのアップグレードはプラグインの再リリースを待つ必要がありません。
|
|
87
|
+
- 言語サポート範囲:DeepSeek Harness `0.2.2-rc.1` 以降で全 8 門の組み込み言語がネイティブに選択可能。`0.2.0`〜`0.2.1` ホストでは追加登録された言語は不活性のままとなり、UI は安全に中英 2 言語にフォールバックします。
|
|
88
|
+
- `0.2.0-rc.1` より前の旧ホストはサポートしていません。`0.3.0` 世代の破壊的変更はバージョンゲートで遮断されます。`0.1.x` ユーザーは `0.1.24` をインストールしてください。
|
|
89
|
+
- Node.js 22+、ターミナルで `dsh` コマンドが実行できること。
|
|
90
|
+
|
|
91
|
+
## インストール
|
|
92
|
+
|
|
93
|
+
以下のコマンドでは `web` プロファイルを使用しています。実際の環境に合わせて置き換えてください。インストール前に `/btw` コマンドを提供する他のプラグインを停止してください。
|
|
94
|
+
|
|
95
|
+
### エージェントに依頼してインストール(推奨)
|
|
96
|
+
|
|
97
|
+
ローカルのターミナルコマンドを実行できるエージェントに以下のテキストを送信してください:
|
|
98
|
+
|
|
99
|
+
```text
|
|
100
|
+
DSH プラグイン @michengai/dsh-btw をローカルの web プロファイルにインストールしてください:dsh plugin --profile web add @michengai/dsh-btw@latest --registry=https://registry.npmjs.org/。インストール後、dsh --profile web --dump-config を実行して設定に michengai-btw が含まれていることを確認し、DSH の再読み込み方法と使い方を教えてください。
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
### 手動で npm からインストール
|
|
104
|
+
|
|
105
|
+
```powershell
|
|
106
|
+
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
|
|
107
|
+
$OutputEncoding = [System.Text.Encoding]::UTF8
|
|
108
|
+
|
|
109
|
+
dsh plugin --profile web add @michengai/dsh-btw@latest --registry=https://registry.npmjs.org/
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
### 再読み込み
|
|
113
|
+
|
|
114
|
+
現在のタスクが終了した後にインストールまたは更新してください。デスクトップアプリは自動的に再読み込みされる場合があります。反映されない場合は、デスクトップアプリの「再読み込み」を使用するか、`dsh web` サービスを再起動してください。ブラウザのリフレッシュだけでは不十分です。
|
|
115
|
+
|
|
116
|
+
`0.2.0` より前のホスト、および `0.2.1` alpha では、`@latest` のインストールがバージョンゲートで拒否され実行されません。`0.1.x` では `0.1.24` をご利用ください。拒否されても既存の設定やメインセッション記録は削除されません。
|
|
117
|
+
|
|
118
|
+
## 使い方
|
|
119
|
+
|
|
120
|
+
### テキスト選択からのサイド質問
|
|
121
|
+
|
|
122
|
+
セッション内のテキストを選択すると、選択範囲の上に表示されるバーから「サイド質問」を選択できます。質問を入力して Enter キーで送信するか、「説明する」をクリックします。Shift+Enter で改行、Esc でキャンセルします。回答は独立した BTW バブル内に表示され、引用原文を展開して確認できます。
|
|
123
|
+
|
|
124
|
+
- 通常の段落、リスト、コードブロックに対応。1回の引用につき最大 8,000 UTF-16 コードユニット(空白を含む)まで対応。超過時は通知され、切り詰められません。
|
|
125
|
+
- 引用は選択時に固定され、本文の生成が続いても変更されません。その他の背景情報は送信時点のメインセッション完了内容を使用します。
|
|
126
|
+
- メイン入力欄の草稿を消費したりクリアしたりすることはありません。複数メッセージにまたがる選択、入力欄、ツール出力にはメニューは表示されません。
|
|
127
|
+
- バーには「会話に追加」も用意されており、引用を既存の草稿に追加して入力欄にフォーカスします(自動送信はしません)。メッセージ送信中は追加が一時停止されます。右クリックはブラウザ本来のメニューを維持します。
|
|
128
|
+
- 本文要素内にフォーカスがあるキーボード選択に対応。Shift を離すとバーにフォーカスします。Popover API 非対応のブラウザでは fixed 浮層にフォールバックし、ホストのレイアウトによるクリッピングの影響を受ける場合があります。
|
|
129
|
+
- `dsh-better-sidebar` と領域を分離:BTW はセッション本文のみを処理し、ファイルプレビューやエディタはサイドバープラグイン本来の「会話に追加」オプションを維持し、ツールバーが重複表示されるのを防ぎます。
|
|
130
|
+
- 新しいエントリはホスト本文の DOM マークに依存します。認識できないレイアウトでは従来の右クリック動作を維持し、依然として `/btw` を利用できます。
|
|
131
|
+
|
|
132
|
+
### コマンドでのサイド質問
|
|
133
|
+
|
|
134
|
+
会話のコンテキストがあるセッションで次のように入力します:
|
|
135
|
+
|
|
136
|
+
```text
|
|
137
|
+
/btw 今の設計案を1行で要約して
|
|
138
|
+
```
|
|
139
|
+
|
|
140
|
+
| 目的 | 操作 |
|
|
141
|
+
| --- | --- |
|
|
142
|
+
| サイド質問をする | `/btw 質問内容` を入力して送信、または `/` メニューから `btw` を選択 |
|
|
143
|
+
| 回答を確認する | 入力欄の上に独立したバブルが表示されるのを待つ |
|
|
144
|
+
| 回答をコピーする | バブル右上のコピーアイコンをクリック |
|
|
145
|
+
| 折りたたむ/展開する | バブル右上の折りたたみ/展開アイコンをクリック |
|
|
146
|
+
| サイド質問をキャンセル | 生成中に対応するバブルを閉じる(メインタスクは継続) |
|
|
147
|
+
| バブルを削除する | 完了したバブルを閉じる |
|
|
148
|
+
| 続けて質問する | 再び `/btw 質問内容` を入力。毎回独立したサイド質問となります |
|
|
149
|
+
|
|
150
|
+
コマンド実行、コード変更、メインタスクの継続が必要な場合は、通常の会話から送信してください。BTW は既存のコンテキストに基づいてのみ回答します。
|
|
151
|
+
|
|
152
|
+
BTW はテキストのみを受け付けます。入力欄に画像や通常ファイルが添付されている場合はサイド質問を拒否し、入力と添付ファイルを保持します。添付ファイルを削除して再試行してください。
|
|
153
|
+
|
|
154
|
+
### 使用上の注意
|
|
155
|
+
|
|
156
|
+
- 毎回のサイド質問は互いに独立しており、質問時点でメインセッションが完了している内容を参照します。生成途中の回答や以前のサイド質問は含まれません。
|
|
157
|
+
- ページをリフレッシュするとバブルは保持されません。保存が必要な回答は事前にコピーしてください。
|
|
158
|
+
|
|
159
|
+
## 設定
|
|
160
|
+
|
|
161
|
+
以下の 2 項目はいずれも任意です。両方とも空欄にしておくと、デフォルトの純粋なテキスト回答と組み込みプロンプトが使用されます。
|
|
162
|
+
|
|
163
|
+
**プラグイン** を開き、`@michengai/dsh-btw` の行にある **設定** をクリックします。設定ページの位置は `dsh-subagent-default-model` の設定ページと同じです。
|
|
164
|
+
|
|
165
|
+
| 設定項目 | 説明 |
|
|
166
|
+
| --- | --- |
|
|
167
|
+
| **許可ツール** | `send_message` 以外にサイド質問で呼び出しを許可するツール名(1行に1つ、例: `pele_draw`)。空欄の場合はテキストのみ許可(デフォルト)。 |
|
|
168
|
+
| **カスタムプロンプト** | 組み込みプロンプトを上書きします。組み込み文言があらかじめ入力されているため直接変更可能。元に戻して保存するとデフォルトに戻ります。 |
|
|
169
|
+
|
|
170
|
+
説明:
|
|
171
|
+
|
|
172
|
+
- ホワイトリストはサイド質問が呼び出せる範囲を広げるだけであり、メインの会話を制限することは一切ありません。存在しないツール名を記述しても何も許可されません。
|
|
173
|
+
- `send_message` をホワイトリストに記述することはできません。回答をメイン会話へ返送する宛先は、サイド質問自身の親セッションのみに限定されており、ホワイトリストによって「任意の agent に送信」へ変更することはできません。
|
|
174
|
+
- カスタムプロンプトは指示のプレフィックスのみを置き換えます。ツールの権限説明および返送チャンネルの説明は常に末尾に追加され、モデルが勝手にツールを呼び出せると誤解するのを防ぎます。
|
|
175
|
+
- 変更は次回のサイド質問から直ちに反映され、プラグインの再読み込みは不要です。
|
|
176
|
+
- 権限説明内で許可されたツール名が明記されるため、ホワイトリストを緩和するとサイド質問プロンプトが変化します。これは末尾のユーザーメッセージに属し、ツール定義とシステムプロンプトはメインセッションとバイト単位で一致したまま保たれるため、メインセッションの prompt cache 再利用には影響しません。
|
|
177
|
+
|
|
178
|
+
### 構成例:サイド質問で図を描画
|
|
179
|
+
|
|
180
|
+
[`dsh-pele`](https://github.com/hesheng01/dsh-pele) は `pele_draw` ツールを提供し、Mermaid ソースコードをセッション内の SVG チャートカードとしてレンダリングします。**許可ツール** に `pele_draw` を記入すると、サイド質問でも図を描画できます。
|
|
181
|
+
|
|
182
|
+
> 注:`dsh-pele` は最近登場したプラグインで、npm には未公開であり、プラグイン市場にも未掲載のため市場では検索できません。インストールは GitHub リポジトリをクローンし、その中の `plugin` ディレクトリをプロファイルに追加して行います:
|
|
183
|
+
>
|
|
184
|
+
> ```bash
|
|
185
|
+
> git clone https://github.com/hesheng01/dsh-pele.git
|
|
186
|
+
> dsh plugin --profile <profile> add <絶対パス>/dsh-pele/plugin
|
|
187
|
+
> ```
|
|
188
|
+
>
|
|
189
|
+
> 初回導入時は Host の再起動が必要です。
|
|
190
|
+
|
|
191
|
+
## アンインストール
|
|
192
|
+
|
|
193
|
+
```powershell
|
|
194
|
+
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
|
|
195
|
+
$OutputEncoding = [System.Text.Encoding]::UTF8
|
|
196
|
+
|
|
197
|
+
dsh plugin --profile web remove @michengai/dsh-btw
|
|
198
|
+
```
|
|
199
|
+
|
|
200
|
+
DSH を再読み込みすると反映されます。停止やアップグレードによってメインセッションの記録が削除されることはありません。
|
|
201
|
+
|
|
202
|
+
## ローカル開発
|
|
203
|
+
|
|
204
|
+
```powershell
|
|
205
|
+
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
|
|
206
|
+
$OutputEncoding = [System.Text.Encoding]::UTF8
|
|
207
|
+
npm ci --ignore-scripts
|
|
208
|
+
npm run check
|
|
209
|
+
```
|
|
210
|
+
|
|
211
|
+
`npm run check` は型チェック、テスト、ビルドを実行します。
|
|
212
|
+
|
|
213
|
+
開発およびビルドのベースラインは `0.2.2-rc.1` です。`npm run test:compat` はそのベースラインでコンパイルし、各隔離ホストバージョンでテストスイートを実行します。モデルはテストアダプタを使用します。DOM コンポーネントテストはブラウザによる実機検証を代替するものではありません。
|
|
214
|
+
|
|
215
|
+
GitHub と npm の両方にそのまま実行可能な `lib` が含まれています。ソースコードを変更した場合はコミット前に `npm run build` を実行してください。
|
|
216
|
+
|
|
217
|
+
ソースコードからインストールする場合は、プロジェクトディレクトリで `dsh plugin --profile web add . --ignore-scripts` を実行し、DSH を再読み込みしてください。
|
|
218
|
+
|
|
219
|
+
## ライセンス
|
|
220
|
+
|
|
221
|
+
[Apache-2.0](LICENSE) © 2026 MichengAI。
|
package/README.md
CHANGED
|
@@ -6,98 +6,101 @@
|
|
|
6
6
|
|
|
7
7
|
# DSH BTW
|
|
8
8
|
|
|
9
|
-
|
|
9
|
+
**在 DeepSeek Harness 当前会话中随手旁问,只回答,不执行**
|
|
10
10
|
|
|
11
|
-
[简体中文](README.zh-CN.md) · [
|
|
11
|
+
[简体中文](README.zh-CN.md) · [English](README.en.md) · [日本語](README.ja.md) · [Español](README.es.md) · [Français](README.fr.md) · [Deutsch](README.de.md) · [Русский](README.ru.md) · [Português](README.pt.md)
|
|
12
12
|
|
|
13
|
-
[
|
|
13
|
+
[界面预览](#界面预览) · [安装](#安装) · [使用](#使用) · [更新日志](CHANGELOG.zh-CN.md) · [Apache-2.0](LICENSE)
|
|
14
|
+
|
|
15
|
+
[](LICENSE)
|
|
14
16
|
[](https://github.com/deepseek-ai/deepseek-harness)
|
|
15
17
|
[](https://nodejs.org/)
|
|
16
18
|
|
|
17
19
|
</div>
|
|
18
20
|
|
|
19
|
-
> DSH BTW
|
|
21
|
+
> DSH BTW 是社区维护的 DeepSeek Harness 插件,并非 DeepSeek AI 官方产品。在当前会话中输入 `/btw 问题`,即可基于已有上下文获得独立气泡回答,不打断主任务。支持 DSH Web 及集成 DSH Web 的桌面应用。`1.0.0` 起,不在支持列表中的宿主会被版本门拒绝,插件不会运行;已安装配置和主会话记录仍保留。
|
|
20
22
|
|
|
21
|
-
##
|
|
23
|
+
## 功能概览
|
|
22
24
|
|
|
23
|
-
-
|
|
24
|
-
-
|
|
25
|
-
-
|
|
26
|
-
-
|
|
27
|
-
-
|
|
28
|
-
-
|
|
29
|
-
-
|
|
25
|
+
- **上下文旁问**:根据当前会话内容解释概念、回顾结论或回答临时问题。
|
|
26
|
+
- **只回答,不执行**:不会读取新文件、联网、运行命令或修改代码。
|
|
27
|
+
- **独立答案气泡**:支持 Markdown、公式、复制、折叠、展开和关闭,可同时查看多条旁问。
|
|
28
|
+
- **不打断主任务**:旁问单独作答,答案默认不会写入主会话。
|
|
29
|
+
- **需要时才回传**:想在主对话里拿到结论时,在问题中明确要求「把答案发回主对话」,旁问会用 `send_message` 把一份自足的答案发回主会话;没有要求时不会回传。
|
|
30
|
+
- **随时取消**:关闭正在回答的气泡即可取消该旁问。
|
|
31
|
+
- **全量国际化与主题**:跟随 DSH 浅色、深色主题;自宿主 0.2.2-rc.1 起完整支持官方 8 门内置语言(中文、英语、日语、西班牙语、法语、德语、俄语、葡萄牙语),在更早的 0.2.0~0.2.1 宿主下安全回退为中英双语。
|
|
30
32
|
|
|
31
|
-
##
|
|
33
|
+
## 界面预览
|
|
32
34
|
|
|
33
|
-
###
|
|
35
|
+
### 原生 DSH 中的旁问
|
|
34
36
|
|
|
35
|
-
|
|
37
|
+
主会话保留在原来的位置,旁问答案位于输入框上方。
|
|
36
38
|
|
|
37
|
-

|
|
38
40
|
|
|
39
|
-
###
|
|
41
|
+
### 命令入口
|
|
40
42
|
|
|
41
|
-
|
|
43
|
+
输入 `/` 后,可在「指令」中选择 `btw`,也可以直接输入 `/btw 问题`。
|
|
42
44
|
|
|
43
|
-

|
|
44
46
|
|
|
45
|
-
###
|
|
47
|
+
### 独立答案气泡
|
|
46
48
|
|
|
47
|
-
|
|
49
|
+
每条旁问单独展示,右上角提供复制、折叠或展开、关闭操作。
|
|
48
50
|
|
|
49
|
-

|
|
50
52
|
|
|
51
|
-
###
|
|
53
|
+
### 旁问配置
|
|
52
54
|
|
|
53
|
-
|
|
55
|
+
打开 **插件**,选中 `@michengai/dsh-btw`,配置表单就在详情页上——放行工具与提示词两个输入框,提示词框已预填内置文案,可以直接在上面改。
|
|
54
56
|
|
|
55
|
-

|
|
56
58
|
|
|
57
|
-
###
|
|
59
|
+
### 在旁问里画图
|
|
58
60
|
|
|
59
|
-
|
|
61
|
+
把 `pele_draw` 加进白名单后,旁问也能画图。图显示在旁问面板里,主对话不受影响。
|
|
60
62
|
|
|
61
|
-

|
|
62
64
|
|
|
63
|
-
## DSH
|
|
65
|
+
## DSH 产品生态
|
|
64
66
|
|
|
65
|
-
|
|
67
|
+
想使用桌面工作台,可下载 [DSH Codex Desktop](https://github.com/MichengAI/dsh-codex-desktop/releases);已有 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 环境,可按各项目 README 按需安装。以下列出 11 个自研插件;桌面端实际随附范围以对应版本的发行说明和内置清单为准。
|
|
66
68
|
|
|
67
|
-
|
|
|
69
|
+
| 插件 | 你可以用它做什么 |
|
|
68
70
|
| --- | --- |
|
|
69
|
-
| [Codex UI](https://github.com/MichengAI/dsh-codex-ui) |
|
|
70
|
-
| [Agency Agents](https://github.com/MichengAI/dsh-agency-agents) |
|
|
71
|
-
| [Skills Manager](https://github.com/MichengAI/dsh-skills-manager) |
|
|
72
|
-
| [Archive Manager](https://github.com/MichengAI/dsh-archive-manager) |
|
|
73
|
-
| [IM Connect](https://github.com/MichengAI/dsh-im-connect) |
|
|
74
|
-
| [Automation](https://github.com/MichengAI/dsh-automation) |
|
|
75
|
-
| [BTW](https://github.com/MichengAI/dsh-btw) |
|
|
76
|
-
| [Simplify](https://github.com/MichengAI/dsh-simplify) |
|
|
77
|
-
| [PUA](https://github.com/MichengAI/dsh-pua) |
|
|
78
|
-
| [Code Review](https://github.com/MichengAI/dsh-code-review) |
|
|
79
|
-
| [Codex Pet](https://github.com/MichengAI/dsh-codex-pet) |
|
|
71
|
+
| [Codex UI](https://github.com/MichengAI/dsh-codex-ui) | 整理项目与会话、搜索任务、跳转对话轮次 |
|
|
72
|
+
| [Agency Agents](https://github.com/MichengAI/dsh-agency-agents) | 按任务选择并召唤专业角色 |
|
|
73
|
+
| [Skills Manager](https://github.com/MichengAI/dsh-skills-manager) | 统一查找、启停、创建和导入本机技能 |
|
|
74
|
+
| [Archive Manager](https://github.com/MichengAI/dsh-archive-manager) | 搜索、恢复或清理已归档会话 |
|
|
75
|
+
| [IM Connect](https://github.com/MichengAI/dsh-im-connect) | 从消息平台下任务、收回复 |
|
|
76
|
+
| [Automation](https://github.com/MichengAI/dsh-automation) | 按计划执行任务,查看每次运行的结果 |
|
|
77
|
+
| [BTW](https://github.com/MichengAI/dsh-btw) | 在当前上下文中临时旁问,不打断主任务 |
|
|
78
|
+
| [Simplify](https://github.com/MichengAI/dsh-simplify) | 用 `/simplify` 整理 Git 改动范围内的代码 |
|
|
79
|
+
| [PUA](https://github.com/MichengAI/dsh-pua) | 引导 Agent 在失败时换方法、查原因,并在完成前验证结果 |
|
|
80
|
+
| [Code Review](https://github.com/MichengAI/dsh-code-review) | 用 `/review` 发起独立 Agent 代码审查,在当前会话接收报告 |
|
|
81
|
+
| [Codex Pet](https://github.com/MichengAI/dsh-codex-pet) | 通过桌面宠物查看会话提醒、处理工具审批和问题回答 |
|
|
80
82
|
|
|
81
|
-
##
|
|
83
|
+
## 前置条件
|
|
82
84
|
|
|
83
|
-
-
|
|
84
|
-
-
|
|
85
|
-
-
|
|
86
|
-
-
|
|
85
|
+
- 已安装 DeepSeek Harness。
|
|
86
|
+
- 宿主支持范围:DeepSeek Harness `0.2.x` 全系列(`>=0.2.0-rc.1 <0.3.0-0`),已验证兼容 `0.2.0-rc.1`、`0.2.0-rc.2`、`0.2.1-rc.1`~`0.2.1-rc.5`、`0.2.2-rc.1`,并自动支持后续 `0.2.x` 的全部 0.2.x RC 版本,同代宿主升级无需重复等待发版。
|
|
87
|
+
- 语言支持范围:自 DeepSeek Harness `0.2.2-rc.1` 起原生可选全部 8 门内置语言;在 `0.2.0`~`0.2.1` 宿主下额外注册的语言保持惰性,界面安全回退为中文与英文。
|
|
88
|
+
- 不再支持 `0.2.0-rc.1` 之前的早期宿主,遇到 `0.3.0` 代际破坏性更新时将被版本门安全拦截。仍在使用 `0.1.x` 的用户请安装插件 `0.1.24`。
|
|
89
|
+
- Node.js 22+,可在终端执行 `dsh`。
|
|
87
90
|
|
|
88
|
-
##
|
|
91
|
+
## 安装
|
|
89
92
|
|
|
90
|
-
|
|
93
|
+
以下命令使用 `web` profile,请按实际环境替换。安装前停用其他提供 `/btw` 命令的插件。
|
|
91
94
|
|
|
92
|
-
###
|
|
95
|
+
### 让 Agent 帮你安装(推荐)
|
|
93
96
|
|
|
94
|
-
|
|
97
|
+
把下面这段话发给任意能够执行本机终端命令的 Agent。将 `web` 替换为实际使用的 profile;安装完成后,在 DSH 中使用本插件。
|
|
95
98
|
|
|
96
99
|
```text
|
|
97
|
-
|
|
100
|
+
请将 DSH 插件 @michengai/dsh-btw 安装到本机 web profile,执行:dsh plugin --profile web add @michengai/dsh-btw@latest --registry=https://registry.npmjs.org/。安装后执行 dsh --profile web --dump-config,确认配置包含 michengai-btw,并告诉我如何重新加载 DSH 和开始使用。
|
|
98
101
|
```
|
|
99
102
|
|
|
100
|
-
###
|
|
103
|
+
### 手动从 npm 安装
|
|
101
104
|
|
|
102
105
|
```powershell
|
|
103
106
|
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
|
|
@@ -106,86 +109,86 @@ $OutputEncoding = [System.Text.Encoding]::UTF8
|
|
|
106
109
|
dsh plugin --profile web add @michengai/dsh-btw@latest --registry=https://registry.npmjs.org/
|
|
107
110
|
```
|
|
108
111
|
|
|
109
|
-
###
|
|
112
|
+
### 重新加载
|
|
110
113
|
|
|
111
|
-
|
|
114
|
+
请在当前任务结束后安装或更新,桌面应用可能自动重载。若未生效,使用桌面应用的“重新加载”,或重启 `dsh web` 服务;仅刷新浏览器不够。
|
|
112
115
|
|
|
113
|
-
|
|
116
|
+
`0.2.0` 之前的宿主,以及 `0.2.1` alpha,安装 `@latest` 会被版本门拒绝,插件不会运行。`0.1.x` 请改装 `0.1.24`。拒绝不会删除已有配置或主会话记录。
|
|
114
117
|
|
|
115
|
-
##
|
|
118
|
+
## 使用
|
|
116
119
|
|
|
117
|
-
###
|
|
120
|
+
### 划词旁问
|
|
118
121
|
|
|
119
|
-
|
|
122
|
+
在会话单条正文中选中文字,在选区上方的横条选择「旁问」,输入问题后按 Enter 发送,或点击「解释一下」。Shift+Enter 换行,Esc 取消。回答仍显示在独立 BTW 气泡中,引用原文可展开查看。
|
|
120
123
|
|
|
121
|
-
-
|
|
122
|
-
-
|
|
123
|
-
-
|
|
124
|
-
-
|
|
125
|
-
-
|
|
126
|
-
-
|
|
127
|
-
-
|
|
124
|
+
- 支持普通段落、列表和代码块文字;一次引用最多 8000 个 UTF-16 代码单元(包括空白),超限会提示,不会截断。
|
|
125
|
+
- 引用在划词时固定,正文继续生成不会改变它;其他背景使用发送时主会话已完成的内容。
|
|
126
|
+
- 不占用或清空主输入框草稿;跨消息选区、输入框和工具输出不提供该菜单。
|
|
127
|
+
- 横条还提供「添加到对话」,将引用追加到已有草稿并聚焦输入框,不自动发送;消息提交期间暂停添加。右键保留浏览器原有菜单。
|
|
128
|
+
- 支持焦点位于正文元素内的键盘选区,释放 Shift 后聚焦横条。不支持 Popover API 的浏览器使用 fixed 浮层降级,可能受到宿主布局裁切。
|
|
129
|
+
- 与 `dsh-better-sidebar` 分区域处理:BTW 仅处理会话正文,文件预览与编辑器保留侧边栏插件原有「添加到对话」选项,不重复弹出工具条。
|
|
130
|
+
- 新入口依赖宿主正文 DOM 标记。无法识别的布局保留原有右键行为,仍可使用 `/btw`。
|
|
128
131
|
|
|
129
|
-
###
|
|
132
|
+
### 命令旁问
|
|
130
133
|
|
|
131
|
-
|
|
134
|
+
在已有上下文的会话中输入:
|
|
132
135
|
|
|
133
136
|
```text
|
|
134
|
-
/btw
|
|
137
|
+
/btw 用一句话总结刚才的方案
|
|
135
138
|
```
|
|
136
139
|
|
|
137
|
-
|
|
|
140
|
+
| 目标 | 操作 |
|
|
138
141
|
| --- | --- |
|
|
139
|
-
|
|
|
140
|
-
|
|
|
141
|
-
|
|
|
142
|
-
|
|
|
143
|
-
|
|
|
144
|
-
|
|
|
145
|
-
|
|
|
142
|
+
| 提一个旁问 | 输入 `/btw 问题` 并提交,或从 `/` 菜单选择 `btw`。 |
|
|
143
|
+
| 查看答案 | 等待输入框上方的独立气泡返回回答。 |
|
|
144
|
+
| 复制答案 | 点击气泡右上角的复制图标。 |
|
|
145
|
+
| 收起或展开 | 点击气泡右上角的折叠或展开图标。 |
|
|
146
|
+
| 取消旁问 | 在回答过程中关闭对应气泡,不取消主任务。 |
|
|
147
|
+
| 移除答案 | 关闭已完成的气泡。 |
|
|
148
|
+
| 继续提问 | 再次输入 `/btw 问题`;每次都是独立旁问。 |
|
|
146
149
|
|
|
147
|
-
|
|
150
|
+
若需要执行命令、修改代码或继续主任务,请通过普通会话提交。BTW 只能依据已有上下文作答。
|
|
148
151
|
|
|
149
|
-
BTW
|
|
152
|
+
BTW 只接受文字。输入框中附带图片或普通文件时会拒绝旁问,并保留输入和附件,请移除附件后重试。
|
|
150
153
|
|
|
151
|
-
###
|
|
154
|
+
### 使用说明
|
|
152
155
|
|
|
153
|
-
-
|
|
154
|
-
-
|
|
156
|
+
- 每次旁问相互独立,参考的是提问时主会话已完成的内容,不包含正在生成的回答或之前的旁问。
|
|
157
|
+
- 刷新页面后气泡不会保留,需要保存的答案请先复制。
|
|
155
158
|
|
|
156
|
-
##
|
|
159
|
+
## 配置
|
|
157
160
|
|
|
158
|
-
|
|
161
|
+
下面两项都是可选的。两项都留空时保持出厂行为:只允许纯文字回答,使用内置提示词。
|
|
159
162
|
|
|
160
|
-
|
|
163
|
+
打开 **插件**,找到 `@michengai/dsh-btw`,点击该行的 **配置**。配置页位置与 `dsh-subagent-default-model` 的配置页相同。
|
|
161
164
|
|
|
162
|
-
|
|
|
165
|
+
| 配置项 | 作用 |
|
|
163
166
|
| --- | --- |
|
|
164
|
-
|
|
|
165
|
-
|
|
|
167
|
+
| **放行工具** | 除 `send_message` 之外,旁问还允许调用的工具名,每行一个(例如 `pele_draw`)。留空表示只允许纯文字回答,这也是默认值。 |
|
|
168
|
+
| **自定义提示词** | 替换内置的旁问提示词。输入框已预填内置文案,可直接在上面修改;原样保存即恢复默认。 |
|
|
166
169
|
|
|
167
|
-
|
|
170
|
+
说明:
|
|
168
171
|
|
|
169
|
-
-
|
|
170
|
-
- `send_message`
|
|
171
|
-
-
|
|
172
|
-
-
|
|
173
|
-
-
|
|
172
|
+
- 白名单只放宽旁问能调用的范围,从不限制主对话;写了不存在的工具名,等于什么都没放行。
|
|
173
|
+
- `send_message` 不能写进白名单。把答案回传主对话仍然只允许发给旁问自己的父会话,白名单无法把它变成「发给任意 agent」。
|
|
174
|
+
- 自定义提示词只替换指令前缀;工具权限说明与回传通道说明始终追加在末尾,避免模型误以为可以随意调用工具。
|
|
175
|
+
- 改完对下一次旁问生效,不需要重新加载插件。
|
|
176
|
+
- 权限说明里会点名放行的工具,因此放宽白名单会改变旁问提示词。它属于末尾的用户消息,工具定义与系统提示词仍与主会话逐字节一致,不影响主会话的 prompt cache 复用。
|
|
174
177
|
|
|
175
|
-
###
|
|
178
|
+
### 示例:让旁问画图
|
|
176
179
|
|
|
177
|
-
[`dsh-pele`](https://github.com/hesheng01/dsh-pele)
|
|
180
|
+
[`dsh-pele`](https://github.com/hesheng01/dsh-pele) 提供 `pele_draw` 工具,把 Mermaid 源码渲染成会话里的 SVG 图表卡片。把 `pele_draw` 填进 **放行工具**,旁问也能画图。
|
|
178
181
|
|
|
179
|
-
>
|
|
182
|
+
> 注意:`dsh-pele` 是最近新出的插件,还没有发布到 npm,也暂时没上架插件市场,因此在插件市场里搜不到。安装方式是从 GitHub 克隆仓库,把其中的 `plugin` 目录装进 profile:
|
|
180
183
|
>
|
|
181
184
|
> ```bash
|
|
182
185
|
> git clone https://github.com/hesheng01/dsh-pele.git
|
|
183
|
-
> dsh plugin --profile <profile> add
|
|
186
|
+
> dsh plugin --profile <profile> add <绝对路径>/dsh-pele/plugin
|
|
184
187
|
> ```
|
|
185
188
|
>
|
|
186
|
-
>
|
|
189
|
+
> 首次接入需要重启 Host。
|
|
187
190
|
|
|
188
|
-
##
|
|
191
|
+
## 卸载
|
|
189
192
|
|
|
190
193
|
```powershell
|
|
191
194
|
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
|
|
@@ -194,26 +197,25 @@ $OutputEncoding = [System.Text.Encoding]::UTF8
|
|
|
194
197
|
dsh plugin --profile web remove @michengai/dsh-btw
|
|
195
198
|
```
|
|
196
199
|
|
|
197
|
-
|
|
200
|
+
重新加载 DSH 后生效。停用或升级不会删除主会话记录。
|
|
198
201
|
|
|
199
|
-
##
|
|
202
|
+
## 本地开发
|
|
200
203
|
|
|
201
204
|
```powershell
|
|
202
205
|
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
|
|
203
206
|
$OutputEncoding = [System.Text.Encoding]::UTF8
|
|
204
|
-
|
|
205
207
|
npm ci --ignore-scripts
|
|
206
208
|
npm run check
|
|
207
209
|
```
|
|
208
210
|
|
|
209
|
-
`npm run check`
|
|
211
|
+
`npm run check` 执行类型检查、测试和构建。
|
|
210
212
|
|
|
211
|
-
|
|
213
|
+
开发与构建基线为 `0.2.2-rc.1`。`npm run test:compat` 用该基线编译,再在各隔离宿主版本中分别运行测试集,模型使用测试适配器。DOM 组件测试不替代真实浏览器验收。
|
|
212
214
|
|
|
213
|
-
GitHub
|
|
215
|
+
GitHub 与 npm 都包含可直接运行的 `lib`;改了源码后,提交前运行 `npm run build`。
|
|
214
216
|
|
|
215
|
-
|
|
217
|
+
从源码安装时,在项目目录执行 `dsh plugin --profile web add . --ignore-scripts`,然后重新加载 DSH。
|
|
216
218
|
|
|
217
|
-
##
|
|
219
|
+
## 许可证
|
|
218
220
|
|
|
219
|
-
[Apache-2.0](LICENSE)
|
|
221
|
+
[Apache-2.0](LICENSE) © 2026 MichengAI。
|