# dsh-qa-panel

**Repository Path**: hnwlc/dsh-qa-panel

## Basic Information

- **Project Name**: dsh-qa-panel
- **Description**: DSH 插件：问答面板 — 会话对卡片化、摘要与 HTML 导出（独立仓库，保留历史）
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-22
- **Last Updated**: 2026-10-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# dsh-qa（问答面板）

DSH Web 插件：在会话视图「对话 / 轨迹 / 上下文」后增加第 4 个标签「问答」，卡片式展示该会话中全部问答对，支持放大、单卡总结、另存 HTML、全文总结。

## 状态

核心功能已完成：`conversation.view` order 30 标签、问答对提取（窗口 + loadOlder 补全）、卡片网格 / 放大模态 / 另存 HTML（全量转义）、单卡与全文总结。总结默认跟随 dsh 已配置的默认模型（Models 设置 / agent-default-model），无需插件侧配置；也可在 cordis.patch.yml 用 `provider` / `model` 固定路由。

## 结构

```
src/
├── index.ts        host half：QaSummaryService（default-export 服务插件）
└── client/         浏览器 half：标签注册 + 面板 + 样式注入
```

## 开发

```sh
pnpm install
pnpm build          # tsc 转译 host（lib/index.js）+ tsdown 出 client（lib/client.js）
pnpm typecheck
```

本机安装到 profile：

```sh
dsh plugin --profile web add link:/Users/jy/dev/deepseek-harness/dsh-qa
```

client 改动在 `pnpm run dev:web` 下可热更；host 改动需重启 `dsh web`。

## 发布给朋友（tarball）

```sh
pnpm pack           # 自动跑 check（typecheck + test + build），生成 dsh-external-dsh-qa-0.1.0.tgz
```

把 `dsh-external-dsh-qa-0.1.0.tgz` 发给朋友，朋友执行：

```sh
dsh plugin --profile web add /path/to/dsh-external-dsh-qa-0.1.0.tgz
```

然后重启 `dsh web`，会话视图会出现第 4 个标签「问答」。

**环境要求**：dsh web 部署（base + web-app bundle，官方包由 profile 提供）；
「总结 / 全文总结」需要已配置的 LLM（`DEEPSEEK_API_KEY` 或 Models 设置里的默认模型）。

## 设计

见 `docs/design.md`（第一性原理评审后的修订版）。