dsh-tidy-display 0.1.0 → 0.2.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/CHANGELOG.md +7 -0
- package/README.de.md +120 -0
- package/README.en.md +7 -5
- package/README.es.md +120 -0
- package/README.fr.md +120 -0
- package/README.it.md +120 -0
- package/README.md +7 -5
- package/README.ru.md +120 -0
- package/compat/harness-020rc2.json +99 -0
- package/lib/client.js +488 -268
- package/lib/client.js.map +1 -1
- package/lib/types/client/settings-copy.d.ts +7 -1
- package/lib/types/client/settings-copy.d.ts.map +1 -1
- package/lib/types/client/settings-copy.js +206 -2
- package/lib/types/client/settings-copy.js.map +1 -1
- package/lib/types/client/settings.js +2 -2
- package/lib/types/client/settings.js.map +1 -1
- package/package.json +18 -18
- package/scripts/check-harness-compat.mjs +1 -1
- package/scripts/verify-official-bridge.mjs +2 -1
- package/src/client/settings-copy.ts +215 -3
- package/src/client/settings.tsx +3 -3
package/CHANGELOG.md
CHANGED
|
@@ -66,6 +66,13 @@
|
|
|
66
66
|
- `tests/footer-precedence.test.ts` guards the ladder in the source sheet and
|
|
67
67
|
in the committed bundle.
|
|
68
68
|
|
|
69
|
+
## 0.2.0 — 2026-09-30(宿主 0.2.0 线适配)
|
|
70
|
+
|
|
71
|
+
- 12 项 `@deepseek-ai/dsh-*` peer 换代到 `>=0.2.0-rc.1 <0.2.1-0`;devDependencies 换代到 0.2.0-rc.2;`pnpm-lock.yaml` 移除(npm 为唯一包管理器,`package-lock.json` 入库)。
|
|
72
|
+
- 门禁基线换代:`compat/harness-020rc2.json`(宿主 0.2.0-rc.2;74 项官方注册零增删,18 个锚点文件 14 个逐字节未变)。
|
|
73
|
+
- 宿主 0.2.0 漂移评审(scoped-slots useMemo 化 / ui-tool contract 纯新增 userQuestionPanels / MessageItem TextShimmer / TurnProcessNodeView 移除 live 时钟):插件对四处均为 caller 语义,**零源码改动**。
|
|
74
|
+
- fixture 服务器补 `/favicon.ico` 204 路由并记录未匹配请求(本机首个 headless fixture 基线建立)。
|
|
75
|
+
|
|
69
76
|
## 0.2.0 — 2026-09-18
|
|
70
77
|
|
|
71
78
|
### Diff review and tool presentation
|
package/README.de.md
ADDED
|
@@ -0,0 +1,120 @@
|
|
|
1
|
+
# dsh-tidy-display
|
|
2
|
+
|
|
3
|
+
[简体中文](README.md) | [English](README.en.md) | [Français](README.fr.md) | [Deutsch](README.de.md) | [Italiano](README.it.md) | [Русский](README.ru.md) | [Español](README.es.md)
|
|
4
|
+
|
|
5
|
+
**Tidy Display** — ein Community-Plugin für DeepSeek Harness (DSH) **0.1.7**, das die Leseansicht und die Nachrichtenleiste in einem Plugin vereint: lange Sitzungen werden überblickbar, navigierbar und fortsetzbar.
|
|
6
|
+
|
|
7
|
+
> Dieses Projekt ist aus der Zusammenführung zweier beliebter DSH-Plugins entstanden:
|
|
8
|
+
> [dsh-better-display](https://github.com/aa2246740/dsh-better-display) (Leseansicht, als Fork gepflegt) ×
|
|
9
|
+
> [dsh-tidychat](https://github.com/BananaSoldier01/dsh-tidychat) (Nachrichtenleiste / intelligentes Nachladen des Verlaufs).
|
|
10
|
+
> Die Zusammenführung beseitigt den DOM-Vertragskonflikt zwischen beiden; Dank an beide.
|
|
11
|
+
|
|
12
|
+
## Herkunft und Danksagung (faktentreu)
|
|
13
|
+
|
|
14
|
+
**Die Live-Leseansicht** stammt aus [dsh-better-display](https://github.com/aa2246740/dsh-better-display): Streaming-Rendering des Upstreams aa2246740, Choreografie des Prozess-Einklappens und offizielle Brückenanbindung, erweitert durch den Fork von drscrewdriver. Dieses Projekt hat weder seine Rendering- noch seine Animations-Pipeline neu geschrieben.
|
|
15
|
+
|
|
16
|
+
**Die Nachrichtenleiste** stammt aus [dsh-tidychat](https://github.com/BananaSoldier01/dsh-tidychat): Canvas-Leiste, Fisheye-Hover, Farbkette und intelligentes Nachladen des Verlaufs sind Portierungen, erweitert durch die drscrewdriver-compat-Linie (weißer Schimmer, Steering-Parität, DOM als single source of truth).
|
|
17
|
+
|
|
18
|
+
### Schwächen des ursprünglichen better-display, behoben durch dieses Projekt / den Fork
|
|
19
|
+
|
|
20
|
+
1. **Kein Hintergrund hinter Nachrichten und Thinking** — finale Antworten und Reasoning-Text liegen direkt auf dem Seitenhintergrund; die Lesbarkeit leidet unter Skins, Hintergrundbildern und dunklen Themes. → Der Fork ergänzte für Antworten die offizielle halbtransparente Blasen-Unterlage `--dsw-alias-bg-layer-1` und für die Reasoning-Karte denselben Untergrund (Commits `fa3a795`, `94d59c7`).
|
|
21
|
+
2. **Die Leseansicht verwirft die zeilenweisen Anker des Hosts** — `data-chat-anchor-key` / `data-chat-flow-kind` werden mit den Nachrichtenzeilen nicht ausgegeben; Drittanbieter-Plugins, die diesen Vertrag als DOM-Quelle der Wahrheit nutzen (z. B. die tidychat-Leiste), lösen unter der Leseansicht null Zeilen auf und **versagen stumm**. → Fix als [aa2246740/dsh-better-display#41](https://github.com/aa2246740/dsh-better-display/pull/41) upstream eingereicht; das zusammengeführte Projekt bringt denselben Fix mit.
|
|
22
|
+
3. Das mitgelieferte TimelineRail ist nur eine einzige Leiste mit der offiziellen Gliederung — keine Fisheye-Zusammenfassungen, kein Sprung per Klick, keine Farben.
|
|
23
|
+
|
|
24
|
+
### Schwächen des ursprünglichen dsh-tidychat und die Motivation der Zusammenführung
|
|
25
|
+
|
|
26
|
+
1. Einklappen / Trennlinien sind DOM-Chirurgie, die sich mit dem nativen Einklappen des Hosts (0.1.2+) überschneidet; Nutzer mussten manuell eines von beiden wählen.
|
|
27
|
+
2. v0.2.10 und früher lasen auf DSH-0.1.2-Hosts den falschen Snapshot ein — die Leiste löste null Runden auf und **wurde nie tatsächlich gerendert** (in v0.3.0 behoben, siehe `docs/RAIL-ROOT-CAUSE-ANALYSIS.md` in dessen Repo).
|
|
28
|
+
3. Doppelter Konflikt mit der better-display-Leseansicht: tidychats Chirurgie erreichte die Zeilen der Leseansicht nicht, und die von der Leseansicht verworfenen Anker legten im Gegenzug die Leiste lahm — die unmittelbare Motivation dieser Zusammenführung.
|
|
29
|
+
|
|
30
|
+
Dank an beide Upstreams und ihre Autoren (aa2246740, BananaSoldier01) — dieses Projekt steht auf ihren Schultern. Upstream-Verbesserungen, die nicht kollidieren, werden bei Gelegenheit nachgezogen.
|
|
31
|
+
|
|
32
|
+
## Host-Kompatibilität
|
|
33
|
+
|
|
34
|
+
| DSH-Host | Leseansicht | Nachrichtenleiste | Einstellungen |
|
|
35
|
+
|---|---|---|---|
|
|
36
|
+
| 0.2.0-rc.1+ (diese Linie, `compat/0.2.0`) | ✅ | ✅ (beide Ansichten) | 起子插件设置 → 整洁显示 |
|
|
37
|
+
| 0.1.7-rc.1+ (main-Linie) | ✅ | ✅ (beide Ansichten) | 起子插件设置 → 整洁显示 |
|
|
38
|
+
| 0.1.5-alpha.1 ~ 0.1.6 (inkl. 0.1.5) | ❌ | ✅ (`compat/0.1.5`-Linie, Tag `v0.1.0-dsh0.1.5`) | Plugin-Konfigurationskarte |
|
|
39
|
+
| 0.1.2-alpha.2 ~ 0.1.4.x | ❌ | ✅ (`compat/0.1.2`-Linie, Tag `v0.1.0-dsh0.1.2`) | Plugin-Konfigurationskarte |
|
|
40
|
+
| 0.1.0-rc.7 ~ 0.1.2-alpha.1 (inkl. 0.1.1) | ❌ | ✅ (`compat/0.1.1`-Linie, Tag `v0.1.0-dsh0.1.1`) | Plugin-Konfigurationskarte |
|
|
41
|
+
|
|
42
|
+
- Die Leseansicht ist an den Slot-Vertrag des Hosts gebunden, je Linie mit eigener Basislinie (diese Linie: 0.2.0-rc.2; main: 0.1.7-rc.2 — der Host hatte über 0.1.7-rc.1 → rc.2 → 0.2.0 hinweg Breaking Changes) und wird nicht auf alte Hosts zurückportiert.
|
|
43
|
+
- Der Rückport auf alte Hosts **ist umgesetzt**: Die Leisten-Teilmenge (Leiste + Schimmer + Farben + intelligentes Nachladen) erscheint auf drei compat-Branches, Installations-Einzeiler z. B. `dsh plugin --profile web add github:drscrewdriver/dsh-tidy-display#v0.1.0-dsh0.1.5`; nach der npm-Veröffentlichung folgen die Dist-Tags `dsh-0.1.5` / `dsh-0.1.2` / `dsh-0.1.1`. Die Übernahme des offiziellen Rails der 0.1.5-Linie ist noch praktisch zu verifizieren; 0.1.3 / 0.1.4 laufen theoretisch über die `compat/0.1.2`-Linie, ungetestet.
|
|
44
|
+
- Die 0.2.0-Linie (dieser Branch): Installation per `dsh plugin --profile web add github:drscrewdriver/dsh-tidy-display#v0.2.0-dsh0.2.0`; nach der npm-Veröffentlichung funktioniert der dist-tag: `dsh plugin --profile web add dsh-tidy-display@dsh-0.2.0`.
|
|
45
|
+
- 0.1.0-rc.6 und früher sind außerhalb des Unterstützungsumfangs (bitte dsh-tidychat 0.1.0 verwenden).
|
|
46
|
+
- Stand der Matrix: 2026-09-30 (Linie tidy-display v0.2.0 / better-display 0.3.3-fork.5 / tidychat 0.3.4).
|
|
47
|
+
|
|
48
|
+
## Funktionen
|
|
49
|
+
|
|
50
|
+
### Leseansicht (aus better-display)
|
|
51
|
+
- Ausführungsschritte kollabieren zu ausklappbaren Zusammenfassungen; finale Antworten erscheinen als **Nachrichtenblasen** (halbtransparenter Untergrund + optionales Milchglas, das Skins-Hintergründe durchscheinen lässt)
|
|
52
|
+
- Die Reasoning-Karte erhält denselben halbtransparenten Untergrund; Streaming-Denken kann dem Scrollen folgen, pausieren und vollständig ausgeklappt werden
|
|
53
|
+
- Offizielle Brücke: Tool-Ansichten, Feedback, Artefakt-Karten, turnTail und mehr werden über offizielle Slots gerendert
|
|
54
|
+
- `` ```mcp-app ``-Codeblöcke werden als interaktive Karten in einer Sandbox gemountet (`<iframe sandbox="allow-scripts allow-forms">`); Skill-Paket unter [`skills/generative-mcpapps/`](skills/generative-mcpapps/)
|
|
55
|
+
- Artefakt-Zeile, Warteuhr, Pending-Echo; die ursprünglichen Ansichten „Dialog / Verlauf“, Eingabefeld, Modellauswahl, Tools und Freigaben bleiben erhalten
|
|
56
|
+
|
|
57
|
+
### Nachrichtenleiste (aus dsh-tidychat)
|
|
58
|
+
- Canvas-Navigationsleiste am Rand des Gesprächs: Fisheye-Hover mit Zusammenfassungskarten, Sprung per Klick, Hervorhebung der aktuellen Runde beim Scrollen
|
|
59
|
+
- Stil **Linien / Punkte**, Position **linker / rechter Rand (gespiegelt)**
|
|
60
|
+
- **Weißer Schimmer-Ring**: Ein weicher Schimmer unter dem Marker der aktuellen und der gehoverten Runde hält ihn auch auf unruhigen Hintergründen klar erkennbar
|
|
61
|
+
- **Farben**: Markierungsfarbe und Akzentfarbe bieten jeweils Auto (folgt dem Theme, mit automatischer Korrektur bei zu geringem Kontrast) / Benutzerdefiniert (Farbwähler + HEX/RGB-Text + Alpha-Regler)
|
|
62
|
+
- **Übernahme der offiziellen Nachrichtenleiste**: blendet den offiziellen TurnNavigator am rechten Rand aus (ausgeblendet, nicht demontiert); nur diese Leiste bleibt
|
|
63
|
+
- Funktioniert in **beiden** Ansichten: der nativen „Dialog“-Ansicht und der Leseansicht
|
|
64
|
+
|
|
65
|
+
### Einstellungen
|
|
66
|
+
Alle Einstellungen liegen unter **Einstellungen → 起子插件设置 → 整洁显示 (Tidy Display)**: Nachrichtenleiste (Schalter / Position / Stil / Schimmer / Übernahme / Farben) + Nachrichtenblasen / halbtransparentes Milchglas / Auto-Einklappen / Öffnungsart von Artefakten. Die Konfiguration wird in `dsh.reader.v1` persistiert.
|
|
67
|
+
|
|
68
|
+
## Installation
|
|
69
|
+
|
|
70
|
+
> ⚠️ **Gegenseitig ausschließend mit `dsh-better-display` und `@bananasoldier01/dsh-tidychat`**: Alle drei registrieren eine `reader`-Ansicht (gleiche id, gleiche Priorität) im Listenslot `conversation.view`. Gleichzeitige Aktivierung scheitert wegen der Doppelregistrierung direkt in der Aktivierungsphase (der Client meldet `entry did not activate`, die Seite hängt auf dem „Plugin-Laden fehlgeschlagen“-Schirm). Vor dem Aktivieren dieses Plugins bitte deinstallieren oder deaktivieren.
|
|
71
|
+
|
|
72
|
+
### DSH Studio Desktop-App (empfohlen)
|
|
73
|
+
|
|
74
|
+
**Einstellungen → Plugins → Plugin hinzufügen** öffnen und den Paketnamen eingeben:
|
|
75
|
+
|
|
76
|
+
```text
|
|
77
|
+
dsh-tidy-display
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
### Web-CLI
|
|
81
|
+
|
|
82
|
+
Auf npm veröffentlicht — Installation über den nackten Namen:
|
|
83
|
+
|
|
84
|
+
```sh
|
|
85
|
+
dsh plugin --profile web add dsh-tidy-display
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
Auch die GitHub-Adresse funktioniert (compat-Linien für alte Hosts werden per Tag installiert, siehe Matrix oben):
|
|
89
|
+
|
|
90
|
+
```sh
|
|
91
|
+
dsh plugin --profile web add github:drscrewdriver/dsh-tidy-display
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
Lokales Verzeichnis / Tarball (Entwicklung / lokaler Test):
|
|
95
|
+
|
|
96
|
+
```sh
|
|
97
|
+
dsh plugin --profile web add ./dsh-tidy-display
|
|
98
|
+
dsh plugin --profile web add ./dsh-tidy-display-0.1.0.tgz
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
`dsh.bundle` wird beim Boot erfasst: Bitte **nicht** denselben Insert-Eintrag von Hand in die `cordis.patch.yml` des Profils schreiben (Doppelmontage); eine bereits installierte Kopie entfernen Sie mit `dsh plugin --profile web remove dsh-tidy-display`. Bei einem bereits laufenden Web Host: Host einmal neu öffnen und die Seite neu laden.
|
|
102
|
+
|
|
103
|
+
## Entwicklung
|
|
104
|
+
|
|
105
|
+
```sh
|
|
106
|
+
pnpm install
|
|
107
|
+
npm run typecheck
|
|
108
|
+
npm run build # erzeugt lib/ (eingecheckt; das check-harness-compat-Gate braucht einen Harness-Checkout)
|
|
109
|
+
npm test
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
Ziel ist DeepSeek Harness **0.2.0-rc.1+** (peer `>=0.2.0-rc.1 <0.2.1-0`). Nur Darstellung — Agent-Ausführung, SDK und Modell-Credentials bleiben unangetastet. Node.js `^22.19.0 || >=24`. Neue Sitzungen starten standardmäßig in der Leseansicht.
|
|
113
|
+
|
|
114
|
+
## Verhältnis zu den Originalprojekten
|
|
115
|
+
|
|
116
|
+
Siehe oben „[Herkunft und Danksagung](#herkunft-und-danksagung-faktentreu)“ — Upstream-Verbesserungen, die nicht kollidieren, werden bei Gelegenheit nachgezogen.
|
|
117
|
+
|
|
118
|
+
## Lizenz
|
|
119
|
+
|
|
120
|
+
Darstellungs- und Markdown-Teile stammen aus DeepSeek Harness (MIT). Animationen nach dem Vorbild von [Transitions.dev](https://transitions.dev/). Der Code dieses Repos steht unter [MIT](LICENSE).
|
package/README.en.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# dsh-tidy-display
|
|
2
2
|
|
|
3
|
-
[
|
|
3
|
+
[简体中文](README.md) | [English](README.en.md) | [Français](README.fr.md) | [Deutsch](README.de.md) | [Italiano](README.it.md) | [Русский](README.ru.md) | [Español](README.es.md)
|
|
4
4
|
|
|
5
5
|
**Tidy Display** — a community plugin for DeepSeek Harness (DSH) **0.1.7** that merges the reading view and the message rail into one plugin: long sessions become scannable, navigable, and resumable.
|
|
6
6
|
|
|
@@ -33,15 +33,17 @@ Thanks to both upstreams and their authors (aa2246740, BananaSoldier01) — this
|
|
|
33
33
|
|
|
34
34
|
| DSH host | Reading view | Message rail | Settings |
|
|
35
35
|
|---|---|---|---|
|
|
36
|
-
| 0.
|
|
36
|
+
| 0.2.0-rc.1+ (this line, `compat/0.2.0`) | ✅ | ✅ (both views) | 起子插件设置 → 整洁显示 |
|
|
37
|
+
| 0.1.7-rc.1+ (main line) | ✅ | ✅ (both views) | 起子插件设置 → 整洁显示 |
|
|
37
38
|
| 0.1.5-alpha.1 ~ 0.1.6 (incl. 0.1.5) | ❌ | ✅ (`compat/0.1.5` line, tag `v0.1.0-dsh0.1.5`) | plugin config card |
|
|
38
39
|
| 0.1.2-alpha.2 ~ 0.1.4.x | ❌ | ✅ (`compat/0.1.2` line, tag `v0.1.0-dsh0.1.2`) | plugin config card |
|
|
39
40
|
| 0.1.0-rc.7 ~ 0.1.2-alpha.1 (incl. 0.1.1) | ❌ | ✅ (`compat/0.1.1` line, tag `v0.1.0-dsh0.1.1`) | plugin config card |
|
|
40
41
|
|
|
41
|
-
- The reading view is bound to the 0.1.7
|
|
42
|
+
- The reading view is bound to the host slot contract, pinned per line (this line pins 0.2.0-rc.2; main pins 0.1.7-rc.2 — the host had breaking changes across 0.1.7-rc.1 → rc.2 → 0.2.0); it will not be backported.
|
|
42
43
|
- The legacy backport of the rail subset (rail + sheen + colors + smart loading) **has shipped**: it lives on three compat branches, install one-liner e.g. `dsh plugin --profile web add github:drscrewdriver/dsh-tidy-display#v0.1.0-dsh0.1.5`; npm dist-tags `dsh-0.1.5` / `dsh-0.1.2` / `dsh-0.1.1` follow the publish. The 0.1.5-line official-rail takeover is to-be-verified; 0.1.3/0.1.4 ride the `compat/0.1.2` line untested.
|
|
44
|
+
- The 0.2.0 line (this branch): install via `dsh plugin --profile web add github:drscrewdriver/dsh-tidy-display#v0.2.0-dsh0.2.0`; after the npm publish the dist-tag works: `dsh plugin --profile web add dsh-tidy-display@dsh-0.2.0`.
|
|
43
45
|
- 0.1.0-rc.6 and earlier are out of scope (use dsh-tidychat 0.1.0).
|
|
44
|
-
- Matrix as of 2026-09-
|
|
46
|
+
- Matrix as of 2026-09-30 (tidy-display v0.2.0 / better-display 0.3.3-fork.5 / tidychat 0.3.4 line).
|
|
45
47
|
|
|
46
48
|
## Features
|
|
47
49
|
|
|
@@ -107,7 +109,7 @@ npm run build # emits lib/ (committed; the check-harness-compat gate needs
|
|
|
107
109
|
npm test
|
|
108
110
|
```
|
|
109
111
|
|
|
110
|
-
Targets DeepSeek Harness **0.
|
|
112
|
+
Targets DeepSeek Harness **0.2.0-rc.1+** (peer `>=0.2.0-rc.1 <0.2.1-0`). Display only — it does not change Agent execution, the SDK, or credentials. Node.js `^22.19.0 || >=24`. New sessions default to reading.
|
|
111
113
|
|
|
112
114
|
## Relationship to the originals
|
|
113
115
|
|
package/README.es.md
ADDED
|
@@ -0,0 +1,120 @@
|
|
|
1
|
+
# dsh-tidy-display
|
|
2
|
+
|
|
3
|
+
[简体中文](README.md) | [English](README.en.md) | [Français](README.fr.md) | [Deutsch](README.de.md) | [Italiano](README.it.md) | [Русский](README.ru.md) | [Español](README.es.md)
|
|
4
|
+
|
|
5
|
+
**Tidy Display** — un plugin comunitario para DeepSeek Harness (DSH) **0.1.7** que fusiona la vista de lectura y el raíl de mensajes en un solo plugin: las sesiones largas se vuelven fáciles de ojear, navegables y reanudables.
|
|
6
|
+
|
|
7
|
+
> Este proyecto nace de la fusión de dos plugins de DSH muy populares:
|
|
8
|
+
> [dsh-better-display](https://github.com/aa2246740/dsh-better-display) (vista de lectura, mantenido mediante un fork) ×
|
|
9
|
+
> [dsh-tidychat](https://github.com/BananaSoldier01/dsh-tidychat) (raíl de mensajes / carga inteligente del historial).
|
|
10
|
+
> La fusión elimina el conflicto de contrato DOM entre ambos; crédito y agradecimiento a los dos.
|
|
11
|
+
|
|
12
|
+
## Procedencia y agradecimientos (declarados tal cual)
|
|
13
|
+
|
|
14
|
+
**La vista de lectura en vivo** procede de [dsh-better-display](https://github.com/aa2246740/dsh-better-display): el render en streaming del upstream aa2246740, la coreografía de plegado del proceso y el puente oficial, mejorados por el fork de drscrewdriver. Este proyecto no reescribió su pipeline de render ni el de animaciones.
|
|
15
|
+
|
|
16
|
+
**El raíl de mensajes** procede de [dsh-tidychat](https://github.com/BananaSoldier01/dsh-tidychat): el raíl sobre canvas, el hover de ojo de pez, la cadena de colores y la carga inteligente del historial son porteos, mejorados por la línea compat de drscrewdriver (destello blanco, paridad con el steering, el DOM como única fuente de verdad).
|
|
17
|
+
|
|
18
|
+
### Carencias del better-display original, corregidas por este proyecto / el fork
|
|
19
|
+
|
|
20
|
+
1. **Sin placa detrás de los mensajes ni del razonamiento** — las respuestas finales y el texto de razonamiento se colocan directamente sobre el fondo de la página; la legibilidad sufre con skins, fondos de pantalla y temas oscuros. → El fork añadió a las respuestas la placa translúcida oficial `--dsw-alias-bg-layer-1`, y a la tarjeta de razonamiento el mismo fondo (commits `fa3a795`, `94d59c7`).
|
|
21
|
+
2. **La vista de lectura pierde los anclajes por fila del host** — `data-chat-anchor-key` / `data-chat-flow-kind` no se emiten con las filas de mensajes, así que los plugins de terceros que dependen de ese contrato como fuente de verdad del DOM (p. ej., el raíl de tidychat) resuelven cero filas y **fallan en silencio** en la vista de lectura. → El arreglo se envió al upstream como [aa2246740/dsh-better-display#41](https://github.com/aa2246740/dsh-better-display/pull/41); el proyecto fusionado incluye el mismo arreglo.
|
|
22
|
+
3. Su TimelineRail es un único raíl con el esquema oficial — sin resúmenes de ojo de pez, sin salto por clic, sin colores.
|
|
23
|
+
|
|
24
|
+
### Carencias del dsh-tidychat original, y el motivo de la fusión
|
|
25
|
+
|
|
26
|
+
1. El plegado / los separadores son cirugía DOM que se solapa con el plegado nativo del host (0.1.2+), obligando al usuario a elegir manualmente entre uno u otro.
|
|
27
|
+
2. Las versiones v0.2.10 y anteriores leían mal la instantánea en hosts DSH 0.1.2 — el raíl resolvía cero turnos y **nunca llegó a renderizarse realmente** (corregido en v0.3.0; véase `docs/RAIL-ROOT-CAUSE-ANALYSIS.md` en su repositorio).
|
|
28
|
+
3. Entraba en conflicto **en ambos sentidos** con la vista de lectura de better-display: la cirugía de tidychat no alcanzaba las filas de la vista de lectura, y los anclajes perdidos por la vista de lectura a su vez inutilizaban el raíl — la motivación directa de esta fusión.
|
|
29
|
+
|
|
30
|
+
Gracias a los dos upstreams y a sus autores (aa2246740, BananaSoldier01) — este proyecto está a hombros de ellos. Las mejoras del upstream que no entren en conflicto se irán incorporando cuando toque.
|
|
31
|
+
|
|
32
|
+
## Compatibilidad con el host
|
|
33
|
+
|
|
34
|
+
| Host DSH | Vista de lectura | Raíl de mensajes | Ajustes |
|
|
35
|
+
|---|---|---|---|
|
|
36
|
+
| 0.2.0-rc.1+ (esta línea, `compat/0.2.0`) | ✅ | ✅ (ambas vistas) | 起子插件设置 → 整洁显示 |
|
|
37
|
+
| 0.1.7-rc.1+ (línea main) | ✅ | ✅ (ambas vistas) | 起子插件设置 → 整洁显示 |
|
|
38
|
+
| 0.1.5-alpha.1 ~ 0.1.6 (incl. 0.1.5) | ❌ | ✅ (línea `compat/0.1.5`, tag `v0.1.0-dsh0.1.5`) | tarjeta de configuración del plugin |
|
|
39
|
+
| 0.1.2-alpha.2 ~ 0.1.4.x | ❌ | ✅ (línea `compat/0.1.2`, tag `v0.1.0-dsh0.1.2`) | tarjeta de configuración del plugin |
|
|
40
|
+
| 0.1.0-rc.7 ~ 0.1.2-alpha.1 (incl. 0.1.1) | ❌ | ✅ (línea `compat/0.1.1`, tag `v0.1.0-dsh0.1.1`) | tarjeta de configuración del plugin |
|
|
41
|
+
|
|
42
|
+
- La vista de lectura está ligada al contrato de slot del host, con línea base propia por línea (esta línea: 0.2.0-rc.2; main: 0.1.7-rc.2 — el host tuvo cambios incompatibles entre 0.1.7-rc.1 → rc.2 → 0.2.0); no se retroportará a hosts antiguos.
|
|
43
|
+
- El backport a hosts antiguos **ya está hecho**: el subconjunto del raíl (raíl + destello + colores + carga inteligente) se publica en tres ramas compat, instalación en una línea tipo `dsh plugin --profile web add github:drscrewdriver/dsh-tidy-display#v0.1.0-dsh0.1.5`; tras publicar en npm se añaden los dist-tags `dsh-0.1.5` / `dsh-0.1.2` / `dsh-0.1.1`. La toma de control del raíl oficial de la línea 0.1.5 queda pendiente de verificación práctica; 0.1.3 / 0.1.4 van en teoría por la línea `compat/0.1.2`, sin probar.
|
|
44
|
+
- La línea 0.2.0 (esta rama): instala con `dsh plugin --profile web add github:drscrewdriver/dsh-tidy-display#v0.2.0-dsh0.2.0`; tras la publicación en npm funciona el dist-tag: `dsh plugin --profile web add dsh-tidy-display@dsh-0.2.0`.
|
|
45
|
+
- 0.1.0-rc.6 y anteriores quedan fuera del soporte (use dsh-tidychat 0.1.0).
|
|
46
|
+
- Matriz a fecha de 2026-09-30 (línea tidy-display v0.2.0 / better-display 0.3.3-fork.5 / tidychat 0.3.4).
|
|
47
|
+
|
|
48
|
+
## Funcionalidades
|
|
49
|
+
|
|
50
|
+
### Vista de lectura (de better-display)
|
|
51
|
+
- Los pasos de ejecución se recogen en resúmenes desplegables; las respuestas finales se presentan como **burbujas de mensaje** (placa translúcida + cristal esmerilado opcional que deja ver los fondos de las skins)
|
|
52
|
+
- La tarjeta de razonamiento comparte la misma placa translúcida; el razonamiento en streaming puede seguir el desplazamiento, pausarse y desplegarse por completo
|
|
53
|
+
- Puente oficial: vistas de herramientas, feedback, tarjetas de entregables, turnTail y demás se renderizan por los slots oficiales
|
|
54
|
+
- Los bloques `` ```mcp-app `` se montan como tarjetas interactivas aisladas (`<iframe sandbox="allow-scripts allow-forms">`); paquete de skills en [`skills/generative-mcpapps/`](skills/generative-mcpapps/)
|
|
55
|
+
- Fila de entregables, reloj de espera, eco de pendientes; la «Conversación / Trayectoria» original, el cuadro de entrada, el selector de modelo, las herramientas y las aprobaciones siguen ahí
|
|
56
|
+
|
|
57
|
+
### Raíl de mensajes (de dsh-tidychat)
|
|
58
|
+
- Raíl de navegación sobre canvas en el borde de la conversación: hover de ojo de pez con tarjetas de resumen, salto por clic, resaltado del turno actual al desplazarse
|
|
59
|
+
- Estilos **líneas / puntos**, posición **borde izquierdo / derecho (en espejo)**
|
|
60
|
+
- **Anillo de destello blanco**: un destello suave bajo la marca del turno actual y del turno bajo el cursor los mantiene legibles sobre fondos recargados
|
|
61
|
+
- **Colores**: el color de marca y el color de acento ofrecen cada uno Automático (sigue el tema, con corrección automática si falta contraste) / Personalizado (selector de color + texto HEX/RGB + deslizador de opacidad)
|
|
62
|
+
- **Toma el control del raíl de mensajes oficial**: oculta el TurnNavigator oficial del borde derecho (oculto, no desmontado) y deja solo este raíl
|
|
63
|
+
- Funciona en **ambas** vistas: la vista «Conversación» nativa y la vista de lectura
|
|
64
|
+
|
|
65
|
+
### Ajustes
|
|
66
|
+
Todos los ajustes están en **Ajustes → 起子插件设置 → 整洁显示 (Tidy Display)**: raíl de mensajes (interruptor / posición / estilo / destello / toma de control / colores) + burbujas de mensaje / cristal esmerilado translúcido / plegado automático / modo de apertura de entregables. La configuración se persiste en `dsh.reader.v1`.
|
|
67
|
+
|
|
68
|
+
## Instalación
|
|
69
|
+
|
|
70
|
+
> ⚠️ **Excluyente mutuamente con `dsh-better-display` y `@bananasoldier01/dsh-tidychat`**: los tres registran una vista `reader` (mismo id, misma prioridad) en el slot de lista `conversation.view`. Activarlos a la vez hace fallar la activación por registro duplicado (el cliente informa `entry did not activate` y la página se queda atascada en la pantalla de fallo de carga de plugins). Desinstale o desactive aquellos antes de activar este plugin.
|
|
71
|
+
|
|
72
|
+
### App de escritorio DSH Studio (recomendada)
|
|
73
|
+
|
|
74
|
+
Abra **Ajustes → Plugins → Añadir plugin** e introduzca el nombre del paquete:
|
|
75
|
+
|
|
76
|
+
```text
|
|
77
|
+
dsh-tidy-display
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
### Web CLI
|
|
81
|
+
|
|
82
|
+
Publicado en npm — instale por el nombre simple:
|
|
83
|
+
|
|
84
|
+
```sh
|
|
85
|
+
dsh plugin --profile web add dsh-tidy-display
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
La dirección de GitHub también funciona (las líneas compat de hosts antiguos se instalan por tag; ver la matriz de arriba):
|
|
89
|
+
|
|
90
|
+
```sh
|
|
91
|
+
dsh plugin --profile web add github:drscrewdriver/dsh-tidy-display
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
Directorio local / tarball (desarrollo / prueba local):
|
|
95
|
+
|
|
96
|
+
```sh
|
|
97
|
+
dsh plugin --profile web add ./dsh-tidy-display
|
|
98
|
+
dsh plugin --profile web add ./dsh-tidy-display-0.1.0.tgz
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
`dsh.bundle` se captura en el arranque: **no** escriba a mano la misma fila de insert en el `cordis.patch.yml` del perfil (montaje doble); para quitar una copia ya instalada use `dsh plugin --profile web remove dsh-tidy-display`. Para un Web Host ya en ejecución, vuelva a abrir el Host una vez y recargue la página.
|
|
102
|
+
|
|
103
|
+
## Desarrollo
|
|
104
|
+
|
|
105
|
+
```sh
|
|
106
|
+
pnpm install
|
|
107
|
+
npm run typecheck
|
|
108
|
+
npm run build # genera lib/ (se sube al repo; la compuerta check-harness-compat necesita un checkout del Harness)
|
|
109
|
+
npm test
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
Apunta a DeepSeek Harness **0.2.0-rc.1+** (peer `>=0.2.0-rc.1 <0.2.1-0`). Solo presentación — no cambia la ejecución del Agent, el SDK ni las credenciales de los modelos. Node.js `^22.19.0 || >=24`. Las sesiones nuevas entran por defecto en lectura.
|
|
113
|
+
|
|
114
|
+
## Relación con los proyectos originales
|
|
115
|
+
|
|
116
|
+
Véase «[Procedencia y agradecimientos](#procedencia-y-agradecimientos-declarados-tal-cual)» al principio — las mejoras del upstream que no entren en conflicto se irán incorporando cuando toque.
|
|
117
|
+
|
|
118
|
+
## Licencia
|
|
119
|
+
|
|
120
|
+
Las partes de presentación y Markdown proceden de DeepSeek Harness (MIT). Las animaciones toman como referencia [Transitions.dev](https://transitions.dev/). El código de este repositorio es [MIT](LICENSE).
|
package/README.fr.md
ADDED
|
@@ -0,0 +1,120 @@
|
|
|
1
|
+
# dsh-tidy-display
|
|
2
|
+
|
|
3
|
+
[简体中文](README.md) | [English](README.en.md) | [Français](README.fr.md) | [Deutsch](README.de.md) | [Italiano](README.it.md) | [Русский](README.ru.md) | [Español](README.es.md)
|
|
4
|
+
|
|
5
|
+
**Tidy Display** — un plugin communautaire pour DeepSeek Harness (DSH) **0.1.7** qui fusionne la vue de lecture et le rail des messages en un seul plugin : les longues sessions deviennent lisibles en un coup d'œil, navigables et faciles à reprendre.
|
|
6
|
+
|
|
7
|
+
> Ce projet est issu de la fusion de deux plugins DSH très populaires :
|
|
8
|
+
> [dsh-better-display](https://github.com/aa2246740/dsh-better-display) (vue de lecture, maintenu via un fork) ×
|
|
9
|
+
> [dsh-tidychat](https://github.com/BananaSoldier01/dsh-tidychat) (rail des messages / chargement intelligent de l'historique).
|
|
10
|
+
> La fusion élimine le conflit de contrat DOM entre les deux ; crédit et remerciements à chacun.
|
|
11
|
+
|
|
12
|
+
## Sources et remerciements (énoncés tels quels)
|
|
13
|
+
|
|
14
|
+
**La vue de lecture en direct** provient de [dsh-better-display](https://github.com/aa2246740/dsh-better-display) : rendu en flux de l'amont aa2246740, chorégraphie de repli du processus et pontage officiel, enrichis par le fork de drscrewdriver. Ce projet n'a pas réécrit sa chaîne de rendu ni celle des animations.
|
|
15
|
+
|
|
16
|
+
**Le rail des messages** provient de [dsh-tidychat](https://github.com/BananaSoldier01/dsh-tidychat) : le rail canvas, le survol fisheye, la chaîne de couleurs et le chargement intelligent de l'historique sont des portages, enrichis par la ligne compat de drscrewdriver (halo blanc, parité avec le steering, DOM comme source unique de vérité).
|
|
17
|
+
|
|
18
|
+
### Limites du better-display d'origine, corrigées par ce projet / le fork
|
|
19
|
+
|
|
20
|
+
1. **Aucune plaque sous les messages ni le raisonnement** — les réponses finales et le texte de raisonnement reposent directement sur l'arrière-plan de la page ; la lisibilité souffre avec les skins, les fonds d'écran et les thèmes sombres. → Le fork a ajouté aux réponses la plaque translucide officielle `--dsw-alias-bg-layer-1`, et à la carte de raisonnement le même fond (commits `fa3a795`, `94d59c7`).
|
|
21
|
+
2. **La vue de lecture perd les ancres par ligne de l'hôte** — `data-chat-anchor-key` / `data-chat-flow-kind` ne sont pas émis avec les lignes de messages, si bien que les plugins tiers qui s'y fient comme source de vérité DOM (par ex. le rail de tidychat) ne résolvent aucune ligne et **échouent en silence** sous la vue de lecture. → Correctif soumis en amont via [aa2246740/dsh-better-display#41](https://github.com/aa2246740/dsh-better-display/pull/41) ; le projet fusionné embarque le même correctif.
|
|
22
|
+
3. Son TimelineRail n'est qu'un unique rail au plan officiel — pas de résumés fisheye, pas de saut au clic, pas de couleurs.
|
|
23
|
+
|
|
24
|
+
### Limites du dsh-tidychat d'origine, et motivations de la fusion
|
|
25
|
+
|
|
26
|
+
1. Le repli / les séparateurs sont de la chirurgie DOM qui chevauche le repli natif de l'hôte (0.1.2+), obligeant l'utilisateur à choisir manuellement l'un ou l'autre.
|
|
27
|
+
2. Les versions v0.2.10 et antérieures lisaient le mauvais instantané sur les hôtes DSH 0.1.2 — le rail ne résolvait aucun tour et **n'a en réalité jamais été rendu** (corrigé en v0.3.0 ; voir `docs/RAIL-ROOT-CAUSE-ANALYSIS.md` dans son dépôt).
|
|
28
|
+
3. Il entrait en conflit **dans les deux sens** avec la vue de lecture de better-display : la chirurgie de tidychat n'atteignait pas les lignes de la vue de lecture, et les ancres perdues par la vue de lecture sabotaient à leur tour le rail — la motivation directe de cette fusion.
|
|
29
|
+
|
|
30
|
+
Merci aux deux dépôts amont et à leurs auteurs (aa2246740, BananaSoldier01) — ce projet est monté sur leurs épaules. Les améliorations amont sans conflit seront suivies au fil de l'eau.
|
|
31
|
+
|
|
32
|
+
## Compatibilité avec l'hôte
|
|
33
|
+
|
|
34
|
+
| Hôte DSH | Vue de lecture | Rail des messages | Réglages |
|
|
35
|
+
|---|---|---|---|
|
|
36
|
+
| 0.2.0-rc.1+ (cette ligne, `compat/0.2.0`) | ✅ | ✅ (les deux vues) | 起子插件设置 → 整洁显示 |
|
|
37
|
+
| 0.1.7-rc.1+ (ligne main) | ✅ | ✅ (les deux vues) | 起子插件设置 → 整洁显示 |
|
|
38
|
+
| 0.1.5-alpha.1 ~ 0.1.6 (0.1.5 inclus) | ❌ | ✅ (ligne `compat/0.1.5`, tag `v0.1.0-dsh0.1.5`) | carte de configuration du plugin |
|
|
39
|
+
| 0.1.2-alpha.2 ~ 0.1.4.x | ❌ | ✅ (ligne `compat/0.1.2`, tag `v0.1.0-dsh0.1.2`) | carte de configuration du plugin |
|
|
40
|
+
| 0.1.0-rc.7 ~ 0.1.2-alpha.1 (0.1.1 inclus) | ❌ | ✅ (ligne `compat/0.1.1`, tag `v0.1.0-dsh0.1.1`) | carte de configuration du plugin |
|
|
41
|
+
|
|
42
|
+
- La vue de lecture est liée au contrat de slot de l'hôte, avec une base propre par ligne (cette ligne : 0.2.0-rc.2 ; main : 0.1.7-rc.2 — l'hôte a connu des changements rupture entre 0.1.7-rc.1 → rc.2 → 0.2.0) ; elle ne sera pas rétroportée vers les anciens hôtes.
|
|
43
|
+
- Le rétroportage vers les anciens hôtes **est réalisé** : le sous-ensemble rail (rail + halo + couleurs + chargement intelligent) est publié sur trois branches compat, installation en une ligne du type `dsh plugin --profile web add github:drscrewdriver/dsh-tidy-display#v0.1.0-dsh0.1.5` ; après publication npm viendront s'ajouter les dist-tags `dsh-0.1.5` / `dsh-0.1.2` / `dsh-0.1.1`. La reprise du rail officiel sur la ligne 0.1.5 reste à vérifier en pratique ; 0.1.3 / 0.1.4 passent théoriquement par la ligne `compat/0.1.2`, sans test réel.
|
|
44
|
+
- La ligne 0.2.0 (cette branche) : installer via `dsh plugin --profile web add github:drscrewdriver/dsh-tidy-display#v0.2.0-dsh0.2.0` ; après publication npm, le dist-tag fonctionne : `dsh plugin --profile web add dsh-tidy-display@dsh-0.2.0`.
|
|
45
|
+
- 0.1.0-rc.6 et antérieurs hors périmètre (utilisez dsh-tidychat 0.1.0).
|
|
46
|
+
- Matrice à jour au 2026-09-30 (ligne tidy-display v0.2.0 / better-display 0.3.3-fork.5 / tidychat 0.3.4).
|
|
47
|
+
|
|
48
|
+
## Fonctionnalités
|
|
49
|
+
|
|
50
|
+
### Vue de lecture (issue de better-display)
|
|
51
|
+
- Les étapes d'exécution se replient en résumés dépliables ; les réponses finales s'affichent en **bulles de message** (plaque translucide + verre dépoli optionnel qui laisse transparaître les fonds d'écran des skins)
|
|
52
|
+
- La carte de raisonnement bénéficie du même fond translucide ; le raisonnement en flux peut suivre le défilement, se mettre en pause et se déplier intégralement
|
|
53
|
+
- Pontage officiel : vues d'outils, feedback, cartes de livrables, turnTail et plus, rendus via les slots officiels
|
|
54
|
+
- Les blocs `` ```mcp-app `` sont montés en cartes interactives en sandbox (`<iframe sandbox="allow-scripts allow-forms">`) ; pack de compétences dans [`skills/generative-mcpapps/`](skills/generative-mcpapps/)
|
|
55
|
+
- Ligne des livrables, horloge d'attente, écho des actions en attente ; la « Conversation / Trajectoire » d'origine, la zone de saisie, le sélecteur de modèle, les outils et les approbations restent en place
|
|
56
|
+
|
|
57
|
+
### Rail des messages (issu de dsh-tidychat)
|
|
58
|
+
- Rail de navigation canvas au bord de la conversation : survol fisheye avec cartes de résumé, saut au clic, surbrillance du tour courant pendant le défilement
|
|
59
|
+
- Styles **lignes / points**, position **bord gauche / droit (en miroir)**
|
|
60
|
+
- **Anneau à halo blanc** : un halo doux sous les marqueurs du tour courant et du tour survolé les garde lisibles même sur des fonds d'écran chargés
|
|
61
|
+
- **Couleurs** : couleur des marqueurs et couleur d'accent offrent chacune Auto (suit le thème, avec correction automatique si le contraste est insuffisant) / Personnalisé (sélecteur de couleur + texte HEX/RGB + curseur d'opacité)
|
|
62
|
+
- **Reprise du rail officiel des messages** : masque le TurnNavigator officiel du bord droit (masqué, pas démonté) pour ne garder que ce rail
|
|
63
|
+
- Fonctionne dans **les deux** vues : la vue « Conversation » native et la vue de lecture
|
|
64
|
+
|
|
65
|
+
### Réglages
|
|
66
|
+
Tous les réglages se trouvent sous **Réglages → 起子插件设置 → 整洁显示 (Tidy Display)** : rail (activation / position / style / halo / reprise / couleurs) + bulles de message / verre dépoli translucide / repli automatique / mode d'ouverture des livrables. La configuration est persistée dans `dsh.reader.v1`.
|
|
67
|
+
|
|
68
|
+
## Installation
|
|
69
|
+
|
|
70
|
+
> ⚠️ **Mutuellement exclusif avec `dsh-better-display` et `@bananasoldier01/dsh-tidychat`** : les trois enregistrent une vue `reader` (même id, même priorité) dans le slot de liste `conversation.view`. Les activer ensemble fait échouer l'activation dès la phase d'activation pour cause de double enregistrement (le client signale `entry did not activate` et la page reste bloquée sur l'écran d'échec de chargement des plugins). Désinstallez ou désactivez-les avant d'activer ce plugin.
|
|
71
|
+
|
|
72
|
+
### Application de bureau DSH Studio (recommandé)
|
|
73
|
+
|
|
74
|
+
Ouvrez **Réglages → Plugins → Ajouter un plugin** et saisissez le nom du paquet :
|
|
75
|
+
|
|
76
|
+
```text
|
|
77
|
+
dsh-tidy-display
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
### Web CLI
|
|
81
|
+
|
|
82
|
+
Publié sur npm — installez par le nom seul :
|
|
83
|
+
|
|
84
|
+
```sh
|
|
85
|
+
dsh plugin --profile web add dsh-tidy-display
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
L'adresse GitHub fonctionne aussi (les lignes compat antérieures à 0.1.7 s'installent par tag, voir la matrice ci-dessus) :
|
|
89
|
+
|
|
90
|
+
```sh
|
|
91
|
+
dsh plugin --profile web add github:drscrewdriver/dsh-tidy-display
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
Répertoire local / tarball (développement / test local) :
|
|
95
|
+
|
|
96
|
+
```sh
|
|
97
|
+
dsh plugin --profile web add ./dsh-tidy-display
|
|
98
|
+
dsh plugin --profile web add ./dsh-tidy-display-0.1.0.tgz
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
`dsh.bundle` est capturé au démarrage : n'**écrivez** pas à la main la même ligne d'insert dans le `cordis.patch.yml` du profil (double montage) ; une copie déjà installée se retire avec `dsh plugin --profile web remove dsh-tidy-display`. Pour un Web Host déjà en cours d'exécution, rouvrez le Host une fois puis rechargez la page.
|
|
102
|
+
|
|
103
|
+
## Développement
|
|
104
|
+
|
|
105
|
+
```sh
|
|
106
|
+
pnpm install
|
|
107
|
+
npm run typecheck
|
|
108
|
+
npm run build # produit lib/ (committée ; le garde-fou check-harness-compat exige un checkout du Harness)
|
|
109
|
+
npm test
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
Cible DeepSeek Harness **0.2.0-rc.1+** (peer `>=0.2.0-rc.1 <0.2.1-0`). Uniquement de l'affichage — ni l'exécution de l'Agent, ni le SDK, ni les identifiants des modèles ne sont modifiés. Node.js `^22.19.0 || >=24`. Les nouvelles sessions ouvrent la lecture par défaut.
|
|
113
|
+
|
|
114
|
+
## Relation avec les projets d'origine
|
|
115
|
+
|
|
116
|
+
Voir « [Sources et remerciements](#sources-et-remerciements-énoncés-tels-quels) » en tête — les améliorations amont sans conflit seront suivies au fil de l'eau.
|
|
117
|
+
|
|
118
|
+
## Licence
|
|
119
|
+
|
|
120
|
+
Les parties affichage et Markdown proviennent de DeepSeek Harness (MIT). Les animations s'inspirent de [Transitions.dev](https://transitions.dev/). Le code de ce dépôt est [MIT](LICENSE).
|
package/README.it.md
ADDED
|
@@ -0,0 +1,120 @@
|
|
|
1
|
+
# dsh-tidy-display
|
|
2
|
+
|
|
3
|
+
[简体中文](README.md) | [English](README.en.md) | [Français](README.fr.md) | [Deutsch](README.de.md) | [Italiano](README.it.md) | [Русский](README.ru.md) | [Español](README.es.md)
|
|
4
|
+
|
|
5
|
+
**Tidy Display** — un plugin della community per DeepSeek Harness (DSH) **0.1.7** che fonde la vista di lettura e la barra dei messaggi in un unico plugin: le sessioni lunghe diventano scorribili a colpo d'occhio, navigabili e riprendibili.
|
|
6
|
+
|
|
7
|
+
> Questo progetto nasce dall'unione di due popolari plugin DSH:
|
|
8
|
+
> [dsh-better-display](https://github.com/aa2246740/dsh-better-display) (vista di lettura, mantenuto tramite un fork) ×
|
|
9
|
+
> [dsh-tidychat](https://github.com/BananaSoldier01/dsh-tidychat) (barra dei messaggi / caricamento intelligente della cronologia).
|
|
10
|
+
> L'unione elimina il conflitto di contratto DOM tra i due; credito e ringraziamenti a entrambi.
|
|
11
|
+
|
|
12
|
+
## Provenienza e ringraziamenti (dichiarati come sono)
|
|
13
|
+
|
|
14
|
+
**La vista di lettura in tempo reale** proviene da [dsh-better-display](https://github.com/aa2246740/dsh-better-display): il rendering in streaming dell'upstream aa2246740, la coreografia di ripiegamento del processo e il bridging ufficiale, potenziati dal fork di drscrewdriver. Questo progetto non ha riscritto la sua pipeline di rendering né quella delle animazioni.
|
|
15
|
+
|
|
16
|
+
**La barra dei messaggi** proviene da [dsh-tidychat](https://github.com/BananaSoldier01/dsh-tidychat): la barra su canvas, l'hover a fisheye, la catena di colori e il caricamento intelligente della cronologia sono porting, potenziati dalla linea compat di drscrewdriver (bagliore bianco, parità con lo steering, DOM come unica fonte di verità).
|
|
17
|
+
|
|
18
|
+
### Limiti del better-display originale, corretti da questo progetto / dal fork
|
|
19
|
+
|
|
20
|
+
1. **Nessuno sfondo dietro messaggi e ragionamento** — le risposte finali e il testo del ragionamento poggiano direttamente sullo sfondo della pagina; la leggibilità soffre con skin, sfondi personalizzati e temi scuri. → Il fork ha aggiunto alle risposte la piastra traslucida ufficiale `--dsw-alias-bg-layer-1` e alla scheda di ragionamento lo stesso fondo (commit `fa3a795`, `94d59c7`).
|
|
21
|
+
2. **La vista di lettura perde le ancore per riga dell'host** — `data-chat-anchor-key` / `data-chat-flow-kind` non vengono emessi con le righe dei messaggi, quindi i plugin di terze parti che vi si affidano come fonte di verità DOM (es. la barra di tidychat) risolvono zero righe e **falliscono in silenzio** nella vista di lettura. → Fix inviato all'upstream con [aa2246740/dsh-better-display#41](https://github.com/aa2246740/dsh-better-display/pull/41); il progetto unito porta lo stesso fix.
|
|
22
|
+
3. Il suo TimelineRail è un'unica barra con il solo schema ufficiale — niente riassunti a fisheye, niente salto al clic, niente colori.
|
|
23
|
+
|
|
24
|
+
### Limiti del dsh-tidychat originale, e le motivazioni dell'unione
|
|
25
|
+
|
|
26
|
+
1. Ripiega / separatori sono interventi DOM chirurgici che si sovrappongono al ripiegamento nativo dell'host (0.1.2+), costringendo l'utente a scegliere manualmente tra i due.
|
|
27
|
+
2. Le versioni fino alla v0.2.10 inclusa leggevano lo snapshot sbagliato sugli host DSH 0.1.2 — la barra risolveva zero turni e **non è mai stata effettivamente renderizzata** (corretto in v0.3.0; vedere `docs/RAIL-ROOT-CAUSE-ANALYSIS.md` nel suo repository).
|
|
28
|
+
3. Entrava in conflitto **in entrambe le direzioni** con la vista di lettura di better-display: la chirurgia di tidychat non raggiungeva le righe della vista di lettura, e le ancore perse dalla vista di lettura a loro volta inutilizzavano la barra — la motivazione diretta di questa unione.
|
|
29
|
+
|
|
30
|
+
Grazie ai due upstream e ai loro autori (aa2246740, BananaSoldier01) — questo progetto sta sulle loro spalle. I miglioramenti dell'upstream che non vanno in conflitto verranno seguiti appena possibile.
|
|
31
|
+
|
|
32
|
+
## Compatibilità con l'host
|
|
33
|
+
|
|
34
|
+
| Host DSH | Vista di lettura | Barra dei messaggi | Impostazioni |
|
|
35
|
+
|---|---|---|---|
|
|
36
|
+
| 0.2.0-rc.1+ (questa linea, `compat/0.2.0`) | ✅ | ✅ (entrambe le viste) | 起子插件设置 → 整洁显示 |
|
|
37
|
+
| 0.1.7-rc.1+ (linea main) | ✅ | ✅ (entrambe le viste) | 起子插件设置 → 整洁显示 |
|
|
38
|
+
| 0.1.5-alpha.1 ~ 0.1.6 (0.1.5 incluso) | ❌ | ✅ (linea `compat/0.1.5`, tag `v0.1.0-dsh0.1.5`) | scheda di configurazione del plugin |
|
|
39
|
+
| 0.1.2-alpha.2 ~ 0.1.4.x | ❌ | ✅ (linea `compat/0.1.2`, tag `v0.1.0-dsh0.1.2`) | scheda di configurazione del plugin |
|
|
40
|
+
| 0.1.0-rc.7 ~ 0.1.2-alpha.1 (0.1.1 incluso) | ❌ | ✅ (linea `compat/0.1.1`, tag `v0.1.0-dsh0.1.1`) | scheda di configurazione del plugin |
|
|
41
|
+
|
|
42
|
+
- La vista di lettura è vincolata al contratto di slot dell'host, con baseline propria per linea (questa linea: 0.2.0-rc.2; main: 0.1.7-rc.2 — l'host ha avuto breaking change tra 0.1.7-rc.1 → rc.2 → 0.2.0); non verrà retroportata sui vecchi host.
|
|
43
|
+
- Il backport del sottoinsieme della barra **è stato realizzato**: il sottoinsieme (barra + bagliore + colori + caricamento intelligente) è pubblicato su tre branch compat, installazione in una riga tipo `dsh plugin --profile web add github:drscrewdriver/dsh-tidy-display#v0.1.0-dsh0.1.5`; dopo la pubblicazione npm seguono i dist-tag `dsh-0.1.5` / `dsh-0.1.2` / `dsh-0.1.1`. La presa in carico della barra ufficiale della linea 0.1.5 resta da verificare sul campo; 0.1.3 / 0.1.4 passano teoricamente per la linea `compat/0.1.2`, non testata.
|
|
44
|
+
- La linea 0.2.0 (questo branch): installa con `dsh plugin --profile web add github:drscrewdriver/dsh-tidy-display#v0.2.0-dsh0.2.0`; dopo la pubblicazione su npm funziona il dist-tag: `dsh plugin --profile web add dsh-tidy-display@dsh-0.2.0`.
|
|
45
|
+
- 0.1.0-rc.6 e precedenti sono fuori dal perimetro di supporto (usare dsh-tidychat 0.1.0).
|
|
46
|
+
- Matrice aggiornata al 2026-09-30 (linea tidy-display v0.2.0 / better-display 0.3.3-fork.5 / tidychat 0.3.4).
|
|
47
|
+
|
|
48
|
+
## Funzionalità
|
|
49
|
+
|
|
50
|
+
### Vista di lettura (da better-display)
|
|
51
|
+
- I passaggi di esecuzione si raccolgono in riassunti espandibili; le risposte finali appaiono come **bolle di messaggio** (piastra traslucida + vetro satinato opzionale che lascia trasparire gli sfondi delle skin)
|
|
52
|
+
- La scheda di ragionamento ha la stessa piastra traslucida; il ragionamento in streaming può seguire lo scorrimento, mettersi in pausa ed espandersi per intero
|
|
53
|
+
- Ponte ufficiale: viste dei tool, feedback, schede dei deliverable, turnTail e altro resi tramite gli slot ufficiali
|
|
54
|
+
- I blocchi `` ```mcp-app `` vengono montati come schede interattive in sandbox (`<iframe sandbox="allow-scripts allow-forms">`); pacchetto di skill in [`skills/generative-mcpapps/`](skills/generative-mcpapps/)
|
|
55
|
+
- Riga dei deliverable, orologio di attesa, eco dei pending; la «Conversazione / Traiettoria» originale, la casella di input, il selettore del modello, i tool e le approvazioni restano al loro posto
|
|
56
|
+
|
|
57
|
+
### Barra dei messaggi (da dsh-tidychat)
|
|
58
|
+
- Barra di navigazione su canvas al bordo della conversazione: hover a fisheye con schede di riepilogo, salto al clic, evidenziazione del turno corrente durante lo scorrimento
|
|
59
|
+
- Stili **linea / punto**, posizione **margine sinistro / destro (specchiato)**
|
|
60
|
+
- **Anello con bagliore bianco**: un bagliore morbido sotto i marker del turno corrente e del turno sotto il cursore li mantiene leggibili anche su sfondi molto ricchi
|
|
61
|
+
- **Colori**: il colore dei marker e il colore d'accento offrono ciascuno Automatico (segue il tema, con correzione automatica in caso di contrasto insufficiente) / Personalizzato (selettore colore + testo HEX/RGB + cursore di trasparenza)
|
|
62
|
+
- **Assume il controllo della barra messaggi ufficiale**: nasconde il TurnNavigator ufficiale sul bordo destro (nascosto, non smontato), restando l'unica barra
|
|
63
|
+
- Funziona in **entrambe** le viste: la vista «Conversazione» nativa e la vista di lettura
|
|
64
|
+
|
|
65
|
+
### Impostazioni
|
|
66
|
+
Tutte le impostazioni si trovano sotto **Impostazioni → 起子插件设置 → 整洁显示 (Tidy Display)**: barra dei messaggi (interruttore / posizione / stile / bagliore / takeover / colori) + bolle di messaggio / vetro satinato traslucido / ripiegamento automatico / modalità di apertura dei deliverable. La configurazione è persistita in `dsh.reader.v1`.
|
|
67
|
+
|
|
68
|
+
## Installazione
|
|
69
|
+
|
|
70
|
+
> ⚠️ **Mutuamente esclusivo con `dsh-better-display` e `@bananasoldier01/dsh-tidychat`**: tutti e tre registrano una vista `reader` (stesso id, stessa priorità) nello slot a lista `conversation.view`. L'attivazione congiunta fallisce per registrazione duplicata già in fase di attivazione (il client riporta `entry did not activate` e la pagina resta bloccata sulla schermata di errore di caricamento dei plugin). Disinstallarli o disabilitarli prima di attivare questo plugin.
|
|
71
|
+
|
|
72
|
+
### App desktop DSH Studio (consigliata)
|
|
73
|
+
|
|
74
|
+
Aprire **Impostazioni → Plugin → Aggiungi plugin** e inserire il nome del pacchetto:
|
|
75
|
+
|
|
76
|
+
```text
|
|
77
|
+
dsh-tidy-display
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
### Web CLI
|
|
81
|
+
|
|
82
|
+
Pubblicato su npm — installazione con il nome semplice:
|
|
83
|
+
|
|
84
|
+
```sh
|
|
85
|
+
dsh plugin --profile web add dsh-tidy-display
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
Funziona anche l'indirizzo GitHub (le linee compat precedenti alla 0.1.7 si installano per tag, vedere la matrice sopra):
|
|
89
|
+
|
|
90
|
+
```sh
|
|
91
|
+
dsh plugin --profile web add github:drscrewdriver/dsh-tidy-display
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
Directory locale / tarball (sviluppo / test locale):
|
|
95
|
+
|
|
96
|
+
```sh
|
|
97
|
+
dsh plugin --profile web add ./dsh-tidy-display
|
|
98
|
+
dsh plugin --profile web add ./dsh-tidy-display-0.1.0.tgz
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
`dsh.bundle` viene acquisito all'avvio: **non** riscrivere a mano la stessa riga di insert nel `cordis.patch.yml` del profilo (doppio montaggio); per rimuovere una copia già installata usare `dsh plugin --profile web remove dsh-tidy-display`. Per un Web Host già in esecuzione, riaprire l'Host una volta e poi ricaricare la pagina.
|
|
102
|
+
|
|
103
|
+
## Sviluppo
|
|
104
|
+
|
|
105
|
+
```sh
|
|
106
|
+
pnpm install
|
|
107
|
+
npm run typecheck
|
|
108
|
+
npm run build # genera lib/ (committata; il gate check-harness-compat richiede un checkout del Harness)
|
|
109
|
+
npm test
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
Punta a DeepSeek Harness **0.2.0-rc.1+** (peer `>=0.2.0-rc.1 <0.2.1-0`). Solo presentazione: non modifica l'esecuzione dell'Agent, l'SDK né le credenziali dei modelli. Node.js `^22.19.0 || >=24`. Le nuove sessioni partono in lettura per impostazione predefinita.
|
|
113
|
+
|
|
114
|
+
## Relazione con i progetti originali
|
|
115
|
+
|
|
116
|
+
Vedere «[Provenienza e ringraziamenti](#provenienza-e-ringraziamenti-dichiarati-come-sono)» in cima — i miglioramenti dell'upstream che non vanno in conflitto verranno seguiti appena possibile.
|
|
117
|
+
|
|
118
|
+
## Licenza
|
|
119
|
+
|
|
120
|
+
Le parti di presentazione e Markdown provengono da DeepSeek Harness (MIT). Le animazioni si ispirano a [Transitions.dev](https://transitions.dev/). Il codice di questo repository è [MIT](LICENSE).
|
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# dsh-tidy-display
|
|
2
2
|
|
|
3
|
-
[English](
|
|
3
|
+
[简体中文](README.md) | [English](README.en.md) | [Français](README.fr.md) | [Deutsch](README.de.md) | [Italiano](README.it.md) | [Русский](README.ru.md) | [Español](README.es.md)
|
|
4
4
|
|
|
5
5
|
**整洁显示** —— DeepSeek Harness(DSH)**0.1.7** 的一个社区插件:把「阅读视图」与「消息轨」缝合成一个插件,长会话可扫读、可定位、可续聊。
|
|
6
6
|
|
|
@@ -33,15 +33,17 @@
|
|
|
33
33
|
|
|
34
34
|
| DSH 宿主 | 阅读视图 | 消息轨 | 设置入口 |
|
|
35
35
|
|---|---|---|---|
|
|
36
|
-
| 0.
|
|
36
|
+
| 0.2.0-rc.1+(本线,`compat/0.2.0`) | ✅ | ✅(双视图) | 起子插件设置 → 整洁显示 |
|
|
37
|
+
| 0.1.7-rc.1+(main 线) | ✅ | ✅(双视图) | 起子插件设置 → 整洁显示 |
|
|
37
38
|
| 0.1.5-alpha.1 ~ 0.1.6(含 0.1.5) | ❌ | ✅(`compat/0.1.5` 线,tag `v0.1.0-dsh0.1.5`) | 插件配置卡片 |
|
|
38
39
|
| 0.1.2-alpha.2 ~ 0.1.4.x | ❌ | ✅(`compat/0.1.2` 线,tag `v0.1.0-dsh0.1.2`) | 插件配置卡片 |
|
|
39
40
|
| 0.1.0-rc.7 ~ 0.1.2-alpha.1(含 0.1.1) | ❌ | ✅(`compat/0.1.1` 线,tag `v0.1.0-dsh0.1.1`) | 插件配置卡片 |
|
|
40
41
|
|
|
41
|
-
-
|
|
42
|
+
- 阅读视图绑定宿主槽位契约,按线锁基线(本线 0.2.0-rc.2,main 线 0.1.7-rc.2;官方在 0.1.7-rc.1 → rc.2 → 0.2.0 之间都有契约漂移),不下放旧宿主。
|
|
42
43
|
- 旧宿主反向适配**已实施**:消息轨子集(轨 + 柔光 + 配色 + 智能加载)在三条兼容分支上发布,安装一行式形如 `dsh plugin --profile web add github:drscrewdriver/dsh-tidy-display#v0.1.0-dsh0.1.5`;npm 发布后补 dist-tag `dsh-0.1.5` / `dsh-0.1.2` / `dsh-0.1.1`。0.1.5 线的官方轨接管为待实测项;0.1.3 / 0.1.4 随 `compat/0.1.2` 线理论可用、未实测。
|
|
44
|
+
- 0.2.0 线(本分支):安装 `dsh plugin --profile web add github:drscrewdriver/dsh-tidy-display#v0.2.0-dsh0.2.0`;npm 发布后可用 dist-tag:`dsh plugin --profile web add dsh-tidy-display@dsh-0.2.0`。
|
|
43
45
|
- 0.1.0-rc.6 及更早不在支持范围(请使用 dsh-tidychat 0.1.0)。
|
|
44
|
-
- 矩阵截至 2026-09-
|
|
46
|
+
- 矩阵截至 2026-09-30(tidy-display v0.2.0 / better-display 0.3.3-fork.5 / tidychat 0.3.4 线)。
|
|
45
47
|
|
|
46
48
|
## 功能
|
|
47
49
|
|
|
@@ -107,7 +109,7 @@ npm run build # 产物 lib/(入库;check-harness-compat 门需要 Harne
|
|
|
107
109
|
npm test
|
|
108
110
|
```
|
|
109
111
|
|
|
110
|
-
面向 DeepSeek Harness **0.
|
|
112
|
+
面向 DeepSeek Harness **0.2.0-rc.1+**(peer `>=0.2.0-rc.1 <0.2.1-0`)。只改展示,不改 Agent 执行、SDK 或模型凭据。Node.js `^22.19.0 || >=24`。新会话默认进阅读。
|
|
111
113
|
|
|
112
114
|
## 与原项目的关系
|
|
113
115
|
|