kind: package-bundle
description: "Highlight completed DSH replies before collecting their text and annotations."
Reading Collection
中文 | English
Compatibility: plugin 0.1.2 requires DSH 0.2.1-rc.2 · Web.
package.json pins engines.dsh to this exact version. Other DSH versions, including newer releases, and Desktop installation have not been verified.
Summary
Highlight replies while reading, then collect the whole reply with all its marks. Highlights save automatically before collection. The collection keeps a copy of the reply so it remains readable after its source session is deleted. This optional bundle adds a collection to your Web profile.
Table of Contents
Screenshots
These screenshots show the Chinese UI in a local sample conversation; the plugin supports both Chinese and English.
Highlight as you read: select text and choose a color before collecting.
Highlight text in a reply before collecting
Browse saved replies by conversation name and reply opening.
Collection with generated titles and highlight counts
Open a collection to read the saved user question, reply, and colored highlights together.
Saved user question and annotated reply
Use this package
Install the supplied dsh-reading-collection-0.1.2.tgz through the Plugins page or the CLI for your Web profile, then restart that profile. With sibling DSH and DSH_plugin/reading-collection directories, run from the Harness checkout:
pnpm dsh plugin --profile web add ../DSH_plugin/reading-collection/artifacts/dsh-reading-collection-0.1.2.tgz
Select text in a completed reply and choose yellow, green, blue, or pink. Click an existing highlight to change or remove it. The five-point star below the reply collects its full Markdown, existing highlights, and the corresponding user question by default. The default title combines the conversation name with the opening of the reply; you can rename it afterward. Open Collection in the sidebar to search reply text, saved questions, and highlights, rename a collection, read, edit highlights, or open the source conversation. Saved replies show colored highlights directly on their original text, including selections across Markdown blocks. The Manage highlights section stays collapsed until you open it to browse quotes or use its controls. Removing a collection keeps its highlight draft.
Changes show as saved only after the Host commits them. A failed operation keeps existing data and offers Retry. Data is stored in the reading_collection storage domain under the Harness home, using the profile's configured storage provider. Unloading the bundle removes its UI without deleting its data.
For plugin development, run pnpm install, pnpm run typecheck, pnpm test, and pnpm run pack:bundle in this directory. The bundle has its own lockfile and does not modify the Harness workspace dependency graph.
This directory is an independent Git repository. Run plugin Git commands here and Harness Git commands in the DSH checkout. To prepare a keyless recorded-session check, run pnpm run prepare:smoke --dsh-root D:/00-code/DSH; omission of --dsh-root uses the sibling DSH directory. The script prints isolated test paths and does not start a server.
Understand the implementation
Implementation internals
The profile patch mounts one Host plugin and its browser contribution. The Host validates owner-only RPC requests and serializes mutations to versioned storage records. The browser uses additive Chat, sidebar, main-panel, and overlay slots. A release-specific DOM adapter maps text selections to completed Chat nodes and paints CSS Custom Highlights without modifying React-owned content. Exact quotes and surrounding text locate highlights after layout changes, with separator-newline differences mapped back to the rendered text; ambiguous matches remain unpainted and their saved quotes remain available.
Model Experience
This bundle contributes no model tools or prompt content. Collections and annotations are private reading data and do not enter the model context.
Known Limitations and Deferred Work
The user question must be loaded in the current Chat history before you can collect its reply. Question attachments are not copied. Older collections without a saved question remain readable and show a notice. Only completed text replies with a standard action row are supported. Streaming replies, reasoning, images, freehand drawing, and cross-message selections are excluded. Text highlighting needs a current browser with CSS Custom Highlight support. The DOM adapter is pinned to the declared DSH version; Desktop installation is unverified. Other browser windows refresh their collection when focused; live multi-window updates and collection export are not included. Opening the source returns to its conversation, without paging to the exact historical message.
Community and contribution
This is an independently maintained community plugin. The DSH contribution guide asks plugin authors to add the dsh-plugin GitHub repository topic so others can discover their work. Report plugin bugs and suggest improvements in this repository's Issues.
Dev Note
None.
