hzthzt/dsh-summary-panel0

dsh-summary-panel

Extensible Codex-style pinned summary panel for DeepSeek Harness Web.

包名
dsh-summary-panel
版本
0.1.0
许可证
MIT
最近更新
2026年8月23日

安装

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:hzthzt/dsh-summary-panel

dsh-summary-panel

English | 简体中文

An extensible Codex-style conversation summary panel for DeepSeek Harness Web.

The list icon in the session header toggles a compact 320px popover. Its height grows with its content until it reaches the available viewport height, then the content scrolls. It stays aligned to the conversation edge and to the left of open Harness tool details. On mobile it becomes a dismissible right drawer. Open state is persisted per session.

Built-in outputs

The Outputs section reads successful file mutations published by ui-deliverables. It aggregates all loaded Turns, keeps each exact path once at its latest successful sequence, and lists the most recent files first. Five files are shown initially, with explicit expand and collapse controls. Clicking a row resolves it against the session workspace and opens it through Harness.

An empty conversation shows No outputs yet. The built-in section has no creation action because the panel does not own a file creation workflow.

Install

Install a reviewed commit into a DSH profile:

dsh plugin --profile 
 add github:hzthzt/dsh-summary-panel#
dsh --profile 
 --dump-config
dsh --profile 
 web

The repository commits lib/, so Git installation does not need to build the package. A local tarball can be installed instead:

pnpm pack
dsh plugin --profile 
 add ./dsh-summary-panel-0.1.0.tgz

Extension API

Client plugins can register session-scoped sections through the typed conversation.summary.section list slot. Add dsh-summary-panel to the contributing bundle's Client inject list and peer dependencies, then import its public Client contract:

import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client'
import {
  SummaryEmpty,
  SummarySection,
  type SummarySectionComponentProps,
} from 'dsh-summary-panel/client'

function ReviewSection({ presentation, closePanel }: SummarySectionComponentProps) {
  return (
     {}}>
      Nothing to review
      {presentation}
      Close
    
  )
}

export function apply(ctx: ClientContext): void {
  ctx.slots.inject('conversation.summary.section', () => ctx.slots.register({
    name: 'conversation.summary.section',
    id: 'review',
    order: 30,
  }, ReviewSection))
}

Every section receives the standard session props, including sessionId, useSession, and useSessions, plus presentation: 'pinned' | 'overlay' and closePanel().

The Client module also augments ctx.summaryPanel:

ctx.summaryPanel.open(sessionId)
ctx.summaryPanel.close(sessionId)
ctx.summaryPanel.toggle(sessionId)

Public presentation primitives are SummarySection, SummaryItem, and SummaryEmpty. SummarySection shows its plus action only when both actionLabel and onAction are provided.

Layout compatibility

Version 0.1.0 targets DeepSeek Harness dsh-v0.1.1-rc.2 at commit b150a551b8d465e31e418e1b2eaf5e79bbb7d28e.

Popover placement assumes the baseline AppFrame order: [data-shell-overlay] follows the details column. The plugin uses its width to keep the popover to the left of open tool details, but never replaces conversation, details, or another single slot and never mutates the center column. If the DOM cannot be discovered or measured, it falls back to a right-aligned popover.

Development

Use Node.js 24 and pnpm@11.7.0:

pnpm install --frozen-lockfile
pnpm typecheck
pnpm test
pnpm build
git diff --exit-code -- lib
pnpm pack

License

MIT