@dungsil/dsh-plugin-ui-sidebar-inbox 0.2.3 → 0.4.0
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 -0
- package/README.de.md +109 -0
- package/README.en.md +109 -0
- package/README.es.md +109 -0
- package/README.fr.md +109 -0
- package/README.ja.md +109 -0
- package/README.md +74 -54
- package/README.pt.md +109 -0
- package/README.ru.md +109 -0
- package/README.zh.md +109 -0
- package/dist/client.js +1200 -52
- package/locale/de.json +20 -0
- package/locale/es.json +20 -0
- package/locale/fr.json +20 -0
- package/locale/ja.json +20 -0
- package/locale/pt.json +20 -0
- package/locale/ru.json +20 -0
- package/package.json +28 -15
- package/assets/sidebar-preview-dark.webp +0 -0
- package/assets/sidebar-preview.webp +0 -0
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 dungsil
|
|
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.de.md
ADDED
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
[한국어](./README.md) | [English](./README.en.md) | [简体中文](./README.zh.md) | [日本語](./README.ja.md) | [Español](./README.es.md) | [Français](./README.fr.md) | **Deutsch** | [Português](./README.pt.md) | [Русский](./README.ru.md)
|
|
2
|
+
|
|
3
|
+
# Sidebar Inbox · Seitenleisten-Posteingang
|
|
4
|
+
|
|
5
|
+
`@dungsil/dsh-plugin-ui-sidebar-inbox`
|
|
6
|
+
|
|
7
|
+
Das Plugin ordnet die Sitzungsliste in der DSH-Seitenleiste **nach Status**, ähnlich wie T3 Code Nightly. Sitzungen, die auf Ihre Antwort warten, rücken nach oben; laufende und archivierte Sitzungen sammeln sich unten. Das Aussehen der Seitenleiste und die vorhandenen Sitzungszeilen bleiben unverändert.
|
|
8
|
+
|
|
9
|
+
## Vorschau
|
|
10
|
+
|
|
11
|
+
**Hell**: Links sind Archiviert und Vorübergehend ausgeblendet eingeklappt, rechts ausgeklappt. Die Überschriften zeigen die Sitzungsanzahl.
|
|
12
|
+
|
|
13
|
+
<img src="./assets/sidebar-preview-de-light.webp" alt="Sidebar Inbox im hellen Design: angeheftete und Posteingangs-Sitzungen sowie In Arbeit, Archiviert und Vorübergehend ausgeblendet mit Anzahl; die letzten beiden links eingeklappt, rechts ausgeklappt" width="720" />
|
|
14
|
+
|
|
15
|
+
**Dunkel**: Dieselben Beispielsitzungen mit Archiviert und Vorübergehend ausgeblendet im eingeklappten und ausgeklappten Zustand.
|
|
16
|
+
|
|
17
|
+
<img src="./assets/sidebar-preview-de-dark.webp" alt="Sidebar Inbox im dunklen Design: angeheftete und Posteingangs-Sitzungen sowie In Arbeit, Archiviert und Vorübergehend ausgeblendet mit Anzahl; die letzten beiden links eingeklappt, rechts ausgeklappt" width="720" />
|
|
18
|
+
|
|
19
|
+
## Verwendung
|
|
20
|
+
|
|
21
|
+
1. Aktivieren Sie **Sidebar Inbox / Seitenleisten-Posteingang** in der Plugin-Verwaltung von DSH.
|
|
22
|
+
2. Bei der ersten Aktivierung werden die Ansichtsoptionen automatisch auf **Gruppieren nach: In einer Liste** und **Bestellen nach: Agentenaktivität** gesetzt. Der Sitzungsfilter bleibt unverändert.
|
|
23
|
+
3. Um es später wieder einzuschalten, wählen Sie dieselben beiden Einträge unter **Optionen anzeigen** in der Seitenleiste.
|
|
24
|
+
4. Um es nicht mehr zu verwenden, stellen Sie **Bestellen nach** auf **Handbuch** (manuelle Sortierung) oder **Zuletzt aktualisiert** um, oder wählen Sie **Agentenaktivität** erneut. Bei erneuter Auswahl kehrt die Liste zu der Sortierung zurück, die Sie vor dem Einschalten von Agentenaktivität verwendet haben.
|
|
25
|
+
|
|
26
|
+
## Platzierung der Sitzungen
|
|
27
|
+
|
|
28
|
+
| Bereich | Enthaltene Sitzungen |
|
|
29
|
+
| -------- | ---------------------------------------------------------------------------------------------------------------------------------- |
|
|
30
|
+
| Pinned | In DSH angeheftete Sitzungen. Sie bleiben hier, auch wenn sie laufen oder auf eine Antwort warten. |
|
|
31
|
+
| Inbox | Sitzungen, die eine Antwortprüfung, Genehmigung, Planprüfung oder Benutzereingabe benötigen, sowie noch nicht geöffnete Sitzungen. |
|
|
32
|
+
| Working | Sitzungen, in denen ein Agent oder Subagent läuft. Sie wechseln in Inbox, sobald eine Anfrage entsteht. |
|
|
33
|
+
| Archived | In DSH archivierte Sitzungen. Sie bleiben hier, unabhängig davon, ob sie angeheftet sind oder laufen. |
|
|
34
|
+
|
|
35
|
+
- Innerhalb jedes Bereichs stehen die zuletzt aktualisierten Sitzungen zuerst. Eine leere neue Sitzung bleibt wie in DSH ganz oben.
|
|
36
|
+
- Diese Platzierung gilt **nur, wenn Gruppieren nach auf In einer Liste steht**. Beim Wechsel zu `WorkSpace` oder `Arbeitsbereichsbaum` wird die Sortierung nach Agentenaktivität aufgehoben und die Standardanzeige von DSH wiederhergestellt.
|
|
37
|
+
|
|
38
|
+
## Bildschirmaufbau
|
|
39
|
+
|
|
40
|
+
Die Liste der Seitenleiste ist in eine obere Liste und einen unteren Bereich geteilt, die unabhängig voneinander scrollen.
|
|
41
|
+
|
|
42
|
+
- **Obere Liste**: Zeigt Pinned und Inbox ohne Überschriften.
|
|
43
|
+
- **Unterer Bereich**: Working und Archived teilen sich einen Scrollbereich. Ihre Überschriften und Sitzungen zusammen nehmen höchstens 50 % der Höhe der Seitenleistenliste ein.
|
|
44
|
+
- **Aus- und Einklappen**: Zu Beginn ist Working ausgeklappt und Archived eingeklappt. Klicken Sie auf die Überschrift eines Bereichs oder aktivieren Sie sie per Tastatur, um ihn aus- oder einzuklappen. Dieser Zustand wird nicht gespeichert; nach dem Neuladen gilt wieder der Ausgangszustand.
|
|
45
|
+
- **Wann Archived einklappbar ist**: Nur wenn der Sitzungsfilter `Alle Gespräche (archiviert anzeigen)` ist. Beim Filter `Nur archiviert` bilden die archivierten Sitzungen die gesamte Liste und werden daher immer ausgeklappt angezeigt.
|
|
46
|
+
|
|
47
|
+
## Archivierung
|
|
48
|
+
|
|
49
|
+
Ob eine Sitzung archiviert ist, verwaltet DSH. Archivieren und Dearchivieren erfolgen über das `⋯`-Menü der Sitzung; dieses Plugin speichert oder ändert den Archivstatus nie.
|
|
50
|
+
|
|
51
|
+
- Archivierte Sitzungen lassen sich jederzeit aus dem unteren Bereich wiederherstellen.
|
|
52
|
+
- Läuft eine Sitzung oder wartet sie auf Ihre Antwort, stoppt DSH ihre Arbeit vor dem Archivieren.
|
|
53
|
+
|
|
54
|
+
## Sprachen
|
|
55
|
+
|
|
56
|
+
Listenüberschriften und Menüeinträge folgen der Sprache der DSH-Oberfläche. In der deutschen Oberfläche heißt der Sortiereintrag `Agentenaktivität`, die Bereichsüberschriften heißen `In Arbeit` und `Archiviert`. Das Plugin bringt seine eigenen Übersetzungen mit; ein separates Sprachpaket ist nicht nötig.
|
|
57
|
+
|
|
58
|
+
## Detailverhalten
|
|
59
|
+
|
|
60
|
+
### Sortierauswahl beibehalten
|
|
61
|
+
|
|
62
|
+
- Die automatische Einstellung wird **nur einmal, bei der ersten Aktivierung** einer Neuinstallation ohne frühere Sortierdaten angewendet. Danach bleiben Ihre Ansichtsoptionen auch nach Neuladen oder erneuter Aktivierung erhalten.
|
|
63
|
+
- Ist der Browserspeicher nicht verfügbar, wird die automatische Einstellung nicht angewendet.
|
|
64
|
+
- Der gewählte Sortierwert (`agent-activity`) wird im gemeinsamen Workspace-Ansichtsspeicher von DSH gespeichert und bleibt daher nach dem Neuladen erhalten.
|
|
65
|
+
- Beim Deaktivieren des Plugins kehrt die Liste zur zuvor verwendeten Sortierung zurück. Wirkt die Reihenfolge falsch, wählen Sie in den Ansichtsoptionen einmal **Handbuch** oder **Zuletzt aktualisiert**.
|
|
66
|
+
|
|
67
|
+
### Verhältnis zur manuellen Sortierung
|
|
68
|
+
|
|
69
|
+
Wenn Sie eine Sitzungszeile ziehen, wechselt DSH zur manuellen Sortierung, wodurch die Sortierung nach Agentenaktivität aufgehoben wird. Eine manuelle Anordnung, die Sie vor dem Einschalten von Agentenaktivität per Ziehen erstellt haben, wird nicht wiederhergestellt. Dies folgt den Regeln von DSH für Sortieränderungen.
|
|
70
|
+
|
|
71
|
+
### Wiederverwendung vorhandener DSH-Funktionen
|
|
72
|
+
|
|
73
|
+
- Sitzungszeilen, Suche, Menüs, Auswahl, Anheften und Archivfilter verwenden die vorhandenen DSH-Funktionen.
|
|
74
|
+
- Das Plugin aktualisiert die Listenreihenfolge von DSH, statt nur per CSS umzusortieren; so stimmt die Bildschirmreihenfolge mit der DOM-Reihenfolge (der Tastaturnavigation) überein.
|
|
75
|
+
- Die Scrollleisten übernehmen Breite, Farbe und Hover-Stil der Standard-Scrollleiste von DSH.
|
|
76
|
+
|
|
77
|
+
### Animation
|
|
78
|
+
|
|
79
|
+
| Aktion | Dauer |
|
|
80
|
+
| ------------------- | ----- |
|
|
81
|
+
| Working ausklappen | 320ms |
|
|
82
|
+
| Archived ausklappen | 480ms |
|
|
83
|
+
| Einklappen | 260ms |
|
|
84
|
+
|
|
85
|
+
Ist die Betriebssystemeinstellung zum Reduzieren von Bewegung (`prefers-reduced-motion`) aktiv, werden Änderungen sofort ohne Animation übernommen.
|
|
86
|
+
|
|
87
|
+
### Hinweise zur Kompatibilität
|
|
88
|
+
|
|
89
|
+
Das Ansichtsoptionen-Menü von DSH `0.2.x` hat keinen Erweiterungsslot für Plugins. Daher hängt dieses Plugin von den folgenden internen Strukturen ab und braucht ein Kompatibilitätsupdate, wenn DSH sie ändert.
|
|
90
|
+
|
|
91
|
+
- Es fügt den Sortiereintrag direkt in das DOM des Ansichtsoptionen-Menüs ein.
|
|
92
|
+
- Es verwendet den gemeinsamen Workspace-Ansichtsspeicher und das Attribut `data-row-key` der Zeilen.
|
|
93
|
+
- Es ersetzt die Standardzeilen nie und verschiebt sie nicht in ein anderes DOM-Elternelement, sondern trennt obere Liste und unteren Bereich mit Shadow-DOM-Slots. Nach dem Deaktivieren stellt der Standardslot die ursprüngliche Liste wieder her.
|
|
94
|
+
|
|
95
|
+
## Entwicklung
|
|
96
|
+
|
|
97
|
+
```bash
|
|
98
|
+
pnpm --filter @dungsil/dsh-plugin-ui-sidebar-inbox build
|
|
99
|
+
pnpm --filter @dungsil/dsh-plugin-ui-sidebar-inbox typecheck
|
|
100
|
+
pnpm --filter @dungsil/dsh-plugin-ui-sidebar-inbox test
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
Die automatisierten Tests prüfen folgendes Verhalten.
|
|
104
|
+
|
|
105
|
+
- Eine Neuinstallation wendet die Standardsortierung an und behält danach die Auswahl des Benutzers bei.
|
|
106
|
+
- Der Sortiereintrag wird mit korrekter Tastaturreihenfolge und Auswahlmarkierung ins Menü eingefügt. Bei einer anderen Gruppierung wird der Eintrag deaktiviert und die Sortierung automatisch aufgehoben.
|
|
107
|
+
- In einer Liste werden Sitzungen nach Status platziert, archivierte Sitzungen nach unten gesetzt und je nach Archivfilter unterschiedlich angezeigt.
|
|
108
|
+
- Working und Archived starten ausgeklappt bzw. eingeklappt und lassen sich über ihre Überschriften umschalten; Dearchivieren wird übernommen; Überschriften aktualisieren sich beim Sprachwechsel der Oberfläche.
|
|
109
|
+
- Das Aufheben der Sortierung stellt die vorherige Reihenfolge wieder her.
|
package/README.en.md
ADDED
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
[한국어](./README.md) | **English** | [简体中文](./README.zh.md) | [日本語](./README.ja.md) | [Español](./README.es.md) | [Français](./README.fr.md) | [Deutsch](./README.de.md) | [Português](./README.pt.md) | [Русский](./README.ru.md)
|
|
2
|
+
|
|
3
|
+
# Sidebar Inbox
|
|
4
|
+
|
|
5
|
+
`@dungsil/dsh-plugin-ui-sidebar-inbox`
|
|
6
|
+
|
|
7
|
+
Sidebar Inbox organizes the DSH sidebar session list **by state**, like T3 Code Nightly. Sessions that need your response move to the top, while running and archived sessions gather at the bottom. The existing sidebar look and session rows stay unchanged.
|
|
8
|
+
|
|
9
|
+
## Preview
|
|
10
|
+
|
|
11
|
+
**Light**: Archived and Snoozed are collapsed on the left and expanded on the right. Section headings show session counts.
|
|
12
|
+
|
|
13
|
+
<img src="./assets/sidebar-preview-en-light.webp" alt="Sidebar Inbox in the light theme: pinned and inbox sessions, Working, Archived and Snoozed lists with counts; Archived and Snoozed collapsed on the left and expanded on the right" width="720" />
|
|
14
|
+
|
|
15
|
+
**Dark**: The same sample sessions, comparing Archived and Snoozed collapsed and expanded.
|
|
16
|
+
|
|
17
|
+
<img src="./assets/sidebar-preview-en-dark.webp" alt="Sidebar Inbox in the dark theme: pinned and inbox sessions, Working, Archived and Snoozed lists with counts; Archived and Snoozed collapsed on the left and expanded on the right" width="720" />
|
|
18
|
+
|
|
19
|
+
## Usage
|
|
20
|
+
|
|
21
|
+
1. Enable **Sidebar Inbox** in the DSH plugin management screen.
|
|
22
|
+
2. On first activation, the view options are set automatically to **Group by: In one list** and **Order by: Agent activity**. The session filter is not changed.
|
|
23
|
+
3. To turn it back on later, select the same two items in the sidebar's **View options**.
|
|
24
|
+
4. To stop using it, switch **Order by** to **Manual** or **Last updated**, or select **Agent activity** again. Selecting it again returns to the order you used before turning on Agent activity.
|
|
25
|
+
|
|
26
|
+
## Session placement
|
|
27
|
+
|
|
28
|
+
| Section | Sessions included |
|
|
29
|
+
| -------- | ------------------------------------------------------------------------------------------------------- |
|
|
30
|
+
| Pinned | Sessions pinned in DSH. They stay here even while running or waiting for a response. |
|
|
31
|
+
| Inbox | Sessions that need a response check, approval, plan review, or user input, and sessions not yet opened. |
|
|
32
|
+
| Working | Sessions where an agent or subagent is running. They move to Inbox when a request appears. |
|
|
33
|
+
| Archived | Sessions archived in DSH. They stay here regardless of whether they are pinned or running. |
|
|
34
|
+
|
|
35
|
+
- Within each section, the most recently updated sessions come first. A blank new session stays at the top, as in default DSH.
|
|
36
|
+
- This placement applies **only when Group by is In one list**. Switching to `WorkSpace` or `Workspace Tree` releases the Agent activity order and returns to the default DSH display.
|
|
37
|
+
|
|
38
|
+
## Layout
|
|
39
|
+
|
|
40
|
+
The sidebar list is split into a top list and a bottom area, and each scrolls independently.
|
|
41
|
+
|
|
42
|
+
- **Top list**: Shows Pinned and Inbox without headings.
|
|
43
|
+
- **Bottom area**: Working and Archived share one scroll area. Their headings and sessions together never take more than 50% of the sidebar list height.
|
|
44
|
+
- **Expanding and collapsing**: Working starts expanded and Archived starts collapsed. Click a section heading or activate it with the keyboard to expand or collapse it. This state is not saved, so a reload restores the initial state.
|
|
45
|
+
- **When Archived can collapse**: Archived can be collapsed only when the session filter is `All conversations (show archived)`. With the `Archived only` filter, archived sessions are the entire list, so they always stay expanded.
|
|
46
|
+
|
|
47
|
+
## Archiving
|
|
48
|
+
|
|
49
|
+
DSH manages whether a session is archived. Archive and unarchive a session from its `⋯` menu; this plugin never stores or changes the archive state.
|
|
50
|
+
|
|
51
|
+
- You can restore an archived session from the bottom area at any time.
|
|
52
|
+
- If a session is running or waiting for your response, DSH stops its work before archiving it.
|
|
53
|
+
|
|
54
|
+
## Languages
|
|
55
|
+
|
|
56
|
+
List headings and menu items follow the DSH UI language. In the English UI, the sort item reads `Agent activity` and the section headings read `Working` and `Archived`. The plugin ships its own translations for these labels.
|
|
57
|
+
|
|
58
|
+
## Details
|
|
59
|
+
|
|
60
|
+
### Keeping your sort choice
|
|
61
|
+
|
|
62
|
+
- The automatic setup is applied **only once, on first activation** of a new installation with no previous sort record. After that, reloading or re-enabling the plugin keeps the view options you chose.
|
|
63
|
+
- If browser storage is unavailable, the automatic setup is not applied.
|
|
64
|
+
- The selected sort value (`agent-activity`) is saved in DSH's shared Workspace view store, so it survives reloads.
|
|
65
|
+
- Disabling the plugin returns to the sort order you used before. If the order looks wrong, select **Manual** or **Last updated** once in the view options.
|
|
66
|
+
|
|
67
|
+
### Interaction with manual sorting
|
|
68
|
+
|
|
69
|
+
Dragging a session row makes DSH switch to manual sorting, which releases the Agent activity order. Any manual arrangement you dragged before turning on Agent activity is not restored. This follows DSH's own rules for changing the sort order.
|
|
70
|
+
|
|
71
|
+
### Reusing existing DSH features
|
|
72
|
+
|
|
73
|
+
- Session rows, search, menus, selection, pinning, and the archive filter all use DSH's existing features.
|
|
74
|
+
- The plugin updates DSH's list order instead of reordering with CSS only, so the on-screen order matches the DOM order (the keyboard navigation order).
|
|
75
|
+
- Scrollbars follow the thickness, color, and hover style of the default DSH scrollbar.
|
|
76
|
+
|
|
77
|
+
### Animation
|
|
78
|
+
|
|
79
|
+
| Action | Duration |
|
|
80
|
+
| --------------- | -------- |
|
|
81
|
+
| Expand Working | 320ms |
|
|
82
|
+
| Expand Archived | 480ms |
|
|
83
|
+
| Collapse | 260ms |
|
|
84
|
+
|
|
85
|
+
When the operating system's reduce motion setting (`prefers-reduced-motion`) is on, changes apply immediately without animation.
|
|
86
|
+
|
|
87
|
+
### Compatibility notes
|
|
88
|
+
|
|
89
|
+
The view options menu in DSH `0.2.x` has no plugin extension slot. This plugin therefore depends on the internal structures below and needs a compatibility update if DSH changes them.
|
|
90
|
+
|
|
91
|
+
- It adds the sort item directly to the view options menu DOM.
|
|
92
|
+
- It uses the shared Workspace view store and the `data-row-key` attribute on rows.
|
|
93
|
+
- It never replaces default rows or moves them to another DOM parent; it splits the top list and bottom area with Shadow DOM slots. When disabled, the default slot restores the original list.
|
|
94
|
+
|
|
95
|
+
## Development
|
|
96
|
+
|
|
97
|
+
```bash
|
|
98
|
+
pnpm --filter @dungsil/dsh-plugin-ui-sidebar-inbox build
|
|
99
|
+
pnpm --filter @dungsil/dsh-plugin-ui-sidebar-inbox typecheck
|
|
100
|
+
pnpm --filter @dungsil/dsh-plugin-ui-sidebar-inbox test
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
The automated tests check the following behavior.
|
|
104
|
+
|
|
105
|
+
- A new installation applies the default sort, and later user choices are kept.
|
|
106
|
+
- The sort item is added to the menu with the correct keyboard order and selection mark. When Group by differs, the item is disabled and the sort is released automatically.
|
|
107
|
+
- In one list, sessions are placed by state, archived sessions go to the bottom, and each archive filter displays them differently.
|
|
108
|
+
- Working and Archived start expanded and collapsed and toggle from their headings; unarchiving is reflected; headings update when the UI language changes.
|
|
109
|
+
- Releasing the sort restores the previous order.
|
package/README.es.md
ADDED
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
[한국어](./README.md) | [English](./README.en.md) | [简体中文](./README.zh.md) | [日本語](./README.ja.md) | **Español** | [Français](./README.fr.md) | [Deutsch](./README.de.md) | [Português](./README.pt.md) | [Русский](./README.ru.md)
|
|
2
|
+
|
|
3
|
+
# Sidebar Inbox · Bandeja de entrada lateral
|
|
4
|
+
|
|
5
|
+
`@dungsil/dsh-plugin-ui-sidebar-inbox`
|
|
6
|
+
|
|
7
|
+
Organiza la lista de sesiones de la barra lateral de DSH **por estado**, como T3 Code Nightly. Las sesiones que necesitan tu respuesta suben arriba, y las sesiones en ejecución y las archivadas se agrupan abajo. El aspecto de la barra lateral y las filas de sesión existentes no cambian.
|
|
8
|
+
|
|
9
|
+
## Vista previa
|
|
10
|
+
|
|
11
|
+
**Claro**: Archivadas y Ocultas temporalmente están plegadas a la izquierda y desplegadas a la derecha. Los encabezados muestran el número de sesiones.
|
|
12
|
+
|
|
13
|
+
<img src="./assets/sidebar-preview-es-light.webp" alt="Sidebar Inbox con tema claro: sesiones fijadas y de la bandeja de entrada, En curso, Archivadas y Ocultas temporalmente con recuentos; las dos últimas plegadas a la izquierda y desplegadas a la derecha" width="720" />
|
|
14
|
+
|
|
15
|
+
**Oscuro**: las mismas sesiones de ejemplo, comparando Archivadas y Ocultas temporalmente plegadas y desplegadas.
|
|
16
|
+
|
|
17
|
+
<img src="./assets/sidebar-preview-es-dark.webp" alt="Sidebar Inbox con tema oscuro: sesiones fijadas y de la bandeja de entrada, En curso, Archivadas y Ocultas temporalmente con recuentos; las dos últimas plegadas a la izquierda y desplegadas a la derecha" width="720" />
|
|
18
|
+
|
|
19
|
+
## Uso
|
|
20
|
+
|
|
21
|
+
1. Activa **Sidebar Inbox / Bandeja de entrada lateral** en la pantalla de gestión de plugins de DSH.
|
|
22
|
+
2. En la primera activación, las opciones de vista se configuran automáticamente como **Agrupar por: en una lista** y **Ordenar por: Actividad del agente**. El filtro de sesiones no cambia.
|
|
23
|
+
3. Para volver a activarlo más adelante, selecciona esos dos mismos elementos en **Ver opciones** de la barra lateral.
|
|
24
|
+
4. Para dejar de usarlo, cambia **Ordenar por** a **manuales** o **Última actualización**, o vuelve a seleccionar **Actividad del agente**. Si lo vuelves a seleccionar, se restablece el orden que usabas antes de activar Actividad del agente.
|
|
25
|
+
|
|
26
|
+
## Ubicación de las sesiones
|
|
27
|
+
|
|
28
|
+
| Sección | Sesiones incluidas |
|
|
29
|
+
| -------- | -------------------------------------------------------------------------------------------------------------------------------------- |
|
|
30
|
+
| Pinned | Sesiones fijadas en DSH. Permanecen aquí aunque estén en ejecución o esperando una respuesta. |
|
|
31
|
+
| Inbox | Sesiones que necesitan revisar una respuesta, una aprobación, una revisión del plan o entrada del usuario, y sesiones aún no abiertas. |
|
|
32
|
+
| Working | Sesiones con un agente o subagente en ejecución. Pasan a Inbox cuando aparece una solicitud. |
|
|
33
|
+
| Archived | Sesiones archivadas en DSH. Permanecen aquí aunque estén fijadas o en ejecución. |
|
|
34
|
+
|
|
35
|
+
- Dentro de cada sección, las sesiones actualizadas más recientemente aparecen primero. Una sesión nueva vacía se mantiene arriba, igual que en DSH.
|
|
36
|
+
- Esta ubicación se aplica **solo cuando Agrupar por es en una lista**. Al cambiar a `Espacio de trabajo` o `Árbol del espacio de trabajo`, se desactiva el orden Actividad del agente y se vuelve a la vista predeterminada de DSH.
|
|
37
|
+
|
|
38
|
+
## Diseño de la pantalla
|
|
39
|
+
|
|
40
|
+
La lista de la barra lateral se divide en una lista superior y un área inferior, y cada una se desplaza por separado.
|
|
41
|
+
|
|
42
|
+
- **Lista superior**: muestra Pinned e Inbox sin encabezados.
|
|
43
|
+
- **Área inferior**: Working y Archived comparten un área de desplazamiento. Sus encabezados y sesiones juntos nunca ocupan más del 50 % de la altura de la lista de la barra lateral.
|
|
44
|
+
- **Desplegar y plegar**: al principio, Working está desplegado y Archived plegado. Haz clic en el encabezado de una sección o actívalo con el teclado para desplegarla o plegarla. Este estado no se guarda, así que al recargar vuelve al estado inicial.
|
|
45
|
+
- **Cuándo se puede plegar Archived**: solo cuando el filtro de sesiones es `Todas las conversaciones (mostrar archivadas)`. Con el filtro `Sólo archivado`, las sesiones archivadas son toda la lista, así que siempre se muestran desplegadas.
|
|
46
|
+
|
|
47
|
+
## Archivado
|
|
48
|
+
|
|
49
|
+
DSH gestiona si una sesión está archivada. Archiva y desarchiva una sesión desde su menú `⋯`; este plugin nunca guarda ni cambia el estado de archivado.
|
|
50
|
+
|
|
51
|
+
- Puedes restaurar una sesión archivada desde el área inferior en cualquier momento.
|
|
52
|
+
- Si una sesión está en ejecución o esperando tu respuesta, DSH detiene su trabajo antes de archivarla.
|
|
53
|
+
|
|
54
|
+
## Idiomas
|
|
55
|
+
|
|
56
|
+
Los encabezados de la lista y los elementos del menú siguen el idioma de la interfaz de DSH. En la interfaz en español, el elemento de orden se muestra como `Actividad del agente` y los encabezados de sección como `En curso` y `Archivadas`. El plugin incluye sus propias traducciones, así que no necesitas un paquete de idioma aparte.
|
|
57
|
+
|
|
58
|
+
## Comportamiento detallado
|
|
59
|
+
|
|
60
|
+
### Conservar la elección de orden
|
|
61
|
+
|
|
62
|
+
- La configuración automática se aplica **solo una vez, en la primera activación** de una instalación nueva sin registro de orden previo. Después, aunque recargues o vuelvas a activar el plugin, se conservan las opciones de vista que elegiste.
|
|
63
|
+
- Si el almacenamiento del navegador no está disponible, la configuración automática no se aplica.
|
|
64
|
+
- El valor de orden seleccionado (`agent-activity`) se guarda en el almacén de vista compartido de Workspace de DSH, por lo que se conserva tras recargar.
|
|
65
|
+
- Al desactivar el plugin, se vuelve al orden que usabas antes. Si el orden parece incorrecto, selecciona una vez **manuales** o **Última actualización** en las opciones de vista.
|
|
66
|
+
|
|
67
|
+
### Relación con el orden manual
|
|
68
|
+
|
|
69
|
+
Al arrastrar una fila de sesión, DSH cambia al orden manual, lo que desactiva el orden Actividad del agente. La disposición manual que hubieras arrastrado antes de activar Actividad del agente no se restaura. Esto sigue las propias reglas de DSH para cambiar el orden.
|
|
70
|
+
|
|
71
|
+
### Reutilización de funciones de DSH
|
|
72
|
+
|
|
73
|
+
- Las filas de sesión, la búsqueda, los menús, la selección, la fijación y el filtro de archivado usan las funciones existentes de DSH.
|
|
74
|
+
- El plugin actualiza el orden de la lista de DSH en lugar de reordenar solo con CSS, por lo que el orden en pantalla coincide con el orden del DOM (el orden de navegación con el teclado).
|
|
75
|
+
- Las barras de desplazamiento siguen el grosor, el color y el estilo al pasar el cursor de la barra de desplazamiento predeterminada de DSH.
|
|
76
|
+
|
|
77
|
+
### Animación
|
|
78
|
+
|
|
79
|
+
| Acción | Duración |
|
|
80
|
+
| ------------------ | -------- |
|
|
81
|
+
| Desplegar Working | 320ms |
|
|
82
|
+
| Desplegar Archived | 480ms |
|
|
83
|
+
| Plegar | 260ms |
|
|
84
|
+
|
|
85
|
+
Si activas la opción de reducir movimiento del sistema operativo (`prefers-reduced-motion`), los cambios se aplican al instante sin animación.
|
|
86
|
+
|
|
87
|
+
### Notas de compatibilidad
|
|
88
|
+
|
|
89
|
+
El menú de opciones de vista de DSH `0.2.x` no tiene una ranura de extensión para plugins. Por eso, este plugin depende de las estructuras internas siguientes y necesita una actualización de compatibilidad si DSH las cambia.
|
|
90
|
+
|
|
91
|
+
- Añade el elemento de orden directamente al DOM del menú de opciones de vista.
|
|
92
|
+
- Usa el almacén de vista compartido de Workspace y el atributo `data-row-key` de las filas.
|
|
93
|
+
- Nunca sustituye las filas predeterminadas ni las mueve a otro elemento padre del DOM; separa la lista superior y el área inferior con ranuras de Shadow DOM. Al desactivarlo, la ranura predeterminada restaura la lista original.
|
|
94
|
+
|
|
95
|
+
## Desarrollo
|
|
96
|
+
|
|
97
|
+
```bash
|
|
98
|
+
pnpm --filter @dungsil/dsh-plugin-ui-sidebar-inbox build
|
|
99
|
+
pnpm --filter @dungsil/dsh-plugin-ui-sidebar-inbox typecheck
|
|
100
|
+
pnpm --filter @dungsil/dsh-plugin-ui-sidebar-inbox test
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
Las pruebas automáticas comprueban el siguiente comportamiento.
|
|
104
|
+
|
|
105
|
+
- Una instalación nueva aplica el orden predeterminado y después conserva la elección del usuario.
|
|
106
|
+
- El elemento de orden se añade al menú con el orden de teclado y la marca de selección correctos. Si Agrupar por es distinto, el elemento se desactiva y el orden se libera automáticamente.
|
|
107
|
+
- En una lista, las sesiones se colocan por estado, las archivadas van abajo y cada filtro de archivado las muestra de forma distinta.
|
|
108
|
+
- Working y Archived empiezan desplegado y plegado y se alternan desde sus encabezados; se refleja el desarchivado; los encabezados se actualizan al cambiar el idioma de la interfaz.
|
|
109
|
+
- Al liberar el orden, se restaura el orden anterior.
|
package/README.fr.md
ADDED
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
[한국어](./README.md) | [English](./README.en.md) | [简体中文](./README.zh.md) | [日本語](./README.ja.md) | [Español](./README.es.md) | **Français** | [Deutsch](./README.de.md) | [Português](./README.pt.md) | [Русский](./README.ru.md)
|
|
2
|
+
|
|
3
|
+
# Sidebar Inbox · Boîte de réception latérale
|
|
4
|
+
|
|
5
|
+
`@dungsil/dsh-plugin-ui-sidebar-inbox`
|
|
6
|
+
|
|
7
|
+
Ce plugin organise la liste des sessions de la barre latérale de DSH **par état**, comme T3 Code Nightly. Les sessions qui attendent votre réponse remontent en haut, tandis que les sessions en cours et archivées se regroupent en bas. L’apparence de la barre latérale et les lignes de session existantes restent inchangées.
|
|
8
|
+
|
|
9
|
+
## Aperçu
|
|
10
|
+
|
|
11
|
+
**Clair** : Archivées et Masquées temporairement sont repliées à gauche et dépliées à droite. Les titres indiquent le nombre de sessions.
|
|
12
|
+
|
|
13
|
+
<img src="./assets/sidebar-preview-fr-light.webp" alt="Sidebar Inbox en thème clair : sessions épinglées et reçues, En cours, Archivées et Masquées temporairement avec compteurs ; les deux dernières repliées à gauche et dépliées à droite" width="720" />
|
|
14
|
+
|
|
15
|
+
**Sombre** : les mêmes sessions d’exemple, comparant Archivées et Masquées temporairement repliées et dépliées.
|
|
16
|
+
|
|
17
|
+
<img src="./assets/sidebar-preview-fr-dark.webp" alt="Sidebar Inbox en thème sombre : sessions épinglées et reçues, En cours, Archivées et Masquées temporairement avec compteurs ; les deux dernières repliées à gauche et dépliées à droite" width="720" />
|
|
18
|
+
|
|
19
|
+
## Utilisation
|
|
20
|
+
|
|
21
|
+
1. Activez **Sidebar Inbox / Boîte de réception latérale** dans l’écran de gestion des plugins de DSH.
|
|
22
|
+
2. À la première activation, les options d’affichage sont réglées automatiquement sur **Regrouper par : Dans une liste** et **Commander par : Activité de l’agent**. Le filtre des sessions n’est pas modifié.
|
|
23
|
+
3. Pour le réactiver plus tard, sélectionnez ces deux mêmes éléments dans **Afficher les options** de la barre latérale.
|
|
24
|
+
4. Pour ne plus l’utiliser, passez **Commander par** à **Manuel** ou **Dernière mise à jour**, ou sélectionnez de nouveau **Activité de l’agent**. Le sélectionner de nouveau rétablit l’ordre que vous utilisiez avant d’activer Activité de l’agent.
|
|
25
|
+
|
|
26
|
+
## Placement des sessions
|
|
27
|
+
|
|
28
|
+
| Section | Sessions incluses |
|
|
29
|
+
| -------- | ---------------------------------------------------------------------------------------------------------------------------------- |
|
|
30
|
+
| Pinned | Sessions épinglées dans DSH. Elles restent ici même lorsqu’elles sont en cours ou attendent une réponse. |
|
|
31
|
+
| Inbox | Sessions qui demandent de vérifier une réponse, une approbation, une revue de plan ou une saisie, et sessions pas encore ouvertes. |
|
|
32
|
+
| Working | Sessions dont un agent ou un sous-agent est en cours d’exécution. Elles passent dans Inbox lorsqu’une demande apparaît. |
|
|
33
|
+
| Archived | Sessions archivées dans DSH. Elles restent ici, qu’elles soient épinglées ou en cours d’exécution. |
|
|
34
|
+
|
|
35
|
+
- Dans chaque section, les sessions mises à jour le plus récemment apparaissent en premier. Une nouvelle session vide reste en haut, comme dans DSH.
|
|
36
|
+
- Ce placement s’applique **uniquement lorsque Regrouper par vaut Dans une liste**. Passer à `Espace de travail` ou `Arborescence de l'espace de travail` désactive l’ordre Activité de l’agent et rétablit l’affichage par défaut de DSH.
|
|
37
|
+
|
|
38
|
+
## Disposition de l’écran
|
|
39
|
+
|
|
40
|
+
La liste de la barre latérale est divisée en une liste supérieure et une zone inférieure, chacune défilant séparément.
|
|
41
|
+
|
|
42
|
+
- **Liste supérieure** : affiche Pinned et Inbox sans titre.
|
|
43
|
+
- **Zone inférieure** : Working et Archived partagent une seule zone de défilement. Leurs titres et leurs sessions réunis n’occupent jamais plus de 50 % de la hauteur de la liste de la barre latérale.
|
|
44
|
+
- **Déplier et replier** : au départ, Working est déplié et Archived replié. Cliquez sur le titre d’une section ou activez-le au clavier pour la déplier ou la replier. Cet état n’est pas enregistré : un rechargement rétablit l’état initial.
|
|
45
|
+
- **Quand Archived peut être replié** : uniquement lorsque le filtre des sessions est `Toutes les conversations (afficher les archives)`. Avec le filtre `Archivé uniquement`, les sessions archivées forment toute la liste ; elles restent donc toujours dépliées.
|
|
46
|
+
|
|
47
|
+
## Archivage
|
|
48
|
+
|
|
49
|
+
DSH gère l’état d’archivage des sessions. Archivez et désarchivez une session depuis son menu `⋯` ; ce plugin n’enregistre ni ne modifie jamais l’état d’archivage.
|
|
50
|
+
|
|
51
|
+
- Vous pouvez restaurer une session archivée depuis la zone inférieure à tout moment.
|
|
52
|
+
- Si une session est en cours ou attend votre réponse, DSH arrête son travail avant de l’archiver.
|
|
53
|
+
|
|
54
|
+
## Langues
|
|
55
|
+
|
|
56
|
+
Les titres de la liste et les éléments de menu suivent la langue de l’interface de DSH. Dans l’interface en français, l’élément de tri s’affiche `Activité de l’agent` et les titres de section `En cours` et `Archivées`. Le plugin inclut ses propres traductions ; aucun pack de langue supplémentaire n’est nécessaire.
|
|
57
|
+
|
|
58
|
+
## Comportement détaillé
|
|
59
|
+
|
|
60
|
+
### Conserver le choix de tri
|
|
61
|
+
|
|
62
|
+
- La configuration automatique est appliquée **une seule fois, à la première activation** d’une nouvelle installation sans historique de tri. Ensuite, recharger ou réactiver le plugin conserve les options d’affichage que vous avez choisies.
|
|
63
|
+
- Si le stockage du navigateur n’est pas disponible, la configuration automatique n’est pas appliquée.
|
|
64
|
+
- La valeur de tri sélectionnée (`agent-activity`) est enregistrée dans le magasin de vue partagé Workspace de DSH ; elle est donc conservée après un rechargement.
|
|
65
|
+
- Désactiver le plugin rétablit l’ordre que vous utilisiez auparavant. Si l’ordre semble incorrect, sélectionnez une fois **Manuel** ou **Dernière mise à jour** dans les options d’affichage.
|
|
66
|
+
|
|
67
|
+
### Relation avec le tri manuel
|
|
68
|
+
|
|
69
|
+
Faire glisser une ligne de session fait passer DSH au tri manuel, ce qui désactive l’ordre Activité de l’agent. La disposition manuelle obtenue par glisser-déposer avant d’activer Activité de l’agent n’est pas restaurée. Ce comportement suit les règles de DSH pour changer l’ordre.
|
|
70
|
+
|
|
71
|
+
### Réutilisation des fonctions de DSH
|
|
72
|
+
|
|
73
|
+
- Les lignes de session, la recherche, les menus, la sélection, l’épinglage et le filtre d’archivage utilisent les fonctions existantes de DSH.
|
|
74
|
+
- Le plugin met à jour l’ordre de la liste de DSH au lieu de réordonner uniquement avec CSS ; l’ordre à l’écran correspond donc à l’ordre du DOM (l’ordre de navigation au clavier).
|
|
75
|
+
- Les barres de défilement suivent l’épaisseur, la couleur et le style de survol de la barre de défilement par défaut de DSH.
|
|
76
|
+
|
|
77
|
+
### Animation
|
|
78
|
+
|
|
79
|
+
| Action | Durée |
|
|
80
|
+
| ---------------- | ----- |
|
|
81
|
+
| Déplier Working | 320ms |
|
|
82
|
+
| Déplier Archived | 480ms |
|
|
83
|
+
| Replier | 260ms |
|
|
84
|
+
|
|
85
|
+
Lorsque le réglage de réduction des animations du système d’exploitation (`prefers-reduced-motion`) est activé, les changements s’appliquent immédiatement, sans animation.
|
|
86
|
+
|
|
87
|
+
### Notes de compatibilité
|
|
88
|
+
|
|
89
|
+
Le menu des options d’affichage de DSH `0.2.x` n’a pas d’emplacement d’extension pour les plugins. Ce plugin dépend donc des structures internes ci-dessous et nécessite une mise à jour de compatibilité si DSH les modifie.
|
|
90
|
+
|
|
91
|
+
- Il ajoute l’élément de tri directement dans le DOM du menu des options d’affichage.
|
|
92
|
+
- Il utilise le magasin de vue partagé Workspace et l’attribut `data-row-key` des lignes.
|
|
93
|
+
- Il ne remplace jamais les lignes par défaut et ne les déplace pas vers un autre parent du DOM ; il sépare la liste supérieure et la zone inférieure avec des slots Shadow DOM. Une fois désactivé, le slot par défaut rétablit la liste d’origine.
|
|
94
|
+
|
|
95
|
+
## Développement
|
|
96
|
+
|
|
97
|
+
```bash
|
|
98
|
+
pnpm --filter @dungsil/dsh-plugin-ui-sidebar-inbox build
|
|
99
|
+
pnpm --filter @dungsil/dsh-plugin-ui-sidebar-inbox typecheck
|
|
100
|
+
pnpm --filter @dungsil/dsh-plugin-ui-sidebar-inbox test
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
Les tests automatisés vérifient le comportement suivant.
|
|
104
|
+
|
|
105
|
+
- Une nouvelle installation applique le tri par défaut, puis conserve le choix de l’utilisateur.
|
|
106
|
+
- L’élément de tri est ajouté au menu avec un ordre clavier et une marque de sélection corrects. Si Regrouper par est différent, l’élément est désactivé et le tri est libéré automatiquement.
|
|
107
|
+
- Dans une liste unique, les sessions sont placées par état, les sessions archivées vont en bas et chaque filtre d’archivage les affiche différemment.
|
|
108
|
+
- Working et Archived démarrent déplié et replié et se basculent depuis leurs titres ; le désarchivage est pris en compte ; les titres se mettent à jour lorsque la langue de l’interface change.
|
|
109
|
+
- Libérer le tri rétablit l’ordre précédent.
|
package/README.ja.md
ADDED
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
[한국어](./README.md) | [English](./README.en.md) | [简体中文](./README.zh.md) | **日本語** | [Español](./README.es.md) | [Français](./README.fr.md) | [Deutsch](./README.de.md) | [Português](./README.pt.md) | [Русский](./README.ru.md)
|
|
2
|
+
|
|
3
|
+
# Sidebar Inbox · サイドバー受信箱
|
|
4
|
+
|
|
5
|
+
`@dungsil/dsh-plugin-ui-sidebar-inbox`
|
|
6
|
+
|
|
7
|
+
DSH サイドバーのセッション一覧を、T3 Code Nightly のように**状態別**に整理します。返信が必要なセッションは上へ、実行中のセッションとアーカイブしたセッションは下へまとめます。既存のサイドバーの見た目とセッション行はそのまま維持します。
|
|
8
|
+
|
|
9
|
+
## プレビュー
|
|
10
|
+
|
|
11
|
+
**ライト**:左は「アーカイブ済み」と「一時的に非表示」を折りたたんだ状態、右は両方を展開した状態です。各見出しにはセッション数を表示します。
|
|
12
|
+
|
|
13
|
+
<img src="./assets/sidebar-preview-ja-light.webp" alt="ライトテーマの Sidebar Inbox:ピン留め・受信箱と、件数付きの作業中・アーカイブ済み・一時的に非表示。左は後者2つを折りたたみ、右は展開" width="720" />
|
|
14
|
+
|
|
15
|
+
**ダーク**:同じサンプルセッションで、「アーカイブ済み」と「一時的に非表示」の折りたたみと展開を比較します。
|
|
16
|
+
|
|
17
|
+
<img src="./assets/sidebar-preview-ja-dark.webp" alt="ダークテーマの Sidebar Inbox:ピン留め・受信箱と、件数付きの作業中・アーカイブ済み・一時的に非表示。左は後者2つを折りたたみ、右は展開" width="720" />
|
|
18
|
+
|
|
19
|
+
## 使い方
|
|
20
|
+
|
|
21
|
+
1. DSH のプラグイン管理画面で **Sidebar Inbox / サイドバー受信箱** を有効にします。
|
|
22
|
+
2. 初めて有効にすると、表示オプションが **グループ化:1つのリスト**、**並び順:エージェントの活動** に自動で設定されます。セッションフィルターは変更しません。
|
|
23
|
+
3. 後で再びオンにするには、サイドバーの **表示オプション** で同じ 2 つの項目を選択します。
|
|
24
|
+
4. 使用をやめるには、並び順を **手動** または **最終更新** に変えるか、**エージェントの活動** をもう一度選択します。もう一度選択すると、エージェントの活動をオンにする前の並び順に戻ります。
|
|
25
|
+
|
|
26
|
+
## セッションの配置
|
|
27
|
+
|
|
28
|
+
| 領域 | 含まれるセッション |
|
|
29
|
+
| -------- | ---------------------------------------------------------------------------------------------------- |
|
|
30
|
+
| Pinned | DSH でピン留めしたセッションです。実行中や返信待ちでもこの領域に置きます。 |
|
|
31
|
+
| Inbox | 返信の確認、承認、計画のレビュー、ユーザー入力が必要なセッションと、まだ開いていないセッションです。 |
|
|
32
|
+
| Working | エージェントまたはサブエージェントが実行中のセッションです。要求が発生すると Inbox に移ります。 |
|
|
33
|
+
| Archived | DSH でアーカイブしたセッションです。ピン留めや実行状態に関係なくこの領域に置きます。 |
|
|
34
|
+
|
|
35
|
+
- 各領域では、最近更新されたセッションを先に表示します。内容のない新しいセッションは、既存の DSH と同じく一番上に置きます。
|
|
36
|
+
- この配置は **グループ化が 1つのリスト のときだけ** 適用されます。`ワークスペース` や `ワークスペースツリー` に切り替えると、エージェントの活動の並び順が解除され、DSH の既定の表示に戻ります。
|
|
37
|
+
|
|
38
|
+
## 画面構成
|
|
39
|
+
|
|
40
|
+
サイドバーの一覧は上部の一覧と下部の領域に分かれ、それぞれ独立してスクロールします。
|
|
41
|
+
|
|
42
|
+
- **上部の一覧**:Pinned と Inbox を見出しなしで表示します。
|
|
43
|
+
- **下部の領域**:Working と Archived が 1 つのスクロール領域を共有します。見出しとセッションを合わせた高さは、サイドバー一覧の高さの 50% を超えません。
|
|
44
|
+
- **展開と折りたたみ**:最初は Working を展開し、Archived を折りたたんでおきます。領域の見出しをクリックするか、キーボードで操作すると展開・折りたたみできます。この状態は保存されないため、再読み込みすると最初の状態に戻ります。
|
|
45
|
+
- **Archived を折りたためる条件**:セッションフィルターが `すべての会話(アーカイブを表示)` のときだけ折りたためます。`アーカイブのみ` フィルターではアーカイブしたセッションが一覧全体なので、常に展開して表示します。
|
|
46
|
+
|
|
47
|
+
## アーカイブ
|
|
48
|
+
|
|
49
|
+
アーカイブするかどうかは DSH が管理します。アーカイブとアーカイブ解除はセッションの `⋯` メニューから実行し、このプラグインはアーカイブ状態を保存も変更もしません。
|
|
50
|
+
|
|
51
|
+
- アーカイブしたセッションは、下部の領域からいつでも復元できます。
|
|
52
|
+
- 実行中またはユーザーの返信を待っているセッションは、DSH がアーカイブする前に作業を停止します。
|
|
53
|
+
|
|
54
|
+
## 言語
|
|
55
|
+
|
|
56
|
+
一覧の見出しとメニュー項目は DSH の UI 言語に従います。日本語 UI では、並び順の項目が `エージェントの活動`、領域の見出しが `作業中` と `アーカイブ済み` と表示されます。翻訳はプラグインに含まれているため、別の言語パックは必要ありません。
|
|
57
|
+
|
|
58
|
+
## 詳細な動作
|
|
59
|
+
|
|
60
|
+
### 並び順の選択を保持する
|
|
61
|
+
|
|
62
|
+
- 自動設定は、以前の並び順の記録がない新規インストールで **初めて有効にしたときに一度だけ** 適用されます。その後は再読み込みや再有効化をしても、ユーザーが選んだ表示オプションを維持します。
|
|
63
|
+
- ブラウザーのストレージが使えない場合、自動設定は適用されません。
|
|
64
|
+
- 選択した並び順の値(`agent-activity`)は DSH の共有 Workspace 表示ストアに保存されるため、再読み込み後も維持されます。
|
|
65
|
+
- プラグインを無効にすると、以前使っていた並び順に戻ります。並び順がずれて見える場合は、表示オプションで **手動** または **最終更新** を一度選択します。
|
|
66
|
+
|
|
67
|
+
### 手動の並び替えとの関係
|
|
68
|
+
|
|
69
|
+
セッション行をドラッグすると DSH が手動の並び順に切り替えるため、エージェントの活動の並び順は解除されます。このとき、エージェントの活動をオンにする前にドラッグしておいた手動の配置は復元されません。これは DSH の並び順変更ルールにそのまま従った結果です。
|
|
70
|
+
|
|
71
|
+
### DSH の既存機能の再利用
|
|
72
|
+
|
|
73
|
+
- セッション行、検索、メニュー、選択、ピン留め、アーカイブフィルターは DSH の既存機能をそのまま使います。
|
|
74
|
+
- CSS で順序だけを変えるのではなく DSH の一覧の並び順を更新するため、画面上の順序と DOM の順序(キーボード移動の順序)が一致します。
|
|
75
|
+
- スクロールバーは、DSH の既定のスクロールバーの太さ、色、ホバースタイルに従います。
|
|
76
|
+
|
|
77
|
+
### アニメーション
|
|
78
|
+
|
|
79
|
+
| 動作 | 時間 |
|
|
80
|
+
| --------------- | ----- |
|
|
81
|
+
| Working の展開 | 320ms |
|
|
82
|
+
| Archived の展開 | 480ms |
|
|
83
|
+
| 折りたたみ | 260ms |
|
|
84
|
+
|
|
85
|
+
OS の視差効果を減らす設定(`prefers-reduced-motion`)をオンにすると、アニメーションなしで即座に切り替わります。
|
|
86
|
+
|
|
87
|
+
### 互換性について
|
|
88
|
+
|
|
89
|
+
DSH `0.2.x` の表示オプションメニューには、プラグイン用の拡張スロットがありません。そのため、このプラグインは次の内部構造に依存しており、DSH がこれらの構造を変更した場合は互換性の更新が必要です。
|
|
90
|
+
|
|
91
|
+
- 並び順の項目を表示オプションメニューの DOM に直接追加します。
|
|
92
|
+
- 共有 Workspace 表示ストアと、行の `data-row-key` 属性を使います。
|
|
93
|
+
- 既定の行を置き換えたり別の DOM の親へ移動したりせず、Shadow DOM のスロットで上部の一覧と下部の領域を分けます。無効にすると、既定のスロットが元の一覧を復元します。
|
|
94
|
+
|
|
95
|
+
## 開発
|
|
96
|
+
|
|
97
|
+
```bash
|
|
98
|
+
pnpm --filter @dungsil/dsh-plugin-ui-sidebar-inbox build
|
|
99
|
+
pnpm --filter @dungsil/dsh-plugin-ui-sidebar-inbox typecheck
|
|
100
|
+
pnpm --filter @dungsil/dsh-plugin-ui-sidebar-inbox test
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
自動テストは次の動作を確認します。
|
|
104
|
+
|
|
105
|
+
- 新規インストールで既定の並び順を適用し、その後はユーザーの選択を維持します。
|
|
106
|
+
- 並び順の項目をメニューに追加し、キーボードの順序と選択表示を維持します。グループ化が異なる場合は項目を無効にし、並び順を自動で解除します。
|
|
107
|
+
- 1つのリストで状態別に配置し、アーカイブしたセッションを下部に置き、アーカイブフィルターごとに表示を変えます。
|
|
108
|
+
- Working と Archived の既定の展開・折りたたみと見出しによる切り替え、アーカイブ解除の反映、UI 言語の切り替えに伴う見出しの更新を確認します。
|
|
109
|
+
- 並び順を解除すると、以前の並び順に戻します。
|