dsh-chat-share
English | 中文
Share a selected range of chat messages as Markdown, HTML, or plain text — a community plugin for
DeepSeek Harness (tagged
dsh-plugin and listed in the
awesome-dsh-plugin market registry).
This repository is the standalone distribution of the plugin: it ships both halves prebuilt
(lib/), installable with dsh plugin add and from the Plugin Market. The reference
implementation lives in the harness repository as packages/session-query/session-chat-share
(branch feat/session-chat-share on the upstream fork), where both halves are built and tested.
What it does
- Registers the Web
/share slash command — plain /share opens the dialog, /share txt saves
the whole chat as one .txt, /share last <n> saves only the newest n messages (combine:
/share txt last 10).
- The browser half adds a Share action to the Session Header, a Share row, and a
Save TXT row to each session's sidebar
... menu (through the sessionRowMenu registry
provided by ui-workspace). The dialog lists the session's shareable messages (append-origin
user/message and assistant/message text), lets you pick an inclusive range via From/To
selects or by clicking message rows, choose Markdown, HTML, or TXT, preview the rendered
artifact (GFM), then copy it to the clipboard or download it as a file (.md / .html /
.txt). Options: redact sensitive info (credential shapes and local absolute/home paths,
on by default) and include tool calls (bounded tool-call rows, off by default).
Save TXT downloads the whole chat as one .txt file directly, without opening the dialog.
Nothing is uploaded: the recipient opens the artifact directly.
- The HTML artifact is a self-contained page with GFM-lite rendering (headings, lists,
tables, blockquotes, links, fenced code, inline code/emphasis) and session images embedded
as data URIs; artifact headers carry the Session title and last model route when known, and
follow the active UI locale.
- Optional host-side auto-save: with
autoSaveDir configured on the plugin row, one TXT per
Session is written after every completed turn.
- History is read through the ordinary
session.history RPC and images through
session.attachment — no Host endpoint, no persistence changes, and no model involvement. The
command stays on the human-command plane with zero token effect.
Install
npm (preferred — the Plugin Market prefers npm sources):
dsh plugin --profile demo add dsh-chat-share
GitHub (alternative; ships the same prebuilt artifacts):
dsh plugin --profile demo add github:chrisx9z/dsh-chat-share#v1.3.0
The package ships prebuilt artifacts (lib/ — host and browser halves), so neither install
needs a build step. Releases are tagged v1.x.y; pin a tag or commit for reproducible installs.
Then use it in any session of that profile:
/share
Plugin Market
The plugin is listed in the awesome-dsh-plugin registry (PR
submission), so it appears in Settings → Plugin Market — browse, one-click install, and
updates once the catalog refreshes (usually within a day of the registry PR merging). The npm
source above makes market installs resolve to the published package.
Browser-half requirements
The installed package's browser half is picked up by the host's dsh.client scan, so the
Header button, dialog, and sidebar menu entries work on hosts whose composition includes it.
The sidebar ... menu rows need ui-workspace's sessionRowMenu service — present in dsh web
builds after 2026-08-18 (and in source checkouts of the harness). On older releases only the
/share command is active until the host is updated.
For the official distribution path (the harness repository's own web bundle), integrate the
package as packages/session-query/session-chat-share and compose the chat-share row in
packages/bundle/web-app/cordis.patch.yml.
How it works
- Host half (
src/index.ts): registers /share on the human-command plane. No arguments are
accepted; the dialog owns range selection.
- Browser half (
src/client/): a controller pages session.history from the tail (up to 300
shareable messages), keeps per-session dialog state, renders the range with pure renderers
(render.ts) into Markdown (verbatim text under role headers), a self-contained HTML page
(paragraphs + fenced code blocks), or plain text (TXT), and copies/downloads the artifact.
- The invariant companion (
src/invariant.ts) registers the package's no-op runtime invariant,
matching the harness convention.
Development and tests
The 41 package tests (command, controller, renderers, dialog, header action, row-menu actions,
invariant, and a real Loader composition) run inside a deepseek-harness checkout where the
@deepseek-ai/* workspace dependencies resolve:
pnpm exec vitest run packages/session-query/session-chat-share
Limitations
- The dialog reads up to 300 shareable messages from the log tail; older messages are out of scope
for one snippet.
- Sharing is a copy/download artifact, not a hosted link: nothing is uploaded to a server.
- HTML output is deliberately basic (paragraphs and fenced code blocks); inline markdown such as
emphasis and links stays as literal text in the HTML artifact, while the Markdown artifact keeps
it verbatim.
- Images are represented by an
[image] marker; tool calls, tool results, boundary markers, and
compaction-replaced copies are excluded.
License
MIT
