dsh-tidy-display 0.1.1 → 0.2.1

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.
Files changed (125) hide show
  1. package/CHANGELOG.md +7 -0
  2. package/README.de.md +120 -118
  3. package/README.en.md +6 -4
  4. package/README.es.md +120 -118
  5. package/README.fr.md +120 -118
  6. package/README.it.md +120 -118
  7. package/README.md +6 -4
  8. package/README.ru.md +120 -118
  9. package/compat/harness-020rc2.json +99 -0
  10. package/lib/client.js +524 -2975
  11. package/lib/client.js.map +1 -1
  12. package/lib/types/client/Blocks.d.ts.map +1 -1
  13. package/lib/types/client/Blocks.js +9 -10
  14. package/lib/types/client/Blocks.js.map +1 -1
  15. package/lib/types/client/ChoreographedFlow.d.ts.map +1 -1
  16. package/lib/types/client/ChoreographedFlow.js +1 -2
  17. package/lib/types/client/ChoreographedFlow.js.map +1 -1
  18. package/lib/types/client/ClosedProcessSummary.d.ts.map +1 -1
  19. package/lib/types/client/ClosedProcessSummary.js +1 -2
  20. package/lib/types/client/ClosedProcessSummary.js.map +1 -1
  21. package/lib/types/client/DiffPanel.d.ts.map +1 -1
  22. package/lib/types/client/DiffPanel.js +1 -2
  23. package/lib/types/client/DiffPanel.js.map +1 -1
  24. package/lib/types/client/McpAppFrame.d.ts.map +1 -1
  25. package/lib/types/client/McpAppFrame.js +7 -8
  26. package/lib/types/client/McpAppFrame.js.map +1 -1
  27. package/lib/types/client/Reader.d.ts.map +1 -1
  28. package/lib/types/client/Reader.js +34 -35
  29. package/lib/types/client/Reader.js.map +1 -1
  30. package/lib/types/client/ReasoningCard.d.ts.map +1 -1
  31. package/lib/types/client/ReasoningCard.js +2 -3
  32. package/lib/types/client/ReasoningCard.js.map +1 -1
  33. package/lib/types/client/SettingsSection.d.ts.map +1 -1
  34. package/lib/types/client/SettingsSection.js +2 -2
  35. package/lib/types/client/SettingsSection.js.map +1 -1
  36. package/lib/types/client/ToolActivity.d.ts.map +1 -1
  37. package/lib/types/client/ToolActivity.js +16 -19
  38. package/lib/types/client/ToolActivity.js.map +1 -1
  39. package/lib/types/client/TurnMetrics.d.ts.map +1 -1
  40. package/lib/types/client/TurnMetrics.js +1 -2
  41. package/lib/types/client/TurnMetrics.js.map +1 -1
  42. package/lib/types/client/WaitClock.d.ts.map +1 -1
  43. package/lib/types/client/WaitClock.js +1 -2
  44. package/lib/types/client/WaitClock.js.map +1 -1
  45. package/lib/types/client/deliverables.d.ts.map +1 -1
  46. package/lib/types/client/deliverables.js +1 -2
  47. package/lib/types/client/deliverables.js.map +1 -1
  48. package/lib/types/client/index.d.ts.map +1 -1
  49. package/lib/types/client/index.js +2 -21
  50. package/lib/types/client/index.js.map +1 -1
  51. package/lib/types/client/live-turn.d.ts.map +1 -1
  52. package/lib/types/client/live-turn.js +5 -6
  53. package/lib/types/client/live-turn.js.map +1 -1
  54. package/lib/types/client/markdown/render.d.ts.map +1 -1
  55. package/lib/types/client/markdown/render.js +2 -3
  56. package/lib/types/client/markdown/render.js.map +1 -1
  57. package/lib/types/client/message-chrome.d.ts.map +1 -1
  58. package/lib/types/client/message-chrome.js +4 -7
  59. package/lib/types/client/message-chrome.js.map +1 -1
  60. package/lib/types/client/motion.d.ts.map +1 -1
  61. package/lib/types/client/motion.js +2 -3
  62. package/lib/types/client/motion.js.map +1 -1
  63. package/lib/types/client/primitive-labels.d.ts +0 -8
  64. package/lib/types/client/primitive-labels.d.ts.map +1 -1
  65. package/lib/types/client/primitive-labels.js +22 -67
  66. package/lib/types/client/primitive-labels.js.map +1 -1
  67. package/lib/types/client/projection.d.ts.map +1 -1
  68. package/lib/types/client/projection.js +5 -8
  69. package/lib/types/client/projection.js.map +1 -1
  70. package/lib/types/client/rail/RailView.d.ts.map +1 -1
  71. package/lib/types/client/rail/RailView.js +4 -5
  72. package/lib/types/client/rail/RailView.js.map +1 -1
  73. package/lib/types/client/settings-copy.d.ts +2 -4
  74. package/lib/types/client/settings-copy.d.ts.map +1 -1
  75. package/lib/types/client/settings-copy.js +2 -89
  76. package/lib/types/client/settings-copy.js.map +1 -1
  77. package/lib/types/client/settings.js +2 -2
  78. package/lib/types/client/settings.js.map +1 -1
  79. package/lib/types/client/tool-activity.d.ts.map +1 -1
  80. package/lib/types/client/tool-activity.js +7 -13
  81. package/lib/types/client/tool-activity.js.map +1 -1
  82. package/lib/types/client/word-motion.d.ts.map +1 -1
  83. package/lib/types/client/word-motion.js +1 -5
  84. package/lib/types/client/word-motion.js.map +1 -1
  85. package/package.json +142 -145
  86. package/scripts/check-harness-compat.mjs +1 -1
  87. package/scripts/verify-official-bridge.mjs +2 -1
  88. package/src/client/Blocks.tsx +16 -17
  89. package/src/client/ChoreographedFlow.tsx +1 -2
  90. package/src/client/ClosedProcessSummary.tsx +1 -2
  91. package/src/client/DiffPanel.tsx +1 -2
  92. package/src/client/McpAppFrame.tsx +10 -11
  93. package/src/client/Reader.tsx +55 -56
  94. package/src/client/ReasoningCard.tsx +9 -10
  95. package/src/client/SettingsSection.tsx +1 -5
  96. package/src/client/ToolActivity.tsx +25 -28
  97. package/src/client/TurnMetrics.tsx +16 -17
  98. package/src/client/WaitClock.tsx +1 -2
  99. package/src/client/deliverables.ts +1 -2
  100. package/src/client/index.tsx +270 -298
  101. package/src/client/live-turn.ts +5 -6
  102. package/src/client/markdown/render.tsx +3 -4
  103. package/src/client/message-chrome.ts +4 -8
  104. package/src/client/motion.tsx +2 -3
  105. package/src/client/primitive-labels.ts +22 -67
  106. package/src/client/projection.ts +5 -8
  107. package/src/client/rail/RailView.tsx +4 -5
  108. package/src/client/settings-copy.ts +3 -93
  109. package/src/client/settings.tsx +2 -2
  110. package/src/client/tool-activity.ts +7 -13
  111. package/src/client/word-motion.tsx +1 -5
  112. package/lib/types/client/locales.d.ts +0 -289
  113. package/lib/types/client/locales.d.ts.map +0 -1
  114. package/lib/types/client/locales.js +0 -2255
  115. package/lib/types/client/locales.js.map +0 -1
  116. package/locale/de.json +0 -6
  117. package/locale/en.json +0 -6
  118. package/locale/es.json +0 -6
  119. package/locale/fr.json +0 -6
  120. package/locale/it.json +0 -6
  121. package/locale/ja.json +0 -6
  122. package/locale/ko.json +0 -6
  123. package/locale/ru.json +0 -6
  124. package/locale/zh.json +0 -6
  125. package/src/client/locales.ts +0 -2422
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 CHANGED
@@ -1,118 +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.1.7-rc.1+ (diese Linie) | ✅ | ✅ (beide Ansichten) | 起子插件设置 → 整洁显示 |
37
- | 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 |
38
- | 0.1.2-alpha.2 ~ 0.1.4.x | ❌ | ✅ (`compat/0.1.2`-Linie, Tag `v0.1.0-dsh0.1.2`) | Plugin-Konfigurationskarte |
39
- | 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 |
40
-
41
- - Die Leseansicht ist an den Slot-Vertrag von 0.1.7 gebunden (der Host selbst hatte zwischen 0.1.7-rc.1 und rc.2 Breaking Changes) und wird nicht auf alte Hosts zurückportiert.
42
- - 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.
43
- - 0.1.0-rc.6 und früher sind außerhalb des Unterstützungsumfangs (bitte dsh-tidychat 0.1.0 verwenden).
44
- - Stand der Matrix: 2026-09-28 (Linie tidy-display v0.1.0 / better-display 0.3.3-fork.5 / tidychat 0.3.4).
45
-
46
- ## Funktionen
47
-
48
- ### Leseansicht (aus better-display)
49
- - Ausführungsschritte kollabieren zu ausklappbaren Zusammenfassungen; finale Antworten erscheinen als **Nachrichtenblasen** (halbtransparenter Untergrund + optionales Milchglas, das Skins-Hintergründe durchscheinen lässt)
50
- - Die Reasoning-Karte erhält denselben halbtransparenten Untergrund; Streaming-Denken kann dem Scrollen folgen, pausieren und vollständig ausgeklappt werden
51
- - Offizielle Brücke: Tool-Ansichten, Feedback, Artefakt-Karten, turnTail und mehr werden über offizielle Slots gerendert
52
- - `` ```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/)
53
- - Artefakt-Zeile, Warteuhr, Pending-Echo; die ursprünglichen Ansichten „Dialog / Verlauf“, Eingabefeld, Modellauswahl, Tools und Freigaben bleiben erhalten
54
-
55
- ### Nachrichtenleiste (aus dsh-tidychat)
56
- - Canvas-Navigationsleiste am Rand des Gesprächs: Fisheye-Hover mit Zusammenfassungskarten, Sprung per Klick, Hervorhebung der aktuellen Runde beim Scrollen
57
- - Stil **Linien / Punkte**, Position **linker / rechter Rand (gespiegelt)**
58
- - **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
59
- - **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)
60
- - **Übernahme der offiziellen Nachrichtenleiste**: blendet den offiziellen TurnNavigator am rechten Rand aus (ausgeblendet, nicht demontiert); nur diese Leiste bleibt
61
- - Funktioniert in **beiden** Ansichten: der nativen „Dialog“-Ansicht und der Leseansicht
62
-
63
- ### Einstellungen
64
- 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.
65
-
66
- ## Installation
67
-
68
- > ⚠️ **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.
69
-
70
- ### DSH Studio Desktop-App (empfohlen)
71
-
72
- **Einstellungen → Plugins → Plugin hinzufügen** öffnen und den Paketnamen eingeben:
73
-
74
- ```text
75
- dsh-tidy-display
76
- ```
77
-
78
- ### Web-CLI
79
-
80
- Auf npm veröffentlicht — Installation über den nackten Namen:
81
-
82
- ```sh
83
- dsh plugin --profile web add dsh-tidy-display
84
- ```
85
-
86
- Auch die GitHub-Adresse funktioniert (compat-Linien für alte Hosts werden per Tag installiert, siehe Matrix oben):
87
-
88
- ```sh
89
- dsh plugin --profile web add github:drscrewdriver/dsh-tidy-display
90
- ```
91
-
92
- Lokales Verzeichnis / Tarball (Entwicklung / lokaler Test):
93
-
94
- ```sh
95
- dsh plugin --profile web add ./dsh-tidy-display
96
- dsh plugin --profile web add ./dsh-tidy-display-0.1.0.tgz
97
- ```
98
-
99
- `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.
100
-
101
- ## Entwicklung
102
-
103
- ```sh
104
- pnpm install
105
- npm run typecheck
106
- npm run build # erzeugt lib/ (eingecheckt; das check-harness-compat-Gate braucht einen Harness-Checkout)
107
- npm test
108
- ```
109
-
110
- Ziel ist DeepSeek Harness **0.1.7-rc.1+** (peer `>=0.1.7-rc.1 <0.1.8`). 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.
111
-
112
- ## Verhältnis zu den Originalprojekten
113
-
114
- Siehe oben „[Herkunft und Danksagung](#herkunft-und-danksagung-faktentreu)“ — Upstream-Verbesserungen, die nicht kollidieren, werden bei Gelegenheit nachgezogen.
115
-
116
- ## Lizenz
117
-
118
- 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).
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
@@ -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.1.7-rc.1+ (this line) | ✅ | ✅ (both views) | 起子插件设置 → 整洁显示 |
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 slot contract (the host itself had breaking changes between 0.1.7-rc.1 and rc.2); it will not be backported.
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-28 (tidy-display v0.1.0 / better-display 0.3.3-fork.5 / tidychat 0.3.4 line).
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.1.7-rc.1+** (peer `>=0.1.7-rc.1 <0.1.8`). Display only — it does not change Agent execution, the SDK, or credentials. Node.js `^22.19.0 || >=24`. New sessions default to reading.
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 CHANGED
@@ -1,118 +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.1.7-rc.1+ (esta línea) | ✅ | ✅ (ambas vistas) | 起子插件设置 → 整洁显示 |
37
- | 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 |
38
- | 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 |
39
- | 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 |
40
-
41
- - La vista de lectura está ligada al contrato de slot de 0.1.7 (el propio host tuvo cambios incompatibles entre 0.1.7-rc.1 y rc.2); no se retroportará a hosts antiguos.
42
- - 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.
43
- - 0.1.0-rc.6 y anteriores quedan fuera del soporte (use dsh-tidychat 0.1.0).
44
- - Matriz a fecha de 2026-09-28 (línea tidy-display v0.1.0 / better-display 0.3.3-fork.5 / tidychat 0.3.4).
45
-
46
- ## Funcionalidades
47
-
48
- ### Vista de lectura (de better-display)
49
- - 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)
50
- - La tarjeta de razonamiento comparte la misma placa translúcida; el razonamiento en streaming puede seguir el desplazamiento, pausarse y desplegarse por completo
51
- - Puente oficial: vistas de herramientas, feedback, tarjetas de entregables, turnTail y demás se renderizan por los slots oficiales
52
- - 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/)
53
- - 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í
54
-
55
- ### Raíl de mensajes (de dsh-tidychat)
56
- - 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
57
- - Estilos **líneas / puntos**, posición **borde izquierdo / derecho (en espejo)**
58
- - **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
59
- - **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)
60
- - **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
61
- - Funciona en **ambas** vistas: la vista «Conversación» nativa y la vista de lectura
62
-
63
- ### Ajustes
64
- 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`.
65
-
66
- ## Instalación
67
-
68
- > ⚠️ **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.
69
-
70
- ### App de escritorio DSH Studio (recomendada)
71
-
72
- Abra **Ajustes → Plugins → Añadir plugin** e introduzca el nombre del paquete:
73
-
74
- ```text
75
- dsh-tidy-display
76
- ```
77
-
78
- ### Web CLI
79
-
80
- Publicado en npm — instale por el nombre simple:
81
-
82
- ```sh
83
- dsh plugin --profile web add dsh-tidy-display
84
- ```
85
-
86
- La dirección de GitHub también funciona (las líneas compat de hosts antiguos se instalan por tag; ver la matriz de arriba):
87
-
88
- ```sh
89
- dsh plugin --profile web add github:drscrewdriver/dsh-tidy-display
90
- ```
91
-
92
- Directorio local / tarball (desarrollo / prueba local):
93
-
94
- ```sh
95
- dsh plugin --profile web add ./dsh-tidy-display
96
- dsh plugin --profile web add ./dsh-tidy-display-0.1.0.tgz
97
- ```
98
-
99
- `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.
100
-
101
- ## Desarrollo
102
-
103
- ```sh
104
- pnpm install
105
- npm run typecheck
106
- npm run build # genera lib/ (se sube al repo; la compuerta check-harness-compat necesita un checkout del Harness)
107
- npm test
108
- ```
109
-
110
- Apunta a DeepSeek Harness **0.1.7-rc.1+** (peer `>=0.1.7-rc.1 <0.1.8`). 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.
111
-
112
- ## Relación con los proyectos originales
113
-
114
- 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.
115
-
116
- ## Licencia
117
-
118
- 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).
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).