dsh-conversation-links 0.1.2 → 0.1.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +203 -177
- package/README.zh-CN.md +180 -0
- package/lib/client.js +3 -1
- package/package.json +4 -3
package/README.md
CHANGED
|
@@ -1,177 +1,203 @@
|
|
|
1
|
-
# dsh-conversation-links
|
|
2
|
-
|
|
3
|
-
[](./LICENSE)
|
|
4
|
-
[](https://www.npmjs.com/package/dsh-conversation-links)
|
|
5
|
-
[](https://github.com/deepseek-ai)
|
|
6
|
-
[](#)
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
```
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
```
|
|
32
|
-
|
|
33
|
-
```
|
|
34
|
-
|
|
35
|
-
```
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
>
|
|
57
|
-
>
|
|
58
|
-
>
|
|
59
|
-
>
|
|
60
|
-
>
|
|
61
|
-
>
|
|
62
|
-
> `@
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
-
|
|
89
|
-
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
1
|
+
# dsh-conversation-links
|
|
2
|
+
|
|
3
|
+
[](./LICENSE)
|
|
4
|
+
[](https://www.npmjs.com/package/dsh-conversation-links)
|
|
5
|
+
[](https://github.com/deepseek-ai)
|
|
6
|
+
[](#)
|
|
7
|
+
|
|
8
|
+
**English** | [简体中文](./README.zh-CN.md)
|
|
9
|
+
|
|
10
|
+
Bring the record of one DSH conversation into another: mention it with `@`, drag it in from the sidebar, or open a conversation, tick a few of its messages and insert them somewhere else.
|
|
11
|
+
|
|
12
|
+
| The "Conversations" group in the `@` panel | The picker | Inserted into the composer |
|
|
13
|
+
| --- | --- | --- |
|
|
14
|
+
|  |  |  |
|
|
15
|
+
|
|
16
|
+
## Install
|
|
17
|
+
|
|
18
|
+
Either route works; reload the DSH page afterwards (`Ctrl+R` in the desktop app):
|
|
19
|
+
|
|
20
|
+
**From a GitHub Release** (no clone needed):
|
|
21
|
+
|
|
22
|
+
Download `dsh-conversation-links-<version>.tgz` from the [latest release](https://github.com/Penguin-SAMA/dsh-conversation-links/releases/latest),
|
|
23
|
+
extract it to get the `package/` directory, then:
|
|
24
|
+
|
|
25
|
+
```text
|
|
26
|
+
plugin_manager action=install_bundle target=<absolute path to the extracted package directory>
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
**From source**:
|
|
30
|
+
|
|
31
|
+
```bash
|
|
32
|
+
git clone https://github.com/Penguin-SAMA/dsh-conversation-links.git
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
```text
|
|
36
|
+
plugin_manager action=install_bundle target=<absolute path to the clone>
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
Uninstall: `plugin_manager action=set_bundle target=dsh-conversation-links enabled=false`.
|
|
40
|
+
|
|
41
|
+
> It is also published on npm (`npm i dsh-conversation-links`), but DSH's `install_bundle`
|
|
42
|
+
> takes an **absolute directory path**, so point it at `node_modules/dsh-conversation-links`
|
|
43
|
+
> when installing from npm. Everything else is the same.
|
|
44
|
+
|
|
45
|
+
## Usage
|
|
46
|
+
|
|
47
|
+
There are three ways to use it.
|
|
48
|
+
|
|
49
|
+
### 1. Mention another conversation with `@`
|
|
50
|
+
|
|
51
|
+
Type `@` in the composer: the candidate panel first lists "Files & folders", then a
|
|
52
|
+
"Conversations" group (the `@conversation-link` source this plugin registers). Picking a
|
|
53
|
+
conversation inserts a conversation chip into the composer; on send, the host attaches a
|
|
54
|
+
read-only snapshot of that conversation as a separate user message (`## Referenced sessions`).
|
|
55
|
+
|
|
56
|
+
> **Why this plugin registers its own `@` source:** the built-in DSH source
|
|
57
|
+
> (`@deepseek-ai/dsh-client-ui-reference`) asks the host remote
|
|
58
|
+
> `sessionReferenceResolver.candidates` for its conversation candidates, and handles failure
|
|
59
|
+
> as `result.ok ? result.value : []` — one remote error **silently degrades to an empty
|
|
60
|
+
> array**. File candidates still render, so `@` shows only "Files & folders" and no
|
|
61
|
+
> conversations at all (that is exactly what happened on this machine). This plugin's
|
|
62
|
+
> `@conversation-link` source reads the client-side session list (`sessions.list`) instead
|
|
63
|
+
> and does not depend on the host remote, so the group can no longer vanish silently.
|
|
64
|
+
>
|
|
65
|
+
> Both sources insert the same wire format, `@[title](dsh-session:<base64url>)`, so it is
|
|
66
|
+
> fully compatible with a hand-typed `@` and with DSH's own reference chips. Snapshot
|
|
67
|
+
> injection on send is still done by the built-in `@deepseek-ai/dsh-session-reference`;
|
|
68
|
+
> this plugin does not reimplement it.
|
|
69
|
+
|
|
70
|
+
Implementation notes (read before touching this code):
|
|
71
|
+
|
|
72
|
+
- `candidates(projection, { query, quoted, drilled, signal })` **must return a Promise / be
|
|
73
|
+
declared `async`**: the trigger controller does `source.candidates(...).then(...)`, and a
|
|
74
|
+
synchronous array throws — the whole group then disappears without a trace.
|
|
75
|
+
- Each candidate carries its own `section` (`t("sectionSessions")` → "Conversations"), which
|
|
76
|
+
together with `showGroupTitle: false` forms its own group.
|
|
77
|
+
- `onPick` must return `{ insert: { source, ref, label, appearance: "session", clipboardText } }`
|
|
78
|
+
to insert a real chip; returning `{ text }` only inserts the raw wire text (the editor does
|
|
79
|
+
not decorate it into a chip live).
|
|
80
|
+
- Register with `ctx.inject(["inputTriggers"], ...)` + `owner.effect(() => triggers.registerSource(...))`,
|
|
81
|
+
and tolerate "already registered" with try/catch (the same plugin can be mounted twice).
|
|
82
|
+
|
|
83
|
+
### 2. Drag a conversation from the sidebar into the composer
|
|
84
|
+
|
|
85
|
+
Press and hold a conversation row in the sidebar, drag it onto any conversation's composer,
|
|
86
|
+
and release:
|
|
87
|
+
|
|
88
|
+
- the composer shows a dashed highlight while you drag over it;
|
|
89
|
+
- on release, a reference chip for that conversation is inserted into that composer;
|
|
90
|
+
- the drag itself is still DSH's original "reorder workspaces" drag — this plugin only
|
|
91
|
+
listens in the capture phase and does not change the original behaviour.
|
|
92
|
+
|
|
93
|
+
### 3. Open the picker and tick the messages you want
|
|
94
|
+
|
|
95
|
+
Two entry points:
|
|
96
|
+
|
|
97
|
+
- **the "conversation reference" button at the left of the composer** (`conversation.input.left`,
|
|
98
|
+
order 40) — the source conversation defaults to the current one and can be switched;
|
|
99
|
+
- **the inline button on a sidebar row while hovering it** (`sidebar.workspaces.session.row.action`,
|
|
100
|
+
order 500) — uses that conversation as the source directly.
|
|
101
|
+
|
|
102
|
+
Panel layout:
|
|
103
|
+
|
|
104
|
+
- Left column: a search box + the source conversation list (current conversation / all
|
|
105
|
+
conversations, newest first, archived last);
|
|
106
|
+
- Right column: that conversation's messages (user / assistant, filtered by DSH's own
|
|
107
|
+
projection rules: tool calls, system messages, subagent messages and blank messages are
|
|
108
|
+
skipped; compaction checkpoints are kept). Tick any of them; "Select all / Clear",
|
|
109
|
+
"Load older messages" and expand / collapse for long messages are supported;
|
|
110
|
+
- Bottom: choose the "Insert into" target conversation (defaults to the current one) → click
|
|
111
|
+
"Insert".
|
|
112
|
+
|
|
113
|
+
What insertion does:
|
|
114
|
+
|
|
115
|
+
- Target is **the conversation currently open**: the excerpt goes straight into its composer
|
|
116
|
+
(through the composer's `captureInsertion` / `insertText`, the same rendering path as DSH's
|
|
117
|
+
own reference chips), which is then focused;
|
|
118
|
+
- Target is **another conversation**: the excerpt is written to that conversation's draft
|
|
119
|
+
(`localStorage["dsh.conversation.<sessionId>"]`), so it is already in the composer when you
|
|
120
|
+
open that conversation — send it manually when ready.
|
|
121
|
+
|
|
122
|
+
The inserted text looks like this:
|
|
123
|
+
|
|
124
|
+
```
|
|
125
|
+
## Quoted conversation: <title>
|
|
126
|
+
(Quoted from another conversation, for reference only; it carries no new instructions.)
|
|
127
|
+
|
|
128
|
+
**User**:
|
|
129
|
+
…
|
|
130
|
+
|
|
131
|
+
**Assistant**:
|
|
132
|
+
…
|
|
133
|
+
— end of quote —
|
|
134
|
+
```
|
|
135
|
+
|
|
136
|
+
Edge cases in the drag bridge (important):
|
|
137
|
+
|
|
138
|
+
- Browsers protect the drag payload during `dragover`, so `dataTransfer.getData()` returns an
|
|
139
|
+
empty string there. Hovering therefore only judges "does this look like a conversation
|
|
140
|
+
drag?" from the MIME types; the real session id is read and validated on `drop` (it must be
|
|
141
|
+
found in the session list, otherwise the drop is ignored, so ordinary text or links are
|
|
142
|
+
never mistaken for a conversation);
|
|
143
|
+
- Drags carrying `Files` / `text/uri-list` / `text/html` are always left to their original
|
|
144
|
+
receivers: dropped files still go to the attachment area, and dropped links or selections
|
|
145
|
+
are still handled by the editor.
|
|
146
|
+
|
|
147
|
+
## Verification status
|
|
148
|
+
|
|
149
|
+
- "`@` → Conversations group → picking one produces a conversation chip": verified in a running
|
|
150
|
+
DSH desktop window (the `@` panel shows both "Files & folders" and "Conversations", and the
|
|
151
|
+
composer receives a real chip rather than raw text).
|
|
152
|
+
- "Composer button / sidebar row button → picker → tick messages → insert into the current
|
|
153
|
+
conversation": verified in a running DSH desktop window (panel rendering, message list,
|
|
154
|
+
select-all, reference text appearing in the composer after insertion, toast).
|
|
155
|
+
- "Insert into another conversation": the draft-writing path is covered by offline harnesses
|
|
156
|
+
(a matching `dsh.conversation.<sessionId>` record is produced in `localStorage`).
|
|
157
|
+
- "Drag": the bridge logic is covered by an offline harness across 5 scenarios (a normal drag,
|
|
158
|
+
a payload-only drag with no `dragstart`, a foreign drag, a drop outside the composer, and
|
|
159
|
+
the payload shape) — all behave as intended. **Synthetic mouse events cannot start a real
|
|
160
|
+
HTML5 drag session in Chromium/Electron**, though, so this one could not be reproduced in
|
|
161
|
+
the UI by script; it needs one drag with a real mouse to confirm.
|
|
162
|
+
|
|
163
|
+
## Known limitations
|
|
164
|
+
|
|
165
|
+
1. When the target is another conversation, the messages land in **that conversation's
|
|
166
|
+
persisted draft**, not in its live editor (DSH only binds a draft writer to mounted
|
|
167
|
+
conversations). Open that conversation to see it, then send when ready.
|
|
168
|
+
2. Dragging relies on native HTML5 DnD and does not work on touch devices (use the two button
|
|
169
|
+
entry points there).
|
|
170
|
+
3. Records are read through `sessions.retain()` + `eventSource`, with no extra host HTTP route;
|
|
171
|
+
the host half of this plugin (`lib/index.js`) is therefore an empty implementation and all
|
|
172
|
+
logic lives on the client.
|
|
173
|
+
4. What gets inserted is a **text snapshot**, not a live link; later changes to the target
|
|
174
|
+
conversation do not flow back.
|
|
175
|
+
|
|
176
|
+
## Files
|
|
177
|
+
|
|
178
|
+
| File | Purpose |
|
|
179
|
+
| --- | --- |
|
|
180
|
+
| `package.json` | Bundle manifest: `dsh.bundle.patch` + `dsh.client` |
|
|
181
|
+
| `cordis.patch.yml` | Inserts the single `conversation-links` row |
|
|
182
|
+
| `lib/index.js` | Host side, intentionally empty (`apply() {}`) |
|
|
183
|
+
| `lib/client.js` | All logic: the `@` conversation source, drag bridge, picker, insertion, i18n, styles |
|
|
184
|
+
| `locale/zh.json`, `locale/en.json` | Title and description shown by the market |
|
|
185
|
+
| `icon.svg` | Plugin icon (vector, used inside DSH) |
|
|
186
|
+
| `icon.png` | Plugin icon (256×256 raster, for the plugin market) |
|
|
187
|
+
| `screenshots.json` | Market screenshot list (relative paths) |
|
|
188
|
+
| `docs/images/` | README screenshots |
|
|
189
|
+
| `README.zh-CN.md` | Chinese version of this document |
|
|
190
|
+
|
|
191
|
+
## Compatibility
|
|
192
|
+
|
|
193
|
+
- DSH `>= 0.2.0-rc.2`, Node `>= 18`, Web platform (`dsh.client.platform = "web"`).
|
|
194
|
+
- DSH internals used (all public client services / slots — please open an issue if an upgrade
|
|
195
|
+
breaks them): `conversation.input.shell(id)`, `shell.actions.captureInsertion/insertText/setDraft`,
|
|
196
|
+
`sessions.retain/list`, `inputTriggers.registerSource`, `slots.inject/register`,
|
|
197
|
+
`uiSession.current`. DOM selectors: `[data-row-key^="session:"]` (sidebar rows),
|
|
198
|
+
`[data-composer-card]` / `[data-composer-seat]` / `[data-conversation-region="composer"]`
|
|
199
|
+
(the composer), `[data-conversation-session]` (DOM → session id).
|
|
200
|
+
|
|
201
|
+
## License
|
|
202
|
+
|
|
203
|
+
[MIT](./LICENSE)
|
package/README.zh-CN.md
ADDED
|
@@ -0,0 +1,180 @@
|
|
|
1
|
+
# dsh-conversation-links（对话引用）
|
|
2
|
+
|
|
3
|
+
[](./LICENSE)
|
|
4
|
+
[](https://www.npmjs.com/package/dsh-conversation-links)
|
|
5
|
+
[](https://github.com/deepseek-ai)
|
|
6
|
+
[](#)
|
|
7
|
+
|
|
8
|
+
[English](./README.md) | **简体中文**
|
|
9
|
+
|
|
10
|
+
把一段 DSH 对话里的记录带到另一段对话：`@` 引用、从左侧栏拖进来、或者打开一段对话勾选其中的消息插到别处。
|
|
11
|
+
|
|
12
|
+
| `@` 面板里的「对话」分组 | 挑选面板 | 插入到输入框 |
|
|
13
|
+
| --- | --- | --- |
|
|
14
|
+
|  |  |  |
|
|
15
|
+
|
|
16
|
+
## 安装
|
|
17
|
+
|
|
18
|
+
两种方式，任选其一（装完刷新 DSH 页面即可，桌面上可 Ctrl+R）：
|
|
19
|
+
|
|
20
|
+
**从 GitHub Release 下载**（无需 clone）：
|
|
21
|
+
|
|
22
|
+
下载 [最新 Release](https://github.com/Penguin-SAMA/dsh-conversation-links/releases/latest) 的
|
|
23
|
+
`dsh-conversation-links-<version>.tgz`，解压得到 `package/` 目录，然后：
|
|
24
|
+
|
|
25
|
+
```text
|
|
26
|
+
plugin_manager action=install_bundle target=<解压出的 package 目录绝对路径>
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
**从源码 clone**：
|
|
30
|
+
|
|
31
|
+
```bash
|
|
32
|
+
git clone https://github.com/Penguin-SAMA/dsh-conversation-links.git
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
```text
|
|
36
|
+
plugin_manager action=install_bundle target=<clone 目录的绝对路径>
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
卸载：`plugin_manager action=set_bundle target=dsh-conversation-links enabled=false`。
|
|
40
|
+
|
|
41
|
+
> npm 上也发布了（`npm i dsh-conversation-links`），但 DSH 的 `install_bundle` 需要**绝对目录路径**，
|
|
42
|
+
> 所以从 npm 安装时请指向 `node_modules/dsh-conversation-links` 的绝对路径，其余同上。
|
|
43
|
+
|
|
44
|
+
## 用法
|
|
45
|
+
|
|
46
|
+
三种用法：
|
|
47
|
+
|
|
48
|
+
### 1. `@` 引用另一段对话
|
|
49
|
+
|
|
50
|
+
在输入框里输入 `@`，候选面板先列「文件与文件夹」，再列「对话」分组（本插件注册的
|
|
51
|
+
`@conversation-link` 源）；选中某个对话后输入框里出现一个对话 chip，发送时主进程会把该对话的
|
|
52
|
+
只读快照作为一条独立的 user 消息附在后面（`## Referenced sessions`）。
|
|
53
|
+
|
|
54
|
+
> **为什么本插件要自己注册一个 `@` 源**：DSH 自带的 `@` 源
|
|
55
|
+
> （`@deepseek-ai/dsh-client-ui-reference`）把「对话」候选交给宿主远端
|
|
56
|
+
> `sessionReferenceResolver.candidates` 去取，而它对失败的处理是
|
|
57
|
+
> `result.ok ? result.value : []`——远端一旦报错就**静默降级成空数组**，文件候选照常显示，
|
|
58
|
+
> 于是 `@` 里只剩「文件与文件夹」、看不到任何对话（本机就是这个现象）。
|
|
59
|
+
> 本插件的 `@conversation-link` 源改成直接读客户端会话列表（`sessions.list`），不依赖宿主远端，
|
|
60
|
+
> 因此不会再静默消失。
|
|
61
|
+
>
|
|
62
|
+
> 两个源插入的都是同一套传输格式 `@[标题](dsh-session:<base64url>)`，所以与手工 `@` 以及
|
|
63
|
+
> DSH 自带的引用 chip 完全一致；发送后的快照注入仍由 DSH 内置的
|
|
64
|
+
> `@deepseek-ai/dsh-session-reference` 完成，本插件不重复实现。
|
|
65
|
+
|
|
66
|
+
实现要点（改这段代码前必读）：
|
|
67
|
+
|
|
68
|
+
- `candidates(projection, { query, quoted, drilled, signal })` **必须返回 Promise / 写成 `async`**：
|
|
69
|
+
触发器控制器是 `source.candidates(...).then(...)`，返回同步数组会抛错，整个分组静默消失。
|
|
70
|
+
- 每个候选项带自己的 `section`（`t("sectionSessions")` → 「对话」/「Conversations」），
|
|
71
|
+
配合 `showGroupTitle: false` 独立成组。
|
|
72
|
+
- `onPick` 必须返回 `{ insert: { source, ref, label, appearance: "session", clipboardText } }`
|
|
73
|
+
才会插入真正的 chip；返回 `{ text }` 只会插入原始 wire text（编辑器不会实时把它渲染成 chip）。
|
|
74
|
+
- 注册用 `ctx.inject(["inputTriggers"], ...)` + `owner.effect(() => triggers.registerSource(...))`，
|
|
75
|
+
并对「重复注册」做 try/catch 容错（同一插件可能被挂载多次）。
|
|
76
|
+
|
|
77
|
+
### 2. 从左侧栏拖拽一段对话到输入框
|
|
78
|
+
|
|
79
|
+
直接按住左侧栏里的对话条目，拖到任意对话的输入框（composer）上松手：
|
|
80
|
+
|
|
81
|
+
- 拖动经过输入框时输入框会显示虚线高亮；
|
|
82
|
+
- 松手后即在该对话的输入框里插入这条对话的引用 chip；
|
|
83
|
+
- 拖动本身仍然是 DSH 原有的「调整工作区顺序」拖拽，本插件只是在 capture 阶段旁路监听，
|
|
84
|
+
不改动原有行为。
|
|
85
|
+
|
|
86
|
+
### 3. 打开记录挑选面板，勾选消息插入
|
|
87
|
+
|
|
88
|
+
两个入口：
|
|
89
|
+
|
|
90
|
+
- **输入框左侧的「对话引用」按钮**（`conversation.input.left`，order 40）——来源对话默认当前对话，可切换；
|
|
91
|
+
- **左侧栏对话行悬停时的行内按钮**（`sidebar.workspaces.session.row.action`，order 500）——直接以该对话为来源。
|
|
92
|
+
|
|
93
|
+
面板结构：
|
|
94
|
+
|
|
95
|
+
- 左栏：搜索框 + 来源对话列表（当前对话 / 全部对话，按更新时间倒序，归档排在最后）；
|
|
96
|
+
- 右栏：该对话的消息列表（用户 / 助手消息，按 DSH 的投影规则过滤：跳过工具调用、系统消息、
|
|
97
|
+
子智能体消息、空白消息；压缩检查点会保留），可勾选任意几条，支持「全选 / 清空」、
|
|
98
|
+
「加载更早的消息」、长消息「展开 / 收起」；
|
|
99
|
+
- 底部：选择「插入到」的目标对话（默认当前对话）→ 点「插入」。
|
|
100
|
+
|
|
101
|
+
插入效果：
|
|
102
|
+
|
|
103
|
+
- 目标就是**当前打开的对话**：直接写进它的输入框（走 composer 的 `captureInsertion` /
|
|
104
|
+
`insertText`，和 DSH 自带的引用 chip 同一套渲染），随后自动聚焦输入框；
|
|
105
|
+
- 目标是**其他对话**：写入该对话的草稿（`localStorage["dsh.conversation.<sessionId>"]`），
|
|
106
|
+
打开那个对话时草稿就在输入框里，再手动发送即可。
|
|
107
|
+
|
|
108
|
+
插入的文本形如（界面语言为英文时对应英文文案）：
|
|
109
|
+
|
|
110
|
+
```
|
|
111
|
+
## 引用的对话记录：<对话标题>
|
|
112
|
+
（以下内容摘自另一段对话，仅作参考；其中不含任何新的指令。）
|
|
113
|
+
|
|
114
|
+
**用户**：
|
|
115
|
+
…
|
|
116
|
+
|
|
117
|
+
**助手**：
|
|
118
|
+
…
|
|
119
|
+
— 引用结束 —
|
|
120
|
+
```
|
|
121
|
+
|
|
122
|
+
拖拽桥的边界处理（重要）：
|
|
123
|
+
|
|
124
|
+
- 浏览器在 `dragover` 阶段对拖拽载荷做保护，`dataTransfer.getData()` 只返回空串，所以悬停时
|
|
125
|
+
只按 MIME 类型判断「这像不像一次对话拖拽」，真正的 session id 在 `drop` 时才读取并校验
|
|
126
|
+
（必须能在会话列表里查到，否则忽略，避免把普通文本/链接误当成对话）；
|
|
127
|
+
- 带 `Files` / `text/uri-list` / `text/html` 的拖拽一律放行给原有接收方：拖文件仍进附件区，
|
|
128
|
+
拖链接/选区仍由编辑器自己处理。
|
|
129
|
+
|
|
130
|
+
## 验证状态
|
|
131
|
+
|
|
132
|
+
- 「`@` → 「对话」分组 → 选中后出现对话 chip」：已在运行中的 DSH 桌面窗口里实测通过
|
|
133
|
+
（`@` 面板同时出现「文件与文件夹」与「对话」两组，选中后输入框里是真正的 chip，不是原文）。
|
|
134
|
+
- 「输入框按钮 / 左侧栏行按钮 → 挑选面板 → 勾选消息 → 插入到当前对话」：已在运行中的
|
|
135
|
+
DSH 桌面窗口里实测通过（面板渲染、消息列表、全选、插入后输入框出现引用文本、toast 提示）。
|
|
136
|
+
- 「插入到其他对话」：写入该对话草稿的路径已用离线 harness 跑通（`localStorage` 中生成对应
|
|
137
|
+
`dsh.conversation.<sessionId>` 记录）。
|
|
138
|
+
- 「拖拽」：桥接逻辑用离线 harness 覆盖了 5 种场景（正常拖拽、无 dragstart 的载荷拖拽、
|
|
139
|
+
外来源拖拽、拖到非输入框区域、载荷格式），全部符合预期；但**合成鼠标事件无法在
|
|
140
|
+
Chromium/Electron 里启动真正的 HTML5 拖拽会话**，所以这一条没能在界面上用脚本复现，
|
|
141
|
+
需要用真实鼠标拖一次确认。
|
|
142
|
+
|
|
143
|
+
## 已知限制
|
|
144
|
+
|
|
145
|
+
1. 目标是其他对话时，消息进入的是**该对话的持久化草稿**，不是它的实时编辑器（DSH 只给
|
|
146
|
+
已挂载的对话绑定草稿写入器）；打开该对话即可看到，按需再发送。
|
|
147
|
+
2. 拖拽依赖浏览器原生 HTML5 DnD，触屏设备不生效（触屏请用两个按钮入口）。
|
|
148
|
+
3. 记录读取走 `sessions.retain()` + `eventSource`，不额外增加宿主 HTTP 路由；因此插件的宿主侧
|
|
149
|
+
`lib/index.js` 是空实现，全部逻辑在客户端。
|
|
150
|
+
4. 插入的是一份**文本快照**，不是活链接；目标对话后续变化不会回流。
|
|
151
|
+
|
|
152
|
+
## 文件
|
|
153
|
+
|
|
154
|
+
| 文件 | 说明 |
|
|
155
|
+
| --- | --- |
|
|
156
|
+
| `package.json` | bundle 清单：`dsh.bundle.patch` + `dsh.client` |
|
|
157
|
+
| `cordis.patch.yml` | 插入 `conversation-links` 一行 |
|
|
158
|
+
| `lib/index.js` | 宿主侧空实现（`apply() {}`） |
|
|
159
|
+
| `lib/client.js` | 全部逻辑：`@` 对话源、拖拽桥、挑选面板、插入、i18n、样式 |
|
|
160
|
+
| `locale/zh.json`、`locale/en.json` | 市场展示用的标题与描述 |
|
|
161
|
+
| `icon.svg` | 插件图标（矢量，供 DSH 内部使用） |
|
|
162
|
+
| `icon.png` | 插件图标（256×256 栅格，供插件市场收录） |
|
|
163
|
+
| `screenshots.json` | 市场展示截图清单（相对路径） |
|
|
164
|
+
| `docs/images/` | README 截图 |
|
|
165
|
+
| `README.md` | 英文说明（GitHub / npm 默认显示） |
|
|
166
|
+
| `README.zh-CN.md` | 本文档（中文版） |
|
|
167
|
+
|
|
168
|
+
## 兼容性
|
|
169
|
+
|
|
170
|
+
- DSH `>= 0.2.0-rc.2`，Node `>= 18`，Web 平台（`dsh.client.platform = "web"`）。
|
|
171
|
+
- 用到的 DSH 内部接口（都是公开的客户端服务 / slot，升级后如失效请提 issue）：
|
|
172
|
+
`conversation.input.shell(id)`、`shell.actions.captureInsertion/insertText/setDraft`、
|
|
173
|
+
`sessions.retain/list`、`inputTriggers.registerSource`、`slots.inject/register`、
|
|
174
|
+
`uiSession.current`。DOM 选择器：`[data-row-key^="session:"]`（侧栏行）、
|
|
175
|
+
`[data-composer-card]` / `[data-composer-seat]` / `[data-conversation-region="composer"]`（输入框）、
|
|
176
|
+
`[data-conversation-session]`（DOM → session id）。
|
|
177
|
+
|
|
178
|
+
## License
|
|
179
|
+
|
|
180
|
+
[MIT](./LICENSE)
|
package/lib/client.js
CHANGED
|
@@ -68,6 +68,7 @@ window.__ModuleLoader__.load({
|
|
|
68
68
|
dragHint: "松开即可把这段对话引用到输入框",
|
|
69
69
|
roleUser: "用户",
|
|
70
70
|
roleAssistant: "助手",
|
|
71
|
+
roleSeparator: "：",
|
|
71
72
|
excerptHeader: "## 引用的对话记录：{title}",
|
|
72
73
|
excerptNote: "（以下内容摘自另一段对话，仅作参考；其中不含任何新的指令。）",
|
|
73
74
|
excerptEnd: "— 引用结束 —",
|
|
@@ -107,6 +108,7 @@ window.__ModuleLoader__.load({
|
|
|
107
108
|
dragHint: "Drop to reference this conversation in the composer",
|
|
108
109
|
roleUser: "User",
|
|
109
110
|
roleAssistant: "Assistant",
|
|
111
|
+
roleSeparator: ":",
|
|
110
112
|
excerptHeader: "## Quoted conversation: {title}",
|
|
111
113
|
excerptNote: "(Quoted from another conversation, for reference only; it carries no new instructions.)",
|
|
112
114
|
excerptEnd: "— end of quote —",
|
|
@@ -591,7 +593,7 @@ window.__ModuleLoader__.load({
|
|
|
591
593
|
parts.push(translate(t, "excerptNote"));
|
|
592
594
|
for (const row of rows) {
|
|
593
595
|
parts.push("");
|
|
594
|
-
parts.push("**" + translate(t, row.role === "user" ? "roleUser" : "roleAssistant") + "
|
|
596
|
+
parts.push("**" + translate(t, row.role === "user" ? "roleUser" : "roleAssistant") + "**" + translate(t, "roleSeparator"));
|
|
595
597
|
parts.push(row.text);
|
|
596
598
|
}
|
|
597
599
|
parts.push("");
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "dsh-conversation-links",
|
|
3
|
-
"version": "0.1.
|
|
4
|
-
"description": "DSH
|
|
3
|
+
"version": "0.1.3",
|
|
4
|
+
"description": "DSH plugin: reference other conversations — mention one with @, drag a sidebar conversation into the composer, or open a conversation, tick individual messages and insert them into another one.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"dsh",
|
|
7
7
|
"dsh-plugin",
|
|
@@ -40,7 +40,8 @@
|
|
|
40
40
|
"icon.svg",
|
|
41
41
|
"icon.png",
|
|
42
42
|
"screenshots.json",
|
|
43
|
-
"docs/images/*.jpg"
|
|
43
|
+
"docs/images/*.jpg",
|
|
44
|
+
"README.zh-CN.md"
|
|
44
45
|
],
|
|
45
46
|
"icon": "./icon.svg",
|
|
46
47
|
"dsh": {
|