@wangjunjian/dsh-artifact-viewer

中文 | English

A DeepSeek Harness bundle plugin that adds an artifact sidebar and bookmarking for agent conversations. It does not modify the deepseek-harness source tree; it is built as a standalone plugin and loaded into the web profile.

What it does

• Detects artifacts produced during a conversation: files created or edited by tools 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 the Harness home at ~/.dsh/storages/artifact-viewer/bookmarks.json by the host half.
• Replaces the default message-image renderer (conversation.message.images) with one that adds a bookmark star overlay.
• Intercepts file links in the conversation window, including tool-row .fileLink buttons, the turn-tail "产物" chips from ui-deliverables, inline-code file mentions in the closing prose, markdown links such as [sample.html](/Users/.../sample.html), and inline <code> paths such as /Users/.../cat.svg, so clicking a generated file opens it inside the artifact panel instead of the host default application.
• 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, or open the containing folder of a previewed artifact.
• Expands the panel to full window with a header button; automatically uses an opaque background when the user has set a background image, while keeping the translucent blurred look for solid-color themes.
• Navigates from a bookmark back to its source session via the header "open conversation" button in the bookmarks tab or preview pane.

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 ~/GitHub/wang-junjian/dsh-artifact-viewer

# Or from a registry, once published
dsh plugin --profile web add @wangjunjian/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

The @deepseek-ai/dsh-* dependencies are regular registry packages (currently release candidates), so no local checkout of deepseek-harness is needed.

pnpm install
pnpm run typecheck
pnpm run build
pnpm run test
pnpm run lint

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

Supported previews

Bookmarks file format

Bookmarks are stored in the DeepSeek Harness home under ~/.dsh/storages/artifact-viewer/bookmarks.json. The file groups bookmarks by canonical project path, so multiple projects can share one store while staying isolated:

{
  "version": 1,
  "projects": {
    "/workspace/project-a": [
      {
        "id": "file:/workspace/foo.ts:42",
        "kind": "file",
        "name": "foo.ts",
        "path": "/workspace/foo.ts",
        "seq": 42,
        "sessionId": "<session-id>",
        "createdAt": 1234567890
      }
    ]
  }
}

Storage location and cross-browser consistency

The DSH home directory is resolved via @deepseek-ai/dsh-home-paths, which honors the $DSH_HOME environment variable and falls back to ~/.dsh. Because the store lives in the Harness home rather than inside any project directory, switching between browsers (Chrome, Safari, etc.) for the same project reads the same bookmark file, provided both browsers resolve the workspace to the same canonical path. The host normalizes projectPath with fs.realpath before it is used as a lookup key, so macOS symbolic-link differences such as /var/folders vs /private/var/folders do not split bookmarks across browsers.

Migration from earlier versions

Versions before this change stored bookmarks at <project-root>/.dsh/bookmarks.json. Those files are no longer read; if you have existing bookmarks in the old location, move them into the new store under ~/.dsh/storages/artifact-viewer/bookmarks.json and wrap them under the project's canonical path key, or re-create the bookmarks in the UI.

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. Non-UTF-8 text files are rejected with an error so that binary files are not rendered as garbled text.

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.
• Bookmarks created before the sessionId field was added cannot be navigated back to their source session.