@wang-junjian/dsh-artifact-viewer

A DeepSeek Harness bundle plugin that adds an artifact sidebar and bookmarking for agent conversations.

What it does

• Detects artifacts produced during a conversation: files created or edited by tools, JSON tool results, and image attachments in messages.
• Renders a right-hand overlay panel (registered into shell.overlay) listing artifacts for the current session.
• Lets users bookmark artifacts; bookmarks are persisted in /.dsh/bookmarks.json by the host half.
• Replaces the default message-image renderer (conversation.message.images) with one that adds a bookmark star overlay.
• Opens clicked artifacts in preview tabs inside the panel and renders HTML (sandboxed iframe), Markdown, images, SVG, JSON, and source code.
• Can open files with the host default application via the workspace API.

Installation

Install the plugin into a DeepSeek Harness profile. The plugin does not modify the deepseek-harness repository itself.

# From a local checkout
dsh plugin --profile web add /Users/junjian/GitHub/wang-junjian/dsh-artifact-viewer

# Or from a registry, once published
dsh plugin --profile web add @wang-junjian/dsh-artifact-viewer

The bundle is appended to dsh.profile.bundles automatically.

Cordis config

You can override the plugin config in your profile's cordis.patch.yml:

- id: artifact-viewer
  config:
    enabled: true

Development

This package uses link: dependencies that point at a local checkout of deepseek-harness, so it can resolve @deepseek-ai/dsh-* packages without being inside the monorepo workspace.

pnpm install
pnpm run typecheck
pnpm run build
pnpm run test

Project layout

src/
  index.ts                    # Node/host half: bookmarks + preview RPC
  client/
    index.ts                  # Browser half: slot registrations
    store.ts                  # Panel UI state store
    locales.ts                # Chinese/English copy
    current-session.ts        # Observable source for the current session snapshot
    bookmarks.ts              # Browser bookmark controller
    artifacts.ts              # Artifact detection from ConversationSnapshot
    display.ts                # Display/bookmark conversion helpers
    ArtifactToggle.tsx        # sidebar.footer.action entry
    ArtifactPanel.tsx         # shell.overlay panel
    ArtifactList.tsx          # Artifact list inside the panel
    ArtifactPreview.tsx       # Preview pane for selected artifact
    ArtifactMessageImages.tsx # conversation.message.images replacement

Bookmarks file format

Bookmarks are stored at /.dsh/bookmarks.json:

[
  {
    "id": "file:/workspace/foo.ts:42",
    "kind": "file",
    "name": "foo.ts",
    "path": "/workspace/foo.ts",
    "seq": 42,
    "sessionId": "",
    "createdAt": 1234567890
  }
]

Host RPC endpoints

The host half registers a loopback-only channel at /artifact-viewer:

• bookmarks/read — returns the bookmark array.
• bookmarks/write — writes the bookmark array.
• file/preview — returns UTF-8 file content or base64-encoded binary data (for images/SVG/HTML) up to 512 KiB.

Known limitations

• The panel floats over the app via shell.overlay; a native right-column slot would be preferable once dsh exposes one.
• Preview of bookmarked images is limited because bookmarks only store the attachment id, not the full image reference.
• Video files are listed but not previewed inline.